dup2, dup3: work around another cygwin crasher

[gnulib.git] / doc / posix-functions / faccessat.texi

diff --git a/doc/posix-functions/faccessat.texi b/doc/posix-functions/faccessat.texi
index 1acfab2..70c7e3d 100644 (file)
--- a/doc/posix-functions/faccessat.texi
+++ b/doc/posix-functions/faccessat.texi
@@ -2,17 +2,29 @@
 @section @code{faccessat}
 @findex faccessat
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/faccessat.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/faccessat.html}
 
-Gnulib module: ---
+Gnulib module: faccessat
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+This function is missing on some platforms:
+glibc 2.3.6, Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8,
+AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, MSVC 9,
+Interix 3.5, BeOS.
+However, the replacement does not always take into account ACLs.  Also,
+it is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
+@end itemize
+
+Other problems of this function:
+@itemize
 @item
-This function is missing on some platforms:
-glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin, mingw, Interix 3.5, BeOS.
+There is an inherent race between calling this function and performing
+some action based on the results; you should think twice before trusting
+this function, especially in a set-uid or set-gid program.
 @end itemize