From cdb921797215d48b444f87dfb8908eb2a28d9f4a Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 9 Oct 2019 23:03:31 +0200 Subject: [PATCH] Changes: Ready for 5.03 Signed-off-by: Michael Kerrisk --- Changes | 343 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 343 insertions(+) diff --git a/Changes b/Changes index 80c44eb4c..be8d2b926 100644 --- a/Changes +++ b/Changes @@ -10,6 +10,51 @@ 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! @@ -17,19 +62,317 @@ 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