bpo-37363: Add audit events for a range of modules (GH-14301)
(cherry picked from commit 60419a7e96577cf783b3b45bf3984f9fb0d7ddff)
Co-authored-by: Steve Dower <steve.dower@python.org>
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index ede5c3c..ad49d7f 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -585,6 +585,13 @@
with Popen(["ifconfig"], stdout=PIPE) as proc:
log.write(proc.stdout.read())
+ .. audit-event:: subprocess.Popen "executable args cwd env"
+
+ Popen and the other functions in this module that use it raise an
+ :ref:`auditing event <auditing>` ``subprocess.Popen`` with arguments
+ ``executable``, ``args``, ``cwd``, ``env``. The value for ``args``
+ may be a single string or a list of strings, depending on platform.
+
.. versionchanged:: 3.2
Added context manager support.