[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 2/2] faccessat: document AT_SYMLINK_NOFOLLOW issue
From: |
Paul Eggert |
Subject: |
[PATCH 2/2] faccessat: document AT_SYMLINK_NOFOLLOW issue |
Date: |
Thu, 27 Jul 2017 18:03:37 -0700 |
* 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 ec39037..0cadec3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
2017-07-27 Paul Eggert <address@hidden>
+ 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 dea811b..48ba172 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
address@hidden
+The replacement does not always take ACLs into account.
address@hidden
+The replacement is not safe to be used in libraries.
address@hidden
+The replacement is not multithread-safe.
address@hidden
+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.7.4