diff --git a/Changes b/Changes index fde7c6742..5087f32f7 100644 --- a/Changes +++ b/Changes @@ -1,47 +1,7 @@ -==================== Changes in man-pages-5.13 ==================== +==================== Changes in man-pages-5.14 ==================== -Released: 2021-08-27, Christchurch +Released: ????-??-??, Munich -Ahelenia Ziemiańska (наб) -Alan Peakall -Alejandro Colomar -Alexis Wilke -Askar Safin -Christian Brauner -Christophe Leroy -Christopher Yeleighton -Cristian Morales Vega -Dan Robertson -Darrick J. Wong -Dominique Brazziel -EmanueleTorre -Eric W. Biederman -G. Branden Robinson -Helge Kreutzmann -Jakub Wilk -James O. D. Hunt -Jonny Grant -Kees Cook -Kir Kolyshkin -Kurt Kanzenbach -kXuan -Michael Kerrisk -Michael Weiß -NeilBrown -Nora Platiel -Pali Rohár -Peter Collingbourne -Richard Palethorpe -Rodrigo Campos -Sagar Patel -Serge E. Hallyn -Sergey Petrakov -Stefan Kanthak -Štěpán Němec -Thomas Gleixner -Thomas Voss -Viet Than -Will Manley Contributors ------------ @@ -57,301 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -mount_setattr.2 - Christian Brauner [Alejandro Colomar, Michael Kerrisk] - New manual page documenting the mount_setattr() system call - Newly documented interfaces in existing pages --------------------------------------------- -futex.2 - Kurt Kanzenbach [Alejandro Colomar, Thomas Gleixner, Michael Kerrisk] - Document FUTEX_LOCK_PI2 -ioctl_tty.2 - Pali Rohár [Alejandro Colomar, Michael kerrisk] - Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2 - -pidfd_open.2 - Michael Kerrisk - Document PIDFD_NONBLOCK - -seccomp_unotify.2 - Rodrigo Campos [Alejandro Colomar] - Document SECCOMP_ADDFD_FLAG_SEND - -sigaction.2 - Peter Collingbourne [Alejandro Colomar, Michael Kerrisk] - Document SA_EXPOSE_TAGBITS and the flag support detection protocol - -statx.2 - NeilBrown - Document STATX_MNT_ID -capabilities.7 -user_namespaces.7 - Michael Kerrisk, Kir Kolyshkin [Alejandro Colomar] - Describe CAP_SETFCAP for mapping UID 0 - -mount_namespaces.7 - Michael Kerrisk [Christian Brauner, Eric W. Biederman] - More clearly explain the notion of locked mounts - For a long time, this manual page has had a brief discussion of - "locked" mounts, without clearly saying what this concept is, or - why it exists. Expand the discussion with an explanation of what - locked mounts are, why mounts are locked, and some examples of the - effect of locking. -user_namespaces.7 - Michael Kerrisk - Document /proc/PID/projid_map - -ld.so.8 - Michael Kerrisk - Document --list-tunables option added in glibc 2.33 +New and changed links +--------------------- Global changes -------------- -A few pages - Michael Kerrisk - ERRORS: correct alphabetic order - -A few pages - Michael Kerrisk - Place SEE ALSO entries in correct order - -A few pages - Michael Kerrisk - Arrange .SH sections in correct order - -Various pages - Michael Kerrisk - Fix EBADF error description - Make the description of the EBADF error for invalid 'dirfd' more - uniform. In particular, note that the error only occurs when the - pathname is relative, and that it occurs when the 'dirfd' is - neither valid *nor* has the value AT_FDCWD. - -Various pages - Michael Kerrisk - ERRORS: combine errors into a single alphabetic list - These pages split out extra errors for some APIs into a separate - list. Probably, the pages are easier to ready if all errors are - combined into a single list. - - Note that there still remain a few pages where the errors are - listed separately for different APIs. For the moment, it seems - best to leave those pages as is, since the error lists are - largely distinct in those pages. - -VArious pages - Michael Kerrisk - Terminology clean-up: "mount point" ==> "mount" - Many times, these pages use the terminology "mount point", where - "mount" would be better. A "mount point" is the location at which - a mount is attached. A "mount" is an association between a - filesystem and a mount point. - -accept.2 -access.2 -getpriority.2 -mlock.2 - Michael Kerrisk - ERRORS: combine errors into a single list - These pages split out errors into separate lists (perhaps per API, - perhaps "may" vs "shall", perhaps "Linux-specific" vs - standard(??)), but there's no good reason to do this. It makes - the error list harder to read, and is inconsistent with other - pages. So, combine the errors into a single list. - -fanotify_mark.2 -futimesat.2 -mount_setattr.2 -statx.2 -symlink.2 -mkfifo.3 - Michael Kerrisk - Refer the reader to openat(2) for explanation of why 'dirfd' is useful - -Various pages - Thomas Voss [Alejandro Colomar] - Consistently use '*argv[]' - Changes to individual pages --------------------------- -iconv.1 -iconvconfig.8 - Michael Kerrisk [Christopher Yeleighton] - FILES: note that files may be under /usr/lib64 rather than /lib/64 - See https://bugzilla.kernel.org/show_bug.cgi?id=214163 - -ldd.1 - Alejandro Colomar [EmanueleTorre] - Fix example command - -add_key.2 -keyctl.2 -request_key.2 - Michael Kerrisk [Dominique Brazziel] - Note that the "libkeyutils" package provides - See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992377 - -close_range.2 - Michael Kerrisk, Alejandro Colomar - Glibc 2.34 has added a close_range() wrapper - -execve.2 - Michael Kerrisk [Nora Platiel] - The pathname given to interpreter is not necessarily absolute - Michael Kerrisk - SEE ALSO: getauxval(3) - getauxval(3) is useful background regarding execve(2). - -fanotify_mark.2 - Michael Kerrisk - ERRORS: add missing EBADF error for invalid 'dirfd' - -ioctl_tty.2 - Pali Rohár [Alejandro Colomar] - Update DTR example - Do not include unused (and incompatible) header file termios.h and - include required header files for puts() and close() functions. - -mount.2 - Michael Kerrisk - ERRORS: add EPERM error for case where a mount is locked - Refer the reader to mount_namespaces(7) for details. - Michael Kerrisk - SEE ALSO: add mount_setattr(2) - -open.2 - Michael Kerrisk - Explicitly describe the EBADF error that can occur with openat() - In particular, specifying an invalid file descriptor number - in 'dirfd' can be used as a check that 'pathname' is absolute. - Michael Kerrisk - Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH - Michael Kerrisk - Add mount_setattr(2) to list of 'dirfd' APIs - -open_by_handle_at.2 - Michael Kerrisk - ERRORS: add missing EBADF error for invalid 'dirfd' - -readv2.2 - Will Manley [Alejandro Colomar] - Note preadv2(..., RWF_NOWAIT) bug in BUGS section - -readv.2 -pipe.7 - Michael Kerrisk [наб] - Make text on pipe writes more general to avoid a confusion in writev(2) - -seccomp.2 - Eric W. Biederman [Kees Cook] - Clarify that bad system calls kill the thread (not the process) - -syscalls.2 - Michael Kerrisk - Add quotactl_fd(); remove quotactl_path() - quotactl_path() was never wired up in Linux 5.13. - It was replaced instead by quotactl_fd(), - Michael Kerrisk - Add system calls that are new in 5.13 - -umount.2 - Michael Kerrisk - ERRORS: add EINVAL for case where mount is locked - -wait.2 - Richard Palethorpe [Alejandro Colomar] - Add ESRCH for when pid == INT_MIN - Michael Kerrisk - ERRORS: document EAGAIN for waitid() on a PID file descriptor - -getaddrinfo.3 - Alejandro Colomar [Cristian Morales Vega] - Note that 'errno' is set in parallel with EAI_SYSTEM - -getauxval.3 - Michael Kerrisk - SEE ALSO: add execve(2) - -getopt.3 - James O. D. Hunt [Alejandro Colomar] - Further clarification of 'optstring' - -pthread_setname_np.3 - Michael Kerrisk [Alexis Wilke] - EXAMPLES: remove a bug by simplifying the code - -strlen.3 -wcslen.3 - Michael Kerrisk [Alejandro Colomar, Jonny Grant] - Recommend alternatives where input buffer might not be null-terminated - -strstr.3 - Alejandro Colomar [Stefan Kanthak] - Document special case for empty needle - -termios.3 - Pali Rohár [Alejandro Colomar] - SPARC architecture has 4 different Bnnn constants - Pali Rohár [Alejandro Colomar] - Add information how to set baud rate to any other value - Pali Rohár [Alejandro Colomar] - Use bold style for Bnn and EXTn macro constants - Pali Rohár [Alejandro Colomar] - Document missing baud-rate constants - -tsearch.3 - Michael Kerrisk - NAME: add twalk_r - -wcstok.3 - Jakub Wilk - Fix type mismatch in the example - -proc.5 - Michael Kerrisk - Add /proc/PID/projid_map, referring reader to user_namespaces(7) - Michael Kerrisk - Remove duplicated /proc/[pid]/gid_map entry - -mount_namespaces.7 - Michael Kerrisk - Terminology clean-up: "mount point" ==> "mount" - Many times, this page uses the terminology "mount point", where - "mount" would be better. A "mount point" is the location at which - a mount is attached. A "mount" is an association between a - filesystem and a mount point. - Michael Kerrisk - SEE ALSO: add mount_setattr(2) - -namespaces.7 - Štěpán Němec [Alejandro Colomar] - Fix confusion caused by text reorganization - -path_resolution.7 - Michael Kerrisk [Askar Safin] - Improve description of trailing slashes - See https://bugzilla.kernel.org/show_bug.cgi?id=212385 - -posixoptions.7 - Alejandro Colomar [Alan Peakall] - Fix legacy functions list (s/getcwd/getwd/) - -user_namespaces.7 - Kir Kolyshkin [Alejandro Colomar] - Fix a reference to a kernel document - Michael Kerrisk [Eric W. Biederman] - Add a definition of "global root" - -vdso.7 - Michael Kerrisk [Christophe Leroy] - Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc - Alejandro Colomar [Christophe Leroy] - Add y2038 compliant gettime for ppc/32 diff --git a/Changes.old b/Changes.old index a27233987..181ff31ab 100644 --- a/Changes.old +++ b/Changes.old @@ -54583,3 +54583,362 @@ signal.7 vsock.7 Alyssa Ross ioctls are on /dev/vsock, not sockets + + +==================== Changes in man-pages-5.13 ==================== + +Released: 2021-08-27, Christchurch + +Ahelenia Ziemiańska (наб) +Alan Peakall +Alejandro Colomar +Alexis Wilke +Askar Safin +Christian Brauner +Christophe Leroy +Christopher Yeleighton +Cristian Morales Vega +Dan Robertson +Darrick J. Wong +Dominique Brazziel +EmanueleTorre +Eric W. Biederman +G. Branden Robinson +Helge Kreutzmann +Jakub Wilk +James O. D. Hunt +Jonny Grant +Kees Cook +Kir Kolyshkin +Kurt Kanzenbach +kXuan +Michael Kerrisk +Michael Weiß +NeilBrown +Nora Platiel +Pali Rohár +Peter Collingbourne +Richard Palethorpe +Rodrigo Campos +Sagar Patel +Serge E. Hallyn +Sergey Petrakov +Stefan Kanthak +Štěpán Němec +Thomas Gleixner +Thomas Voss +Viet Than +Will Manley + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes, and ideas that have been +incorporated in changes in this release: + + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +mount_setattr.2 + Christian Brauner [Alejandro Colomar, Michael Kerrisk] + New manual page documenting the mount_setattr() system call + + +Newly documented interfaces in existing pages +--------------------------------------------- + +futex.2 + Kurt Kanzenbach [Alejandro Colomar, Thomas Gleixner, Michael Kerrisk] + Document FUTEX_LOCK_PI2 + +ioctl_tty.2 + Pali Rohár [Alejandro Colomar, Michael kerrisk] + Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2 + +pidfd_open.2 + Michael Kerrisk + Document PIDFD_NONBLOCK + +seccomp_unotify.2 + Rodrigo Campos [Alejandro Colomar] + Document SECCOMP_ADDFD_FLAG_SEND + +sigaction.2 + Peter Collingbourne [Alejandro Colomar, Michael Kerrisk] + Document SA_EXPOSE_TAGBITS and the flag support detection protocol + +statx.2 + NeilBrown + Document STATX_MNT_ID +capabilities.7 +user_namespaces.7 + Michael Kerrisk, Kir Kolyshkin [Alejandro Colomar] + Describe CAP_SETFCAP for mapping UID 0 + +mount_namespaces.7 + Michael Kerrisk [Christian Brauner, Eric W. Biederman] + More clearly explain the notion of locked mounts + For a long time, this manual page has had a brief discussion of + "locked" mounts, without clearly saying what this concept is, or + why it exists. Expand the discussion with an explanation of what + locked mounts are, why mounts are locked, and some examples of the + effect of locking. +user_namespaces.7 + Michael Kerrisk + Document /proc/PID/projid_map + +ld.so.8 + Michael Kerrisk + Document --list-tunables option added in glibc 2.33 + + +Global changes +-------------- + +A few pages + Michael Kerrisk + ERRORS: correct alphabetic order + +A few pages + Michael Kerrisk + Place SEE ALSO entries in correct order + +A few pages + Michael Kerrisk + Arrange .SH sections in correct order + +Various pages + Michael Kerrisk + Fix EBADF error description + Make the description of the EBADF error for invalid 'dirfd' more + uniform. In particular, note that the error only occurs when the + pathname is relative, and that it occurs when the 'dirfd' is + neither valid *nor* has the value AT_FDCWD. + +Various pages + Michael Kerrisk + ERRORS: combine errors into a single alphabetic list + These pages split out extra errors for some APIs into a separate + list. Probably, the pages are easier to ready if all errors are + combined into a single list. + + Note that there still remain a few pages where the errors are + listed separately for different APIs. For the moment, it seems + best to leave those pages as is, since the error lists are + largely distinct in those pages. + +VArious pages + Michael Kerrisk + Terminology clean-up: "mount point" ==> "mount" + Many times, these pages use the terminology "mount point", where + "mount" would be better. A "mount point" is the location at which + a mount is attached. A "mount" is an association between a + filesystem and a mount point. + +accept.2 +access.2 +getpriority.2 +mlock.2 + Michael Kerrisk + ERRORS: combine errors into a single list + These pages split out errors into separate lists (perhaps per API, + perhaps "may" vs "shall", perhaps "Linux-specific" vs + standard(??)), but there's no good reason to do this. It makes + the error list harder to read, and is inconsistent with other + pages. So, combine the errors into a single list. + +fanotify_mark.2 +futimesat.2 +mount_setattr.2 +statx.2 +symlink.2 +mkfifo.3 + Michael Kerrisk + Refer the reader to openat(2) for explanation of why 'dirfd' is useful + +Various pages + Thomas Voss [Alejandro Colomar] + Consistently use '*argv[]' + + +Changes to individual pages +--------------------------- + +iconv.1 +iconvconfig.8 + Michael Kerrisk [Christopher Yeleighton] + FILES: note that files may be under /usr/lib64 rather than /lib/64 + See https://bugzilla.kernel.org/show_bug.cgi?id=214163 + +ldd.1 + Alejandro Colomar [EmanueleTorre] + Fix example command + +add_key.2 +keyctl.2 +request_key.2 + Michael Kerrisk [Dominique Brazziel] + Note that the "libkeyutils" package provides + See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992377 + +close_range.2 + Michael Kerrisk, Alejandro Colomar + Glibc 2.34 has added a close_range() wrapper + +execve.2 + Michael Kerrisk [Nora Platiel] + The pathname given to interpreter is not necessarily absolute + Michael Kerrisk + SEE ALSO: getauxval(3) + getauxval(3) is useful background regarding execve(2). + +fanotify_mark.2 + Michael Kerrisk + ERRORS: add missing EBADF error for invalid 'dirfd' + +ioctl_tty.2 + Pali Rohár [Alejandro Colomar] + Update DTR example + Do not include unused (and incompatible) header file termios.h and + include required header files for puts() and close() functions. + +mount.2 + Michael Kerrisk + ERRORS: add EPERM error for case where a mount is locked + Refer the reader to mount_namespaces(7) for details. + Michael Kerrisk + SEE ALSO: add mount_setattr(2) + +open.2 + Michael Kerrisk + Explicitly describe the EBADF error that can occur with openat() + In particular, specifying an invalid file descriptor number + in 'dirfd' can be used as a check that 'pathname' is absolute. + Michael Kerrisk + Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH + Michael Kerrisk + Add mount_setattr(2) to list of 'dirfd' APIs + +open_by_handle_at.2 + Michael Kerrisk + ERRORS: add missing EBADF error for invalid 'dirfd' + +readv2.2 + Will Manley [Alejandro Colomar] + Note preadv2(..., RWF_NOWAIT) bug in BUGS section + +readv.2 +pipe.7 + Michael Kerrisk [наб] + Make text on pipe writes more general to avoid a confusion in writev(2) + +seccomp.2 + Eric W. Biederman [Kees Cook] + Clarify that bad system calls kill the thread (not the process) + +syscalls.2 + Michael Kerrisk + Add quotactl_fd(); remove quotactl_path() + quotactl_path() was never wired up in Linux 5.13. + It was replaced instead by quotactl_fd(), + Michael Kerrisk + Add system calls that are new in 5.13 + +umount.2 + Michael Kerrisk + ERRORS: add EINVAL for case where mount is locked + +wait.2 + Richard Palethorpe [Alejandro Colomar] + Add ESRCH for when pid == INT_MIN + Michael Kerrisk + ERRORS: document EAGAIN for waitid() on a PID file descriptor + +getaddrinfo.3 + Alejandro Colomar [Cristian Morales Vega] + Note that 'errno' is set in parallel with EAI_SYSTEM + +getauxval.3 + Michael Kerrisk + SEE ALSO: add execve(2) + +getopt.3 + James O. D. Hunt [Alejandro Colomar] + Further clarification of 'optstring' + +pthread_setname_np.3 + Michael Kerrisk [Alexis Wilke] + EXAMPLES: remove a bug by simplifying the code + +strlen.3 +wcslen.3 + Michael Kerrisk [Alejandro Colomar, Jonny Grant] + Recommend alternatives where input buffer might not be null-terminated + +strstr.3 + Alejandro Colomar [Stefan Kanthak] + Document special case for empty needle + +termios.3 + Pali Rohár [Alejandro Colomar] + SPARC architecture has 4 different Bnnn constants + Pali Rohár [Alejandro Colomar] + Add information how to set baud rate to any other value + Pali Rohár [Alejandro Colomar] + Use bold style for Bnn and EXTn macro constants + Pali Rohár [Alejandro Colomar] + Document missing baud-rate constants + +tsearch.3 + Michael Kerrisk + NAME: add twalk_r + +wcstok.3 + Jakub Wilk + Fix type mismatch in the example + +proc.5 + Michael Kerrisk + Add /proc/PID/projid_map, referring reader to user_namespaces(7) + Michael Kerrisk + Remove duplicated /proc/[pid]/gid_map entry + +mount_namespaces.7 + Michael Kerrisk + Terminology clean-up: "mount point" ==> "mount" + Many times, this page uses the terminology "mount point", where + "mount" would be better. A "mount point" is the location at which + a mount is attached. A "mount" is an association between a + filesystem and a mount point. + Michael Kerrisk + SEE ALSO: add mount_setattr(2) + +namespaces.7 + Štěpán Němec [Alejandro Colomar] + Fix confusion caused by text reorganization + +path_resolution.7 + Michael Kerrisk [Askar Safin] + Improve description of trailing slashes + See https://bugzilla.kernel.org/show_bug.cgi?id=212385 + +posixoptions.7 + Alejandro Colomar [Alan Peakall] + Fix legacy functions list (s/getcwd/getwd/) + +user_namespaces.7 + Kir Kolyshkin [Alejandro Colomar] + Fix a reference to a kernel document + Michael Kerrisk [Eric W. Biederman] + Add a definition of "global root" + +vdso.7 + Michael Kerrisk [Christophe Leroy] + Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc + Alejandro Colomar [Christophe Leroy] + Add y2038 compliant gettime for ppc/32