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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes

@@ -1,4 +1,4 @@
-==================== Changes in man-pages-5.12 ====================
+==================== Changes in man-pages-5.13 ====================
 
 Released: ????-??-??, Munich
 

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

man-pages-5.13.Announce

@@ -1,7 +1,7 @@
 RELEASE
 The Linux man page maintainer proudly announces. . .
 
-    man-pages-5.12.tar.gz - man pages for Linux
+    man-pages-5.13.tar.gz - man pages for Linux
 
 Differences from the previous manual pages release are listed in
 the file "Changes".

man-pages-5.13.lsm

@@ -1,13 +1,13 @@
 Begin3
 Title:          Section 2, 3, 4, 5 and 7 man pages for Linux
-Version:        5.12
+Version:        5.13
 Entered-date:   ????-??-??
 Description:    Linux manual pages
 Keywords:       man pages
 Author:         several
 Maintained-by:  Michael Kerrisk <mtk.manpages@gmail.com>
 Primary-site:   http://www.kernel.org/pub/linux/docs/man-pages
-                ????k man-pages-5.12.tar.gz
+                ????k man-pages-5.13.tar.gz
 Copying-policy: several; the pages are all freely distributable as long as
 		nroff source is provided
 End

man2/exit_group.2

@@ -22,7 +22,7 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.TH EXIT_GROUP 2 2008-11-27 "Linux" "Linux Programmer's Manual"
+.TH EXIT_GROUP 2 2021-06-20 "Linux" "Linux Programmer's Manual"
 .SH NAME
 exit_group \- exit all threads in a process
 .SH SYNOPSIS

man2/ioctl_fideduperange.2

@@ -25,8 +25,8 @@
 ioctl_fideduperange \- share some the data of one file with another file
 .SH SYNOPSIS
 .nf
-.BR "#include <linux/fs.h>" "      /* Definition of " FIDEDUPERANGE " and 
-.BR "                              FILE_DEDUPE_* " constants */"
+.BR "#include <linux/fs.h>" "      /* Definition of " FIDEDUPERANGE " and
+.BR "                              FILE_DEDUPE_* " constants */
 .B #include <sys/ioctl.h>
 .PP
 .BI "int ioctl(int " src_fd ", FIDEDUPERANGE, struct file_dedupe_range *" arg );

man2/ioprio_set.2

@@ -21,7 +21,7 @@
 .\" with various additions by Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
 .\"
-.TH IOPRIO_SET 2 2019-03-06 "Linux" "Linux Programmer's Manual"
+.TH IOPRIO_SET 2 2021-06-20 "Linux" "Linux Programmer's Manual"
 .SH NAME
 ioprio_get, ioprio_set \- get/set I/O scheduling class and priority
 .SH SYNOPSIS

man2/mount.2

@@ -221,6 +221,12 @@ Do not allow programs to be executed from this filesystem.
 .B MS_NOSUID
 Do not honor set-user-ID and set-group-ID bits or file capabilities
 when executing programs from this filesystem.
+In addition, SELinux domain
+transitions require the permission
+.IR nosuid_transition ,
+which in turn needs
+also the policy capability
+.IR nnp_nosuid_transition .
 .\" (This is a security feature to prevent users executing set-user-ID and
 .\" set-group-ID programs from removable disk devices.)
 .TP

man2/pipe.2

