doc/posix-functions/faccessat.texi

   1 @node faccessat
   2 @section @code{faccessat}
   3 @findex faccessat
   4
   5 POSIX specification:@* @url{https://pubs.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 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
  19
  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 @item
  32 On some platforms, @code{faccessat} can mishandle @code{AT_EACCESS}
  33 after a process starts as root and then becomes non-root:
  34 GNU/Linux with glibc 2.32.
  35 @c This bug should be fixed in glibc 2.33.  See:
  36 @c https://sourceware.org/bugzilla/show_bug.cgi?id=18683
  37 @end itemize
  38
  39 Other problems of this function:
  40 @itemize
  41 @item
  42 There is an inherent race between calling this function and performing
  43 some action based on the results; you should think twice before trusting
  44 this function, especially in a set-uid or set-gid program.
  45 @end itemize