careadlinkat: Use 'restrict'.
[gnulib.git] / doc / posix-functions / faccessat.texi
bloba3c21cff0d2f9d3cb6bf03bdc60ad386635912bc
1 @node faccessat
2 @section @code{faccessat}
3 @findex faccessat
5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/faccessat.html}
7 Gnulib module: faccessat
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 glibc 2.3.6, macOS 10.12, FreeBSD 7.4, NetBSD 6.1.5, OpenBSD 4.9, Minix 3.1.8, AIX 5.1, HP-UX 11, IRIX 6.5, Solaris 10, Cygwin 1.5.x, mingw, MSVC 14, Android 4.0.4.
14 @item
15 On some platforms, @code{faccessat (dfd, "file/", amode, flag)}
16 succeeds instead of failing when @file{file} is not a directory.
17 macOS 10.13.
18 @end itemize
20 Portability problems not fixed by Gnulib:
21 @itemize
22 @item
23 The replacement does not always take ACLs into account.
24 @item
25 The replacement is not safe to be used in libraries.
26 @item
27 The replacement is not multithread-safe.
28 @item
29 The replacement does not support the @code{AT_SYMLINK_NOFOLLOW} flag,
30 which is supported by GNU @code{faccessat}.
31 @end itemize
33 Other problems of this function:
34 @itemize
35 @item
36 There is an inherent race between calling this function and performing
37 some action based on the results; you should think twice before trusting
38 this function, especially in a set-uid or set-gid program.
39 @end itemize