@@ -56,7 +56,7 @@ pipe, pipe2 \- create pipe
 .B struct fd_pair {
 .B "    long fd[2];"
 .B "};"
-.B struct fd_pair pipe();
+.B struct fd_pair pipe(void);
 .fi
 .SH DESCRIPTION
 .BR pipe ()

man2/process_madvise.2

@@ -25,7 +25,7 @@
 .\"
 .\" Commit ecb8ac8b1f146915aa6b96449b66dd48984caacc
 .\"
-.TH PROCESS_MADVISE 2 2021-01-12 "Linux" "Linux Programmer's Manual"
+.TH PROCESS_MADVISE 2 2021-06-20 "Linux" "Linux Programmer's Manual"
 .SH NAME
 process_madvise \- give advice about use of memory to a process
 .SH SYNOPSIS

man2/s390_guarded_storage.2

@@ -38,7 +38,7 @@ s390_guarded_storage \- operations with z/Architecture guarded storage facility
 .PP
 .IR Note :
 glibc provides no wrapper for
-.BR s390_guarded_storage (2),
+.BR s390_guarded_storage (),
 necessitating the use of
 .BR syscall (2).
 .SH DESCRIPTION

man2/s390_runtime_instr.2

@@ -36,7 +36,7 @@ s390_runtime_instr \- enable/disable s390 CPU run-time instrumentation
 .PP
 .IR Note :
 glibc provides no wrapper for
-.BR s390_runtime_instr (2),
+.BR s390_runtime_instr (),
 necessitating the use of
 .BR syscall (2).
 .SH DESCRIPTION

man2/s390_sthyi.2

@@ -38,7 +38,7 @@ s390_sthyi \- emulate STHYI instruction
 .PP
 .IR Note :
 glibc provides no wrapper for
-.BR s390_sthyi (2),
+.BR s390_sthyi (),
 necessitating the use of
 .BR syscall (2).
 .SH DESCRIPTION

man2/seccomp.2

@@ -31,20 +31,25 @@
 seccomp \- operate on Secure Computing state of the process
 .SH SYNOPSIS
 .nf
-.B #include <linux/seccomp.h>
-.B #include <linux/filter.h>
-.B #include <linux/audit.h>
-.B #include <linux/signal.h>
-.B #include <sys/ptrace.h>
+.BR "#include <linux/seccomp.h>" "  /* Definition of " SECCOMP_* " constants */"
+.BR "#include <linux/filter.h>" "   /* Definition of " "struct sock_fprog" " */"
+.BR "#include <linux/audit.h>" "    /* Definition of " AUDIT_* " constants */"
+.BR "#include <linux/signal.h>" "   /* Definition of " SIG* " constants */"
+.BR "#include <sys/ptrace.h>" "     /* Definition of " PTRACE_* " constants */"
 .\" Kees Cook noted: Anything that uses SECCOMP_RET_TRACE returns will
 .\"                  need <sys/ptrace.h>
+.BR "#include <sys/syscall.h>" "    /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
 .PP
-.BI "int seccomp(unsigned int " operation ", unsigned int " flags \
-", void *" args );
+.BI "int syscall(SYS_seccomp, unsigned int " operation ", unsigned int " flags ,
+.BI "            void *" args );
 .fi
 .PP
 .IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+glibc provides no wrapper for
+.BR seccomp (),
+necessitating the use of
+.BR syscall (2).
 .SH DESCRIPTION
 The
 .BR seccomp ()
@@ -930,9 +935,6 @@ Tile (since Linux 4.3)
 PA-RISC (since Linux 4.6)
 .\" User mode Linux since Linux 4.6
 .PD
-.PP
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
 .\"
 .SS Caveats
 There are various subtleties to consider when applying seccomp filters

man2/seccomp_unotify.2

@@ -22,7 +22,7 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.TH SECCOMP_UNOTIFY 2 2020-10-01 "Linux" "Linux Programmer's Manual"
+.TH SECCOMP_UNOTIFY 2 2021-06-20 "Linux" "Linux Programmer's Manual"
 .SH NAME
 seccomp_unotify \- Seccomp user-space notification mechanism
 .SH SYNOPSIS

man2/set_mempolicy.2

@@ -24,7 +24,7 @@
 .\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com>
 .\"     more precise specification of behavior.
 .\"
-.TH SET_MEMPOLICY 2 2020-12-21 Linux "Linux Programmer's Manual"
+.TH SET_MEMPOLICY 2 2021-06-20 Linux "Linux Programmer's Manual"
 .SH NAME
 set_mempolicy \- set default NUMA memory policy for a thread and its children
 .SH SYNOPSIS

man2/set_tid_address.2

@@ -22,7 +22,7 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.TH SET_TID_ADDRESS 2 2020-12-21 "Linux" "Linux Programmer's Manual"
+.TH SET_TID_ADDRESS 2 2021-06-20 "Linux" "Linux Programmer's Manual"
 .SH NAME
 set_tid_address \- set pointer to thread ID
 .SH SYNOPSIS

man2/spu_create.2

@@ -27,16 +27,20 @@
 spu_create \- create a new spu context
 .SH SYNOPSIS
 .nf
