==================== 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