From a782d567d90dc8c8535562adc748443ce7d5f2fa Mon Sep 17 00:00:00 2001 From: Bruno Haible <bruno@clisp.org> Date: Fri, 7 Aug 2020 23:02:21 +0200 Subject: [PATCH] doc: Update for glibc 2.32. * doc/glibc-functions/__libc_single_threaded.texi: New file. * doc/glibc-functions/pthread_attr_getsigmask_np.texi: New file. * doc/glibc-functions/pthread_attr_setsigmask_np.texi: New file. * doc/glibc-functions/sigabbrev_np.texi: New file. * doc/glibc-functions/sigdescr_np.texi: New file. * doc/glibc-functions/strerrordesc_np.texi: New file. * doc/glibc-functions/strerrorname_np.texi: New file. * doc/gnulib.texi: Include them. (Glibc sys/single_threaded.h): New section. * doc/pastposix-functions/h_errno.texi: Update. * doc/posix-functions/*.texi: Likewise. * doc/glibc-functions/*.texi: Likewise. --- ChangeLog | 16 +++++++++++++ .../__libc_single_threaded.texi | 24 +++++++++++++++++++ doc/glibc-functions/getrandom.texi | 2 +- doc/glibc-functions/lchmod.texi | 2 +- .../pthread_attr_getsigmask_np.texi | 24 +++++++++++++++++++ .../pthread_attr_setsigmask_np.texi | 24 +++++++++++++++++++ doc/glibc-functions/sigabbrev_np.texi | 24 +++++++++++++++++++ doc/glibc-functions/sigdescr_np.texi | 24 +++++++++++++++++++ doc/glibc-functions/strerrordesc_np.texi | 24 +++++++++++++++++++ doc/glibc-functions/strerrorname_np.texi | 24 +++++++++++++++++++ doc/glibc-functions/sysctl.texi | 2 +- doc/gnulib.texi | 22 +++++++++++++++++ doc/pastposix-functions/h_errno.texi | 2 +- doc/posix-functions/crypt.texi | 2 +- doc/posix-functions/fchmodat.texi | 2 +- doc/posix-functions/setkey.texi | 2 +- 16 files changed, 213 insertions(+), 7 deletions(-) create mode 100644 doc/glibc-functions/__libc_single_threaded.texi create mode 100644 doc/glibc-functions/pthread_attr_getsigmask_np.texi create mode 100644 doc/glibc-functions/pthread_attr_setsigmask_np.texi create mode 100644 doc/glibc-functions/sigabbrev_np.texi create mode 100644 doc/glibc-functions/sigdescr_np.texi create mode 100644 doc/glibc-functions/strerrordesc_np.texi create mode 100644 doc/glibc-functions/strerrorname_np.texi diff --git a/ChangeLog b/ChangeLog index f568b2bdd1..2d63ae286f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,19 @@ +2020-08-07 Bruno Haible <bruno@clisp.org> + + doc: Update for glibc 2.32. + * doc/glibc-functions/__libc_single_threaded.texi: New file. + * doc/glibc-functions/pthread_attr_getsigmask_np.texi: New file. + * doc/glibc-functions/pthread_attr_setsigmask_np.texi: New file. + * doc/glibc-functions/sigabbrev_np.texi: New file. + * doc/glibc-functions/sigdescr_np.texi: New file. + * doc/glibc-functions/strerrordesc_np.texi: New file. + * doc/glibc-functions/strerrorname_np.texi: New file. + * doc/gnulib.texi: Include them. + (Glibc sys/single_threaded.h): New section. + * doc/pastposix-functions/h_errno.texi: Update. + * doc/posix-functions/*.texi: Likewise. + * doc/glibc-functions/*.texi: Likewise. + 2020-08-07 Bruno Haible <bruno@clisp.org> alloca: No need to compile alloca.c with clang. diff --git a/doc/glibc-functions/__libc_single_threaded.texi b/doc/glibc-functions/__libc_single_threaded.texi new file mode 100644 index 0000000000..45501e323f --- /dev/null +++ b/doc/glibc-functions/__libc_single_threaded.texi @@ -0,0 +1,24 @@ +@node __libc_single_threaded +@subsection @code{__libc_single_threaded} +@findex __libc_single_threaded + +Documentation:@* +@ifinfo +@ref{Single Threaded,,Detecting Single-Threaded Execution,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Single_002dThreaded.html}. +@end ifnotinfo + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This variable is missing on all non-glibc platforms: +glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +@end itemize diff --git a/doc/glibc-functions/getrandom.texi b/doc/glibc-functions/getrandom.texi index 2c95fe3561..f8ba845428 100644 --- a/doc/glibc-functions/getrandom.texi +++ b/doc/glibc-functions/getrandom.texi @@ -31,7 +31,7 @@ Portability problems not fixed by Gnulib: @itemize @item The @code{GRND_INSECURE} flag is missing on some platforms: -glibc 2.31, macOS 10.15, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.5, +glibc 2.32, macOS 10.15, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.5, Minix 3.3, Haiku. @item diff --git a/doc/glibc-functions/lchmod.texi b/doc/glibc-functions/lchmod.texi index 79569258e1..d0ea7b995f 100644 --- a/doc/glibc-functions/lchmod.texi +++ b/doc/glibc-functions/lchmod.texi @@ -15,7 +15,7 @@ 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. +GNU/Linux with glibc 2.31 (or newer?). @end itemize Portability problems not fixed by Gnulib: diff --git a/doc/glibc-functions/pthread_attr_getsigmask_np.texi b/doc/glibc-functions/pthread_attr_getsigmask_np.texi new file mode 100644 index 0000000000..75b73f9b42 --- /dev/null +++ b/doc/glibc-functions/pthread_attr_getsigmask_np.texi @@ -0,0 +1,24 @@ +@node pthread_attr_getsigmask_np +@subsection @code{pthread_attr_getsigmask_np} +@findex pthread_attr_getsigmask_np + +Documentation:@* +@ifinfo +@ref{Initial Thread Signal Mask,,Controlling the Initial Signal Mask of a New Thread,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Initial-Thread-Signal-Mask.html}. +@end ifnotinfo + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on all non-glibc platforms: +glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +@end itemize diff --git a/doc/glibc-functions/pthread_attr_setsigmask_np.texi b/doc/glibc-functions/pthread_attr_setsigmask_np.texi new file mode 100644 index 0000000000..d819c7ea72 --- /dev/null +++ b/doc/glibc-functions/pthread_attr_setsigmask_np.texi @@ -0,0 +1,24 @@ +@node pthread_attr_setsigmask_np +@subsection @code{pthread_attr_setsigmask_np} +@findex pthread_attr_setsigmask_np + +Documentation:@* +@ifinfo +@ref{Initial Thread Signal Mask,,Controlling the Initial Signal Mask of a New Thread,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Initial-Thread-Signal-Mask.html}. +@end ifnotinfo + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on all non-glibc platforms: +glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +@end itemize diff --git a/doc/glibc-functions/sigabbrev_np.texi b/doc/glibc-functions/sigabbrev_np.texi new file mode 100644 index 0000000000..2376dac436 --- /dev/null +++ b/doc/glibc-functions/sigabbrev_np.texi @@ -0,0 +1,24 @@ +@node sigabbrev_np +@subsection @code{sigabbrev_np} +@findex sigabbrev_np + +Documentation:@* +@ifinfo +@ref{Signal Messages,,Signal Messages,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Signal-Messages.html}. +@end ifnotinfo + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on all non-glibc platforms: +glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +@end itemize diff --git a/doc/glibc-functions/sigdescr_np.texi b/doc/glibc-functions/sigdescr_np.texi new file mode 100644 index 0000000000..44e63c1168 --- /dev/null +++ b/doc/glibc-functions/sigdescr_np.texi @@ -0,0 +1,24 @@ +@node sigdescr_np +@subsection @code{sigdescr_np} +@findex sigdescr_np + +Documentation:@* +@ifinfo +@ref{Signal Messages,,Signal Messages,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Signal-Messages.html}. +@end ifnotinfo + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on all non-glibc platforms: +glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +@end itemize diff --git a/doc/glibc-functions/strerrordesc_np.texi b/doc/glibc-functions/strerrordesc_np.texi new file mode 100644 index 0000000000..f7fd85971e --- /dev/null +++ b/doc/glibc-functions/strerrordesc_np.texi @@ -0,0 +1,24 @@ +@node strerrordesc_np +@subsection @code{strerrordesc_np} +@findex strerrordesc_np + +Documentation:@* +@ifinfo +@ref{Error Messages,,Error Messages,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Error-Messages.html}. +@end ifnotinfo + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on all non-glibc platforms: +glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +@end itemize diff --git a/doc/glibc-functions/strerrorname_np.texi b/doc/glibc-functions/strerrorname_np.texi new file mode 100644 index 0000000000..2b0820c367 --- /dev/null +++ b/doc/glibc-functions/strerrorname_np.texi @@ -0,0 +1,24 @@ +@node strerrorname_np +@subsection @code{strerrorname_np} +@findex strerrorname_np + +Documentation:@* +@ifinfo +@ref{Error Messages,,Error Messages,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Error-Messages.html}. +@end ifnotinfo + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on all non-glibc platforms: +glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +@end itemize diff --git a/doc/glibc-functions/sysctl.texi b/doc/glibc-functions/sysctl.texi index 8924f1e9ab..b7cdc206de 100644 --- a/doc/glibc-functions/sysctl.texi +++ b/doc/glibc-functions/sysctl.texi @@ -25,5 +25,5 @@ Portability problems not fixed by Gnulib: @itemize @item This function is missing on some platforms: -Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +glibc 2.32, Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0. @end itemize diff --git a/doc/gnulib.texi b/doc/gnulib.texi index 812e7d063f..c4bf8b1c89 100644 --- a/doc/gnulib.texi +++ b/doc/gnulib.texi @@ -3829,6 +3829,7 @@ This list of functions is sorted according to the header that declares them. * Glibc sys/sem.h:: * Glibc sys/sendfile.h:: * Glibc sys/signalfd.h:: +* Glibc sys/single_threaded.h:: * Glibc sys/socket.h:: * Glibc sys/stat.h:: * Glibc sys/statfs.h:: @@ -4743,6 +4744,8 @@ This list of functions is sorted according to the header that declares them. @menu * pthread_attr_getaffinity_np:: * pthread_attr_setaffinity_np:: +* pthread_attr_getsigmask_np:: +* pthread_attr_setsigmask_np:: * pthread_clockjoin_np:: * pthread_cond_clockwait:: * pthread_getaffinity_np:: @@ -4769,6 +4772,8 @@ This list of functions is sorted according to the header that declares them. @include glibc-functions/pthread_attr_getaffinity_np.texi @include glibc-functions/pthread_attr_setaffinity_np.texi +@include glibc-functions/pthread_attr_getsigmask_np.texi +@include glibc-functions/pthread_attr_setsigmask_np.texi @include glibc-functions/pthread_clockjoin_np.texi @include glibc-functions/pthread_cond_clockwait.texi @include glibc-functions/pthread_getaffinity_np.texi @@ -5781,8 +5786,12 @@ This list of functions is sorted according to the header that declares them. * mempcpy:: * memrchr:: * rawmemchr:: +* sigabbrev_np:: +* sigdescr_np:: * strcasestr:: * strchrnul:: +* strerrordesc_np:: +* strerrorname_np:: * strfry:: * strsep:: * strverscmp:: @@ -5796,8 +5805,12 @@ This list of functions is sorted according to the header that declares them. @include glibc-functions/mempcpy.texi @include glibc-functions/memrchr.texi @include glibc-functions/rawmemchr.texi +@include glibc-functions/sigabbrev_np.texi +@include glibc-functions/sigdescr_np.texi @include glibc-functions/strcasestr.texi @include glibc-functions/strchrnul.texi +@include glibc-functions/strerrordesc_np.texi +@include glibc-functions/strerrorname_np.texi @include glibc-functions/strfry.texi @include glibc-functions/strsep.texi @include glibc-functions/strverscmp.texi @@ -6100,6 +6113,15 @@ This list of functions is sorted according to the header that declares them. @include glibc-functions/signalfd.texi +@node Glibc sys/single_threaded.h +@section Glibc @code{<sys/single_threaded.h>} + +@menu +* __libc_single_threaded:: +@end menu + +@include glibc-functions/__libc_single_threaded.texi + @node Glibc sys/socket.h @section Glibc Extensions to @code{<sys/socket.h>} diff --git a/doc/pastposix-functions/h_errno.texi b/doc/pastposix-functions/h_errno.texi index e5820850ed..28bc0f6e15 100644 --- a/doc/pastposix-functions/h_errno.texi +++ b/doc/pastposix-functions/h_errno.texi @@ -14,5 +14,5 @@ Portability problems not fixed by Gnulib: @itemize @item This function is missing on some platforms: -glibc 2.31, IRIX 6.5, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +glibc 2.32, IRIX 6.5, Cygwin 2.9, mingw, MSVC 14, Android 9.0. @end itemize diff --git a/doc/posix-functions/crypt.texi b/doc/posix-functions/crypt.texi index fffe2f8c84..9581b23acc 100644 --- a/doc/posix-functions/crypt.texi +++ b/doc/posix-functions/crypt.texi @@ -14,7 +14,7 @@ Portability problems not fixed by Gnulib: @itemize @item This function is missing on some platforms: -glibc 2.31, FreeBSD 6.0, NetBSD 5.0, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +glibc 2.32, FreeBSD 6.0, NetBSD 5.0, Cygwin 2.9, mingw, MSVC 14, Android 9.0. @item This function is not declared in @code{<unistd.h>} (without @code{-D_GNU_SOURCE}) on some platforms: diff --git a/doc/posix-functions/fchmodat.texi b/doc/posix-functions/fchmodat.texi index a295f83853..d0cdeb08f8 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, Cygwin 2.9. +GNU/Linux with glibc 2.31 (or newer?), Cygwin 2.9. @end itemize Portability problems not fixed by Gnulib: diff --git a/doc/posix-functions/setkey.texi b/doc/posix-functions/setkey.texi index f8a4172d0b..0dfed7b9b1 100644 --- a/doc/posix-functions/setkey.texi +++ b/doc/posix-functions/setkey.texi @@ -14,7 +14,7 @@ Portability problems not fixed by Gnulib: @itemize @item This function is missing on some platforms: -glibc 2.31, NetBSD 5.0, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0. +glibc 2.32, NetBSD 5.0, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0. @item This function is not declared in @code{<stdlib.h>} (without @code{-D_GNU_SOURCE}) on some platforms: -- 2.39.5