Changes: Tweaks

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

1 files changed, 465 insertions, 10 deletions

diff --git a/Changes b/Changes
index e59876115..4aca6118b 100644
--- a/Changes
+++ b/Changes
@@ -10,26 +10,481 @@ 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:
 
+Alex Henrie <alexhenrie24@gmail.com>
+Andi Kleen <andi-bz.firstfloor.org>
+Arjun Shankar <arjun.is@lostca.se>
+Brad Bendily <bendily@gmail.com>
+Cameron Wright <wright18@uw.edu>
+Carlos O'Donell <carlos@redhat.com>
+Darrick J. Wong <darrick.wong@oracle.com>
+David Lewis <davlewi3@cisco.com>
+DJ Delorie <dj@delorie.com>
+Douglas Caetano dos Santos <douglascs@taghos.com.br>
+Dr. Tobias Quathamer <toddy@debian.org>
+Eric Biggers <ebiggers@google.com>
+Ferdinand Thiessen <f.thiessen@gmx.de>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Henry Bent <henry.r.bent@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Janne Snabb <snabb@epipe.com>
+Joe Brown <joe.brown.89@outlook.com>
+Jorge Nerin <jnerin@gmail.com>
+Kirill Tkhai <ktkhai@virtuozzo.com>
+lilydjwg <lilydjwg@gmail.com>
+Long Wang <w@laoqinren.net>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@chromium.org>
+Nadav Har'El <nyh@math.technion.ac.il>
+NeilBrown <neilb@suse.com>
+Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
+Quentin Rameau <quinq@fifth.space>
+Ruben Kerkhof <ruben@rubenkerkhof.com>
+sulit <sulitsrc@foxmail.com>
+石井大貴 <hiroki.ishii@miraclelinux.com>
 
 Apologies if I missed anyone!
 
 
-New and rewritten pages
------------------------
-
-
 Newly documented interfaces in existing pages
 ---------------------------------------------
 
+namespaces.7
+    Kirill Tkhai  [Michael Kerrisk]
+        Document the /proc/[pid]/ns/pid_for_children file
 
-New and changed links
----------------------
 
+Changes to individual pages
+---------------------------
 
-Global changes
---------------
+ldd.1
+    Michael Kerrisk
+        'objdump -p prog | grep NEEDED' doesn't give quite same info as 'ldd'
 
+chmod.2
+    Michael Kerrisk
+        Put fchmod() feature test macro requirements in a more readable format
+    Michael Kerrisk
+        Note glibc 2.24 feature test macro requirements changes for fchmod()
 
