mirror of
https://github.com/python/cpython.git
synced 2025-12-08 06:10:17 +00:00
2666a06d33
Add extra audit hooks to catch C function calling from ctypes, reading/writing files through readline and executing external programs through _posixsubprocess. * Make audit-tests for open pass when readline.append_history_file is unavailable * Less direct testing of _posixsubprocess for audit hooks * Also remove the audit hook from call_cdeclfunction now that _ctypes_callproc does it instead. * reword the NEWS entry. * mention readline in NEWS * add versionchanged markers * fix audit_events.rst versionadded * doc lint --------- Co-authored-by: Gregory P. Smith <greg@krypto.org>
52 lines
2.6 KiB
ReStructuredText
52 lines
2.6 KiB
ReStructuredText
.. _audit-events:
|
|
|
|
.. index:: single: audit events
|
|
|
|
Audit events table
|
|
==================
|
|
|
|
This table contains all events raised by :func:`sys.audit` or
|
|
:c:func:`PySys_Audit` calls throughout the CPython runtime and the
|
|
standard library. These calls were added in 3.8 or later (see :pep:`578`).
|
|
|
|
See :func:`sys.addaudithook` and :c:func:`PySys_AddAuditHook` for
|
|
information on handling these events.
|
|
|
|
.. impl-detail::
|
|
|
|
This table is generated from the CPython documentation, and may not
|
|
represent events raised by other implementations. See your runtime
|
|
specific documentation for actual events raised.
|
|
|
|
.. audit-event-table::
|
|
|
|
The following events are raised internally and do not correspond to any
|
|
public API of CPython:
|
|
|
|
+----------------------------+-------------------------------------------+
|
|
| Audit event | Arguments |
|
|
+============================+===========================================+
|
|
| _winapi.CreateFile | ``file_name``, ``desired_access``, |
|
|
| | ``share_mode``, ``creation_disposition``, |
|
|
| | ``flags_and_attributes`` |
|
|
+----------------------------+-------------------------------------------+
|
|
| _winapi.CreateJunction | ``src_path``, ``dst_path`` |
|
|
+----------------------------+-------------------------------------------+
|
|
| _winapi.CreateNamedPipe | ``name``, ``open_mode``, ``pipe_mode`` |
|
|
+----------------------------+-------------------------------------------+
|
|
| _winapi.CreatePipe | |
|
|
+----------------------------+-------------------------------------------+
|
|
| _winapi.CreateProcess | ``application_name``, ``command_line``, |
|
|
| | ``current_directory`` |
|
|
+----------------------------+-------------------------------------------+
|
|
| _winapi.OpenProcess | ``process_id``, ``desired_access`` |
|
|
+----------------------------+-------------------------------------------+
|
|
| _winapi.TerminateProcess | ``handle``, ``exit_code`` |
|
|
+----------------------------+-------------------------------------------+
|
|
| _posixsubprocess.fork_exec | ``exec_list``, ``args``, ``env`` |
|
|
+----------------------------+-------------------------------------------+
|
|
| ctypes.PyObj_FromPtr | ``obj`` |
|
|
+----------------------------+-------------------------------------------+
|
|
|
|
.. versionadded:: next
|
|
The ``_posixsubprocess.fork_exec`` internal audit event.
|