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

1 files changed, 381 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index defd0c1f3..2a96d9428 100644
--- a/Changes.old
+++ b/Changes.old
@@ -47504,3 +47504,384 @@ sched.7
 user_namespaces.7
     Michael Kerrisk
         Mention NS_GET_OWNER_UID ioctl() operation
+
+
+==================== Changes in man-pages-4.16 ====================
+
+Released: 2018-04-30, 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>
+Andy Owen <andrew.owen@dolby.com>
+Carlos O'Donell <carlos@redhat.com>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Elvira Khabirova <lineprinter@altlinux.org>
+Enrique Garcia <cquike@arcor.de>
+Frederic Brault <fbrault@xyalis.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Howard Johnson <hwj@BridgeportContractor.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+John Hubbard <jhubbard@nvidia.com>
+Jürg Billeter <j@bitron.ch>
+Konstantin Grinemayer <cdlscpmv@gmail.com>
+Konstantin Khlebnikov <khlebnikov@yandex-team.ru>
+Martin Mares <mj@ucw.cz>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Mattias Andrée <maandree@kth.se>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mike Frysinger <vapier@gentoo.org>
+Nikos Mavrogiannopoulos <nmavrogi@redhat.com>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+Ross Zwisler <ross.zwisler@linux.intel.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Serge E. Hallyn <serge@hallyn.com>
+Song Liu <songliubraving@fb.com>
+Tomi Salminen <tsalminen@forcepoint.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+membarrier.2
+    Mathieu Desnoyers  [Michael Kerrisk]
+        Document new membarrier commands introduced in Linux 4.16
+            Document the following membarrier commands introduced in
+            Linux 4.16:
+
+                MEMBARRIER_CMD_GLOBAL_EXPEDITED
+                    (the old enum label MEMBARRIER_CMD_SHARED is now an
+                    alias to preserve header backward compatibility)
+                MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED
+                MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE
+                MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE
+
+mmap.2
+    Jan Kara  [Ross Zwisler, Michael Kerrisk]
+        Add description of MAP_SHARED_VALIDATE and MAP_SYNC
+    Michal Hocko  [John Hubbard, Michael Kerrisk, Jann Horn]
+        Document new MAP_FIXED_NOREPLACE flag
+            4.17+ kernels offer a new MAP_FIXED_NOREPLACE flag which allows
+            the caller to atomically probe for a given address range.
+
+readv.2
+io_submit.2
+    Jürg Billeter
+        Document RWF_APPEND added in Linux 4.16
+
+capabilities.7
+    Michael Kerrisk
+        Describe file capability versioning
+    Michael Kerrisk  [Serge E. Hallyn]
+        Document namespaced-file capabilities
+        [There's still more work to be done on this new text]
+
+
+Changes to individual pages
+---------------------------
+
+bpf.2
+    Michael Kerrisk
+        Update list of architectures that support JITed eBPF
+            And note kernel version numbers where support is added.
+    Michael Kerrisk
+        Kernel 4.15 added CONFIG_BPF_JIT_ALWAYS_ON
+            This causes the JIT compiler to be always on and
+            forces bpf_jit_enable to 1.
+
+execve.2
+    Michael Kerrisk
+        Note that describing execve as "executing a new process" is misleading
+            This misdescription is so common that it's worth calling it out
+            explicitly.
+    Michael Kerrisk
+        More explicitly describe effect of execve() in the opening paragraph
+
+fallocate.2
+    Michael Kerrisk
+        Since Linux 4.16, Btrfs supports FALLOC_FL_ZERO_RANGE
+
+getrlimit.2
+    Michael Kerrisk
+        CAP_SYS_RESOURCE capability is required in *initial user namespace*
+
+io_submit.2
+    Michael Kerrisk
+        Add kernel version numbers for various 'aio_rw_flags' flags
+    Michael Kerrisk
+        Place 'aio_rw_flags' in alphabetical order
+
+mmap.2
+    Jann Horn
+        MAP_FIXED is okay if the address range has been reserved
+            Clarify that MAP_FIXED is appropriate if the specified address
+            range has been reserved using an existing mapping, but shouldn't
+            be used otherwise.
+    Michael Kerrisk
+        Move the text on MAP_FIXED to NOTES
+            This text has become rather long, making it it somewhat
+            unwieldy in the discussion of the mmap() flags. Therefore,
+            move it to NOTES, with a pointer in DESCRIPTION referring
+            the reader to NOTES.
+    Michael Kerrisk  [Heinrich Schuchardt]
+        Clarify that when addr==NULL, address chosen by kernel is page-aligned
+    Michael Kerrisk
+        Add a little historical detail on the obsolete MAP_DENYWRITE
+
+mount.2
+    Michael Kerrisk
+        ERRORS: add EBUSY for the case of trying to stack same mount twice
+    Michael Kerrisk
+        Remove a couple of obsolete EBUSY errors
+            As far as I can tell, these EBUSY errors disappeared
+            with the addition of stackable mounts in Linux 2.4.
+
+msgget.2
+semget.2
+shmget.2
+    Michael Kerrisk
+        The purpose of "flags" == 0 is to obtain ID of an existing IPC object
+            This was implied in these pages, but the meaning of "flags" == 0
+            could be more explicit, as indicated by questions such as
+            https://stackoverflow.com/questions/49833569/flag-value-of-semget-function
+
+open.2
+    Jann Horn
+        Document more -ETXTBSY conditions
+    Jakub Wilk
+        Add missing argument for snprintf() in example code
+
+perf_event_open.2
+    Song Liu
+        Add type kprobe and uprobe
+            Two new types kprobe and uprobe are being added to
+            perf_event_open(), which allow creating kprobe or
+            uprobe with perf_event_open. This patch adds
+            information about these types.
+
+ptrace.2
+    Jann Horn
+        Copy retval info for SECCOMP_GET_FILTER to right section
+            The "RETURN VALUE" section made a claim that was incorrect for
+            PTRACE_SECCOMP_GET_FILTER. Explicitly describe the behavior of
+            PTRACE_SECCOMP_GET_FILTER in the "RETURN VALUE" section (as
+            usual), but leave the now duplicate description in the section
+            describing PTRACE_SECCOMP_GET_FILTER, since the
+            PTRACE_SECCOMP_GET_FILTER section would otherwise probably become
+            harder to understand.
+
+readv.2
+    Michael Kerrisk
+        Remove redundant sentence
+
+seccomp.2
+    Michael Kerrisk
+        Note that execve() may change syscall numbers during life of process
+            On a multiarch/multi-ABI platform such as modern x86, each
+            architecture/ABI (x86-64, x32, i386)has its own syscall numbers,
+            which means a seccomp() filter may see different syscall numbers
+            over the life of the process if that process uses execve() to
+            execute programs that has a different architectures/ABIs.
+    Michael Kerrisk
+        Note which architectures support seccomp BPF
+    Michael Kerrisk
+        In EXAMPLE, clearly note that x32 syscalls are >= X32_SYSCALL_BIT
+
+shutdown.2
+    Carsten Grohmann
+        SEE ALSO: add close(2)
+
+syscall.2
+    Adam Borowski
+        Add riscv
+
+wait.2
+    Michael Kerrisk  [Robin Kuzmin]
+        wait() and waitpid() block the calling thread (not process)
+
+wait4.2
+    Michael Kerrisk  [Martin Mares]
+        Soften the warning against the use of wait3()/wait4()
+            These functions are nonstandard, but there is no replacement.
+
+            See https://bugzilla.kernel.org/show_bug.cgi?id=199215
+
+crypt.3
+encrypt.3
+    Carlos O'Donell  [Michael Kerrisk]
+        Add notes about _XOPEN_CRYPT
+            The distribution may choose not to support _XOPEN_CRYPT in the
+            case that the distribution has transitioned from glibc crypt to
+            libxcrypt.
+
+fseek.3
+    Michael Kerrisk  [Andy Owen]
+        ERRORS: EBADF should be ESPIPE
+    Michael Kerrisk
+        Improve EPIPE error text
+
+getcwd.3
+    Carlos O'Donell
+        Mention that "(unreachable)" is no longer returned for glibc >= 2.27.
+
+makedev.3
+    Michael Kerrisk
+        Since glibc 2.28, <sys/types.h> no longer defines these macros
+
+pthread_create.3
+    Frederic Brault
+        Note default thread stack size for several architectures
+
+tsearch.3
+    Jann Horn
+        Clarify items vs nodes
+            The manpage claimed that tsearch() returns a pointer to a data
+            item. This is incorrect; tsearch() returns a pointer to the
+            corresponding tree node, which can also be interpreted as a
+            pointer to a pointer to the data item.
+
+            Since this API is quite unintuitive, also add a clarifying
+            sentence.
+    Jann Horn
+        tdelete() can return dangling pointers
+            POSIX says that deleting the root node must cause tdelete() to
+            return some unspecified non-NULL pointer. Glibc implements it by
+            returning a dangling pointer to the (freed) root node.
+            Therefore, explicitly note that tdelete() may return bad pointers
+            that must not be accessed.
+
+elf.5
+    Michael Kerrisk
+        SEE ALSO: add patchelf(1)
+
+filesystems.5
+    Michael Kerrisk
+        Add an entry for tmpfs(5)
+
+group.5
+    Michael Kerrisk
+        SEE ALSO: add vigr(8)
+
+passwd.5
+    Michael Kerrisk
+        SEE ALSO: add vipw(8)
+
+sysfs.5
+    Michael Kerrisk
+        Add brief note on /sys/fs/smackfs
+
+tmpfs.5
+    Mike Frysinger
+        Document current mount options
+            Some of this content is moved from the mount(8) man page.
+            Style was based on proc(5) sections.
+    Michael Kerrisk
+        Remove reference to mount(8) for discussion of mount options
+            The mount options are now described in this page.
+    Michael Kerrisk
+        SEE ALSO: add Documentation/vm/transhuge.txt
+    Michael Kerrisk
+        Reformat 'huge' and 'mpol' mount option values as lists
+    Michael Kerrisk
+        Describe 'mpol' mount options
+            Based on text from Documentation/filesystems/tmpfs.txt.
+    Michael Kerrisk
+        Document 'huge' mount options
+            Based on text from Documentation/vm/transhuge.txt.
+    Michael Kerrisk
+        SEE ALSO: add set_mempolicy(2)
+    Michael Kerrisk
+        Document mpol=local mount option
+
+capabilities.7
+    Michael Kerrisk
+        Remove redundant mention of PTRACE_SECCOMP_GET_FILTER
+
+cgroups.7
+    Michael Kerrisk
+        cgroup.events transitions generate POLLERR as well as POLLPRI
+
+mount_namespaces.7
+    Michael Kerrisk
+        Note another case where shared "peer groups" are formed
+
+namespaces.7
+    Michael Kerrisk  [Konstantin Khlebnikov]
+        Mention that device ID should also be checked when comparing NS symlinks
+            When comparing two namespaces symlinks to see if they refer to
+            the same namespace, both the inode number and the device ID
+            should be compared. This point was already made clear in
+            ioctl_ns(2), but was missing from this page.
+    Michael Kerrisk
+        Note an idiosyncrasy of /proc/[pid]/ns/pid_for_children
+            /proc/[pid]/ns/pid_for_children has a value only after first
+            child is created in PID namespace. Verified by experiment.
+
+network_namespaces.7
+    Michael Kerrisk
+        Network namespaces isolate the UNIX domain abstract socket namespace
+    Michael Kerrisk
+        Add cross reference to unix(7)
+            For further information on UNIX domain abstract sockets.
+
+posixoptions.7
+    Carlos O'Donell
+        Expand XSI Options groups
+            We define in detail the X/Open System Interfaces i.e. _XOPEN_UNIX
+            and all of the X/Open System Interfaces (XSI) Options Groups.
+
+            The XSI options groups include encryption, realtime, advanced
+            realtime, realtime threads, advanced realtime threads, tracing,
+            streams, and legacy interfaces.
+    Michael Kerrisk
+        Use a more consistent, less cluttered layout for option lists
+    Michael Kerrisk
+        Make function lists more consistent and less cluttered
+            Use more consistent layout for lists of functions, and
+            remove punctuation from the lists to make them less cluttered.
+
+socket.7
+    Michael Kerrisk  [Tomi Salminen]
+        Fix error in SO_INCOMING_CPU code snippet
+            The last argument is passed by value, not reference.
+
+time.7
+    Michael Kerrisk  [Enrique Garcia]
+        Mention clock_gettime()/clock_settime() rather than [gs]ettimeofday()
+            gettimeofday() is declared obsolete by POSIX. Mention instead
+            the modern APIs for working with the realtime clock.
+
+            See https://bugzilla.kernel.org/show_bug.cgi?id=199049
+
+unix.7
+    Michael Kerrisk  [Rusty Russell]
+        ERRORS: add EBADF for sending closed file descriptor with SCM_RIGHTS
+
+vdso.7
+    Michael Kerrisk
+        VDSO symbols (system calls) are not visible to seccomp(2) filters
+
+xattr.7
+    Michael Kerrisk
+        SEE ALSO: add selinux(8)
+
+ld.so.8
+    Mike Frysinger
+        Make lack of separator escaping explicit
+            Make it clear that the delimiters in LD_PRELOAD, LD_LIBRARY_PATH,
+            and LD_AUDIT cannot be escaped so people don't try various methods
+            (such as \:) to workaround it.
+    Michael Kerrisk
+        Remove unneeded mention of PATH in discussion of LD_LIBRARY_PATH
+            This brief sentence doesn't add value to the text.