man-pages-5.03 is released

From: Michael Kerrisk (man-pages)
Date: Fri Oct 11 2019 - 17:23:27 EST


Gidday,

The Linux man-pages maintainer proudly announces:

man-pages-5.03 - man pages for Linux

This release resulted from patches, bug reports, reviews, and
comments from 45 people, with over 200 commits making changes
to around 80 pages.

Tarball download:
http://www.kernel.org/doc/man-pages/download.html
Git repository:
https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
http://man7.org/linux/man-pages/changelog.html#release_5.03

A short summary of the release is blogged at:
https://linux-man-pages.blogspot.com/2019/10/man-pages-503-is-released.html

The current version of the pages is browsable at:
http://man7.org/linux/man-pages/

A selection of changes in this release that may be of interest
to readers of LKML is shown below.

Cheers,

Michael

==================== Changes in man-pages-5.03 ====================


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


Changes to individual pages
---------------------------

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"

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.
signalfd.2
Andrew Clayton, Michael Kerrisk
Note about interactions with epoll & fork

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

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.

user_namespaces.7
Michael Kerrisk
Improve explanation of meaning of ownership of nonuser namespaces


--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/