2019-08-02 08:31:40 +00:00
|
|
|
==================== Changes in man-pages-5.03 ====================
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2019-10-10 20:30:49 +00:00
|
|
|
Released: 2019-10-10, Munich
|
2007-09-19 21:40:03 +00:00
|
|
|
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Contributors
|
|
|
|
------------
|
2007-10-23 11:33:49 +00:00
|
|
|
|
2011-09-16 02:56:20 +00:00
|
|
|
The following people contributed patches/fixes or (noted in brackets
|
2012-03-05 20:07:17 +00:00
|
|
|
in the changelog below) reports, notes, and ideas that have been
|
2011-09-16 02:56:20 +00:00
|
|
|
incorporated in changes in this release:
|
2007-09-20 18:15:23 +00:00
|
|
|
|
2019-10-09 21:03:31 +00:00
|
|
|
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>
|
2013-03-10 10:24:30 +00:00
|
|
|
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
|
|
|
2019-08-02 08:31:40 +00:00
|
|
|
New and rewritten pages
|
|
|
|
-----------------------
|
2019-08-02 06:32:54 +00:00
|
|
|
|
2019-10-09 21:03:31 +00:00
|
|
|
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
|
2019-10-10 10:30:19 +00:00
|
|
|
change in the future. Many longstanding errors in the old version of
|
|
|
|
the page have also been corrected.
|
2019-10-09 21:03:31 +00:00
|
|
|
|
|
|
|
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)
|
|
|
|
|
2019-08-02 06:32:54 +00:00
|
|
|
|
2019-08-02 08:31:40 +00:00
|
|
|
Newly documented interfaces in existing pages
|
|
|
|
---------------------------------------------
|
2019-08-02 06:32:54 +00:00
|
|
|
|
2019-10-09 21:03:31 +00:00
|
|
|
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
|
|
|
|
|
2018-02-02 06:50:23 +00:00
|
|
|
|
2018-04-30 19:34:48 +00:00
|
|
|
New and changed links
|
|
|
|
---------------------
|
2017-07-13 12:22:09 +00:00
|
|
|
|
2019-10-09 21:03:31 +00:00
|
|
|
res_nclose.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Add NEW link to resolver.3
|
|
|
|
|
2019-05-09 07:46:26 +00:00
|
|
|
|
|
|
|
Global changes
|
|
|
|
--------------
|
2017-07-13 12:22:09 +00:00
|
|
|
|
2019-10-09 21:03:31 +00:00
|
|
|
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
|
|
|
|
|
2017-07-13 12:22:09 +00:00
|
|
|
|
2017-07-13 22:12:22 +00:00
|
|
|
Changes to individual pages
|
|
|
|
---------------------------
|
2014-10-02 21:44:42 +00:00
|
|
|
|
2019-10-09 21:03:31 +00:00
|
|
|
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
|