-.B #include <sys/types.h>
-.B #include <sys/spu.h>
+.BR "#include <sys/spu.h>" "          /* Definition of " SPU_* " constants */"
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
 .PP
-.BI "int spu_create(const char *" pathname ", unsigned int " flags \
-", mode_t " mode ,
-.BI "               int " neighbor_fd ");"
+.BI "int syscall(SYS_spu_create, const char *" pathname \
+", unsigned int " flags ,
+.BI "            mode_t " mode ", int " neighbor_fd );
 .fi
 .PP
 .IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+glibc provides no wrapper for
+.BR spu_create (),
+necessitating the use of
+.BR syscall (2).
 .SH DESCRIPTION
 The
 .BR spu_create ()
@@ -260,9 +264,6 @@ This call is Linux-specific and implemented only on the PowerPC
 architecture.
 Programs using this system call are not portable.
 .SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
-Note however, that
 .BR spu_create ()
 is meant to be used from libraries that implement a more abstract
 interface to SPUs, not to be used from regular applications.

man2/spu_run.2

@@ -28,13 +28,18 @@
 spu_run \- execute an SPU context
 .SH SYNOPSIS
 .nf
-.B #include <sys/spu.h>
+.BR "#include <sys/spu.h>" "          /* Definition of " SPU_* " constants */"
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
 .PP
 .BI "int spu_run(int " fd ", uint32_t *" npc ", uint32_t *" event );
 .fi
 .PP
 .IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+glibc provides no wrapper for
+.BR spu_run (),
+necessitating the use of
+.BR syscall (2).
 .SH DESCRIPTION
 The
 .BR spu_run ()
@@ -195,9 +200,6 @@ This call is Linux-specific and implemented only by the PowerPC
 architecture.
 Programs using this system call are not portable.
 .SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
-Note however, that
 .BR spu_run ()
 is meant to be used from libraries that implement a more abstract
 interface to SPUs, not to be used from regular applications.

man2/stat.2

@@ -41,7 +41,6 @@
 stat, fstat, lstat, fstatat \- get file status
 .SH SYNOPSIS
 .nf
-.B #include <sys/types.h>
 .B #include <sys/stat.h>
 .PP
 .BI "int stat(const char *restrict " pathname ,
@@ -50,7 +49,7 @@ stat, fstat, lstat, fstatat \- get file status
 .BI "int lstat(const char *restrict " pathname ,
 .BI "         struct stat *restrict " statbuf );
 .PP
-.BR "#include <fcntl.h>           " "/* Definition of AT_* constants */"
+.BR "#include <fcntl.h>           " "/* Definition of " AT_* " constants */"
 .B #include <sys/stat.h>
 .PP
 .BI "int fstatat(int " dirfd ", const char *restrict " pathname ,

man2/statx.2

@@ -32,9 +32,8 @@
 statx \- get file status (extended)
 .SH SYNOPSIS
 .nf
+.BR "#include <fcntl.h>           " "/* Definition of " AT_* " constants */"
 .B #include <sys/stat.h>
-.B #include <unistd.h>
-.BR "#include <fcntl.h>           " "/* Definition of AT_* constants */"
 .PP
 .BI "int statx(int " dirfd ", const char *restrict " pathname ", int " flags ,
 .BI "          unsigned int " mask ", struct statx *restrict " statxbuf );

man2/subpage_prot.2

@@ -32,12 +32,18 @@
 subpage_prot \- define a subpage protection for an address range
 .SH SYNOPSIS
 .nf
-.BI "int subpage_prot(unsigned long " addr ", unsigned long " len \
-", uint32_t *" map );
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
+.PP
+.BI "int syscall(SYS_subpage_prot, unsigned long " addr ", unsigned long " len ,
+.BI "            uint32_t *" map );
 .fi
 .PP
 .IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+glibc provides no wrapper for
+.BR subpage_prot (),
+necessitating the use of
+.BR syscall (2).
 .SH DESCRIPTION
 The PowerPC-specific
 .BR subpage_prot ()
@@ -96,9 +102,6 @@ No library support is provided.
 .SH CONFORMING TO
 This system call is Linux-specific.
 .SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
-.PP
 Normal page protections (at the 64-kB page level) also apply;
 the subpage protection mechanism is an additional constraint,
 so putting 0 in a 2-bit field won't allow writes to a page that is otherwise

