On 8/7/20 2:08 PM, Bruno Haible wrote:
I'm not sure whether the problem mentioned in lchown.texi and fchmodat.texi
for glibc 2.31 is still open, or fixed, or partially fixed in glibc 2.32.
I added some doc for that by installing the attached, which also adds doc for
the longstanding faccessat setuid problem (should be fixed in 2.33). Thanks for
doing this doc update.
>From ca801cfb6d334572d28fef34db8a8c73d479dee1 Mon Sep 17 00:00:00 2001
From: Paul Eggert <egg...@cs.ucla.edu>
Date: Fri, 7 Aug 2020 15:26:27 -0700
Subject: [PATCH] doc: more updates for glibc 2.32
* doc/glibc-functions/lchmod.texi, doc/posix-functions/faccessat.texi:
* doc/posix-functions/fchmodat.texi: Update.
---
ChangeLog | 6 ++++++
doc/glibc-functions/lchmod.texi | 11 ++++++++++-
doc/posix-functions/faccessat.texi | 6 ++++++
doc/posix-functions/fchmodat.texi | 9 ++++++++-
4 files changed, 30 insertions(+), 2 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 2d63ae286..73e205695 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2020-08-07 Paul Eggert <egg...@cs.ucla.edu>
+
+ doc: more updates for glibc 2.32
+ * doc/glibc-functions/lchmod.texi, doc/posix-functions/faccessat.texi:
+ * doc/posix-functions/fchmodat.texi: Update.
+
2020-08-07 Bruno Haible <br...@clisp.org>
doc: Update for glibc 2.32.
diff --git a/doc/glibc-functions/lchmod.texi b/doc/glibc-functions/lchmod.texi
index d0ea7b995..a85b38714 100644
--- a/doc/glibc-functions/lchmod.texi
+++ b/doc/glibc-functions/lchmod.texi
@@ -15,9 +15,18 @@ HP-UX 11.31.
@item
This function always fails with @code{errno} set to @code{ENOSYS},
even when the file is not a symbolic link:
-GNU/Linux with glibc 2.31 (or newer?).
+GNU/Linux with glibc 2.31.
@end itemize
Portability problems not fixed by Gnulib:
@itemize
+@item
+Some platforms do not allow changing the access bits on symbolic
+links.
+
+@item
+This function can fail with @code{errno} set to @code{EMFILE} or @code{ENFILE},
+and it fails with @code{errno} set to @code{EOPNOTSUPP} if the
+@file{/proc} file system is not mounted:
+GNU/Linux with glibc 2.32.
@end itemize
diff --git a/doc/posix-functions/faccessat.texi b/doc/posix-functions/faccessat.texi
index a3c21cff0..5d5165e47 100644
--- a/doc/posix-functions/faccessat.texi
+++ b/doc/posix-functions/faccessat.texi
@@ -28,6 +28,12 @@ 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}.
+@item
+On some platforms, @code{faccessat} can mishandle @code{AT_EACCESS}
+after a process starts as root and then becomes non-root:
+GNU/Linux with glibc 2.32.
+@c This bug should be fixed in glibc 2.33. See:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=18683
@end itemize
Other problems of this function:
diff --git a/doc/posix-functions/fchmodat.texi b/doc/posix-functions/fchmodat.texi
index d0cdeb08f..10821b63e 100644
--- a/doc/posix-functions/fchmodat.texi
+++ b/doc/posix-functions/fchmodat.texi
@@ -17,7 +17,7 @@ But the replacement function is not safe to be used in libraries and is not mult
When given the @code{AT_SYMLINK_NOFOLLOW} flag,
this function fails with @code{errno} set to @code{ENOTSUP},
even when the file is not a symbolic link:
-GNU/Linux with glibc 2.31 (or newer?), Cygwin 2.9.
+GNU/Linux with glibc 2.31, Cygwin 2.9.
@end itemize
Portability problems not fixed by Gnulib:
@@ -25,4 +25,11 @@ Portability problems not fixed by Gnulib:
@item
Some platforms do not allow changing the access bits on symbolic
links.
+
+@item
+If the @code{AT_SYMLINK_NOFOLLOW} flag is specified,
+this function can fail with @code{errno} set to @code{EMFILE} or @code{ENFILE},
+and it fails with @code{errno} set to @code{EOPNOTSUPP} if the
+@file{/proc} file system is not mounted:
+GNU/Linux with glibc 2.32.
@end itemize
--
2.17.1
