bug [ 872769 ] os.access() documentation should stress race conditions

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 2fbe66936f898f12ba6faadd1998699b877a6cde..e5b5962d99b8c76ec9ebc350d3e89549093d79bd 100644 (file)
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -680,6 +680,11 @@ test permissions.  Return \constant{True} if access is allowed,
 \constant{False} if not.
 See the \UNIX{} man page \manpage{access}{2} for more information.
 Availability: Macintosh, \UNIX, Windows.
+
+\note{Using \function{access()} to check if a user is authorized to e.g.
+open a file before actually doing so using \function{open()} creates a 
+security hole, because the user might exploit the short time interval 
+between checking and opening the file to manipulate it.}
 \end{funcdesc}
 
 \begin{datadesc}{F_OK}