man2/swapon.2

@@ -44,7 +44,6 @@
 swapon, swapoff \- start/stop swapping to file/device
 .SH SYNOPSIS
 .nf
-.B #include <unistd.h>
 .B #include <sys/swap.h>
 .PP
 .BI "int swapon(const char *" path ", int " swapflags );

man2/symlink.2

@@ -39,7 +39,7 @@ symlink, symlinkat \- make a new name for a file
 .PP
 .BI "int symlink(const char *" target ", const char *" linkpath );
 .PP
-.BR "#include <fcntl.h>           " "/* Definition of AT_* constants */"
+.BR "#include <fcntl.h>           " "/* Definition of " AT_* " constants */"
 .B #include <unistd.h>
 .PP
 .BI "int symlinkat(const char *" target ", int " newdirfd \

man2/syscall.2

@@ -44,8 +44,8 @@
 syscall \- indirect system call
 .SH SYNOPSIS
 .nf
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
 .B #include <unistd.h>
-.BR "#include <sys/syscall.h>   "  "/* For SYS_xxx definitions */"
 .PP
 .BI "long syscall(long " number ", ...);"
 .fi

man2/syslog.2

@@ -35,10 +35,14 @@ syslog, klogctl \- read and/or clear kernel message ring buffer;
 set console_loglevel
 .SH SYNOPSIS
 .nf
-.BI "int syslog(int " type ", char *" bufp ", int " len );
+.BR "#include <sys/klog.h>" "        /* Definition of " SYSLOG_* " constants */"
+.BR "#include <sys/syscall.h>" "     /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
+.PP
+.BI "int syscall(SYS_syslog, int " type ", char *" bufp ", int " len );
 .PP
 /* The glibc interface */
-.B "#include <sys/klog.h>"
+.B #include <sys/klog.h>
 .PP
 .BI "int klogctl(int " type ", char *" bufp ", int " len );
 .fi

man2/timer_create.2

@@ -28,7 +28,7 @@
 timer_create \- create a POSIX per-process timer
 .SH SYNOPSIS
 .nf
-.B  #include <signal.h>
+.BR "#include <signal.h>" "           /* Definition of " SIGEV_* " constants */"
 .B  #include <time.h>
 .PP
 .BI "int timer_create(clockid_t " clockid ", struct sigevent *restrict " sevp ,

man2/tkill.2

@@ -31,14 +31,22 @@
 tkill, tgkill \- send a signal to a thread
 .SH SYNOPSIS
 .nf
-.BI "int tkill(pid_t " tid ", int " sig );
-.BI "int tgkill(pid_t " tgid ", pid_t " tid ", int " sig );
+.BR "#include <signal.h>" "           /* Definition of " SIG* " constants */"
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
+.PP
+.BI "int syscall(SYS_tkill, pid_t " tid ", int " sig );
+.PP
+.B #include <signal.h>
+.PP
+.BI "int tgkill, pid_t " tgid ", pid_t " tid ", int " sig );
 .fi
 .PP
 .IR Note :
-There is no glibc wrapper for
-.BR tkill ();
-see NOTES.
+glibc provides no wrapper for
+.BR tkill (),
+necessitating the use of
+.BR syscall (2).
 .SH DESCRIPTION
 .BR tgkill ()
 sends the signal
@@ -138,10 +146,6 @@ in
 .BR clone (2)
 for an explanation of thread groups.
 .PP
-Glibc does not provide a wrapper for
-.BR tkill ();
-call it using
-.BR syscall (2).
 Before glibc 2.30, there was also no wrapper function for
 .BR tgkill ().
 .SH SEE ALSO

man2/truncate.2

@@ -46,7 +46,6 @@ truncate, ftruncate \- truncate a file to a specified length
 .SH SYNOPSIS
 .nf
 .B #include <unistd.h>
-.B #include <sys/types.h>
 .PP
 .BI "int truncate(const char *" path ", off_t " length );
 .BI "int ftruncate(int " fd ", off_t " length );

man2/umask.2

@@ -36,7 +36,6 @@
 umask \- set file mode creation mask
 .SH SYNOPSIS
 .nf
