Merge man-pages 5.10 import

Author: sevan

share/man/dist/CONTRIBUTING

@@ -0,0 +1,13 @@
+For general information about how to contribute, see:
+https://www.kernel.org/doc/man-pages/contributing.html
+
+For information on how to send patches, see:
+https://www.kernel.org/doc/man-pages/patches.html
+
+For a description of the preferred layout of manual pages,
+as well as some style guide notes, see:
+
+    $ man 7 man-pages
+
+For information about reporting bugs, see:
+https://www.kernel.org/doc/man-pages/reporting_bugs.html

share/man/dist/Changes

@@ -0,0 +1,350 @@
+==================== Changes in man-pages-5.10 ====================
+
+Released: 2020-12-21, 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:
+
+Ahelenia Ziemiańska <[email protected]>
+Alejandro Colomar <[email protected]>
+Amir Goldstein <[email protected]>
+Arusekk <[email protected]>
+Baruch Siach <[email protected]>
+Bill Allombert <[email protected]>
+Colin Ian King <[email protected]>
+Dave Martin <[email protected]>
+Davide Giorgio <[email protected]>
+Heinrich Schuchardt <[email protected]>
+Jan Kara <[email protected]>
+Jing Peng <[email protected]>
+John A. Leuenhagen <[email protected]>
+Mathias Rav <[email protected]>
+Michael Kerrisk <[email protected]>
+Mike Crowe <[email protected]>
+Namhyung Kim <[email protected]>
+Peter Oskolkov <[email protected]>
+Philip Rowlands <[email protected]>
+Rob Landley <[email protected]>
+Ross Zwisler <[email protected]>
+Sebastian Kirmayer <[email protected]>
+наб <[email protected]>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+access.2
+    Michael Kerrisk
+        Document faccessat2()
+            faccessat2() was added in Linux 5.8 and enables a fix to
+            longstanding bugs in the faccessat() wrapper function.
+
+membarrier.2
+    Peter Oskolkov  [Alejandro Colomar]
+        Update for Linux 5.10
+            Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840
+            (part of 5.10 release) changed sys_membarrier prototype/parameters
+            and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ
+            and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ].
+
+
+New and changed links
+---------------------
+
+faccessat2.2
+    Michael Kerrisk
+        New link to access.2
+
+CIRCLEQ_EMPTY.3
+CIRCLEQ_FIRST.3
+CIRCLEQ_FOREACH.3
+CIRCLEQ_FOREACH_REVERSE.3
+CIRCLEQ_HEAD_INITIALIZER.3
+CIRCLEQ_LAST.3
+CIRCLEQ_LOOP_NEXT.3
+CIRCLEQ_LOOP_PREV.3
+CIRCLEQ_NEXT.3
+CIRCLEQ_PREV.3
+    Michael Kerrisk
+        Add missing links to circleq.3
+
+pthread_attr_getsigmask_np.3
+    Michael Kerrisk
+        New link to pthread_attr_setsigmask_np.3
+
+
+Global changes
+--------------
+
+Various pages
+    Alejandro Colomar
+        Use Oxford comma
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+    Michael Kerrisk
+        BUGS: note that faccessat() wrapper function emulation ignores ACLs
+
+bpf.2
+    Michael Kerrisk
+        Place EXAMPLES section in correct location
+
+cacheflush.2
+    Alejandro Colomar
+        Document Architecture-specific variants
+    Alejandro Colomar  [Heinrich Schuchardt]
+        Document __builtin___clear_cache() as a more portable alternative
+
+chroot.2
+memfd_create.2
+tailq.3
+    Michael Kerrisk  [Alejandro Colomar]
+        Fix unbalanced .nf/.fi
+
+clock_getres.2
+    Michael Kerrisk
+        Place ERRORS in alphabetical order
+
+clone.2
+sigaltstack.2
+    Michael Kerrisk
+        clone(CLONE_VM) disables the alternate signal stack
+
+getrlimit.2
+    Michael Kerrisk
+        State more precisely the range of kernel versions that had RLIMIT_LOCKS
+
+getrusage.2
+    Michael Kerrisk
+        Note that the 'vtimes' symbol exists only up to glibc 2.32
+
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+    Alejandro Colomar
+        SYNOPSIS: s/io_context_t/aio_context_t/
+            Linux uses aio_context_t for these syscalls,
+            and it's the type provided by <linux/aio_abi.h>.
+            Use it in the SYNOPSIS.
+
+            libaio uses 'io_context_t', but that difference is already noted
+            in NOTES.
+
+io_setup.2
+    Alejandro Colomar
+        SYNOPSIS: return long
+
+link.2
+    Mathias Rav
+        ERRORS: add ENOENT when target is deleted
+            Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part
+            of kernel release v2.6.39) added a check to disallow creating a
+            hard link to an unlinked file.
+
+llseek.2
+    Michael Kerrisk
+        Note size of 'loff_t' type
+    Michael Kerrisk
+        Point the reader to lseek64(3) for info about llseek(3)
+    Michael Kerrisk
+        Some mild rewriting to ease reading of the info in this page
+
+mmap.2
+    Michael Kerrisk
+        Clarify SIGBUS text and treatment of partial page at end of a mapping
+
+mount.2
+statfs.2
+    Ross Zwisler
+        Add NOSYMFOLLOW flags to mount(2) and statfs(2)
+
+msgctl.2
+    Michael Kerrisk
+        Make comments in 'msqid_ds' definition more compact
+    Michael Kerrisk
+        Place list of field descriptions in same order as structure definition
+    Michael Kerrisk
+        Use field name "msg_cbytes" rather than "__msg_cbytes"
+    Michael Kerrisk
+        Add description of 'msg_cbytes' field
+
+openat.2
+    Colin Ian King
+        Fix include path, should be linux/openat2.h
+
+perf_event_open.2
+    Namhyung Kim  [Alejandro Colomar]
+        Update man page with recent kernel changes
+    Alejandro Colomar
+        Assign calculated value explicitly to 'config'
+
+restart_syscall.2
+    Alejandro Colomar
+        SYNOPSIS: Fix restart_syscall() return type
+
+set_tid_address.2
+    Alejandro Colomar
+        SYNOPSIS: Fix set_tid_address() return type
+
+shmctl.2
+    Michael Kerrisk
+        Place list of field descriptions in same order as structure definition
+
+sigaction.2
+    Michael Kerrisk
+        Clarify description of SA_NODEFER
+            Clarify description of SA_NODEFER, and note interaction with
+            act.sa_mask.
+    Michael Kerrisk
+        Add a cross-reference to signal(7) for further info on 'ucontext_t'
+
+sigaltstack.2
+    Michael Kerrisk
+        Clarify that the alternate signal stack is per-thread
+            Clarify that the alternate signal stack is per-thread (rather
+            than process-wide).
+
+spu_create.2
+    Michael Kerrisk
+        Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM
+    Michael Kerrisk
+        Relocate paragraph on 'mode' argument
+    Michael Kerrisk  [Alejandro Colomar]
+        Clarify that spu_create() now has 4 arguments but once had only 3
+
+subpage_prot.2
+    Alejandro Colomar
+        SYNOPSIS: Fix return type: s/long/int/
+
+syscalls.2
+    Michael Kerrisk
+        Add process_madvise()
+    Michael Kerrisk
+        Note that sysctl() was removed in Linux 5.5
+
+timer_getoverrun.2
+    Michael Kerrisk
+        timer_getoverrun() now clamps the overrun count to DELAYTIMER_MAX
+            See https://bugzilla.kernel.org/show_bug.cgi?id=12665.
+
+uselib.2
+posix_memalign.3
+profil.3
+rtime.3
+    Michael Kerrisk
+        Remove some text about libc/libc5
+            With this change, there remain almost no vestiges of information
+            about the long defunct Linux libc.
+
+errno.3
+    Michael Kerrisk
+        Note another possible cause of the EMFILE error
+
+getcontext.3
+    Michael Kerrisk
+        Mention SA_SIGINFO flag when talking about 3-argument signal handler
+    Michael Kerrisk
+        SEE ALSO: add signal(7)
+
+list.3
+    Michael Kerrisk
+        NAME: remove LIST_PREV, which is not documented in this page
+
+lseek64.3
+    Michael Kerrisk
+        Remove section numbers from interface list
+    Michael Kerrisk
+        Remove sentence saying lseek64() is an alias for llseek()
+    Michael Kerrisk
+        NOTES: describe the origin of lseek64() in LFS
+
+nextafter.3
+    Michael Kerrisk
+        Remove duplicate "BUGS" section heading
+
+pthread_tryjoin_np.3
+    Michael Kerrisk  [Mike Crowe]
+        Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug
+
+rcmd.3
+    Michael Kerrisk
+        SEE ALSO: remove intro(2)
+
+strnlen.3
+    Michael Kerrisk  [Heinrich Schuchardt]
+        Fix a small inconsistency in the text
+
+elf.5
+    Michael Kerrisk
+        SEE ALSO: add objcopy(1)
+
+filesystems.5
+    Ahelenia Ziemiańska  [Alejandro Colomar]
+        Fix link to user space tooling for ncpfs
+    Ahelenia Ziemiańska  [Alejandro Colomar]
+        Note ncpfs removal from kernel
+
+attributes.7
+    Michael Kerrisk
+        SEE ALSO: add signal-safety(7)
+
+fanotify.7
+    Amir Goldstein  [Jan Kara]
+        fix outdated description
+
+kernel_lockdown.7
+    Michael Kerrisk
+        Remove unneeded quotes
+
+packet.7
+    Baruch Siach  [Alejandro Colomar]
+        Update references to kernel documentation
+
+pthreads.7
+    Michael Kerrisk
+        Rephrase function list in terms of POSIX rather than SUS
+            The list was using an inconsistent mixture of "POSIX" and "SUS".
+
+signal.7
+    Michael Kerrisk  [Heinrich Schuchardt, Dave Martin]
+        Add some details on the execution of signal handlers
+            Add a "big picture" of what happens when a signal handler
+            is invoked.
+    Michael Kerrisk
+        Add pidfd_send_signal() to list of APIs for sending signals
+    Michael Kerrisk
+        Mention 'ucontext_t' in the discussion of signal handler execution
+    Michael Kerrisk
+        SEE ALSO: add swapcontext(3)
+
+signal-safety.7
+    Michael Kerrisk
+        Note async-signal-safety details for errno
+
+standards.7
+    Michael Kerrisk
+        Add URL for POSIX.1-2008/SUSv4
+    Michael Kerrisk
+        Add LFS (Large File Summit)
+    Michael Kerrisk  [Rob Landley]
+        Fix some URLs for locations of the standards
+    Michael Kerrisk
+        Relocate the discussion on POSIX manual pages
+
+tcp.7
+    Alejandro Colomar  [Philip Rowlands]
+        tcp_syncookies: It is now an integer [0, 2]
+            Since Linux kernel 3.12, tcp_syncookies can have the value 2,
+            which sends out cookies unconditionally.