From f42d5af5ba76970309c5704db1c229143043bcc0 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Thu, 27 Jul 2017 18:02:18 -0700 Subject: [PATCH] faccessat: document AT_SYMLINK_NOFOLLOW issue * doc/posix-functions/faccessat.texi: Modernize platform list. Document AT_SYMLINK_NOFOLLOW limitation. --- ChangeLog | 4 ++++ doc/posix-functions/faccessat.texi | 13 ++++++++++--- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index ec39037df6..0cadec3d0d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2017-07-27 Paul Eggert + faccessat: document AT_SYMLINK_NOFOLLOW issue + * doc/posix-functions/faccessat.texi: Modernize platform list. + Document AT_SYMLINK_NOFOLLOW limitation. + renameat2: port to Solaris 10 * lib/renameat2.c (rename_noreplace): Use lstat, not faccessat with AT_SYMLINK_NOFOLLOW (which is not portable). diff --git a/doc/posix-functions/faccessat.texi b/doc/posix-functions/faccessat.texi index dea811b414..48ba17225f 100644 --- a/doc/posix-functions/faccessat.texi +++ b/doc/posix-functions/faccessat.texi @@ -10,15 +10,22 @@ 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, +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, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, MSVC 14, 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 +@item +The replacement does not always take ACLs into account. +@item +The replacement is not safe to be used in libraries. +@item +The replacement is not multithread-safe. +@item +The replacement does not support the @code{AT_SYMLINK_NOFOLLOW} flag, +which is supported by GNU @code{faccessat}. @end itemize Other problems of this function: -- 2.39.5