gh-85283: Add PySys_Audit() to the limited C API

This function was added in Python 3.8 by the PEP 578 "Python Runtime
Audit Hooks". It is needed to convert some stdlib extensions to the
limited C API, like fcntl, resource and syslog.

Move also non-limited "PerfMap" C API from Include/sysmodule.h to
Include/cpython/sysmodule.h.

Author: vstinner

Doc/data/stable_abi.dat

@@ -924,6 +924,10 @@ New Features
   references) now supports the :ref:`Limited API <limited-c-api>`.
   (Contributed by Victor Stinner in :gh:`108634`.)
 
+* Add :c:func:`PySys_Audit` function to the limited C API.
+  (Contributed by Victor Stinner in :gh:`85283`.)
+
+
 Porting to Python 3.13
 ----------------------
 

Doc/whatsnew/3.13.rst

@@ -4,8 +4,15 @@
 
 typedef int(*Py_AuditHookFunction)(const char *, PyObject *, void *);
 
-PyAPI_FUNC(int) PySys_Audit(
-    const char *event,
-    const char *argFormat,
-    ...);
 PyAPI_FUNC(int) PySys_AddAuditHook(Py_AuditHookFunction, void*);
+
+typedef struct {
+    FILE* perf_map;
+    PyThread_type_lock map_lock;
+} PerfMapState;
+
+PyAPI_FUNC(int) PyUnstable_PerfMapState_Init(void);
+
+PyAPI_FUNC(int) PyUnstable_WritePerfMapEntry(const void *code_addr, unsigned int code_size, const char *entry_name);
+
+PyAPI_FUNC(void) PyUnstable_PerfMapState_Fini(void);

Include/cpython/sysmodule.h

@@ -21,17 +21,11 @@ Py_DEPRECATED(3.13) PyAPI_FUNC(void) PySys_ResetWarnOptions(void);
 
 PyAPI_FUNC(PyObject *) PySys_GetXOptions(void);
 
-#if !defined(Py_LIMITED_API)
-typedef struct {
-    FILE* perf_map;
-    PyThread_type_lock map_lock;
-} PerfMapState;
-
-PyAPI_FUNC(int) PyUnstable_PerfMapState_Init(void);
-
-PyAPI_FUNC(int) PyUnstable_WritePerfMapEntry(const void *code_addr, unsigned int code_size, const char *entry_name);
-
-PyAPI_FUNC(void) PyUnstable_PerfMapState_Fini(void);
+#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x030d0000
+PyAPI_FUNC(int) PySys_Audit(
+    const char *event,
+    const char *argFormat,
+    ...);
 #endif
 
 #ifndef Py_LIMITED_API

Include/sysmodule.h

@@ -0,0 +1,2 @@
+Add the :c:func:`PySys_Audit` function to the limited C API. Patch by Victor
+Stinner.

Lib/test/test_stable_abi_ctypes.py

@@ -2452,3 +2452,5 @@
     added = '3.13'
 [function.PyLong_AsInt]
     added = '3.13'
+[function.PySys_Audit]
+    added = '3.13'