Changes: Ready for 5.03

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2019-10-09 23:03:31 +02:00
parent 20a3713221
commit cdb9217972
1 changed files with 343 additions and 0 deletions

343
Changes
View File

@ -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 <kilobyte@angband.pl>
Aleksa Sarai <asarai@suse.de>
Alexey Budankov <alexey.budankov@linux.intel.com>
Amir Goldstein <amir73il@gmail.com>
Andrew Clayton <andrew@digital-domain.net>
Carlos O'Donell <carlos@redhat.com>
Christian Brauner <christian@brauner.io>
Christopher M. Riedl <cmr@informatik.wtf>
Daniel Colascione <dancol@google.com>
Dave Carroll <david.carroll@microsemi.com>
Dave Chinner <dchinner@redhat.com>
Дилян Палаузов <dilyan.palauzov@aegee.org>
Dmitry V. Levin <ldv@altlinux.org>
Don Brace <don.brace@microsemi.com>
eponymous alias <eponymousalias@yahoo.com>
Eric Biggers <ebiggers@google.com>
Eric W. Biederman <ebiederm@xmission.com>
Florian Weimer <fw@deneb.enyo.de>
Florin Blanaru <florin.blanaru96@gmail.com>
Gilbert Wu <gilbert.wu@microsemi.com>
Ingo Schwarze <schwarze@usta.de>
Jakub Wilk <jwilk@jwilk.net>
Kevin Barnett <kevin.barnett@microsemi.com>
Marko Myllynen <myllynen@redhat.com>
Matti Moell <Matti.Moell@opensynergy.com>
Matti Möll <Matti.Moell@opensynergy.com>
Matt Perricone <matt.perricone@microsemi.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Murthy Bhat <Murthy.Bhat@microsemi.com>
Nikola Forró <nforro@redhat.com>
nilsocket <nilsocket@gmail.com>
Paul Wise <pabs3@bonedaddy.net>
Philipp Wendler <ml@philippwendler.de>
Raphael Moreira Zinsly <rzinsly@linux.vnet.ibm.com>
Rasmus Villemoes <rv@rasmusvillemoes.dk>
Reid Priedhorsky <reidpr@lanl.gov>
Rick Stanley <rstanley@rsiny.com>
Rob Landley <rob@landley.net>
Scott Benesh <scott.benesh@microsemi.com>
Scott Teel <scott.teel@microsemi.com>
Shawn Anastasio <shawn@anastas.io>
Simone Piccardi <piccardi@truelite.it>
Vincent Lefevre <vincent@vinc17.net>
Yang Xu <xuyang2018.jy@cn.fujitsu.com>
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