doc: tweak *at function documentation
[gnulib.git] / doc / posix-functions / faccessat.texi
1 @node faccessat
2 @section @code{faccessat}
3 @findex faccessat
4
5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/faccessat.html}
6
7 Gnulib module: faccessat
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
14 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
15 Interix 3.5, BeOS.
16 However, the replacement does not always take into account ACLs.  Also,
17 it is not safe to be used in libraries and is not multithread-safe.
18 @end itemize
19
20 Portability problems not fixed by Gnulib:
21 @itemize
22 @item
23 There is an inherent race between calling this function and performing
24 some action based on the results; you should think twice before
25 trusting this function in a set-uid or set-gid program.
26 @end itemize