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

1 files changed, 392 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 067fce382..a27233987 100644
--- a/Changes.old
+++ b/Changes.old
@@ -54191,3 +54191,395 @@ tcp.7
 uri.7
     Michael Kerrisk
         Note that 'logical' quoting is the norm in Europe
+
+
+==================== Changes in man-pages-5.12 ====================
+
+Released: 2021-06-20, Christchurch
+
+
+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:
+
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Akihiro Motoki <amotoki@gmail.com>
+Alejandro Colomar <alx.manpages@gmail.com>
+Alyssa Ross <hi@alyssa.is>
+Aurelien Aptel <aaptel@suse.com>
+Borislav Petkov <bp@suse.de>
+Bruce Merry <bmerry@ska.ac.za>
+Chris Keilbart <keilbartchris@gmail.com>
+Christian Brauner <christian@brauner.io>
+Christoph Anton Mitterer <calestyo@scientia.net>
+dann frazier <dann.frazier@canonical.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Florian Weimer <fw@deneb.enyo.de>
+Huang Ying <ying.huang@intel.com>
+Jakub Wilk <jwilk@jwilk.net>
+James O. D. Hunt <jamesodhunt@gmail.com>
+Jann Horn <jannh@google.com>
+Johannes Berg <johannes@sipsolutions.net>
+Jon Murphy <jonmurphy1618@gmail.com>
+Josh Triplett <josh@joshtriplett.org>
+Katsuhiro Numata <byakkomon@gmail.com>
+Kees Cook <keescook@chromium.org>
+Mark Kettenis <kettenis@openbsd.org>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Rapoport <rppt@linux.vnet.ibm.com>
+Peter Xu <peterx@redhat.com>
+Sargun Dhillon <sargun@sargun.me>
+Stefan Puiu <stefan.puiu@gmail.com>
+Štěpán Němec <stepnem@gmail.com>
+thomasavoss <thomasavoss@protonmail.com>
+Topi Miettinen <toiwoton@gmail.com>
+Tycho Andersen <tycho@tycho.pizza>
+Utkarsh Singh <utkarsh190601@gmail.com>
+Vishwajith K <vishuvikas1996@gmail.com>
+Walter Harms <wharms@bfs.de>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Zhiheng Li <phoenix_lzh@sina.com>
+наб <nabijaczleweli@nabijaczleweli.xyz>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+seccomp_unotify.2
+    Michael Kerrisk  [Tycho Andersen, Jann Horn, Kees Cook, Christian Brauner
+                      Sargun Dhillon]
+        New page documenting the seccomp user-space notification mechanism
+
+MAX.3
+    Alejandro Colomar
+        New page to document MAX() and MIN()
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+seccomp.2
+    Tycho Andersen  [MichaelKerrisk]
+        Document SECCOMP_GET_NOTIF_SIZES
+    Tycho Andersen
+        Document SECCOMP_FILTER_FLAG_NEW_LISTENER   [Michael Kerrisk]
+    Tycho Andersen
+        Document SECCOMP_RET_USER_NOTIF  [Michael Kerrisk]
+
+set_mempolicy.2
+    Huang Ying  [Alejandro Colomar, "Huang, Ying"]
+        Add mode flag MPOL_F_NUMA_BALANCING
+
+userfaultfd.2
+    Peter Xu  [Alejandro Colomar, Mike Rapoport]
+        Add UFFD_FEATURE_THREAD_ID docs
+    Peter Xu  [Alejandro Colomar, Mike Rapoport]
+        Add write-protect mode docs
+
+proc.5
+    Michael Kerrisk
+        Document /proc/sys/vm/sysctl_hugetlb_shm_group
+
+system_data_types.7
+    Alejandro Colomar
+        Add 'blksize_t'
+    Alejandro Colomar
+        Add 'blkcnt_t'
+    Alejandro Colomar
+        Add 'mode_t'
+    Alejandro Colomar
+        Add 'struct sockaddr'
+    Alejandro Colomar
+        Add 'cc_t'
+    Alejandro Colomar
+        Add 'socklen_t'
+
+
+New and changed links
+---------------------
+
+blkcnt_t.3
+    Alejandro Colomar
+        New link to system_data_types(7)
+
+blksize_t.3
+    Alejandro Colomar
+        New link to system_data_types(7)
+
+cc_t.3
+    Alejandro Colomar
+        New link to system_data_types(7)
+
+MIN.3
+    Michael Kerrisk
+        New link to MIN.3
+
+mode_t.3
+    Alejandro Colomar
+        New link to system_data_types(7)
+
+sockaddr.3
+    Alejandro Colomar
+        New link to system_data_types(7)
+
+socklen_t.3
+    Alejandro Colomar
+        New link to system_data_types(7)
+
+
+Global changes
+--------------
+
+Many pages
+    Alejandro Colomar
+        SYNOPSIS: Use syscall(SYS_...); for system calls without a wrapper
+
+Many pages
+    Alejandro Colomar
+        SYNOPSIS: Document why each header is required
+
+Many pages
+    Alejandro Colomar
+        SYNOPSIS: Remove unused includes
+
+Various pages
+    Alejandro Colomar
+        Add note about the use of syscall(2)
+
+Various pages
+    Alejandro Colomar
+        SYNOPSIS: Miscellaneous fixes to includes
+
+A few pages
+    Alejandro Colomar
+        SYNOPSIS: Add missing 'const'
+
+
+Changes to individual pages
+---------------------------
+
+dup.2
+    Michael Kerrisk
+        Rewrite the description of dup() somewhat
+            As can be seen by any number of StackOverflow questions, people
+            persistently misunderstand what dup() does, and the existing manual
+            page text, which talks of "copying" a file descriptor doesn't help.
+            Rewrite the text a little to try to prevent some of these
+            misunderstandings, in particular noting at the start that dup()
+            allocates a new file descriptor.
+    Michael Kerrisk
+        Clarify what silent closing means
+    Alejandro Colomar
+        SYNOPSIS: Use consistent comments through pages
+
+epoll_wait.2
+    Alejandro Colomar
+        Move misplaced subsection to NOTES from BUGS
+
+execveat.2
+    Michael Kerrisk
+        Library support has been added in glibc 2.34
+
+_exit.2
+    Michael Kerrisk
+        Add a little more detail on the raw _exit() system cal
+
+exit_group.2
+    Alejandro Colomar
+        Use 'noreturn' in prototypes
+
+flock.2
+    Aurelien Aptel  [Alejandro Colomar]
+        Add CIFS details
+            CIFS flock() locks behave differently than the standard.
+            Give an overview of those differences.
+
+ioperm.2
+    Alejandro Colomar
+        Remove obvious comment
+
+memfd_create.2
+mmap.2
+shmget.2
+    Michael Kerrisk  [Yang Xu]
+        Document the EPERM error for huge page allocations
+            This error can occur if the caller is does not have CAP_IPC_LOCK
+            and is not a member of the sysctl_hugetlb_shm_group.
+
+mmap.2
+    Bruce Merry
+        Clarify that MAP_POPULATE is best-effort
+
+mount.2
+    Topi Miettinen
+        Document SELinux use of MS_NOSUID mount flag
+
+open.2
+    Alejandro Colomar  [Walter Harms]
+        Fix bug in linkat(2) call example
+            AT_EMPTY_PATH works with empty strings (""), but not with NULL
+            (or at least it's not obvious).
+    Michael Kerrisk
+        Make it clearer that an FD is an index into the process's FD table
+            Sometimes people are confused, thinking a file descriptor is just a
+            number....
+
+perfmonctl.2
+    Michael Kerrisk
+        This system call was removed in Linux 5.10
+
+pipe.2
+    Alejandro Colomar
+        SYNOPSIS: Fix incorrect prototype
+    Michael Kerrisk
+        Rearrange SYNOPSIS so that minority version pipe() is at end
+
+ptrace.2
+    Dmitry V. Levin  [Alejandro Colomar, Mathieu Desnoyers]
+        Mention PTRACE_GET_SYSCALL_INFO in RETURN VALUE section
+
+seccomp.2
+    Michael Kerrisk
+        Reorder list of SECCOMP_SET_MODE_FILTER flags alphabetically
+            (No content changes.)
+    Michael Kerrisk
+        SEE ALSO: add seccomp_unotify(2)
+
+select.2
+    Michael Kerrisk
+        Strengthen the warning regarding the low value of FD_SETSIZE
+            All modern code should avoid select(2) in favor of poll(2)
+            or epoll(7).
+    Michael Kerrisk
+        Relocate sentence about the fd_set value-result arguments to BUGS
+
+syscalls.2
+    Michael Kerrisk
+        perfmonctl(2) was removed in Linux 5.10
+
+bswap.3
+    Alejandro Colomar
+        bswap_*() are implemented using functions
+            Even though it's true that they are macros,
+            it's transparent to the user.
+
+            The user will see their results casted to unsigned types
+            after the conversion due to the underlying functions,
+            so it's better to document these as the underlying functions,
+            specifying the types.
+
+cmsg.3
+unix.7
+    Michael Kerrisk
+        Refer to seccomp_unotify(2) for an example of SCM_RIGHTS usage
+
+cpow.3
+    Alejandro Colomar
+        Use 'complex' after the type consistently
+
+ctime.3
+    Michael Kerrisk  [Katsuhiro Numata]
+        Restore documentation of 'tm_gmtoff' field
+
+errno.3
+    Alejandro Colomar  [Florian Weimer, Mark Kettenis]
+        Fix ENODATA text
+            ENODATA is an XSI STREAMS extension (not base POSIX).
+
+exec.3
+    Josh Triplett  [Alejandro Colomar]
+        Clarify that execvpe() uses PATH from the caller, not envp
+    Josh Triplett  [Alejandro Colomar]
+        Fix description of 'e' variants
+            The envp argument specifies the environment of the new process
+            image, not "the environment of the caller".
+
+fflush.3
+    Alejandro Colomar
+        SEE ALSO: Add fpurge(3)
+
+getline.3
+    наб  [Ahelenia Ziemiańska, Alejandro Colomar]
+        !*lineptr is sufficient
+            No implementation or spec requires *n to be 0 to allocate
+            a new buffer.
+
+getopt.3
+    James O. D. Hunt  [Alejandro Colomar]
+        Clarify behaviour
+
+printf.3
+    Utkarsh Singh  [Alejandro Colomar]
+        Add overall structure of format string
+
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+    Alejandro Colomar
+        SYNOPSIS: Use 'restrict' in prototypes
+
+pthread_mutexattr_setrobust.3
+    Michael Kerrisk
+        Note that the *_np() APIs are deprecated since glibc 2.34
+    Alejandro Colomar
+        SYNOPSIS: Remove incorrect 'const'
+
+pthread_mutex_consistent.3
+    Michael Kerrisk
+        Note that pthread_mutexattr_setrobust() is now deprecated
+
+pthread_yield.3
+    Michael Kerrisk
+        Note that this function is deprecated since glibc 2.34
+
+rpc.3
+    Alejandro Colomar
+        SYNOPSIS: Fix prototypes (misc.)
+
+scanf.3
+    Alyssa Ross  [Alejandro Colomar]
+        Clarify that %n supports type modifiers
+
+xdr.3
+    Alejandro Colomar
+        SYNOPSIS: Fix prototype types
+            Use the same types glibc uses, and add a missing 'const'.
+
+capabilities.7
+    Michael Kerrisk
+        CAP_IPC_LOCK also governs memory allocation using huge pages
+
+environ.7
+    Josh Triplett  [Alejandro Colomar]
+        Remove obsolete admonishment of the GZIP environment variable
+
+kernel_lockdown.7
+    dann frazier  [Alejandro Colomar]
+        Remove description of lifting via SysRq (not upstream)
+            The patch that implemented lockdown lifting via SysRq ended up
+            getting dropped[*] before the feature was merged upstream. Having
+            the feature documented but unsupported has caused some confusion
+            for our users.
+
+mount_namespaces.7
+namespaces.7
+    Michael Kerrisk
+        Relocate reference to pam_namespace(8) from namespaces.7 to
+        mount_namespaces.7.
+
+signal.7
+    Michael Kerrisk
+        Add reference to seccomp_unotify(2)
+            The seccomp user-space notification feature can cause changes in
+            the semantics of SA_RESTART with respect to system calls that
+            would never normally be restarted. Point the reader to the page
+            that provide further details.
+
+vsock.7
+    Alyssa Ross
+        ioctls are on /dev/vsock, not sockets