Start of man-pages-5.04: updating Changes and Changes.old

1 files changed, 380 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index a8bc6ae08..ab016234f 100644
--- a/Changes.old
+++ b/Changes.old
@@ -49731,3 +49731,383 @@ ld.so.8
             variables, not used by the dynamic linker itself, that are also
             treated in this way (see the glibc source file
             sysdeps/generic/unsecvars.h).
+
+
+==================== 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 <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