From a1182d02f9c37c533c3ff98fb1f1558c81c72ba3 Mon Sep 17 00:00:00 2001
From: Jake Wallin <jakewallin42@gmail.com>
Date: Tue, 20 Oct 2026 02:31:55 +0000
Subject: [PATCH] gh-158916: Clarify mode in os.open audit events

---
 Doc/library/os.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 3f0b91af4d0a86f..38eb2114815e55d 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1352,6 +1352,10 @@ as internal buffering of data.
 
    .. audit-event:: open path,mode,flags os.open
 
+   In this event, *mode* is always ``None``. Access modes and other options
+   are reported in *flags*. The file permission bits passed to this function
+   as *mode* are not included in the event.
+
    .. versionchanged:: 3.4
       The new file descriptor is now non-inheritable.