-==================== Changes in man-pages-5.03 ====================
+==================== Changes in man-pages-5.07 ====================
-Released: 2019-10-11, Munich
+Released: ????-??-??, Munich
Contributors
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!
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