-Changes to individual pages
----------------------------
+chown.2
+    Michael Kerrisk
+        When file owner or group is changed, file capabilities are cleared
+    Michael Kerrisk
+        Changes to file owner by root also clear set-UID and set-GID bits
+
+clone.2
+    Michael Kerrisk
+        Update BUGS to reflect fact that PID caching was removed in glibc 2.25
+
+epoll_wait.2
+    Michael Kerrisk
+        Clarify semantics of returned 'data' field
+            The returned 'data' is the 'data' most recently set via
+            epoll_ctl().
+
+get_mempolicy.2
+    Michael Kerrisk  [Nadav Har'El, Andi Kleen]
+        SYNOPSIS: fix return type of get_mempolicy()
+            See https://bugzilla.kernel.org/show_bug.cgi?id=97051
+
+getpid.2
+    Carlos O'Donell, Michael Kerrisk
+        Note that PID caching is removed as of glibc 2.25
+            Since glibc 2.25 the PID cache is removed.
+
+            Rationale given in the release notes:
+            https://sourceware.org/glibc/wiki/Release/2.25#pid_cache_removal
+
+ioctl.2
+    Michael Kerrisk
+        SEE ALSO: add ioctl_getfsmap(2)
+
+ioctl_getfsmap.2
+    Michael Kerrisk
+        Fix ordering of sections
+    Michael Kerrisk
+        Add VERSIONS section
+
+ioctl_getfsmap.2
+    Darrick J. Wong
+        Document the GETFSMAP ioctl
+            Document the new GETFSMAP ioctl that returns the physical layout of a
+            (disk-based) filesystem.
+    Michael Kerrisk
+        ERRORS: order alphabetically
+
+madvise.2
+    Michael Kerrisk
+        Remove bogus text re POSIX_MADV_NOREUSE
+            There is a POSIX_FADV_NOREUSE for posix_fadvise(),
+            but no POSIX_MADV_NOREUSE for any API in POSIX.
+
+membarrier.2
+    Michael Kerrisk
+        Add ENOSYS error for 'nohz_full' CPU setting
+
+mount.2
+    NeilBrown
+        Revise description of MS_REMOUNT | MS_BIND
+            MS_REMOUNT|MS_BIND affects all per-mount-point
+            flag.  MS_RDONLY is only special because it,
+            uniquely, is both a per-mount-point flag *and* a
+            per-filesystem flag.
+
+            So the sections of per-mount-point flags and
+            MS_REMOUNT can usefully be clarified.
+
+open.2
+    Michael Kerrisk
+        Note some further advantages of the *at() APIs
+
+pipe.2
+    Michael Kerrisk
+        SEE ALSO: add tee(2) and vmsplice(2)
+
+readv.2
+    Michael Kerrisk
+        glibc 2.26 adds library support for preadv2() and pwritev2()
+
+sched_setaffinity.2
+    Michael Kerrisk
+        Mention cpuset cgroups as a cause of EINVAL error
+
+seccomp.2
+    Mike Frysinger
+        Expand SECCOMP_RET_KILL documentation
+
+sigaction.2
+    Michael Kerrisk
+        Note feature test macro requirements for 'si_code' constants
+    Michael Kerrisk
+        Add a subheading for the description of 'si_code'
+    Michael Kerrisk
+        TRAP_BRANCH and TRAP_HWBKPT are present only on IA64
+
+sigaltstack.2
+    Michael Kerrisk
+        Note that specifying SS_ONSTACK in ss.ss_flags decreases portability
+            In the Illumos source (which presumably mirrors its Solaris
+            ancestry), there is this check in the sigaltstack()
+            implementation:
+
+                           if (ss.ss_flags & ~SS_DISABLE)
+                                    return (set_errno(EINVAL));
+
+            And in the FreeBSD source we find similar:
+
+                            if ((ss->ss_flags & ~SS_DISABLE) != 0)
+                                    return (EINVAL);
+    Michael Kerrisk
+        Note buggy addition of ss.ss_flags==SS_ONSTACK
+            Note buggy addition of ss.ss_flags==SS_ONSTACK as a synonym
+            for ss_flags==0. No other implemenation does this, AFAIK.
+            And it was not needed :-(.
+    Michael Kerrisk
+        Specifying 'ss' returns the current settings without changing them
+    Michael Kerrisk
+        Give 'oss' argument a more meaningful name: 'old_ss'
+    Michael Kerrisk
+        Some minor reworking of the text
+    Michael Kerrisk
+        ERRORS: update description of EINVAL error
+
+splice.2
+tee.2
+vmsplice.2
+    Michael Kerrisk
+        SEE ALSO: add pipe(7)
+
+splice.2
+    Michael Kerrisk
+        ERRORS: split EINVAL error cases
+    Michael Kerrisk
+        ERRORS: add EINVAL for case where both descriptors refer to same pipe
+
+timer_create.2
+    Michael Kerrisk
+        Document the CONFIG_POSIX_TIMERS option added in Linux 4.10
+
+wait.2
+    Michael Kerrisk
+        Note glibc 2.26 changes to feature test macro requirements for waitid()
+
+acosh.3
+asinh.3
+atanh.3
+    Alex Henrie
+        Remove C89 designation.
+            See https://bugzilla.kernel.org/show_bug.cgi?id=196319
+
+            [mtk: confirmed from review of draft of C90 standard]
+
+bsd_signal.3
+    Michael Kerrisk
+        Note feature test macro requirements changes for glibc 2.26
+
+dl_iterate_phdr.3
+    Michael Kerrisk
+        dl_iterate_phdr() shows the order in which objects were loaded
+            dl_iterate_phdr() tells us not just which objects are
+            loaded, but also the order in which they are loaded
+            (the "link-map order"). Since the order is relevant for
+            understanding symbol resolution, give the reader this clue.
+    Michael Kerrisk
+        Expand the code example, and show sample output
+    Michael Kerrisk
+        List values for the 'p_type' field
+
+dlsym.3
+    Michael Kerrisk
+        _GNU_SOURCE is needed to get RTLD_DEFAULT and RTLD_NEXT definitions
+
+flockfile.3
+    Michael Kerrisk
+        Note glibc 2.24 feature test macro requirement changes
+
+fpathconf.3
+    Michael Kerrisk
+        Rework RETURN VALUE description to add more detail
+    Michael Kerrisk
+        Add an errors section
+    Michael Kerrisk
+        Largely rewrite the description of _PC_CHOWN_RESTRICTED
+    Michael Kerrisk
+        Rewrite description of _PC_PIPE_BUF
+            The existing description was not accurate, and lacked details.
+
+ftw.3
+    Michael Kerrisk
+        BUGS: document a probable glibc regression in FTW_SLN case
+            See https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+            and http://austingroupbugs.net/view.php?id=1121.
+
+getaddrinfo.3
+    Quentin Rameau
+        Fix _POSIX_C_SOURCE value for getaddrinfo()
+            The correct _POSIX_C_SOURCE value is 200112L, not 201112L in features.h.
+
+getcontext.3
+    Carlos O'Donell
+        Exemplar structure should use 'ucontext_t'.
+            In glibc we just finished a round of purging 'struct ucontext'
+            which is not in the POSIX reserved namespace of *_t tags. This has
+            some consequences to applications using the non-standard struct
+            ucontext:
+            https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
+            but it also fixes a namespace conformance issue which is always a
+            longterm pain for large portable programs.
+
+            It was noted by Peter Maydell
+            (https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
+            linux man pages still had references to 'struct ucontext' but only
+            in the form of an exemplar structure.
+
+            The patch fixes the exemplar to match what is in glibc
+            and therefore it won't ever suggest users can use 'struct
+            ucontext'.
+
+getgrent.3
+    Michael Kerrisk
+        Note glibc 2.22 changes for feature test macro requirements
+
+grantpt.3
+ptsname.3
+unlockpt.3
+    Ferdinand Thiessen  [Michael Kerrisk]
+        Update feature test macro-requirements for glibc 2.24
+
+if_nametoindex.3
+    Douglas Caetano dos Santos
+        Add ENODEV error for if_nametoindex()
+            Checked against glibc and kernel code: when given name isn't
+            a valid interface, kernel returns ENODEV and glibc just
+            forwards it.
+
+malloc.3
+    Michael Kerrisk
+        Document the reallocarray() added in glibc 2.26
+
+nl_langinfo.3
+    Michael Kerrisk
+        Note feature test macro requirements for nl_langinfo_l()
+
+posix_madvise.3
+    Dr. Tobias Quathamer
+        Remove paragraph about POSIX_FADV_NOREUSE
+            POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
+            corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.
+
+            Thanks to Marc Lehmann <debian-reportbug@plan9.de>
+            See https://bugs.debian.org/865699
+
+ptsname.3
+    Michael Kerrisk  [Arjun Shankar]
+        Since glibc 2.26, ptsname_r() no longer gives EINVAL for buf==NULL
+
+rand.3
+    Michael Kerrisk
+        Note glibc 2.24 feature test macro requirement changes for rand_r()
+
+resolver.3
+    Michael Kerrisk
+        Add basic notes on 'op' argument of res_nmkquery() and res_mkquery()
+
+sigpause.3
+    Michael Kerrisk
+        Note glibc 2.26 changes to feature test macro requirements
+
+sigwait.3
+    Michael Kerrisk
+        Note glibc 2.26 feature test macro changes
+
+strtol.3
+    Heinrich Schuchardt
+        Mention 0X prefix
+            The prefix 0x may be capitalized as 0X.
+
+            See ISO/IEC 9899:1999.
+
+sysconf.3
+    Michael Kerrisk  [Pavel Tikhomirov]
+        Rework RETURN VALUE description to add more detail
+            Make the discussion clearer, and add a few details.
+            Also, fix the problem report from Pavel Tikhomirov
+            who noted that the man page falsely said that errno
+            is not changed on a successful return.
+
+            Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955
+
+sysconf.3
+    Michael Kerrisk
+        Add ERRORS section
+
+ttyslot.3
+    Michael Kerrisk
+        Fix error in feature test macro requirements
+    Michael Kerrisk
+        Note feature test macro requirements changes in glibc 2.24
+    Michael Kerrisk
+        Clarify details of use of <stdlib.h> file
+
+unlocked_stdio.3
+    Michael Kerrisk
+        Note glibc 2.24 feature test macro requirement changes
+
+elf.5
+    Michael Kerrisk
+        SEE ALSO: add dl_iterate_phdr(3)
+
+nsswitch.conf.5
+    DJ Delorie
+        Clarify group merge rules
+            This minor patch clarifies when merging is not done,
+            and how duplicate entries are merged.
+
+            Found while extending glibc's NSS test suite, discussed with glibc
+            team and Stephen Gallagher.
+
+proc.5
+    Michael Kerrisk
+        Document that 'iowait' field of /proc/stat is unreliable
+            Text taken from Chao Fan's kernel commit 9c240d757658a3ae996.
+
+slabinfo.5
+    Michael Kerrisk  [Jorge Nerin]
+        SEE ALSO: add some references to relevant kernel source files
+
+tmpfs.5
+    Michael Kerrisk
+        SEE ALSO: add memfd_create(2), mmap(2), shm_open(3)
+
+capabilities.7
+    Michael Kerrisk
+        Clarify the effect on process capabilities when UID 0 does execve(2)
+    Michael Kerrisk
+        Note effect on capabilities when a process with UID != 0 does execve(2)
+    Michael Kerrisk  [David Lewis]
+        Fix reversed descriptions of CAP_MAC_OVERRIDE and CAP_MAC_ADMIN
+    Michael Kerrisk
+        SEE ALSO: add filecap(8), netcap(8), pscap(8)
+
+cgroup_namespaces.7
+    Michael Kerrisk
+        Add some further explanation of the example shell session
+    Michael Kerrisk
+        Fix a bug in shell session example
+    Michael Kerrisk
+        Some minor wording fixes and clarifications
+
+inode.7
+    Michael Kerrisk
+        Note glibc 2.24 feature test macro changes for S_IFSOCK and S_ISSOCK()
+
+man.7
+    G. Branden Robinson
+        Undocument "URL" macro in man(7) in favor .UR+.UE
+
+pid_namespaces.7
+    Michael Kerrisk
+        Mention /proc/[pid]/ns/pid_for_children
+
+pipe.7
+    Michael Kerrisk
+        SEE ALSO: add tee(2) and vmsplice(2)
+
+sigevent.7
+    Michael Kerrisk
+        Mention signal.h header file
+
+signal.7
+    Michael Kerrisk  [lilydjwg]
+        Since Linux 3.8, read(2) on an inotify FD is restartable with SA_RESTART
+            See https://bugzilla.kernel.org/show_bug.cgi?id=195711
+    Michael Kerrisk
+        read() from an inotify FD is no longer interrupted by a stop signal
+            (Change was in Linux 3.8.)
+
+tcp.7
+    Michael Kerrisk
+        Document value '2' for tcp_timestamps
+            Since Linux 4.10, the value '2' is meaningful for tcp_timestamps
+    Ruben Kerkhof
+        Change default value of tcp_frto
+            The default changed in c96fd3d461fa495400df24be3b3b66f0e0b152f9
+            (Linux 2.6.24).
+
+ld.so.8
+    Michael Kerrisk
+        Greatly expand the explanation of LD_DYNAMIC_WEAK
+    Carlos O'Donell
+        Expand DT_RUNPATH details.
+            ld.so.8: Expand DT_RUNPATH details.
+
+            Every 3 years we get asked why DT_RUNPATH doesn't work like DT_RPATH.
+            The most recent question was here:
+            https://www.sourceware.org/ml/libc-help/2017-06/msg00013.html
 
+            We need to expand the description of DT_RUNPATH to cover this
+            situation and explain that the DT_RUNPATH entries apply only to the
+            immediate DT_NEEDED, not that of another, say dlopen'd child object.
+    Michael Kerrisk
+        Since glibc 2.2.5, LD_PROFILE is ignored in secure-execution mode
+    Michael Kerrisk
+        Make notes on secure-execute mode more prominent
+            Place each note on secure-execution mode in a separate
+            paragraph, to make it more obvious.
+    Michael Kerrisk
+        Note that libraries in standard directories are not normally set-UID
+            In secure mode, LD_PRELOAD loads only libraries from standard
+            directories that are marked set-UID. Note that it is unusual for
+            a library to be marked in this way.
+    Michael Kerrisk
+        SEE ALSO: add elf(5)
+    Michael Kerrisk
+        Note version where secure-execution started ignoring LD_USE_LOAD_BIAS
+    Michael Kerrisk
+        Correct glibc version that ignores LD_SHOW_AUXV in secure-execution mode
+            Ignored since 2.3.4 (not 2.3.5).
+    Michael Kerrisk
+        Rewrite LD_DEBUG_OUTPUT description and note that .PID is appended