>From ca801cfb6d334572d28fef34db8a8c73d479dee1 Mon Sep 17 00:00:00 2001 From: Paul Eggert 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 + + 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 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