-.B #include <sys/types.h>
 .B #include <sys/stat.h>
 .PP
 .BI "mode_t umask(mode_t " mask );

man2/unlink.2

@@ -39,7 +39,7 @@ unlink, unlinkat \- delete a name and possibly the file it refers to
 .PP
 .BI "int unlink(const char *" pathname );
 .PP
-.BR "#include <fcntl.h>           " "/* Definition of AT_* constants */"
+.BR "#include <fcntl.h>           " "/* Definition of " AT_* " constants */"
 .B #include <unistd.h>
 .PP
 .BI "int unlinkat(int " dirfd ", const char *" pathname ", int " flags );

man2/userfaultfd.2

@@ -29,14 +29,18 @@
 userfaultfd \- create a file descriptor for handling page faults in user space
 .SH SYNOPSIS
 .nf
-.B #include <sys/types.h>
-.B #include <linux/userfaultfd.h>
+.BR "#include <fcntl.h>" "            /* Definition of " O_* " constants */"
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
 .PP
-.BI "int userfaultfd(int " flags );
+.BI "int syscall(SYS_userfaultfd, int " flags );
 .fi
 .PP
 .IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+glibc provides no wrapper for
+.BR userfaultfd (),
+necessitating the use of
+.BR syscall (2).
 .SH DESCRIPTION
 .BR userfaultfd ()
 creates a new userfaultfd object that can be used for delegation of page-fault
@@ -575,9 +579,6 @@ non-page-fault events was added in Linux 4.11
 is Linux-specific and should not be used in programs intended to be
 portable.
 .SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
-.PP
 The userfaultfd mechanism can be used as an alternative to
 traditional user-space paging techniques based on the use of the
 .BR SIGSEGV

man2/utime.2

@@ -33,7 +33,6 @@
 utime, utimes \- change file last access and modification times
 .SH SYNOPSIS
 .nf
-.B #include <sys/types.h>
 .B #include <utime.h>
 .PP
 .BI "int utime(const char *" filename ", const struct utimbuf *" times );

man2/utimensat.2

@@ -28,7 +28,7 @@
 utimensat, futimens \- change file timestamps with nanosecond precision
 .SH SYNOPSIS
 .nf
-.B #include <fcntl.h>           /* Definition of AT_* constants */
+.BR "#include <fcntl.h>" "            /* Definition of " AT_* " constants */"
 .B #include <sys/stat.h>
 .PP
 .BI "int utimensat(int " dirfd ", const char *" pathname ,

man2/vmsplice.2

@@ -30,7 +30,6 @@ vmsplice \- splice user pages to/from a pipe
 .nf
 .BR "#define _GNU_SOURCE" "         /* See feature_test_macros(7) */"
 .B #include <fcntl.h>
-.B #include <sys/uio.h>
 .PP
 .BI "ssize_t vmsplice(int " fd ", const struct iovec *" iov ,
 .BI "                 size_t " nr_segs ", unsigned int " flags );

man2/wait.2

@@ -51,7 +51,6 @@
 wait, waitpid, waitid \- wait for process to change state
 .SH SYNOPSIS
 .nf
-.B #include <sys/types.h>
 .B #include <sys/wait.h>
 .PP
 .BI "pid_t wait(int *" "wstatus" );

man2/wait4.2

@@ -35,9 +35,6 @@
 wait3, wait4 \- wait for process to change state, BSD style
 .SH SYNOPSIS
 .nf
-.B #include <sys/types.h>
-.B #include <sys/time.h>
-.B #include <sys/resource.h>
 .B #include <sys/wait.h>
 .PP
 .BI "pid_t wait3(int *" "wstatus" ", int " options ", struct rusage *" rusage );

man3/MAX.3

