Debian Codegraph @

Doc/library/audit_events.rst

raw
1 .. _audit-events:
2
3 .. index:: single: audit events
4
5 Audit events table
6 ==================
7
8 This table contains all events raised by :func:`sys.audit` or
9 :c:func:`PySys_Audit` calls throughout the CPython runtime and the
10 standard library. These calls were added in 3.8 or later (see :pep:`578`).
11
12 See :func:`sys.addaudithook` and :c:func:`PySys_AddAuditHook` for
13 information on handling these events.
14
15 .. impl-detail::
16
17 This table is generated from the CPython documentation, and may not
18 represent events raised by other implementations. See your runtime
19 specific documentation for actual events raised.
20
21 .. audit-event-table::
22
23 The following events are raised internally and do not correspond to any
24 public API of CPython:
25
26 +----------------------------+-------------------------------------------+
27 | Audit event | Arguments |
28 +============================+===========================================+
29 | _winapi.CreateFile | ``file_name``, ``desired_access``, |
30 | | ``share_mode``, ``creation_disposition``, |
31 | | ``flags_and_attributes`` |
32 +----------------------------+-------------------------------------------+
33 | _winapi.CreateJunction | ``src_path``, ``dst_path`` |
34 +----------------------------+-------------------------------------------+
35 | _winapi.CreateNamedPipe | ``name``, ``open_mode``, ``pipe_mode`` |
36 +----------------------------+-------------------------------------------+
37 | _winapi.CreatePipe | |
38 +----------------------------+-------------------------------------------+
39 | _winapi.CreateProcess | ``application_name``, ``command_line``, |
40 | | ``current_directory`` |
41 +----------------------------+-------------------------------------------+
42 | _winapi.OpenProcess | ``process_id``, ``desired_access`` |
43 +----------------------------+-------------------------------------------+
44 | _winapi.TerminateProcess | ``handle``, ``exit_code`` |
45 +----------------------------+-------------------------------------------+
46 | _posixsubprocess.fork_exec | ``exec_list``, ``args``, ``env`` |
47 +----------------------------+-------------------------------------------+
48 | ctypes.PyObj_FromPtr | ``obj`` |
49 +----------------------------+-------------------------------------------+
50
51 .. versionadded:: 3.14
52 The ``_posixsubprocess.fork_exec`` internal audit event.