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

1 files changed, 492 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 8c9d78f85..38da83271 100644
--- a/Changes.old
+++ b/Changes.old
@@ -50568,3 +50568,495 @@ vsock.7
 ldconfig.8
     DJ Delorie
         Document file filter and symlink pattern expectations
+
+
+==================== Changes in man-pages-5.06 ====================
+
+Released: 2020-04-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:
+
+Alejandro Colomar <colomar.6.4.3@gmail.com>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexander Miller <alex.miller@gmx.de>
+Andrea Arcangeli <aarcange@redhat.com>
+André Almeida <andrealmeid@collabora.com>
+Andrei Vagin <avagin@gmail.com>
+Andrew Micallef <andrew.micallef@live.com.au>
+Bart Van Assche <bvanassche@acm.org>
+Benjamin Peterson <benjamin@python.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Christian Brauner <christian@brauner.io>
+devi R.K <devi.feb27@gmail.com>
+Dmitry Safonov <dima@arista.com>
+Eric Biggers <ebiggers@google.com>
+Eric Dumazet <eric.dumazet@gmail.com>
+Eric Rannaud <e@nanocritical.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helge Deller <deller@gmx.de>
+Jakub Wilk <jwilk@jwilk.net>
+Jorgen Hansen <jhansen@vmware.com>
+Julia Suvorova <jusual@mail.ru>
+Keno Fischer <keno@juliacomputing.com>
+Krzysztof Małysa <varqox@gmail.com>
+Marc Lehmann <debian-reportbug@plan9.de>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Michael Galassi <michael@galassi.us>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@kernel.org>
+Mike Christie <mchristi@redhat.com>
+Mike Frysinger <vapier@gentoo.org>
+Pablo M. Ronchi <pmronchi@yahoo.com.ar>
+Ricardo Biehl Pasquali <pasqualirb@gmail.com>
+Stefan Hajnoczi <stefanha@redhat.com>
+Stefano Garzarella <sgarzare@redhat.com>
+Thomas Gleixner <tglx@linutronix.de>
+Walter Harms <wharms@bfs.de>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+openat2.2
+    Aleksa Sarai  [Michael Kerrisk]
+        Document new openat2(2) syscall
+
+pidfd_getfd.2
+    Michael Kerrisk  [Christian Brauner]
+        New manual page documenting the pidfd_getfd() system call
+
+select.2
+    Michael Kerrisk
+        Rewrite DESCRIPTION
+            Improve structure and readability, at the same time incorporating
+            text and details that were formerly in select_tut(2). Also
+            move a few details in other parts of the page into DESCRIPTION.
+    Michael Kerrisk
+        Consolidate the discussion of pselect into a headed subsection
+    Michael Kerrisk
+        Consolidate historical glibc pselect() details under one subhead
+    Michael Kerrisk
+        Consolidate info on usleep() emulation in one place
+    Michael Kerrisk
+        Place the discussion of the self-pipe technique in a headed subsection
+    Michael Kerrisk
+        Note that FD_SET() and FD_CLR() do not return errors
+    Michael Kerrisk
+        Remove details of historical #include requirements
+            The POSIX situation has been the norm for a long time now,
+            and including ancient details overcomplicates the page.
+    Michael Kerrisk
+        Remove some ancient information about pre-POSIX types for 'timeout'
+
+select_tut.2
+    Michael Kerrisk
+        Eliminate duplication of info across select_tut.2 and select2
+            There was a lot of a duplication of info in SYNOPSIS, DESCRIPTION
+            RETURN VALUE, and SEE ALSO. Move all of the info to one place:
+            the select(2) page.
+
+sysvipc.7
+    Michael Kerrisk
+        Rewrite this page as just a summary of the System V IPC APIs
+            All of the other details in this page have by now been moved into
+            the relevant *ctl(2) pages.
+
+time_namespaces.7
+    Michael Kerrisk  [Andrei Vagin, Dmitry Safonov, Thomas Gleixner]
+        New page documenting time namespaces
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+arch_prctl.2
+    Keno Fischer
+        Add ARCH_SET_CPUID subcommand
+
+clock_getres.2
+    Benjamin Peterson
+        Document CLOCK_TAI
+    Michael Kerrisk
+        Add CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM
+
+prctl.2
+    Mike Christie  [Michal Hocko, Michael Kerrisk, Bart Van Assche]
+        Document PR_SETIO_FLUSHER/GET_IO_FLUSHER
+
+setns.2
+    Michael Kerrisk
+        Document CLONE_NEWTIME
+
+statx.2
+    Eric Biggers
+        Document STATX_ATTR_VERITY
+
+unshare.2
+    Michael Kerrisk
+        Document CLONE_NEWTIME
+
+socket.7
+    Ricardo Biehl Pasquali, Michael Kerrisk
+        Add description of SO_SELECT_ERR_QUEUE
+    Alejandro Colomar  [Michael Kerrisk]
+        Document SO_TIMESTAMPNS
+
+
+Global changes
+--------------
+
+Various pages
+    Michael Kerrisk
+        Remove a few mentions of the ancient "Linux libc"
+
+Various pages
+    Michael Kerrisk
+        Global formatting fix: disfavor nonstandard .TP indents
+            In many cases, these don't improve readability, and (when stacked)
+            they sometimes have the side effect of sometimes forcing text
+            to be justified within a narrow column range.
+
+Various pages
+    Michael Kerrisk  [Christian Brauner]
+        Fix clumsy wording around "nonnegative file descriptors"
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+    Helge Deller  [Michael Kerrisk]
+        Consecutive calls for CLOCK_MONOTONIC may return same value
+            Consecutive calls to clock_gettime(CLOCK_MONOTONIC) are guaranteed
+            to return MONOTONIC values, which means that they either return
+            the *SAME* time value like the last call, or a later (higher) time
+            value.
+    Eric Rannaud
+        Dynamic POSIX clock devices can return other errors
+    Michael Kerrisk
+        Improve description of CPU-time clocks
+    Michael Kerrisk
+        Add an example program
+    Michael Kerrisk
+        CLOCK_REALTIME_COARSE is not settable
+    Michael Kerrisk
+        Note that CPU-time clocks are not settable.
+            Explicitly note that CLOCK_PROCESS_CPUTIME_ID and
+            CLOCK_PROCESS_CPUTIME_ID are not settable.
+    Michael Kerrisk
+        Clarify that CLOCK_TAI is nonsettable
+    Michael Kerrisk
+        Clarify that CLOCK_MONOTONIC is system-wide
+    Michael Kerrisk
+        ERRORS: add EINVAL for attempt to set a nonsettable clock
+    Michael Kerrisk
+        Move text in BUGS to NOTES
+            The fact that CLOCK_PROCESS_CPUTIME_ID and
+            CLOCK_PROCESS_CPUTIME_ID are not settable isn't a bug,
+            since POSIX does allow the possibility that these clocks
+            are not settable.
+    Michael Kerrisk
+        SEE ALSO: add time_namespaces(7)
+
+clock_nanosleep.2
+    Michael Kerrisk
+        clock_nanosleep() can also sleep against CLOCK_TAI
+    Michael Kerrisk
+        clock_nanosleep() also supports CLOCK_BOOTTIME
+            Presumably (and from a quick glance at the source code)
+            since Linux 2.6.39, when CLOCK_BOOTTIME was introduced.
+
+clock_nanosleep.2
+timer_create.2
+timerfd_create.2
+    Michael Kerrisk
+        Add various missing errors
+            Mostly verified by testing and reading the code.
+
+            There is unfortunately quite a bit of inconsistency across API~s:
+
+                              clock_gettime  clock_settime  clock_nanosleep  timer_create  timerfd_create
+
+            CLOCK_BOOTTIME            y        n (EINVAL)     y                y             y
+            CLOCK_BOOTTIME_ALARM      y        n (EINVAL)     y [1]            y [1]         y [1]
+            CLOCK_MONOTONIC           y        n (EINVAL)     y                y             y
+            CLOCK_MONOTONIC_COARSE    y        n (EINVAL)     n (ENOTSUP)      n (ENOTSUP)   n (EINVAL)
+            CLOCK_MONOTONIC_RAW       y        n (EINVAL)     n (ENOTSUP)      n (ENOTSUP)   n (EINVAL)
+            CLOCK_REALTIME            y        y              y                y             y
+            CLOCK_REALTIME_ALARM      y        n (EINVAL)     y [1]            y [1]         y [1]
+            CLOCK_REALTIME_COARSE     y        n (EINVAL)     n (ENOTSUP)      n (ENOTSUP)   n (EINVAL)
+            CLOCK_TAI                 y        n (EINVAL)     y                y             n (EINVAL)
+            CLOCK_PROCESS_CPUTIME_ID  y        n (EINVAL)     y                y             n (EINVAL)
+            CLOCK_THREAD_CPUTIME_ID   y        n (EINVAL)     n (EINVAL [2])   y             n (EINVAL)
+            pthread_getcpuclockid()   y        n (EINVAL)     y                y             n (EINVAL)
+
+            [1] The caller must have CAP_WAKE_ALARM, or the error EPERM results.
+
+            [2] This error is generated in the glibc wrapper.
+
+connect.2
+    Michael Kerrisk  [Eric Dumazet]
+        Update the details on AF_UNSPEC
+            Update the details on AF_UNSPEC and circumstances in which
+            socket can be reconnected.
+
+dup.2
+    Michael Kerrisk
+        SEE ALSO: add pidfd_getfd(2)
+
+epoll_ctl.2
+    Michael Kerrisk
+        Various minor additions and clarifications
+
+epoll_wait.2
+    Michael Kerrisk
+        A few minor additions and rewrites
+
+execve.2
+    Michael Kerrisk
+        Add a subhead for the discussion of effect on process attributes
+    Michael Kerrisk
+        Explicitly note that argv[argc] == NULL in the new program
+    Michael Kerrisk
+        ERRORS: ENOENT does not occur for missing shared libraries
+            See http://sourceware.org/bugzilla/show_bug.cgi?id=12241.
+
+_exit.2
+    Michael Kerrisk
+        Clarify that raw _exit() system call terminates only the calling thread
+
+inotify_add_watch.2
+    Michael Kerrisk
+        EXAMPLE: add reference to example in inotify(7)
+
+io_submit.2
+    Julia Suvorova
+        Add IOCB_CMD_POLL opcode
+
+lseek.2
+    Michael Kerrisk
+        ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file
+
+madvise.2
+    Michael Kerrisk  [Andrea Arcangeli]
+        Incorporate some (ancient) comments about MADV_HUGEPAGE
+            Back in 2011, a mail from Andrea Arcangeli noted some details
+            that I never got round to incorporating into the manual page.
+
+mmap.2
+    Michael Kerrisk
+        Add a subhead for the 'flags' argument
+    Michael Kerrisk
+        Move some text hidden at the end of DESCRIPTION to NOTES
+
+msgctl.2
+    Michael Kerrisk
+        Add information on permission bits (based on sysvipc(7) text)
+    Michael Kerrisk
+        Copy information on 'msqid_ds' fields from sysvipc(7)
+
+open.2
+    Michael Kerrisk
+        Clarify that O_NOFOLLOW is relevant (only) for basename of 'pathname'
+    Aleksa Sarai
+        Add references to new openat2(2) page
+    Michael Kerrisk
+        Note EINVAL error for invalid character in basename of 'pathname'
+
+pidfd_open.2
+    Michael Kerrisk
+        Mention pidfd_getfd(2)
+
+poll.2
+    Michael Kerrisk
+        Add an example program
+    Michael Kerrisk
+        Mention epoll(7) in the introductory paragraph
+    Michael Kerrisk
+        Improve description of EFAULT error
+    Michael Kerrisk
+        Fix description of ENOMEM error
+
+select_tut.2
+    Michael Kerrisk
+        Adjust header file includes in example
+            Employ <sys/select.h>, rather than the historical header files.
+
+semctl.2
+    Michael Kerrisk
+        Copy information on 'semid_ds' fields from sysvipc(7)
+    Michael Kerrisk
+        Add a reference to the example in shmop(2)
+    Michael Kerrisk
+        Add information on permission bits (based on sysvipc(7) text)
+
+semget.2
+    Michael Kerrisk
+        EXAMPLE: add an example program
+
+semop.2
+    Michael Kerrisk
+        Add a reference to the semop(2) example in shmop(2)
+
+shmctl.2
+    Michael Kerrisk
+        Add information on permission bits (based on sysvipc(7) text)
+    Michael Kerrisk
+        Note that execute permission is not needed for shmat() SHM_EXEC
+    Michael Kerrisk
+        Copy information on 'shmid_ds' fields from sysvipc(7)
+    Michael Kerrisk
+        Some small improvements to the description of the 'shmid_ds' structure
+
+shmget.2
+    Michael Kerrisk
+        Add a reference to the example in shmop(2)
+
+shmop.2
+    Michael Kerrisk
+        EXAMPLE: add a pair of example programs
+            Add example programs demonstrating usage of shmget(2), shmat(2),
+            semget(2), semctl(2), and semop(2).
+
+sigaction.2
+signal.7
+    Zack Weinberg
+        Document kernel bugs in delivery of signals from CPU exceptions
+
+stat.2
+    Michael Kerrisk
+        Clarify definitions of timestamp fields
+            In particular, make it clear that atime and mtime relate to the
+            file *data*.
+
+syscalls.2
+    Michael Kerrisk
+        Add new Linux 5.6 system calls
+    Michael Kerrisk
+        Note that the 5.x series followed 4.20
+
+timer_create.2
+    Michael Kerrisk
+        timer_create(2) also supports CLOCK_TAI
+    Michael Kerrisk
+        Mention clock_getres(2) for further details on the various clocks
+
+timerfd_create.2
+    Michael Kerrisk  [Thomas Gleixner]
+        Note a case where timerfd_settime() can fail with ECANCELED
+    Michael Kerrisk  [devi R.K, Thomas Gleixner]
+        Negative changes to CLOCK_REALTIME may cause read() to return 0
+    Michael Kerrisk
+        Rework text for EINVAL for invalid clock ID
+    Michael Kerrisk
+        Refer reader to clock_getres(2) for further details on the clocks
+
+unshare.2
+    Michael Kerrisk
+        Add CLONE_NEWCGROUP and CLONE_NEWTIME to example program
+
+exit.3
+    Michael Kerrisk  [Walter Harms]
+        Small improvement to the discussion of 'status' argument
+
+ftok.3
+    Michael Kerrisk
+        EXAMPLE: add a reference to the example in semget(2)
+
+getifaddrs.3
+    Michael Kerrisk  [Michael Galassi]
+        EXAMPLE: remove unneeded loop variable
+
+nl_langinfo.3
+    Eugene Syromyatnikov
+        Document era-related locale elements
+    Eugene Syromyatnikov
+        Add information about AM/PM time format locale elements
+    Eugene Syromyatnikov
+        Mention the respective strftime(3) conversion specifications
+
+sem_init.3
+    Michael Kerrisk
+        Add references to example code in shm_open(3) and sem_wait(3)
+
+sem_post.3
+    Michael Kerrisk
+        Add a reference to code example code in shm_open(3)
+
+shm_open.3
+    Michael Kerrisk
+        EXAMPLE: add some example programs
+
+strcmp.3
+    Michael Kerrisk
+        Add an example program
+    Michael Kerrisk  [Andrew Micallef, Walter Harms]
+        Rework text describing return value to be clearer
+    Michael Kerrisk
+        Note that the comparison is done using unsigned char
+    Michael Kerrisk
+        SEE ALSO: add ascii(7)
+
+strftime.3
+    Eugene Syromyatnikov  [Michael Kerrisk]
+        Refer to the relevant nl_langinfo(3) items
+    Eugene Syromyatnikov
+        Expand %E and %O description
+    Eugene Syromyatnikov
+        Consistently document fall-back format string
+
+proc.5
+    Mike Frysinger
+        Clarify /proc/[pid]/cmdline mutability
+
+cgroups.7
+    Michael Kerrisk
+        Update list of cgroups v2 controllers
+            Update the list of cgroups v2 controllers (several controllers
+            were missing).
+    Michael Kerrisk
+        Add a subsection on cgroup v2 mount options and include 'nsdelegate'
+    Michael Kerrisk
+        Document the cgroups v2 'memory_localevents' mount option
+    Michael Kerrisk
+        SEE ALSO: add Documentation/admin-guide/cgroup-v2.rst
+
+namespaces.7
+    Michael Kerrisk
+        Add time namespaces information
+    Michael Kerrisk
+        Eliminate some superfluous info from display of /proc/PID/ns links
+
+path_resolution.7
+    Aleksa Sarai
+        Update to mention openat2(2) features
+
+socket.7
+    Michael Kerrisk
+        Note SCM message types for SO_TIMESTAMP and SO_TIMESTAMPNS
+
+tcp.7
+    Michael Kerrisk
+        SEE ALSO: mention Documentation/networking/ip-sysctl.txt
+
+time.7
+    Michael Kerrisk
+        Add small subsection on clocks and time namespaces
+
+unix.7
+    Heinrich Schuchardt
+        Correct example
+
+vsock.7
+    Stefano Garzarella  [Jorgen Hansen, Stefan Hajnoczi]
+        Add VMADDR_CID_LOCAL description