diff --git a/Changes b/Changes index f3324ea09..cc14d7864 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.03 ==================== +==================== Changes in man-pages-5.04 ==================== -Released: 2019-10-11, Munich +Released: ????-??-??, Munich Contributors @@ -10,51 +10,6 @@ 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: -Adam Borowski -Aleksa Sarai -Alexey Budankov -Amir Goldstein -Andrew Clayton -Carlos O'Donell -Christian Brauner -Christopher M. Riedl -Daniel Colascione -Dave Carroll -Dave Chinner -Дилян Палаузов -Dmitry V. Levin -Don Brace -eponymous alias -Eric Biggers -Eric W. Biederman -Florian Weimer -Florin Blanaru -Gilbert Wu -Ingo Schwarze -Jakub Wilk -Kevin Barnett -Marko Myllynen -Matti Moell -Matti Möll -Matt Perricone -Michael Kerrisk -Mike Frysinger -Murthy Bhat -Nikola Forró -nilsocket -Paul Wise -Philipp Wendler -Raphael Moreira Zinsly -Rasmus Villemoes -Reid Priedhorsky -Rick Stanley -Rob Landley -Scott Benesh -Scott Teel -Shawn Anastasio -Simone Piccardi -Vincent Lefevre -Yang Xu Apologies if I missed anyone! @@ -62,317 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -pidfd_open.2 - Michael Kerrisk [Christian Brauner, Florian Weimer, Daniel Colascione] - New page documenting pidfd_open(2) - -pidfd_send_signal.2 - Michael Kerrisk [Florian Weimer, Christian Brauner] - New page documenting pidfd_send_signal(2) - -pivot_root.2 - Michael Kerrisk [Eric W. Biederman, Reid Priedhorsky, Philipp Wendler] - This page has been completely rewritten, adding a lot of missing - details (including the use of (pivot_root(".", ".")) and an example - program. In addition, the text prevaricating on whether or not - pivot_root() might change the root and current working directories has - been eliminated, and replaced with a simple description of the behavior - of the system call, which has not changed for 19 years, and will not - change in the future. Many longstanding errors in the old version of - the page have also been corrected. - -ipc_namespaces.7 - Michael Kerrisk - New page with content migrated from namespaces(7) - -uts_namespaces.7 - Michael Kerrisk - New page with content migrated from namespaces(7) - Newly documented interfaces in existing pages --------------------------------------------- -clone.2 - Christian Brauner, Michael Kerrisk - Document CLONE_PIDFD - Add an entry for CLONE_PIDFD. This flag is available starting - with kernel 5.2. If specified, a process file descriptor - ("pidfd") referring to the child process will be returned in - the ptid argument. - -fanotify_mark.2 - Jakub Wilk - Document FAN_MOVE_SELF - -ptrace.2 - Dmitry V. Levin [Michael Kerrisk] - Document PTRACE_GET_SYSCALL_INFO - -regex.3 - Rob Landley - Document REG_STARTEND - New and changed links --------------------- -res_nclose.3 - Michael Kerrisk - Add NEW link to resolver.3 - Global changes -------------- -Varios pages - Michael Kerrisk - SEE ALSO: correct list order - -Various pages - Michael Kerrisk - Remove section number from references to function in its own page - -Various pages - Michael Kerrisk - ERRORS: correct alphabetical order - Changes to individual pages --------------------------- -localedef.1 - Marko Myllynen - Describe recently added options - Describe few recently added options (present in glibc-2.29). - -clone.2 - Michael Kerrisk - SEE ALSO: add pidfd_open(2) - -copy_file_range.2 - Amir Goldstein [Dave Chinner] - Kernel v5.3 updates - -fanotify_mark.2 - Jakub Wilk - Add kernel version numbers for some FAN_* constants - -getdomainname.2 - Michael Kerrisk - Add mention of UTS namespaces - -gethostname.2 - Michael Kerrisk [Jakub Wilk] - Mention UTS namespaces - -io_submit.2 - Matti Moell [Matti Möll] - Fix kernel version numbers for 'aio_rw_flags' flags - -kill.2 - Michael Kerrisk - SEE ALSO: add pidfd_send_signal(2) - -mmap.2 - Nikola Forró - Fix EINVAL conditions - Since introduction of MAP_SHARED_VALIDATE, in case flags contain - both MAP_PRIVATE and MAP_SHARED, mmap() doesn't fail with EINVAL, - it succeeds. - - The reason for that is that MAP_SHARED_VALIDATE is in fact equal - to MAP_PRIVATE | MAP_SHARED. - -mount.2 - Michael Kerrisk [Reid Priedhorsky] - Describe the concept of "parent mounts" - Michael Kerrisk - NOTES: add subsection heading for /proc/[pid]/{mounts,mountinfo} - Michael Kerrisk - Rework the text on mount namespaces a little - Eliminate the term "Per-process namespaces" and add a reference - to mount_namespaces(7). - -move_pages.2 - Yang Xu [Michael Kerrisk] - Mark E2BIG as deprecated - E2BIG was removed in 2.6.29, we should mark it as deprecated. - -perf_event_open.2 - Michael Kerrisk [Alexey Budankov] - SEE ALSO: add Documentation/admin-guide/perf-security.rst - -prctl.2 - Michael Kerrisk - Clarify that PR_GET_SPECULATION_CTRL returns value as function result - Michael Kerrisk - Clarify that PR_MCE_KILL_GET returns value via function result - Michael Kerrisk - Clarify that PR_GET_FP_MODE returns value as function result - Michael Kerrisk - RETURN VALUE: add some missing entries - Note success return for PR_GET_SPECULATION_CTRL and PR_GET_FP_MODE. - -rt_sigqueueinfo.2 - Michael Kerrisk - Note that 'si_code' can't be specified as SI_KERNEL - Michael Kerrisk - The rules for 'si_code' don't apply when sending a signal to oneself - The restriction on what values may be specified in 'si_code' - apply only when sending a signal to a process other than the - caller itself. - Michael Kerrisk - Rename 'uinfo' argument to 'info' - This is more consistent with the naming in other pages - that refer to a 'siginfo_t' structure. - Michael Kerrisk - SEE ALSO: add pidfd_send_signal(2) - -sched_setaffinity.2 - Michael Kerrisk - RETURN VALUE: sched_getaffinity() syscall differs from the wrapper - -setns.2 - Mike Frysinger - Fix CLONE_NEWNS restriction info - -sigaction.2 - Michael Kerrisk - SEE ALSO: add pidfd_send_signal(2) - -signalfd.2 - Andrew Clayton, Michael Kerrisk - Note about interactions with epoll & fork - -statx.2 - Michael Kerrisk [Simone Piccardi] - Clarify details of a case where an invalid 'mask' value may be rejected - -syscall.2 - Shawn Anastasio - Add information for powerpc64 - Michael Kerrisk [Adam Borowski, Florin Blanaru] - Update name of syscall instruction for riscv - -syscalls.2 - Michael Kerrisk - Add fsconfig(), fsmount(), fsopen(), fspick(), move_mount(), open_tree() - Michael Kerrisk [(), Michael(), Kerrisk(),] - Add new syscalls in 5.1 - Add io_uring_enter(), io_uring_register(), io_uring_setup(), and - pidfd_send_signal(). - Michael Kerrisk - Add clone3() and pidfd_open() - -uname.2 - Michael Kerrisk - Replace reference to namespaces(7) with reference to uts_namespaces(7) - -errno.3 - Rasmus Villemoes - Add some comments on EAGAIN/EWOULDBLOCK and EDEADLK/EDEADLOCK - -fexecve.3 - Michael Kerrisk [Simone Piccardi] - ENOSYS occurs only if the kernel provides no execveat() syscall - Michael Kerrisk [Simone Piccardi] - ERRORS: add ENOENT - -getauxval.3 - Raphael Moreira Zinsly - Add new cache geometry entries - -printf.3 - Vincent Lefevre - Add detail on the first digit with the %e format - -pthread_setcancelstate.3 -pthreads.7 -signal-safety.7 - Carlos O'Donell - Describe issues with cancellation points in signal handlers - -strtok.3 - Michael Kerrisk [eponymous alias] - Correct description of use of 'saveptr' argument in strtok_r() - Michael Kerrisk [eponymous alias] - The caller should not modify 'saveptr' between strtok_r() calls - Michael Kerrisk - Add portability note for strtok_r() '*saveptr' value - On some implementations, '*saveptr' must be NULL on first call - to strtok_r(). - -smartpqi.4 - Murthy Bhat [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] - Add sysfs entries - Gilbert Wu [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] - Add module param expose ld first - Dave Carroll [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] - Add module param to hide vsep - -core.5 - Paul Wise - Explain the new situation with argument splitting - Things changed in Linux v5.3-rc3 commit 315c69261dd3 from - splitting after template expansion to splitting beforehand. - -resolv.conf.5 - Nikola Forró - Update information about search list - Since glibc 2.26, the number of domains in the search list is - no longer limited. - -man-pages.7 - Michael Kerrisk - Relocate and enhance the text on semantic newlines - Michael Kerrisk [Paul Wise] - Paragraphs should not be separated by blank lines - -mount_namespaces.7 - Michael Kerrisk - Explain how a namespace's mount point list is initialized - Provide a more detailed explanation of the initialization of - the mount point list in a new mount namespace. - Michael Kerrisk [Eric W. Biederman] - Clarify description of "less privileged" mount namespaces - Michael Kerrisk - SEE ALSO: refer to example in pivot_root(2) - Michael Kerrisk [Eric W. Biederman] - It may be desirable to disable propagation after creating a namespace - After creating a new mount namespace, it may be desirable to - disable mount propagation. Give the reader a more explicit - hint about this. - -mq_overview.7 -sysvipc.7 - Michael Kerrisk - Adjust references to namespaces(7) to ipc_namespaces(7) - -namespaces.7 - Michael Kerrisk - Remove content migrated to new ipc_namespaces(7) page - Michael Kerrisk - Remove content migrated to uts_namespaces(7) - Michael Kerrisk - Include manual page references in the summary table of namespace types - Make the page more compact by removing the stub subsections that - list the manual pages for the namespace types. And while we're - here, add an explanation of the table columns. - -operator.7 - Michael Kerrisk [Rick Stanley] - Prefix and postfix ++/-- have different precedences - Harbison and Steele also agree on this. - -signal.7 - Michael Kerrisk - Enhance the text on process-directed and thread-directed signals - clone(2) has a good description of these concepts; borrow - from it liberally. - Michael Kerrisk - SEE ALSO: add pidfd_send_signal(2) - -user_namespaces.7 - Michael Kerrisk - Improve explanation of meaning of ownership of nonuser namespaces diff --git a/Changes.old b/Changes.old index a8bc6ae08..ab016234f 100644 --- a/Changes.old +++ b/Changes.old @@ -49731,3 +49731,383 @@ ld.so.8 variables, not used by the dynamic linker itself, that are also treated in this way (see the glibc source file sysdeps/generic/unsecvars.h). + + +==================== Changes in man-pages-5.03 ==================== + +Released: 2019-10-11, Munich + + +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: + +Adam Borowski +Aleksa Sarai +Alexey Budankov +Amir Goldstein +Andrew Clayton +Carlos O'Donell +Christian Brauner +Christopher M. Riedl +Daniel Colascione +Dave Carroll +Dave Chinner +Дилян Палаузов +Dmitry V. Levin +Don Brace +eponymous alias +Eric Biggers +Eric W. Biederman +Florian Weimer +Florin Blanaru +Gilbert Wu +Ingo Schwarze +Jakub Wilk +Kevin Barnett +Marko Myllynen +Matti Moell +Matti Möll +Matt Perricone +Michael Kerrisk +Mike Frysinger +Murthy Bhat +Nikola Forró +nilsocket +Paul Wise +Philipp Wendler +Raphael Moreira Zinsly +Rasmus Villemoes +Reid Priedhorsky +Rick Stanley +Rob Landley +Scott Benesh +Scott Teel +Shawn Anastasio +Simone Piccardi +Vincent Lefevre +Yang Xu + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +pidfd_open.2 + Michael Kerrisk [Christian Brauner, Florian Weimer, Daniel Colascione] + New page documenting pidfd_open(2) + +pidfd_send_signal.2 + Michael Kerrisk [Florian Weimer, Christian Brauner] + New page documenting pidfd_send_signal(2) + +pivot_root.2 + Michael Kerrisk [Eric W. Biederman, Reid Priedhorsky, Philipp Wendler] + This page has been completely rewritten, adding a lot of missing + details (including the use of (pivot_root(".", ".")) and an example + program. In addition, the text prevaricating on whether or not + pivot_root() might change the root and current working directories has + been eliminated, and replaced with a simple description of the behavior + of the system call, which has not changed for 19 years, and will not + change in the future. Many longstanding errors in the old version of + the page have also been corrected. + +ipc_namespaces.7 + Michael Kerrisk + New page with content migrated from namespaces(7) + +uts_namespaces.7 + Michael Kerrisk + New page with content migrated from namespaces(7) + + +Newly documented interfaces in existing pages +--------------------------------------------- + +clone.2 + Christian Brauner, Michael Kerrisk + Document CLONE_PIDFD + Add an entry for CLONE_PIDFD. This flag is available starting + with kernel 5.2. If specified, a process file descriptor + ("pidfd") referring to the child process will be returned in + the ptid argument. + +fanotify_mark.2 + Jakub Wilk + Document FAN_MOVE_SELF + +ptrace.2 + Dmitry V. Levin [Michael Kerrisk] + Document PTRACE_GET_SYSCALL_INFO + +regex.3 + Rob Landley + Document REG_STARTEND + + +New and changed links +--------------------- + +res_nclose.3 + Michael Kerrisk + Add NEW link to resolver.3 + + +Global changes +-------------- + +Varios pages + Michael Kerrisk + SEE ALSO: correct list order + +Various pages + Michael Kerrisk + Remove section number from references to function in its own page + +Various pages + Michael Kerrisk + ERRORS: correct alphabetical order + + +Changes to individual pages +--------------------------- + +localedef.1 + Marko Myllynen + Describe recently added options + Describe few recently added options (present in glibc-2.29). + +clone.2 + Michael Kerrisk + SEE ALSO: add pidfd_open(2) + +copy_file_range.2 + Amir Goldstein [Dave Chinner] + Kernel v5.3 updates + +fanotify_mark.2 + Jakub Wilk + Add kernel version numbers for some FAN_* constants + +getdomainname.2 + Michael Kerrisk + Add mention of UTS namespaces + +gethostname.2 + Michael Kerrisk [Jakub Wilk] + Mention UTS namespaces + +io_submit.2 + Matti Moell [Matti Möll] + Fix kernel version numbers for 'aio_rw_flags' flags + +kill.2 + Michael Kerrisk + SEE ALSO: add pidfd_send_signal(2) + +mmap.2 + Nikola Forró + Fix EINVAL conditions + Since introduction of MAP_SHARED_VALIDATE, in case flags contain + both MAP_PRIVATE and MAP_SHARED, mmap() doesn't fail with EINVAL, + it succeeds. + + The reason for that is that MAP_SHARED_VALIDATE is in fact equal + to MAP_PRIVATE | MAP_SHARED. + +mount.2 + Michael Kerrisk [Reid Priedhorsky] + Describe the concept of "parent mounts" + Michael Kerrisk + NOTES: add subsection heading for /proc/[pid]/{mounts,mountinfo} + Michael Kerrisk + Rework the text on mount namespaces a little + Eliminate the term "Per-process namespaces" and add a reference + to mount_namespaces(7). + +move_pages.2 + Yang Xu [Michael Kerrisk] + Mark E2BIG as deprecated + E2BIG was removed in 2.6.29, we should mark it as deprecated. + +perf_event_open.2 + Michael Kerrisk [Alexey Budankov] + SEE ALSO: add Documentation/admin-guide/perf-security.rst + +prctl.2 + Michael Kerrisk + Clarify that PR_GET_SPECULATION_CTRL returns value as function result + Michael Kerrisk + Clarify that PR_MCE_KILL_GET returns value via function result + Michael Kerrisk + Clarify that PR_GET_FP_MODE returns value as function result + Michael Kerrisk + RETURN VALUE: add some missing entries + Note success return for PR_GET_SPECULATION_CTRL and PR_GET_FP_MODE. + +rt_sigqueueinfo.2 + Michael Kerrisk + Note that 'si_code' can't be specified as SI_KERNEL + Michael Kerrisk + The rules for 'si_code' don't apply when sending a signal to oneself + The restriction on what values may be specified in 'si_code' + apply only when sending a signal to a process other than the + caller itself. + Michael Kerrisk + Rename 'uinfo' argument to 'info' + This is more consistent with the naming in other pages + that refer to a 'siginfo_t' structure. + Michael Kerrisk + SEE ALSO: add pidfd_send_signal(2) + +sched_setaffinity.2 + Michael Kerrisk + RETURN VALUE: sched_getaffinity() syscall differs from the wrapper + +setns.2 + Mike Frysinger + Fix CLONE_NEWNS restriction info + +sigaction.2 + Michael Kerrisk + SEE ALSO: add pidfd_send_signal(2) + +signalfd.2 + Andrew Clayton, Michael Kerrisk + Note about interactions with epoll & fork + +statx.2 + Michael Kerrisk [Simone Piccardi] + Clarify details of a case where an invalid 'mask' value may be rejected + +syscall.2 + Shawn Anastasio + Add information for powerpc64 + Michael Kerrisk [Adam Borowski, Florin Blanaru] + Update name of syscall instruction for riscv + +syscalls.2 + Michael Kerrisk + Add fsconfig(), fsmount(), fsopen(), fspick(), move_mount(), open_tree() + Michael Kerrisk [(), Michael(), Kerrisk(),] + Add new syscalls in 5.1 + Add io_uring_enter(), io_uring_register(), io_uring_setup(), and + pidfd_send_signal(). + Michael Kerrisk + Add clone3() and pidfd_open() + +uname.2 + Michael Kerrisk + Replace reference to namespaces(7) with reference to uts_namespaces(7) + +errno.3 + Rasmus Villemoes + Add some comments on EAGAIN/EWOULDBLOCK and EDEADLK/EDEADLOCK + +fexecve.3 + Michael Kerrisk [Simone Piccardi] + ENOSYS occurs only if the kernel provides no execveat() syscall + Michael Kerrisk [Simone Piccardi] + ERRORS: add ENOENT + +getauxval.3 + Raphael Moreira Zinsly + Add new cache geometry entries + +printf.3 + Vincent Lefevre + Add detail on the first digit with the %e format + +pthread_setcancelstate.3 +pthreads.7 +signal-safety.7 + Carlos O'Donell + Describe issues with cancellation points in signal handlers + +strtok.3 + Michael Kerrisk [eponymous alias] + Correct description of use of 'saveptr' argument in strtok_r() + Michael Kerrisk [eponymous alias] + The caller should not modify 'saveptr' between strtok_r() calls + Michael Kerrisk + Add portability note for strtok_r() '*saveptr' value + On some implementations, '*saveptr' must be NULL on first call + to strtok_r(). + +smartpqi.4 + Murthy Bhat [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] + Add sysfs entries + Gilbert Wu [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] + Add module param expose ld first + Dave Carroll [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] + Add module param to hide vsep + +core.5 + Paul Wise + Explain the new situation with argument splitting + Things changed in Linux v5.3-rc3 commit 315c69261dd3 from + splitting after template expansion to splitting beforehand. + +resolv.conf.5 + Nikola Forró + Update information about search list + Since glibc 2.26, the number of domains in the search list is + no longer limited. + +man-pages.7 + Michael Kerrisk + Relocate and enhance the text on semantic newlines + Michael Kerrisk [Paul Wise] + Paragraphs should not be separated by blank lines + +mount_namespaces.7 + Michael Kerrisk + Explain how a namespace's mount point list is initialized + Provide a more detailed explanation of the initialization of + the mount point list in a new mount namespace. + Michael Kerrisk [Eric W. Biederman] + Clarify description of "less privileged" mount namespaces + Michael Kerrisk + SEE ALSO: refer to example in pivot_root(2) + Michael Kerrisk [Eric W. Biederman] + It may be desirable to disable propagation after creating a namespace + After creating a new mount namespace, it may be desirable to + disable mount propagation. Give the reader a more explicit + hint about this. + +mq_overview.7 +sysvipc.7 + Michael Kerrisk + Adjust references to namespaces(7) to ipc_namespaces(7) + +namespaces.7 + Michael Kerrisk + Remove content migrated to new ipc_namespaces(7) page + Michael Kerrisk + Remove content migrated to uts_namespaces(7) + Michael Kerrisk + Include manual page references in the summary table of namespace types + Make the page more compact by removing the stub subsections that + list the manual pages for the namespace types. And while we're + here, add an explanation of the table columns. + +operator.7 + Michael Kerrisk [Rick Stanley] + Prefix and postfix ++/-- have different precedences + Harbison and Steele also agree on this. + +signal.7 + Michael Kerrisk + Enhance the text on process-directed and thread-directed signals + clone(2) has a good description of these concepts; borrow + from it liberally. + Michael Kerrisk + SEE ALSO: add pidfd_send_signal(2) + +user_namespaces.7 + Michael Kerrisk + Improve explanation of meaning of ownership of nonuser namespaces