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

1 files changed, 912 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index d7713ad32..ff7cb55cd 100644
--- a/Changes.old
+++ b/Changes.old
@@ -43931,3 +43931,915 @@ user_namespaces.7
         Add reference to namespaces(7) for NS_GET_USERNS operation
     Michael Kerrisk
         Add reference to namespaces(7) for NS_GET_PARENT operation
+
+
+==================== Changes in man-pages-4.10 ====================
+
+Released: 2017-03-13, Paris
+
+
+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 Martindale <adam.john.martindale@gmail.com>
+Alex <psybin@riseup.net>
+Anders Thulin <anders@thulin.name>
+Andreas Gruenbacher <agruenba@redhat.com>
+Brian Masney <masneyb@onstation.org>
+Casey Schaufler <casey@schaufler-ca.com>
+David Howells <dhowells@redhat.com>
+Erik Kline <ekline@gmail.com>
+Erik Roland van der Meer <ervdmeer@gmail.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabjan Sukalia <fsukalia@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helmut Eller <eller.helmut@gmail.com>
+Hugo Guiroux <hugo.guiroux@gmail.com>
+Ian Jackson <ijackson@chiark.greenend.org.uk>
+Jakub Wilk <jwilk@jwilk.net>
+Jann Horn <jannh@google.com>
+Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
+John Wiersba <jrw32982@yahoo.com>
+Jon Jensen <jon@endpoint.com>
+Kai NODA <nodakai@gmail.com>
+KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Keno Fischer <keno@juliacomputing.com>
+Kent Fredic <kentfredric@gmail.com>
+Krzysztof Kulakowski <krzysztof.kulakowski@intel.com>
+Maik Zumstrull <maik@zumstrull.net>
+Mat Martineau <mathew.j.martineau@linux.intel.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@chromium.org>
+Nadav Har'El  <nyh@math.technion.ac.il>
+Namhyung Kim <namhyung@gmail.com>
+Nicolas Biscos <nicolas.biscos+man7@gmail.com>
+Omar Sandoval <osandov@osandov.com>
+Paul Fee <paul.f.fee@gmail.com>
+Reverend Homer <mk.43.ecko@gmail.com>
+Rob Landley <rob@landley.net>
+Sergey Polovko <sergey@polovko.me>
+Steven Luo <steven@steven676.net>
+Tadeusz Struk <tadeusz.struk@intel.com>
+Vincent Bernat <vincent@bernat.im>
+Vivenzio Pagliari <vivenzio.pagliari@nokia.com>
+Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
+Willy Tarreau <w@1wt.eu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+add_key.2
+    Michael Kerrisk  [Eugene Syromyatnikov, David Howells]
+        Major improvements and additions
+            The page has doubled in length.
+
+ioctl_iflags.2
+    Michael Kerrisk
+        New page describing inode flags and ioctl() operations
+
+ioctl_ns.2
+    Michael Kerrisk
+        New page created by splitting ioctl(2) operations out of namespaces(7)
+
+keyctl.2
+    Michael Kerrisk, Eugene Syromyatnikov  [David Howells, Mat Martineau]
+         A vast number of additions and improvements
+             The page has gone from somewhat over 100 lines to well over
+             1000 lines and now more or less documents the complete interface
+             provided by this system call.
+
+getentropy.3
+    Michael Kerrisk
+        New page documenting getentropy(3)
+            getentropy(3) is added to glibc in version 2.25.
+
+keyrings.7
+    David Howells
+        New page (written by David Howells) adopted from keyutils
+            Since this page documents kernel-user-space interfaces,
+            it makes sense to have it as part of man-pages, rather
+            than the keyutils package.
+    Michael Kerrisk  [Eugene Syromyatnikov, David Howells]
+        Very many additions and improvements
+    Michael Kerrisk
+        Document /proc/keys
+    Michael Kerrisk
+        Document /proc/sys/kernel/keys/persistent_keyring_expiry
+    Michael Kerrisk
+        Document /proc/key-users
+    Michael Kerrisk
+        Document /proc/sys/kernel/keys/gc_delay
+    Michael Kerrisk
+        Document /proc files that define key quotas
+
+persistent-keyring.7
+    Michael Kerrisk
+        New page (written by David Howells) adopted from keyutils
+            Since this page documents kernel-user-space interfaces,
+            it makes sense to have it as part of man-pages, rather
+            than the keyutils package.
+    Michael Kerrisk
+        Various clean-ups and additions
+
+process-keyring.7
+    Michael Kerrisk
+        New page (written by David Howells) adopted from keyutils
+            Since this page documents kernel-user-space interfaces,
+            it makes sense to have it as part of man-pages, rather
+            than the keyutils package.
+    Michael Kerrisk
+        Various additions and improvements
+
+request_key.2
+    Michael Kerrisk, Eugene Syromyatnikov  [David Howells]
+        Very many additions and improvements
+             The page is now three times its former length.
+
+session-keyring.7
+    Michael Kerrisk
+        New page (written by David Howells) adopted from keyutils
+            Since this page documents kernel-user-space interfaces,
+            it makes sense to have it as part of man-pages, rather
+            than the keyutils package.
+    Michael Kerrisk
+        Various reworking and additions
+
+signal-safety.7
+    Michael Kerrisk
+        New page created by migrating the signal-safety discussion from
+        signal(7). Along the way some more details got added.
+    Michael Kerrisk  [KASAKI Motohiro]
+        Note async-signal-safety problems caused by pthread_atfork()
+            See https://bugzilla.kernel.org/show_bug.cgi?id=25292
+    Michael Kerrisk  [KASAKI Motohiro]
+        Note glibc deviations from POSIX requirements
+            See https://bugzilla.kernel.org/show_bug.cgi?id=25292
+
+thread-keyring.7
+    Michael Kerrisk
+        New page (written by David Howells) adopted from keyutils
+            Since this page documents kernel-user-space interfaces,
+            it makes sense to have it as part of man-pages, rather
+            than the keyutils package.
+    Michael Kerrisk
+        Various rewordings and additions
+
+user-keyring.7
+    Michael Kerrisk
+        New page (written by David Howells) adopted from keyutils
+            Since this page documents kernel-user-space interfaces,
+            it makes sense to have it as part of man-pages, rather
+            than the keyutils package.
+    Michael Kerrisk
+        Various reworking and improvements
+
+user-session-keyring.7
+    Michael Kerrisk
+        New page (written by David Howells) adopted from keyutils
+            Since this page documents kernel-user-space interfaces,
+            it makes sense to have it as part of man-pages, rather
+            than the keyutils package.
+    Michael Kerrisk
+        Various rewordings and additions
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+bzero.3
+    Michael Kerrisk
+        Document explicit_bzero() (new in glibc 2.25)
+            Also, reword the description of bzero somewhat.
+
+proc.5
+    Michael Kerrisk
+        Document /proc/sys/vm/user_reserve_kbytes
+    Michael Kerrisk
+        Document /proc/sys/vm/admin_reserve_kbytes
+    Michael Kerrisk
+        Document /proc/sys/fs/mount-max
+    Michael Kerrisk
+        Document /proc/PID/status 'NoNewPrivs' field
+
+
+New and changed links
+---------------------
+
+explicit_bzero.3
+    Michael Kerrisk
+        New link to bzero.3
+
+
+Changes to individual pages
+---------------------------
+
+chmod.2
+    Michael Kerrisk
+        ERRORS: add EPERM error for immutable/append-only file
+
+chown.2
+    Michael Kerrisk
+        ERRORS: add EPERM error for immutable/append-only file
+
+chroot.2
+    Michael Kerrisk
+        SEE ALSO: add switch_root(8)
+
+clock_getres.2
+    Michael Kerrisk
+        Note POSIX.1 requirements re relative time services and CLOCK_REALTIME
+
+clone.2
+    Michael Kerrisk
+        clone() does not execute fork handlers
+
+execve.2
+    Michael Kerrisk
+        Rework text describing when effective IDs aren't transformed by execve()
+    Michael Kerrisk
+        File capabilities can be ignored for the same reasons as set-UID/set-GID
+    Michael Kerrisk
+        The 'no_new_privs' bit inhibits transformations of the effective IDs
+
+fork.2
+    Michael Kerrisk
+        cgroup PIDs controller may also be trigger for EAGAIN error
+
+fsync.2
+    Michael Kerrisk
+        SEE ALSO: add posix_fadvise(2)
+
+getrandom.2
+    Michael Kerrisk
+        Remove getentropy(3) details and defer to new getentropy(3) page
+    Michael Kerrisk
+        Starting with glibc 2.25, getrandom() is now declared in <sys/random.h>
+    Michael Kerrisk
+        glibc support was added in version 2.25
+
+getrlimit.2
+    Michael Kerrisk
+        Document role of RLIMIT_NOFILE for FD passing over UNIX sockets
+
+getxattr.2
+listxattr.2
+    Andreas Gruenbacher
+        Document E2BIG errors
+
+inotify_add_watch.2
+    Michael Kerrisk
+        Note "inode" as a synonym for "filesystem object"
+            Consistent with clarifications just made in inotify(7).
+
+ioctl.2
+    Michael Kerrisk
+        SEE ALSO: add ioctl_ns(2), ioctl_iflags(2)
+
+ioctl_fat.2
+    Brian Masney
+        Correctly reference volume ID instead of volume label
+
+kcmp.2
+    Michael Kerrisk
+        Mention the clone(2) flags relating to various kcmp() 'type' values
+    Michael Kerrisk
+        KCMP_FILE: note reasons why FDs may refer to same open file description
+
+link.2
+    Michael Kerrisk
+        When using linkat() AT_EMPTY_PATH, 'olddirfd' must not be a directory
+    Michael Kerrisk
+        ERRORS: add EPERM for immutable/append-only files
+    Michael Kerrisk
+        Note limits where EMLINK is encountered on ext4 and Btrfs
+
+listxattr.2
+    Michael Kerrisk
+        Eliminate extra E2BIG error text
+            Andreas' patch added a second description of E2BIG that
+            was (mostly) more detailed than the existing text. Combine
+            the two texts.
+
+lseek.2
+    Michael Kerrisk
+        O_APPEND overrides the effect of lseek() when doing file writes
+    Michael Kerrisk
+        Remove ancient info about whence values and return values on old systems
+    Michael Kerrisk
+        Remove slightly bogus advice about race conditions
+            The page already (by now) contains a reference to open(2)
+            for a discussion of open file descriptions. Leave it at that,
+            since the reader can then deduce how things work.
+
+madvise.2
+    Michael Kerrisk
+        Note that madvise() is generally about improving performance
+
+mbind.2
+    Krzysztof Kulakowski  [Michael Kerrisk]
+        Update MPOL_BIND description
+            Behavior of MPOL_BIND Linux 2.6.26.
+
+mincore.2
+    Michael Kerrisk
+        SEE ALSO: add madvise(2), posix_fadvise(2), posix_madvise(3)
+
+mlock.2
+    Michael Kerrisk
+        Note pre-4.9 bug in RLIMIT_MEMLOCK accounting for overlapping locks
+    Michael Kerrisk
+        SEE ALSO: add mincore(2)
+
+mmap.2
+    Michael Kerrisk
+        mincore(2) can be used to discover which pages of a mapping are resident
+
+mount.2
+    Michael Kerrisk  [Rob Landley]
+        Refer to mount_namespaces(7) for details of default propagation type
+
+nanosleep.2
+    Michael Kerrisk
+        Describe "creeping sleep" problem
+            nanosleep() has a problem if used in a program that catches
+            signals and those signals are delivered at a very high rate.
+            Describe the problem, and note that clock_nanosleep(2)
+            provides a solution.
+    Michael Kerrisk
+        BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6
+
+open.2
+    Michael Kerrisk
+        Make it clear that O_APPEND implies atomicity
+    Michael Kerrisk
+        Clarify distinction between file creation flags and file status flags
+    Michael Kerrisk
+        Note ambiguity of ELOOP error when using O_NOFOLLOW
+    Michael Kerrisk
+        Restructure O_NOFOLLOW text for easier parsing
+    Michael Kerrisk
+        Clarify that O_NOFOLLOW is now in POSIX
+
+poll.2
+select.2
+    Nicolas Biscos
+        Add a reference to the sigset discussion in sigprocmask(2)
+            A little while back, I added a note to sigprocmask.2 that
+            discussed the difference between the libc's and the kernel's
+            sigset_t structures.  I added that note, because I saw this being
+            done wrong in a tool tracing system calls (causing subtle bugs).
+            As it turns out, the same bugs existed for ppoll and pselect, for
+            the same reason. I'm hoping by adding the reference here, future
+            writers of similar tools will find that discussion and not make
+            the same mistake.
+
+posix_fadvise.2
+    Michael Kerrisk
+        Mention /proc/sys/vm/drop_caches
+            It may be helpful for the reader of this page to know about
+            /proc/sys/vm/drop_caches.
+    Michael Kerrisk
+        Reorganize some text
+            Details for various flags were hidden under NOTES.
+            Move them to DESCRIPTION, to make the details more
+            obvious.
+    Michael Kerrisk
+        One can use open(2) + mmap(2) + mincore(2) as a 'fincore'
+            Note that open(2) + mmap(2) + mincore(2) to get a view of which
+            pages of a file are currently cached.
+    Michael Kerrisk  [Maik Zumstrull]
+        Note that POSIX_FADV_DONTNEED *may* try to write back dirty pages
+    Michael Kerrisk
+        SEE ALSO: mincore(2)
+
+prctl.2
+    Michael Kerrisk
+        Clarify that the ambient capability set is per-thread
+    Keno Fischer
+        Be more precise in what causes dumpable to reset
+    Michael Kerrisk
+        The no_new_privs setting is per-thread (not per-process)
+    Michael Kerrisk
+        Mention /proc/PID/status 'NoNewPrivs' field
+    Michael Kerrisk
+        Add reference to seccomp(2) in discussion of PR_SET_NO_NEW_PRIVS
+
+ptrace.2
+    Omar Sandoval
+        Clarify description of PTRACE_O_EXITKILL
+
+read.2
+    Michael Kerrisk  [Kai NODA]
+        Rework text in DESCRIPTION that talks about limits for 'count'
+            See https://bugzilla.kernel.org/show_bug.cgi?id=86061
+    Michael Kerrisk  [Steven Luo]
+        Remove crufty text about EINTR and partial read
+            Remove bogus text saying that POSIX permits partial read
+            to return -1/EINTR on interrupt by a signal handler.
+            That statement already ceased to be true in SUSv1 (1995)!
+
+            See https://bugzilla.kernel.org/show_bug.cgi?id=193111
+
+readv.2
+    Michael Kerrisk
+        Remove generic advice about mixing stdio and syscalls on same file
+            There is nothing specific to readv()/writev() about this advice.
+
+recv.2
+    Michael Kerrisk  [Vincent Bernat]
+        Remove duplicate paragraph
+            man-pages-1.34 included changes that duplicated an existing
+            paragraph. Remove that duplicate.
+    Michael Kerrisk
+        SEE ALSO: add ip(7), ipv6(7), tcp(7), udp(7), unix(7)
+
+remap_file_pages.2
+    Michael Kerrisk
+        remap_file_pages() has been replaced by a slower in-kernel emulation
+
+send.2
+    Michael Kerrisk
+        SEE ALSO: add ipv6(7), socket(7), unix(7)
+
+setxattr.2
+    Michael Kerrisk
+        ERRORS: add EPERM for immutable/append-only files
+
+signalfd.2
+    Michael Kerrisk
+        signalfd() doesn't play well with helper programs spawned by libraries
+            See https://lwn.net/Articles/415684/.
+    Michael Kerrisk
+        signalfd can't be used to receive synchronously generated signals
+            Signals such as the SIGSEGV that results from an invalid
+            memory access can be caught only with a handler.
+
+stat.2
+    Michael Kerrisk
+        EXAMPLE: extend program to also show ID of the containing device
+    Michael Kerrisk
+        NOTES: mention fstatat() AT_NO_AUTOMOUNT in discussion of automounting
+
+statfs.2
+    Namhyung Kim
+        Add more filesystem types
+            Add missing magic numbers from /usr/include/linux/magic.h
+
+syscall.2
+    Mike Frysinger
+        Add endian details with 64-bit splitting
+            Architectures that split 64-bit values across register pairs
+            usually do so according to their C ABI calling convention (which
+            means endianness).  Add some notes to that effect, and change the
+            readahead example to show a little endian example (since that is
+            way more common than big endian).
+
+            Also start a new list of syscalls that this issue does not apply
+            to.
+    Mike Frysinger
+        Note parisc handling of aligned register pairs
+            While parisc would normally have the same behavior as ARM/PowerPC,
+            they decide to write shim syscall stubs to unpack/realign rather
+            than expose the padding to userspace.
+
+tkill.2
+    Jann Horn
+        Document EAGAIN error for real-time signals
+
+truncate.2
+    Michael Kerrisk
+        Note use of ftruncate() for POSIX shared memory objects
+
+unlink.2
+    Michael Kerrisk
+        ERRORS: add EPERM error for immutable/read-only files
+
+vfork.2
+    Michael Kerrisk
+        Explain why the child should not call exit(3)
+    Michael Kerrisk
+        Another reason to use vfork() is to avoid overcommitting memory
+    Michael Kerrisk
+        Note some caveats re the use of vfork()
+            Inspired by Rich Felker's post at http://ewontfix.com/7/.
+            See also https://sourceware.org/bugzilla/show_bug.cgi?id=14749 and
+            See also https://sourceware.org/bugzilla/show_bug.cgi?id=14750.
+    Michael Kerrisk
+        SEE ALSO: add _exit(2)
+
+write.2
+    Michael Kerrisk  [Kai NODA]
+        Alert the reader that there is a limit on 'count'
+            See https://bugzilla.kernel.org/show_bug.cgi?id=86061
+
+aio_suspend.3
+    Michael Kerrisk
+        Note that the glibc implementation is not async-signal-safe
+            See https://sourceware.org/bugzilla/show_bug.cgi?id=13172
+
+backtrace.3
+    Michael Kerrisk
+        SEE ALSO: add addr2line(1) and gdb(1)
+
+bcmp.3
+bcopy.3
+bzero.3
+memccpy.3
+memchr.3
+memcmp.3
+memcpy.3
+memfrob.3
+memmem.3
+memmove.3
+memset.3
+    Michael Kerrisk
+        SEE ALSO: add bstring(3)
+
+exec.3
+    Michael Kerrisk
+        execl() and execle() were not async-signal-safe before glibc 2.24
+
+fopen.3
+    Michael Kerrisk  [Helmut Eller]
+        Describe freopen() behavior for NULL pathname argument
+            See https://bugzilla.kernel.org/show_bug.cgi?id=191261
+    Michael Kerrisk
+        Note the open(2) flags that correspond to the 'mode' argument
+    Michael Kerrisk
+        Change argument name: 'path' to 'pathname'
+            For consistency with open(2).
+    Michael Kerrisk
+        Add subsection headings for each function
+
+fts.3
+    Michael Kerrisk
+        Use better argument name for fts_children() and fts_set()
+    Michael Kerrisk
+        Fix minor error in FTSENT structure definition
+    Michael Kerrisk
+        Improve explanation of 'fts_errno'
+    Michael Kerrisk
+        Give a hint that there are further fields in the FTSENT structure
+    Michael Kerrisk
+        Clarify meaning of zero as 'instr' value for fts_set()
+
+ftw.3
+    Michael Kerrisk
+        Correctly handle use of stat info for FTW_NS in example program
+    Michael Kerrisk
+        Clarify that stat buffer is undefined for FTW_NS
+
+getline.3
+    Michael Kerrisk
+        EXAMPLE: better error handling
+    Michael Kerrisk  [Kent Fredic]
+        EXAMPLE: handle null bytes in input
+    Jann Horn
+        Document ENOMEM error case
+            see the error handling in libio/iogetdelim.c
+    Michael Kerrisk
+        EXAMPLE: specify file to be opened as command-line argument
+    Michael Kerrisk
+        Use better variable name in example program
+
+getmntent.3
+    Michael Kerrisk  [Anders Thulin]
+        Prefer '\\' as the escape to get a backslash
+            See https://bugzilla.kernel.org/show_bug.cgi?id=191611
+
+getopt.3
+    Michael Kerrisk
+        Reword discussion of error handling and reporting
+            The existing description was hard to understand. Break
+            it into a bullet list that separates out the details
+            in a manner that is easier to parse.
+    Michael Kerrisk
+        Correct details of use of <stdio.h> to get getopt() declaration
+    Michael Kerrisk  [John Wiersba]
+        Remove some redundant text
+
+mq_open.3
+    Michael Kerrisk  [Adam Martindale]
+        Include definition of the 'mq_attr' structure in this man page
+            Make the reader's life a little easier by saving them from
+            having to refer to mq_getattr(3).
+
+mq_send.3
+    Michael Kerrisk  [Adam Martindale]
+        Refer to mq_overview(7) for details on range of message priority
+
+__ppc_set_ppr_med.3
+    Wainer dos Santos Moschetta
+        Note need for _ARCH_PWR8 macro
+            The _ARCH_PWR8 macro must be defined to get the
+             __ppc_set_ppr_very_low() and __ppc_set_ppr_med_high()
+            definitions.
+
+printf.3
+    Michael Kerrisk
+        Document nonstandard 'Z' modifier
+    Michael Kerrisk
+        Document 'q' length modifier
+    Michael Kerrisk  [Erik Roland van der Meer]
+        Fix a small bug in example code
+            Move the second call to va_end(ap) to above the if-block that
+            precedes it, so that the va_list 'ap' will be cleaned up in
+            all cases.
+    Michael Kerrisk  [Nadav Har'El]
+        As a nonstandard extension, GNU treats 'll' and 'L' as synonyms
+            See https://bugzilla.kernel.org/show_bug.cgi?id=190341.
+    Michael Kerrisk
+        Add references to setlocale(3) in discussions of locales
+    Michael Kerrisk
+        SEE ALSO: remove bogus self reference (dprintf(3))
+
+random.3
+    Michael Kerrisk
+        Relocate information of "optimal" value of initstate() 'n' argument
+            The information was a bit hidden in NOTES.
+
+random_r.3
+    Michael Kerrisk  [Jan Ziak]
+        'buf.state' must be initialized to NULL before calling initstate_r()
+            See https://bugzilla.kernel.org/show_bug.cgi?id=192801.
+    Michael Kerrisk
+        Add some usage notes for setstate_r()
+    Michael Kerrisk
+        Note that 'buf' records a pointer to 'statebuf'
+            See https://sourceware.org/bugzilla/show_bug.cgi?id=3662.
+    Michael Kerrisk
+        Add BUGS section pointing out the weirdness of the initstate_r() API
+
+resolver.3
+    Michael Kerrisk
+        RES_AAONLY, RES_PRIMARY, RES_NOCHECKNAME, RES_KEEPTSIG are deprecated
+            These options were never implemented; since glibc 2.25, they
+            are deprecated.
+    Michael Kerrisk
+        The RES_NOIP6DOTINT is removed in glibc 2.25
+    Michael Kerrisk
+        Note that RES_BLAST was unimplemented and is now deprecated
+    Michael Kerrisk
+        RES_USE_INET6 is deprecated since glibc 2.25
+    Michael Kerrisk
+        RES_USEBSTRING was removed in glibc 2.25
+
+resolver.3
+resolv.conf.5
+    Michael Kerrisk
+        Note that RES_USEBSTRING defaults to off
+
+scandir.3
+    Michael Kerrisk  [Ian Jackson]
+        Fix errors in example program
+            See http://bugs.debian.org/848231.
+    Michael Kerrisk
+        Improve logic of the example program
+
+scanf.3
+    Michael Kerrisk
+        Document the quote (') modifier for decimal conversions
+
+sem_post.3
+setjmp.3
+    Michael Kerrisk
+        SEE ALSO: add signal-safety(7)
+
+sem_wait.3
+    Michael Kerrisk  [Fabjan Sukalia]
+        Remove statement that SA_RESTART does not cause restarting
+            This has not been true since Linux 2.6.22. The description
+            of EINTR maintains a reference to signal(7), which explains
+            the historical details.
+
+            See https://bugzilla.kernel.org/show_bug.cgi?id=192071
+
+sleep.3
+    Michael Kerrisk  [Mike Frysiner]
+        Note that sleep() is implemented via nanosleep(2)
+            See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
+    Michael Kerrisk  [Mike Frysinger]
+        Note that sleep() sleeps for a real-time number of seconds
+            See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
+    Michael Kerrisk
+        Convert BUGS text to "Portability notes" subsection
+            The existing text is not a bug, as such.
+    Michael Kerrisk
+        DESCRIPTION: minor reworking
+
+strerror.3
+    Heinrich Schuchardt
+        Indicate reasonable buffer size for strerror_r() and strerror_l()
+            Add a hint which buffer size is needed for
+            strerror_r() and strerror_l().
+
+strverscmp.3
+    Michael Kerrisk  [Vivenzio Pagliari]
+        Fix comparison error in example program
+
+system.3
+    Michael Kerrisk
+        In the glibc implementation, fork handlers are not executed by system()
+
+random.4
+    Michael Kerrisk  [Jon Jensen]
+        Note that entropY-avail will be a number in the range 0..4096
+
+core.5
+    Michael Kerrisk
+        Clarify that dumping program's initial CWD is root directory
+    Michael Kerrisk
+        The target of core dump piping can also be a script
+
+filesystems.5
+    Michael Kerrisk
+        SEE ALSO: add btrfs(5), nfs(5), tmpfs(5)
+
+intro.5
+    Michael Kerrisk
+        Document the reality that by now Section 5 also covers filesystems
+            There are by now, from various filesystem projects, various
+            pages in Section 5 that document different filesystems.
+            Change intro(5) to reflect that.
+
+            Documented after following: http://bugs.debian.org/847998
+
+proc.5
+    Mike Frysinger  [Michael Kerrisk]
+        Clarify /proc/pid/environ behavior
+            /proc/pid/environ reflects process environment at
+            *start* of program execution; it is set at time of execve(2)
+    Michael Kerrisk
+        Add reference to slabinfo(5) in discussion of /proc/meminfo 'Slab' field
+    Michael Kerrisk
+        Add entries for "keys" files that refer reader to keyrings(7)
+    Michael Kerrisk
+        Remove duplicate /proc/[pid]/seccomp entry
+    Michael Kerrisk
+        Mention other system calls that create 'anon_inode' file descriptors
+            Mention a few other system calls that create file descriptors
+            that display an 'anon_inode' symlink in /proc/PID/fd
+    Michael Kerrisk
+        Add some detail on overcommit_memory value 1
+    Michael Kerrisk
+        Add reference to vdso(7) in discussion of /proc/PID/maps
+
+resolv.conf.5
+    Michael Kerrisk
+        ip6-bytestring was removed in glibc 2.25
+    Michael Kerrisk
+        The ipc-dotint and no-ip6-dotint options were removed in glibc 2.25
+    Michael Kerrisk
+        The 'inet6' option is deprecated since glibc 2.25
+
+slabinfo.5
+    Michael Kerrisk
+        SEE ALSO: add slabtop(1)
+
+capabilities.7
+    Michael Kerrisk  [Casey Schaufler]
+        Add subsection with notes to kernel developers
+            Provide some notes to kernel developers considering how to choose
+            which capability should govern a new kernel feature.
+    Michael Kerrisk
+        Further enhance the recommendation against new uses of CAP_SYS_ADMIN
+    Michael Kerrisk
+        Explicitly point from CAP_SYS_ADMIN to "Notes for kernel developers"
+    Michael Kerrisk
+        Add another case for CAP_DAC_READ_SEARCH
+    Michael Kerrisk
+        Refer to execve(2) for the reasons that file capabilities may be ignored
+    Michael Kerrisk
+        Document a new use of CAP_SYS_RESOURCE
+    Michael Kerrisk
+        Add some more operations governed by CAP_SYS_ADMIN
+    Michael Kerrisk
+        Adjust references to chattr(1) to point to ioctl_iflags(2)
+
+environ.7
+    Michael Kerrisk
+        Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations
+
+inotify.7
+    Michael Kerrisk
+        Point out that inotify monitoring is inode based
+
+ip.7
+    Michael Kerrisk
+        SEE ALSO: add ip(8)
+
+man.7
+uri.7
+    Jakub Wilk
+        Use "www.kernel.org" in example URLs
+            Apparently www.kernelnotes.org is now a spam site.
+
+mount_namespaces.7
+    Michael Kerrisk  [Rob Landley]
+        Rework the discussion of defaults for mount propagation types
+            Add rather more detail. In particular, note the cases where the
+            default propagation type is MS_PRIVATE vs MS_SHARED.
+
+namespaces.7
+    Michael Kerrisk
+        EXAMPLE: fix an error in shell session
+    Michael Kerrisk
+        EXAMPLE: rename the example program
+            Use a more generic name, since this program may be expanded
+            in various ways in the future.
+    Michael Kerrisk
+        SEE ALSO: add ip-netns(8)
+    Michael Kerrisk
+        Remove content split out into ioctl_ns(2)
+
+netlink.7
+    Michael Kerrisk
+        NETLINK_IP6_FW went away in Linux 3.5
+    Michael Kerrisk
+        NETLINK_W1 went away in Linux 2.6.18
+    Michael Kerrisk
+        Add NETLINK_SCSITRANSPORT to list
+    Michael Kerrisk
+        Add NETLINK_RDMA to list
+    Michael Kerrisk
+        NETLINK_FIREWALL was removed in Linux 3.5
+    Michael Kerrisk
+        NETLINK_NFLOG was removed in Linux 3.17
+    Jakub Wilk
+        Update libnl homepage URL
+            The original URL is 404.
+
+pid_namespaces.7
+user_namespaces.7
+    Michael Kerrisk
+        Adjust references to namespaces(7) to ioctl_ns(2)
+
+pid_namespaces.7
+    Keno Fischer
+        CLONE_SIGHAND|CLONE_VM|CLONE_NEWPID is no longer disallowed
+
+pipe.7
+    Michael Kerrisk
+        Since Linux 4.9, pipe-max-size is ceiling for the default pipe capacity
+    Michael Kerrisk
+        Clarify that default pipe capacity is 16 pages
+            The statement that the default pipe capacity is 65536 bytes
+            is accurate only on systems where the page size is 4096B.
+            See the use of PIPE_DEF_BUFFERS in the kernel source.
+
+random.7
+    Michael Kerrisk
+        Mention getentropy(3)
+    Michael Kerrisk
+        SEE ALSO: add getentropy(3)
+    Michael Kerrisk
+        SEE ALSO: add getauxval(3)
+            A small hint to the reader that some random bytes arrive
+            in the auxiliary vector.
+
+signal.7
+    Michael Kerrisk
+        SIGSYS: add reference to seccomp(2)
+    Michael Kerrisk
+        Change description of SIGSYS to "Bad system call"
+            This is the more typical definition.
+    Michael Kerrisk
+        SIGPIPE: add reference to pipe(7)
+    Michael Kerrisk
+        SIGXFSZ: add reference to setrlimit(2)
+    Michael Kerrisk
+        Add a name for SIGEMT
+    Michael Kerrisk
+        SIGXCPU: add reference to setrlimit(2)
+    Michael Kerrisk
+        Migrated signal-safety discussion to new signal-safet(7) page
+
+unix.7
+    Michael Kerrisk  [Sergey Polovko]
+        Since Linux 3.4, UNIX domain sockets support MSG_TRUNC
+            This was correctly noted in recv(2), but the unix(7) page
+            was not correspondingly updated for the Linux 3.4 change.
+    Michael Kerrisk  [Willy Tarreau]
+        Document ETOOMANYREFS for SCM_RIGHTS send exceeding RLIMIT_NOFILE limit
+
+user_namespaces.7
+    Michael Kerrisk
+        Change page cross reference: keyctl(2) ==> keyrings(7)
+
+ld.so.8
+    Michael Kerrisk
+        LD_BIND_NOT has effect only for function symbols
+    Michael Kerrisk
+        Describe use of LD_DEBUG with LD_BIND_NOT
+    Michael Kerrisk
+        In secure mode, LD_AUDIT restricts the libraries that it will load
+    Michael Kerrisk
+        LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM
+