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

1 files changed, 559 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 91c3e5ea3..48a19cdb6 100644
--- a/Changes.old
+++ b/Changes.old
@@ -44843,3 +44843,562 @@ ld.so.8
     Michael Kerrisk
         LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM
 
+
+
+==================== Changes in man-pages-4.11 ====================
+
+Released: 2017-05-03, Baden, Switzerland
+
+
+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:
+
+Alexander Alemayhu <alexander@alemayhu.com>
+Alexander Miller <alex.miller@gmx.de>
+Andrea Arcangeli <aarcange@redhat.com>
+Andreas Dilger <adilger@dilger.ca>
+Andrew Clayton <andrew@digital-domain.net>
+Arnd Bergmann <arnd@arndb.de>
+Ben Dog <wsy2220@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Chema Gonzalez <chema@google.com>
+Christian Brauner <christian.brauner@ubuntu.com>
+Cyril Hrubis <chrubis@suse.cz>
+David Howells <dhowells@redhat.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Florian Weimer <fweimer@redhat.com>
+Francois Saint-Jacques <fsaintjacques@gmail.com>
+Frank Theile
+Georg Sauthoff <mail@georg.so>
+Ian Abbott <abbotti@mev.co.uk>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Heberer <jangc@t-online.de>
+Marcin Ślusarz <marcin.slusarz@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Matthew Wilcox <willy@infradead.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Rapoport <rppt@linux.vnet.ibm.com>
+Nicolas Biscos <nicolas.biscos+man7@gmail.com>
+Nicolas Iooss <Nicolas.Iooss@ssi.gouv.fr>
+Nikos Mavrogiannopoulos <nmav@redhat.com>
+Nominal Animal <question@nominal-animal.net>
+Silvan Jegen <s.jegen@gmail.com>
+Stephan Bergmann <sbergman@redhat.com>
+Walter Harms <wharms@bfs.de>
+Zack Weinberg <zackw@panix.com>
+丁贵强<dingguiqiang@foxmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+ioctl_userfaultfd.2
+    Michael Kerrisk, Mike Rapoport
+        New page describing ioctl(2) operations for userfaultfd
+
+statx.2
+    David Howells, Michael Kerrisk  [Andreas Dilger]
+        New page describing statx(2) system call added in Linux 4.11
+
+userfaultfd.2
+    Mike Rapoport, Michael Kerrisk  [Andrea Arcangeli]
+        New page describing userfaultfd(2) system call.
+
+pthread_atfork.3
+    Michael Kerrisk
+        New page describing pthread_atfork(3)
+
+slabinfo.5
+    Michael Kerrisk
+        Rewrite to try to bring the content close to current reality
+            There's still gaps to fill in, but the existing page
+            was in any case hugely out of date.
+
+inode.7
+    Michael Kerrisk
+        New page with information about inodes
+            David Howells provided a statx(2) page that duplicated much of
+            the information from form stat(2). Avoid such duplication
+            by moving the common information in stat(2) and statx(2)
+            to a new page.
+
+
+Renamed pages
+--------------
+
+ioctl_console.2
+    Michael Kerrisk
+        Renamed from console_ioctl.4
+            Most ioctl() man pages are in section 2, so move this one there
+            for consistency.
+    Michael Kerrisk
+        Note type of 'argp' for a various operations
+            For some commands, there was no clear statement about the type
+            of the 'argp' argument.
+
+ioctl_tty.2
+    Michael Kerrisk
+        Renamed from tty_ioctl(4)
+            All other ioctl(2) pages are in section 2. Make this
+            page consistent.
+    Michael Kerrisk
+        Packet mode state change events give POLLPRI events for poll(2)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ioctl_ns.2
+    Michael Kerrisk
+        Document the NS_GET_NSTYPE operation added in Linux 4.11
+    Michael Kerrisk
+        Document the NS_GET_OWNER_UID operation added in Linux 4.11
+
+proc.5
+    Michael Kerrisk
+        Document /proc/sys/kernel/sched_child_runs_first
+
+
+New and changed links
+---------------------
+
+console_ioctl.4
+    Michael Kerrisk
+        Link for old name of ioctl_console(2) page
+
+tty_ioctl.4
+    Michael Kerrisk
+        Link for old name of ioctl_tty(2) page
+
+
+Global changes
+--------------
+
+Various pages
+    Michael Kerrisk
+        Change page cross-references from tty_ioctl(4) to ioctl_tty(2)
+    Michael Kerrisk
+        Change page cross-references for console_ioctl(4) to ioctl_console(2)
+
+
+Changes to individual pages
+---------------------------
+
+alarm.2
+    Michael Kerrisk
+        SEE ALSO: add timer_create(2) and timerfd_create(2)
+
+chmod.2
+fsync.2
+mkdir.2
+mknod.2
+open.2
+truncate.2
+umask.2
+utime.2
+utimensat.2
+    Michael Kerrisk
+        Add/replace references to inode(7)
+
+clone.2
+    Michael Kerrisk
+        CLONE_NEWCGROUP by an unprivileged process also causes an EPERM error
+
+clone.2
+unshare.2
+    Michael Kerrisk
+        Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC
+    Michael Kerrisk
+        CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached
+    Michael Kerrisk
+        Exceeding the maximum nested user namespace limit now gives ENOSPC
+            Formerly, if the limit of 32 nested user namespaces was exceeded,
+            the error EUSERS resulted. Starting with Linux 4.9, the error
+            is ENOSPC.
+
+epoll_ctl.2
+    Michael Kerrisk
+        Defer to poll(2) for an explanation of EPOLLIN
+    Michael Kerrisk  [Nicolas Biscos]
+        EPOLLERR is also set on write end of a pipe when the read end is closed
+    Michael Kerrisk  [Nicolas Biscos]
+        Give the reader a clue that the 'events' field can be zero
+            'events' specified as zero still allows EPOLLHUP and
+            EPOLLERR to be reported.
+
+_exit.2
+    Michael Kerrisk
+        On exit, child processes may be inherited by a "subreaper"
+            It is no longer necessarily true that orphaned processes
+            are inherited by PID 1.
+    Michael Kerrisk
+        Only the least significant byte of exit status is passed to the parent
+
+fcntl.2
+    Michael Kerrisk
+        Mention memfd_create() in the discussion of file seals
+            Give the reader a clue about what kinds of objects can
+            be employed with file seals.
+    Michael Kerrisk
+        File seals are not generally applicable to tmpfs(5) files
+            As far as I can see, file seals can be applied only to
+            memfd_create(2) file descriptors. This was checked by experiment
+            and by reading mm/shmem.c::shmem_get_inode((), where one finds
+            the following line that applies to all new shmem files:
+
+                            info->seals = F_SEAL_SEAL;
+
+            Only in the code of the memfd_create() system call is this
+            setting reversed (in mm/shmem.c::memfd_create):
+
+                    if (flags & MFD_ALLOW_SEALING)
+                            info->seals &= ~F_SEAL_SEAL;
+
+fork.2
+    Michael Kerrisk
+        SEE ALSO: add pthread_atfork(3)
+
+getdents.2
+open.2
+stat.2
+statx.2
+    Michael Kerrisk
+        SEE ALSO: add inode(7)
+
+getdtablesize.2
+attr.5
+    Alexander Miller
+        Move .so directive to first line
+            Improves compatibility with the man and other dumb tools
+            that process man page files.
+
+getpid.2
+    Michael Kerrisk
+        Mention init(1) and "subreapers" in discussion of parent PID
+
+ioctl_list.2
+    Cyril Hrubis  [Arnd Bergmann]
+        BLKRASET/BLKRAGET take unsigned long
+
+ioctl_ns.2
+    Michael Kerrisk
+        ERRORS: document ENOTTY
+
+kexec_load.2
+sched_setaffinity.2
+bootparam.7
+    Michael Kerrisk
+        Documentation/kernel-parameters.txt is now in Documentation/admin-guide/
+
+lseek.2
+    Michael Kerrisk
+        SEE ALSO: add fallocate(2)
+            Both of these pages discuss file holes.
+
+mincore.2
+    Michael Kerrisk
+        SEE ALSO: add fincore(1)
+
+mmap.2
+    Michael Kerrisk
+        Remove ancient reference to flags that appear on some other systems
+            MAP_AUTOGROW, MAP_AUTORESRV, MAP_COPY, and MAP_LOCAL may have
+            appeared on some systems many years ago, but  the discussion here
+            mentions no details and the systems and flags probably ceased to
+            be relevant long ago. So, remove this text.
+    Michael Kerrisk
+        SEE ALSO: add userfaultfd(2)
+
+open.2
+    Michael Kerrisk
+        Add statx() to list of "at" calls in rationale discussion
+
+poll.2
+    Michael Kerrisk
+        Expand discussion of POLLPRI
+    Michael Kerrisk  [Nicolas Biscos]
+        POLLERR is also set on write end of a pipe when the read end is closed
+
+posix_fadvise.2
+    Michael Kerrisk
+        SEE ALSO: add fincore(1)
+
+prctl.2
+    Mike Frysinger
+        PR_SET_MM: Refine CONFIG_CHECKPOINT_RESTORE requirement
+            The Linux 3.10 release dropped the c/r requirement and opened it
+            up to all users.
+    Mike Frysinger
+        PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers
+    Mike Frysinger
+        PR_SET_MM: Document arg4/arg5 zero behavior
+            The kernel will immediately reject calls where arg4/arg5 are not
+            zero.  See kernel/sys.c:prctl_set_mm().
+    Michael Kerrisk
+        Explain rationale for use of subreaper processes
+    Michael Kerrisk
+        Note semantics of child_subreaper setting on fork() and exec()
+    Michael Kerrisk
+        Improve description of PR_SET_CHILD_SUBREAPER
+
+rename.2
+    Michael Kerrisk  [Georg Sauthoff]
+        Note that there is no glibc wrapper for renameat2()
+
+sched_setaffinity.2
+    Michael Kerrisk
+        SEE ALSO: add get_nprocs(3)
+
+select.2
+    Michael Kerrisk  [Matthew Wilcox, Carlos O'Donell]
+        Linux select() is buggy wrt POSIX in its check for EBADF errors
+    Michael Kerrisk
+        Show correspondence between select() and poll() readiness notifications
+    Michael Kerrisk
+        Give a hint that sets must be reinitialized if using select() in a loop
+    Michael Kerrisk
+        Refer to POLLPRI in poll(2) for info on exceptional conditions
+    Michael Kerrisk
+        Move mislocated text describing the self-pipe text from BUGS to NOTES
+
+sigaction.2
+    Michael Kerrisk
+        Show the prototype of an SA_SIGINFO signal handler
+
+signalfd.2
+    Michael Kerrisk
+        SIGKILL and SIGSTOP are silently ignored in 'mask'
+
+sigprocmask.2
+    Dmitry V. Levin
+        Do not specify an exact value of rt_sigprocmask's 4th argument
+            As sizeof(kernel_sigset_t) is not the same for all architectures,
+            it would be better not to mention any numbers as its value.
+    Michael Kerrisk
+        'set' and 'oldset' can both be NULL
+
+sigwaitinfo.2
+    Michael Kerrisk
+        sigwaitinfo() can't be used to accept synchronous signals
+
+socketcall.2
+    Mike Frysinger
+       Document call argument
+
+stat.2
+    Michael Kerrisk
+        Remove information migrated to inode(7) page
+    Michael Kerrisk
+        Restructure field descriptions as a hanging list
+    Michael Kerrisk
+        Remove "Other systems" subsection
+            These details about other systems were added in 1999,
+            and were probably of limited use then, and even less today.
+            However, they do clutter the page, so remove them.
+    Michael Kerrisk
+        DESCRIPTION: add list entries for 'st_uid' and 'st_gid'
+    Michael Kerrisk
+        Add some subsection headings to ease readability
+    David Howells
+        ERRORS: correct description of ENOENT
+    Michael Kerrisk
+        Give 'struct stat' argument a more meaningful name ('statbuf')
+    Marcin Ślusarz
+        Tweak description of AT_EMPTY_PATH
+            Currently it says when dirfd is AT_FDCWD it can be something
+            other than directory, which doesn't make much sense. Just swap
+            the order of sentences.
+    Michael Kerrisk
+        Add slightly expanded description oif 'st_ino' field
+    Michael Kerrisk
+        DESCRIPTION: add a list entry for 'st_ino'
+    Michael Kerrisk
+        DESCRIPTION: add a list entry for 'st_nlinks' field
+
+syscalls.2
+    Michael Kerrisk
+        Add membarrier(2)
+    Michael Kerrisk
+        Fix kernel version for userfaultfd(2)
+    Michael Kerrisk
+        Linux 4.11 added statx()
+    Michael Kerrisk
+        Include deprecated getunwind(2) in list
+
+wait.2
+    Michael Kerrisk
+        Orphaned children may be adopted by a "subreaper", rather by than PD 1
+
+bzero.3
+    Michael Kerrisk  [Zack Weinberg]
+        Add correct header file for exlicit_bzero()
+
+cfree.3
+    Michael Kerrisk
+        cfree() is removed from glibc in version 2.26
+
+exit.3
+    Michael Kerrisk
+        Improve discussion of zombie processes
+
+getentropy.3
+    Nikos Mavrogiannopoulos  [Michael Kerrisk, Florian Weimer]
+        Correct header file
+    Michael Kerrisk  [Frank Theile]
+        SYNOPSIS: add missing return type for getentropy() declaration
+
+grantpt.3
+    Michael Kerrisk
+        Tell a more nuanced story about what grantpt() does or does not do
+
+insque.3
+    Michael Kerrisk
+        SEE ALSO: add queue(3)
+
+queue.3
+    Michael Kerrisk
+        SEE ALSO: add insque(3)
+
+shm_open.3
+    Michael Kerrisk
+        Clarify that POSIX shared memory uses tmpfs(5)
+
+syslog.3
+    Michael Kerrisk  [Ian Abbott, Walter Harms]
+        Reorganize page text for easier parsing and better readability
+    Michael Kerrisk
+        Various rewordings and improvements
+    Michael Kerrisk
+        Note default value for 'facility' when calling openlog()
+    Michael Kerrisk
+        SEE ALSO: add journalctl(1)
+
+ttyname.3
+    Dmitry V. Levin
+        Document ENODEV error code
+    Christian Brauner
+        NOTES: warn about a confusing case that may occur with mount namespaces
+
+
+wcsdup.3
+    Jan Heberer
+        RETURN VALUE: fix error in return value description
+            Return value for failure was accidentally changed from NULL to
+            -1 in man-pages commit 572acb41c48b6b8e690d50edff367d8b8b01702a.
+
+elf.5
+    Michael Kerrisk
+        SEE ALSO: add elfedit(1), nm(1), size(1), strings(1), and strip(1)
+
+nsswitch.conf.5
+    Florian Weimer
+        Mention sudoers
+            It turns out that sudo drops things into nsswitch.conf, too.
+
+proc.5
+    Michael Kerrisk
+        Refer to namespaces(7) for discussion of /proc/sys/user/* files
+    Michael Kerrisk
+        Simplify /proc/slabinfo entry
+            Don't repeat (out-of-date) info from slabinfo(5); just defer to
+            that page.
+
+tmpfs.5
+    Michael Kerrisk
+        tmpfs supports extended attributes, but not 'user' extended attributes
+
+environ.7
+    Jakub Wilk
+        Fix name of function that honors TMPDIR
+            tempnam() takes the TMPDIR environment variable into account, unlike
+            tmpnam(), which always creates pathnames within /tmp.
+
+hostname.7
+    Marko Myllynen
+        Use lower case for hostname example
+    Marko Myllynen
+        Use generic names in examples
+    Marko Myllynen
+        Describe accepted characters for hostname
+
+inotify.7
+    Michael Kerrisk  [Nicolas Iooss]
+        Mounting a filesystem on top of a monitored directory causes no event
+
+man-pages.7
+    Michael Kerrisk
+        Note preferred approach for 'duplicate' errors
+
+namespaces.7
+    Michael Kerrisk
+        Document the /proc/sys/user/* files added in Linux 4.9
+
+pid_namespaces.7
+    Michael Kerrisk
+        The maximum nesting depth for PID namespaces is 32
+
+user_namespaces.7: Fixes to example
+    Stephan Bergmann
+        While toying around with the userns_child_exec example program on the
+        user_namespaces(7) man page, I noticed two things:
+
+        * In the EXAMPLE section, we need to mount the new /proc before
+          looking at /proc/$$/status, otherwise the latter will print
+          information about the outer namespace's PID 1 (i.e., the real
+          init).  So the two paragraphs need to be swapped.
+
+        * In the program source, make sure to close pipe_fd[0] in the
+          child before exec'ing.
+
+pthreads.7
+    Michael Kerrisk
+        SEE ALSO: add pthread_rwlockattr_setkind_np(3)
+
+pty.7
+    Michael Kerrisk
+        Mention a couple of other applications of pseudoterminals
+
+sem_overview.7
+    Michael Kerrisk
+        SEE ALSO: add shm_overview(7)
+
+signal.7
+    Michael Kerrisk
+        SEE ALSO: add sigreturn(2)
+
+socket.7
+    Michael Kerrisk
+        Enhance the description of SO_INCOMING_CPU
+    Francois Saint-Jacques
+        Document SO_INCOMING_CPU
+
+tcp.7
+    Michael Kerrisk
+        Note indications for OOB data given by select(2) and poll(2)
+    Chema Gonzalez
+        tcp_abc was removed in 3.9
+
+xattr.7
+    Michael Kerrisk
+        SEE ALSO: add ioctl_iflags(2)
+            People sometimes confuse xattrs and inode flags. Provide a link
+            to the page that describes inode flags to give them a tip.
+
+ld.so.8
+    Michael Kerrisk
+        Mention quoting when using "Rpath tokens" in LD_AUDIT and LD_PRELOAD
+    Michael Kerrisk
+        Expand description of /etc/ld.so.preload
+    Michael Kerrisk
+        Mention ldconfig(8) in discussion of /etc/ld.so.cache
+
+zdump.8
+    Jakub Wilk
+        Add OPTIONS section heading