@@ -0,0 +1,90 @@
+.\" Copyright (C) 2021 Alejandro Colomar <alx.manpages@gmail.com>
+.\"
+.\" %%%LICENSE_START(VERBATIM)
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date.  The author(s) assume no
+.\" responsibility for errors or omissions, or for damages resulting from
+.\" the use of the information contained herein.  The author(s) may not
+.\" have taken the same level of care in the production of this manual,
+.\" which is licensed free of charge, as they might when working
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
+.\"
+.TH MAX 3 2020-11-01 "Linux" "Linux Programmer's Manual"
+.SH NAME
+MAX, MIN \- maximum or minimum of two values
+.SH SYNOPSIS
+.nf
+.B #include <sys/param.h>
+.PP
+.BI MAX( a ", " b );
+.BI MIN( a ", " b );
+.fi
+.SH DESCRIPTION
+These macros return the maximum or minimum of
+.I a
+and
+.IR b .
+.SH RETURN VALUE
+These macros return the value of one of their arguments,
+possibly converted to a different type (see BUGS).
+.SH ERRORS
+These macros may raise the "invalid" floating-point exception
+when any of the arguments is NaN.
+.SH CONFORMING TO
+These nonstandard macros are present in glibc and the BSDs.
+.SH NOTES
+If either of the arguments is of a floating-point type,
+you might prefer to use
+.BR fmax (3)
+or
+.BR fmin (3),
+which can handle NaN.
+.PP
+The arguments may be evaluated more than once, or not at all.
+.PP
+Some UNIX systems might provide these macros in a different header,
+or not at all.
+.SH BUGS
+Due to the usual arithmetic conversions,
+the result of these macros may be very different from either of the arguments.
+To avoid this, ensure that both arguments have the same type.
+.SH EXAMPLES
+.EX
+#include <stdio.h>
+#include <stdlib.h>
+#include <sys/param.h>
+
+int
+main(int argc, char *argv[])
+{
+    int a, b, x;
+
+    if (argc != 3) {
+        fprintf(stderr, "Usage: %s <num> <num>\en", argv[0]);
+        exit(EXIT_FAILURE);
+    }
+
+    a = atoi(argv[1]);
+    b = atoi(argv[2]);
+    x = MAX(a, b);
+    printf("MAX(%d, %d) is %d\en", a, b, x);
+
+    exit(EXIT_SUCCESS);
+}
+.EE
+.SH SEE ALSO
+.BR fmax (3),
+.BR fmin (3)

man3/MIN.3

@@ -0,0 +1 @@
+.so man3/MAX.3

man3/bswap.3

@@ -22,7 +22,7 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.TH BSWAP 3 2020-11-01 "Linux" "Linux Programmer's Manual"
+.TH BSWAP 3 2021-06-20 "Linux" "Linux Programmer's Manual"
 .SH NAME
 bswap_16, bswap_32, bswap_64 \- reverse order of bytes
 .SH SYNOPSIS

man3/ferror.3

@@ -85,7 +85,7 @@ function returns nonzero if the end-of-file indicator is set for
 otherwise, it returns zero.
 .PP
 The
-.BR feof ()
+.BR ferror ()
 function returns nonzero if the error indicator is set for
 .IR stream ;
 otherwise, it returns zero.

man3/getline.3

@@ -59,9 +59,7 @@ one was found.
 .PP
 If
 .I "*lineptr"
-is set to NULL and
-.I *n
-is set 0 before the call, then
+is set to NULL before the call, then
 .BR getline ()
 will allocate a buffer for storing the line.
 This buffer should be freed by the user program

man3/strcmp.3

@@ -143,7 +143,7 @@ First, some examples using
 .EX
 $ \fB./string_comp ABC ABC\fP
 <str1> and <str2> are equal
-$ \fB./string_comp ABC AB\fP      # \(aqC\(aq is ASCII 67; \(aqC\(aq \- \(aq\0\(aq = 67
+$ \fB./string_comp ABC AB\fP      # \(aqC\(aq is ASCII 67; \(aqC\(aq \- \(aq\e0\(aq = 67
 <str1> is greater than <str2> (67)
 $ \fB./string_comp ABA ABZ\fP     # \(aqA\(aq is ASCII 65; \(aqZ\(aq is ASCII 90
 <str1> is less than <str2> (\-25)

man7/kernel_lockdown.7

@@ -9,7 +9,7 @@
 .\" 2 of the License, or (at your option) any later version.
 .\" %%%LICENSE_END
 .\"
-.TH KERNEL_LOCKDOWN 7 2020-11-01 Linux "Linux Programmer's Manual"
+.TH KERNEL_LOCKDOWN 7 2021-06-20 Linux "Linux Programmer's Manual"
 .SH NAME
 kernel_lockdown \- kernel image access prevention feature
 .SH DESCRIPTION