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

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index b5703637882d7fce6ac485c20e92056bd6104d05..46764b2bb6da957d9fc318229a599659a1725b0a 100644 (file)
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -667,6 +667,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}