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

1 files changed, 531 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 981d57132..f27f0174f 100644
--- a/Changes.old
+++ b/Changes.old
@@ -45866,3 +45866,534 @@ ld.so.8
             Ignored since 2.3.4 (not 2.3.5).
     Michael Kerrisk
         Rewrite LD_DEBUG_OUTPUT description and note that .PID is appended
+
+
+==================== Changes in man-pages-4.13 ====================
+
+Released: 2017-09-15, 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:
+
+Aleksa Sarai <asarai@suse.de>
+Alex Henrie <alexhenrie24@gmail.com>
+Benjamin Peterson <bp@benjamin.pe>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Cyrill Gorcunov <gorcunov@openvz.org>
+Darrick J. Wong <darrick.wong@oracle.com>
+David Wilder <dwilder@us.ibm.com>
+Dennis Knorr <dennis.knorr@muenchen.de>
+Don Brace <don.brace@microsemi.com>
+Douglas Caetano dos Santos <douglascs@taghos.com.br>
+Elliott Hughes <enh@google.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabio Scotoni <fabio@esse.ch>
+Florian Weimer <fweimer@redhat.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jason Noakes <jjnoakes@gmail.com>
+Jens Axboe <axboe@kernel.dk>
+Jonas Grabber <jobegrabber@gmail.com>
+Kees Cook <keescook@chromium.org>
+Konstantin Shemyak <konstantin@shemyak.com>
+Li Zhijian <lizhijian@cn.fujitsu.com>
+Marko Myllynen <myllynen@redhat.com>
+Mark Wielaard <mark@klomp.org>
+Meelis Roos <mroos@linux.ee>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Rapoport <rppt@linux.vnet.ibm.com>
+NeilBrown <neilb@suse.com>
+Otto Ebeling <oebeling@github.mail.kapsi.fi>
+Paul Eggert <eggert@cs.ucla.edu>
+Rick Jones <rick.jones2@hpe.com>
+Sage Weil <sage@redhat.com>
+Sam Varshavchik <mrsam@courier-mta.com>
+Sergey Z. <zhurxx@gmail.com>
+Shrikant Giridhar <shrikantgiridhar@gmail.com>
+Stephan Müller <smueller@chronox.de>
+Sukadev Bhattiprolu <sukadev@linux.vnet.ibm.com>
+Tej Chajed <tchajed@mit.edu>
+Thiago Jung Bauermann <bauerman@linux.vnet.ibm.com>
+Vincent Bernat <vincent@bernat.im>
+Yubin Ruan <ablacktshirt@gmail.com>
+Ильдар Низамов <niya3@mail.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pthread_mutex_consistent.3
+    Yubin Ruan, Michael Kerrisk
+        New page documenting pthread_mutex_consistent(3)
+
+pthread_mutexattr_getpshared.3
+    Michael Kerrisk
+        New page for pthread_mutexattr_getpshared(3) and pthread_mutexattr_setpshared(3)
+
+pthread_mutexattr_init.3
+    Michael Kerrisk
+        New page for pthread_mutexattr_init(3) and pthread_mutexattr_destroy(3)
+
+pthread_mutexattr_setrobust.3
+    Yubin Ruan, Michael Kerrisk
+        New page for pthread_mutexattr_setrobust(3) and pthread_mutexattr_getrobust(3)
+
+sysfs.5
+    Michael Kerrisk  [Mark Wielaard]
+        New page documenting the sysfs filesystem
+            Just a skeleton page so far, but perhaps it will be filled out
+            over time.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fcntl.2
+    Jens Axboe, Michael Kerrisk
+        Describe the set/get write hints commands that are added in Linux 4.13
+            Document F_GET_RW_HINT, F_SET_RW_HINT, F_GET_FILE_RW_HINT, and
+            F_SET_FILE_RW_HINT.
+
+ioctl_tty.2
+    Aleksa Sarai, Michael Kerrisk
+        Add TIOCGPTPEER documentation
+
+kcmp.2
+    Cyrill Gorcunov
+        Add KCMP_EPOLL_TFD description
+
+keyctl.2
+    Eugene Syromyatnikov
+        Document the KEYCTL_RESTRICT_KEYRING operation
+    Eugene Syromyatnikov  [Stephan Müller]
+        Document the ability to provide KDF parameters in KEYCTL_DH_COMPUTE
+
+
+New and changed links
+---------------------
+
+pthread_mutexattr_destroy.3
+    Michael Kerrisk
+        New link to new pthread_mutexattr_init.3 page
+
+pthread_mutexattr_getrobust.3
+    Michael Kerrisk
+        New link to new pthread_mutexattr_setrobust.3 page
+
+pthread_mutexattr_getrobust_np.3
+    Michael Kerrisk
+        New link to new pthread_mutexattr_setrobust.3 page
+
+pthread_mutexattr_setpshared.3
+    Michael Kerrisk
+        New link to new pthread_mutexattr_getpshared.3 page
+
+
+Global changes
+--------------
+
+Various pages
+    Michael Kerrisk
+        Use .EX/.EE for EXAMPLE programs
+
+Various pages
+    Michael Kerrisk
+        Use consistent markup for code snippets
+            Change .nf/.fi to .EX/.EE
+
+Various pages
+    Michael Kerrisk
+        Use consistent markup for code snippets
+            The preferred form is
+
+                .PP/.IP
+                .in +4n
+                .EX
+                <code>
+                .EE
+                .in
+                .PP/.IP
+
+Various pages
+    Michael Kerrisk
+        Formatting fix: replace blank lines with .PP/.IP
+            Blank lines shouldn't generally appear in *roff source (other
+            than in code examples), since they create large vertical
+            spaces between text blocks.
+
+Various pages
+    Michael Kerrisk  [Bjarni Ingi Gislason]
+        Add a non-breaking space between a number and a unit (prefix)
+            Based on a patch by Bjarni Ingi Gislason.
+
+Various pages
+    Michael Kerrisk  [Bjarni Ingi Gislason]
+        Use en-dash for ranges
+            Based on a patch by Bjarni Ingi Gislason.
+
+A few pages
+    Michael Kerrisk
+        Fix misordering of sections
+    Michael Kerrisk
+        Fix order of SEE ALSO entries
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+    Michael Kerrisk
+        Add more detail on ldd security implications, noting glibc 2.27 changes
+
+add_key.2
+backtrace.3
+syslog.3
+    Michael Kerrisk
+        Fix misordered SEE ALSO entries
+
+add_key.2
+request_key.2
+keyrings.7
+    Eugene Syromyatnikov
+        Update Linux documentation pointers
+
+chown.2
+    Michael Kerrisk
+        Update kernel version in note on support for grpid/nogrpid mount options
+            There has been no change since Linux 2.6.25, so update the
+            kernel version to 4.12.
+
+execve.2
+    Michael Kerrisk
+        SEE ALSO: add get_robust_list(2)
+
+getrandom.2
+    Michael Kerrisk  [Fabio Scotoni]
+        SYNOPSIS: make return type of getrandom() 'ssize_t'
+            This accords with glibc headers and the Linux kernel source.
+
+getrlimit.2
+    Thiago Jung Bauermann
+        Mention unit used by RLIMIT_CORE and RLIMIT_FSIZE
+    Michael Kerrisk
+        Note that RLIMIT_AS and RLIMIT_DATA are rounded down to system page size
+    Michael Kerrisk
+        Mention unit for RLIMIT_DATA
+
+getrlimit.2
+mmap.2
+malloc.3
+    Jonas Grabber
+        RLIMIT_DATA affects mmap (2) since Linux 4.7
+
+get_robust_list.2
+    Michael Kerrisk
+        Detail the operation of robust futex lists
+    Michael Kerrisk
+        Since Linux 2.6.28, robust futex lists also have an effect for execve(2)
+    Michael Kerrisk
+        Clarify that "thread ID" means "kernel thread ID"
+    Michael Kerrisk
+        SEE ALSO: add pthread_mutexattr_setrobust(3)
+
+ioctl_getfsmap.2
+    Darrick J. Wong
+        Correct semantics of FMR_OF_LAST flag
+
+ioctl_userfaultfd.2
+    Mike Rapoport
+        Document replacement of ENOSPC with ESRCH
+    Mike Rapoport
+        Update uffdio_api.features description
+            There is no requirement that uffdio_api.features must be zero
+            for newer kernels. This field actually defines what features
+            space would like to enable.
+
+io_submit.2
+    Sage Weil
+        Acknowledge possibility of short return
+            Note that the return value may be a value less than 'nr'
+            if not all iocbs were queued at once.
+
+ipc.2
+    Michael Kerrisk
+        SEE ALSO: add svipc(7)
+
+keyctl.2
+    Eugene Syromyatnikov
+        mention keyctl_dh_compute(3) and keyctl_dh_compute_alloc (3)
+            These functions have been added in keyutils 1.5.10
+    Eugene Syromyatnikov
+        Mention ENOMEM in ERRORS
+    Eugene Syromyatnikov
+        Update kernel documentation path reference
+
+move_pages.2
+    Otto Ebeling  [Michael Kerrisk]
+        Note permission changes that occurred in Linux 4.13
+
+mprotect.2
+    Michael Kerrisk  [Shrikant Giridhar]
+        Add warning about the use of printf() in the example code
+
+open.2
+    NeilBrown
+        Improve O_PATH documentation
+            - fstatfs is now permitted.
+            - ioctl isn't, and is worth listing explicitly
+            - O_PATH allows an automount point to be opened with
+              triggering the mount.
+
+prctl.2
+seccomp.2
+    Eugene Syromyatnikov
+        Update pointer to in-kernel seccomp documentation
+
+prctl.2
+ptrace.2
+    Eugene Syromyatnikov
+        Update pointer to in-kernel Yama documentation
+
+prctl.2
+    Eugene Syromyatnikov
+        Update pointer to in-kernel no_new_privs flag documentation
+
+readlink.2
+    Michael Kerrisk  [Jason Noakes]
+        Fix an off-by-one error in example code
+
+seccomp.2
+    Kees Cook
+        Clarify SECCOMP_RET_KILL kills tasks not processes
+
+select_tut.2
+    Michael Kerrisk  [Sergey Z.]
+        Clarify an ambiguity with respect to select() and EAGAIN
+            See https://bugzilla.kernel.org/show_bug.cgi?id=196345
+
+set_tid_address.2
+    Elliott Hughes
+        Note that there's no glibc wrapper for set_tid_address()
+
+socket.2
+    Michael Kerrisk  [Yubin Ruan]
+        socket() uses the lowest available file descriptor
+
+_syscall.2
+    Michael Kerrisk
+        Remove redundant comment from EXAMPLE
+            A discussion of the nroff source of the manual
+            page isn't very useful...
+
+sysfs.2
+    Michael Kerrisk
+        Add a pointer to sysfs(5) to help possibly confused readers
+    Michael Kerrisk
+        Make it clearer near the start of the page that sysfs(2) is obsolete
+
+timer_create.2
+    Michael Kerrisk
+        Strengthen the warning about use of printf() in the example program
+    Michael Kerrisk
+        Update cross reference: signal(7) should be signal-safety(7)
+
+umount.2
+    NeilBrown
+        Revise MNT_FORCE description
+            MNT_FORCE does not allow a busy filesystem to be unmounted.  Only
+            MNT_DETACH allows that.  MNT_FORCE only tries to abort pending
+            transactions, in the hope that might help umount not to block,
+
+            Also, other filesystems than NFS support MNT_FORCE.
+
+unshare.2
+    Eugene Syromyatnikov
+        Update pointer to in-kernel unshare documentation
+
+wait.2
+    Michael Kerrisk  [Ильдар Низамов]
+        POSIX.1-2008 TC1 clarifies treatment of 'si_pid' for waitid() WNOHANG
+
+cmsg.3
+    Sukadev Bhattiprolu
+        Add a scatter/gather buffer to sample code
+    Michael Kerrisk
+        Reorganize the text somewhat (no content changes)
+
+crypt.3
+    Konstantin Shemyak  [Michael Kerrisk]
+        Add description of previously undocumented 'rounds' parameter
+    Konstantin Shemyak
+        Encryption isn't done with SHA-xxx, but with a function based on SHA-xxx
+    Konstantin Shemyak
+        Clarify that ending of the salt string with '$' is optional
+
+exit.3
+    Michael Kerrisk
+        Mention the prctl(2) PR_SET_PDEATHSIG operation
+    Michael Kerrisk
+        SEE ALSO: add get_robust_list(2)
+    Michael Kerrisk
+        Add a heading to delimit discussion of signals sent to other processes
+
+exp2.3
+    Alex Henrie
+        Remove C89 designation
+
+log1p.3
+    Alex Henrie
+        Document fixes to give EDOM or ERANGE on error
+
+matherr.3
+    Michael Kerrisk
+        Note that glibc 2.27 removes the 'matherr' mechanism
+    Michael Kerrisk
+        Remove crufty feature test macro requirements
+
+pow10.3
+    Michael Kerrisk
+        Note that pow10() is now obsolete in favor of exp10()
+            Also, the pow10() functions are no longer supported by glibc,
+            starting with version 2.27.
+
+sincos.3
+    Michael Kerrisk
+        Note that sincos() is intended to be more efficient than sin() + cos()
+
+cciss.4
+hpsa.4
+    Eugene Syromyatnikov  [Don Brace, Meelis Roos]
+        Mention cciss removal in Linux 4.14
+            During the Linux 4.13 development cycle, the cciss driver has been
+            removed in favor of the hpsa driver, which has been amended with
+            some legacy board support.
+
+initrd.4
+proc.5
+bootparam.7
+    Eugene Syromyatnikov
+        Update pointer to in-kernel initrd documentation
+
+initrd.4
+    Eugene Syromyatnikov
+        Update pointer to in-kernel root over NFS documentation
+
+intro.4
+    Michael Kerrisk
+        SEE ALSO: add mknod(1) and mknod(2)
+
+host.conf.5
+    Michael Kerrisk
+        Add cross-reference to hosts(5)
+
+locale.5
+    Marko Myllynen
+        Refer to existing locales for encoding details
+            Since I don't think it would make sense to try to have different
+            explanation for each glibc version on the locale(5) man page, I'm
+            proposing that we apply the below patch so that we refer to
+            existing locale definition files in general and not spell out the
+            exact format or any certain locale as a definitive guideline.
+
+nologin.5
+    Michael Kerrisk
+        Add a sentence explaining why nologin is useful
+
+proc.5
+    Eugene Syromyatnikov
+        Document removal of htab-reclaim sysctl file
+            This PPC-specific sysctl option has been removed in Linux 2.4.9.2,
+            according to historic Linux repository commit log.
+    Eugene Syromyatnikov
+        Add description for cpuN lines in /proc/stat
+    Eugene Syromyatnikov
+        Add description for softirq line in /proc/stat
+    Eugene Syromyatnikov
+        Document removal of timer_stats file
+    Michael Kerrisk
+        Note Linux 4.9 changes to privileges for /proc/[pid]/timerslack_ns
+    Michael Kerrisk
+        Show command used to mount /proc
+    Michael Kerrisk
+        Explicitly note in intro that some /proc files are writable
+    Eugene Syromyatnikov
+        Update pointer to in-kernel SysRq documentation
+    Michael Kerrisk
+        SEE ALSO: add sysfs(5)
+    Eugene Syromyatnikov
+        Update pointer to in-kernel security keys documentation
+    Benjamin Peterson
+        Fix path to binfmt_misc docs
+    Eugene Syromyatnikov
+        Update pointer to in-kernel MTRR documentation
+    Eugene Syromyatnikov
+        Update reference to kernel's crypto API documentation
+
+tzfile.5
+    Paul Eggert
+        Sync from tzdb upstream
+            This makes tzfile.5 a copy of the tzdb version, except that the
+            tzdb version's first line is replaced by man-pages boilerplate.
+            The new version documents version 3 format, among other things.
+            Also, it removes the "Summary of the timezone information file
+            format" section, which should no longer be needed due to
+            improvements in the the part of the man page.
+
+capabilities.7
+    Michael Kerrisk
+        Note semantics for a program that is set-UID-root and has capabilities
+            Note semantics for a program that is both set-user-ID-root and has
+            file capabilities.
+    Michael Kerrisk  [Dennis Knorr]
+        Note that a set-UID-root program may have an empty file capabilite set
+
+cgroups.7
+    Michael Kerrisk
+        SEE ALSO: systemd-cgls(1)
+
+cpuset.7
+    Eugene Syromyatnikov
+        Update pointer to in-kernel cpusets documentation
+
+keyrings.7
+    Eugene Syromyatnikov
+        Document description restriction for logon keys
+            "logon" type has additional check that enforces colon-separated
+            prefix in key descriptions.
+    Eugene Syromyatnikov
+        Add pointers to kernel's documentation
+            Mostly because of assymmetric-keys.txt, which is outside
+            security/keys for some reason.
+
+man-pages.7
+    Michael Kerrisk
+        Expand the guidance on formatting code snippets
+
+netlink.7
+    David Wilder
+        Change buffer size in example code about reading netlink message
+    Michael Kerrisk  [Rick Jones]
+        Add a comment on 8192 buffer size in example code
+
+pthreads.7
+    Michael Kerrisk
+        SEE ALSO: add pthread_mutexattr_destroy(3) and pthread_mutexattr_init(3)
+
+signal.7
+    Michael Kerrisk
+        Since glibc 2.26, SIGUNUSED is no longer defined
+
+tcp.7
+    Vincent Bernat
+        tcp_tw_recycle is removed from Linux 4.12
+            And it is completely broken.
+
+unicode.7
+    Eugene Syromyatnikov
+        Update pointer to in-kernel Unicode terminal support documentation