Changes: Ready for 5.08

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

1 files changed, 309 insertions, 6 deletions

diff --git a/Changes b/Changes
index 005d870be..fd7878883 100644
--- a/Changes
+++ b/Changes
@@ -10,26 +10,329 @@ 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:
 
+Alejandro Colomar <colomar.6.4.3@gmail.com>
+Aleksa Sarai <cyphar@cyphar.com>
+Alyssa Ross <hi@alyssa.is>
+Andrew Price <anprice@redhat.com>
+Andy Lutomirski <luto@kernel.org>
+Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
+Benjamin Peterson <benjamin@python.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Bruno Haible <bruno@clisp.org>
+Carlos O'Donell <carlos@redhat.com>
+Catalin Marinas <catalin.marinas@arm.com>
+Dan Kenigsberg <danken@redhat.com>
+Dave Martin <Dave.Martin@arm.com>
+Diogo Miguel Ferreira Rodrigues <dmfrodrigues2000@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Geoff Clare <gwc@opengroup.org>
+Helge Kreutzmann <debian@helgefjell.de>
+Jakub Wilk <jwilk@jwilk.net>
+Jeff Layton <jlayton@kernel.org>
+John Scott <jscott@posteo.net>
+Kumar Kartikeya Dwivedi <memxor@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Oleksandr Kravchuk <open.source@oleksandr-kravchuk.com>
+Philip Adams <mail@philipadams.org>
+Rich Felker <dalias@libc.org>
+Saikiran Madugula <hummerbliss@gmail.com>
+Stephen Hemminger <stephen@networkplumber.org>
+Sven Hoexter <sven@stormbind.net>
+Thomas Bartelsmeier <t.bartelsmeier@gmail.com>
+Thomas Piekarski <t.piekarski@deloquencia.de>
+victorm007@yahoo.com
 
 Apologies if I missed anyone!
 
 
-New and rewritten pages
------------------------
-
-
 Newly documented interfaces in existing pages
 ---------------------------------------------
 
+prctl.2
+    Dave Martin
+        Add SVE prctls (arm64)
+            Add documentation for the the PR_SVE_SET_VL and PR_SVE_GET_VL
+            prctls added in Linux 4.15 for arm64.
+    Dave Martin  [Catalin Marinas]
+        Add tagged address ABI control prctls (arm64)
+            Add documentation for the the PR_SET_TAGGED_ADDR_CTRL and
+            PR_GET_TAGGED_ADDR_CTRL prctls added in Linux 5.4 for arm64.
+
+setns.2
+    Michael Kerrisk
+        Document the use of PID file descriptors with setns()
+            Starting with Linux 5.8, setns() can take a PID file descriptor as
+            an argument, and move the caller into or more of the namespaces of
+            the thread referred to by that descriptor.
 
-New and changed links
----------------------
+capabilities.7
+    Michael Kerrisk
+        Document CAP_BPF
+    Michael Kerrisk
+        Add CAP_PERFMON
+
+symlink.7
+    Aleksa Sarai
+        Document magic links more completely
 
 
 Global changes
 --------------
 
+A few pages
+    Michael Kerrisk
+        Use \` rather than `
+            \` produces better rendering in PDF.
+
+Various pages
+    Michael Kerrisk  [Geoff Clare]
+        Use "\(ti" instead of "~"
+            A naked tilde ("~") renders poorly in PDF. Instead use "\(ti",
+            which renders better in a PDF, and produces the same glyph
+            when rendering on a terminal.
+
+Various pages
+    Michael Kerrisk  [Geoff Clare]
+        Use "\(ha" rather than "^" in code
+            This renders better in PDF.
+
+Various pages
+    Mike Frysinger
+        Drop "coding: UTF-8" header
+            This header is used inconsistently -- man pages are UTF-8 encoded
+            but not setting this marker.  It's only respected by the man-db
+            package, and seems a bit anachronistic at this point when UTF-8
+            is the standard default nowadays.
+
+Various pages
+    Mike Frysinger
+        Trim leading blank comment line
+            Very few pages do this, so trim them.
+
+Various pages
+    Mike Frysinger
+        Use standard .\" comment style
+            The \" comment produces blank lines.  Use the .\" that the vast
+            majority of the codebase uses instead.
+
+Various pages
+    Mike Frysinger  [G. Branden Robinson]
+        Various pages: Drop t comment header
+            Historically, a comment of the following form at the top of a
+            manual page was used to indicate too man(1) that the use of tbl(1)
+            was required in order to process tables:
+
+                '\" t
+
+            However, at least as far back as 2001 (according to Branden),
+            man-db's man(1) automatically uses tbl(1) as needed, rendering
+            this comment unnecessary. And indeed many existing pages in
+            man-pages that have tables don't have this comment at the top of
+            the file.  So, drop the comment from those files where it is
+            present.
+
 
 Changes to individual pages
 ---------------------------
 
+ioctl_tty.2
+    Michael Kerrisk
+        Fix a confusing wording error in description of TIOCSPTLCK
+
+iopl.2
+    Thomas Piekarski  [victorm007@yahoo.com]
+        Updating description of permissions and disabling interrupts
+            Update description of permissions for port-mapped I/O set
+            per-thread and not per-process. Mention that iopl() can not
+            disable interrupts since Linux 5.5 anymore and is in general
+            deprecated and only provided for legacy X servers.
+
+            See https://bugzilla.kernel.org/show_bug.cgi?id=205317
+
+keyctl.2
+    Oleksandr Kravchuk
+        Declare auth_key to fix a compilation error in example code
+
+lseek.2
+    Andrew Price
+        List gfs2 support for SEEK_HOLE/SEEK_DATA
+
+mount.2
+    Michael Kerrisk
+        ERRORS: add EINVAL for bind mount of mount namespace inode
+
+open.2
+    Michael Kerrisk
+        Say a bit more about what happens when 'mode' is wrongly omitted
+
+pidfd_open.2
+    Michael Kerrisk
+        Add the setns(2) use case for PID file descriptors
+    Michael Kerrisk
+        Close the pidfd in EXAMPLE
+            Close the PID file descriptor in the example program, to hint to
+            the reader that like every other kind of file descriptor, a PID FD
+            should be closed.
+
+prctl.2
+    Michael Kerrisk
+        The parent death signal is cleared on some credential changes
+            See kernel/cred.c::commit_creds() in the Linux 5.6 source code.
+
+seccomp.2
+    Andy Lutomirski
+        Improve x32 and nr truncation notes
+
+send.2
+recv.2
+    Alyssa Ross
+        Add msg_iovlen POSIX note
+            msg_iovlen is incorrectly typed (according to POSIX) in addition
+            to msg_controllen, but unlike msg_controllen, this wasn't
+            mentioned for msg_iovlen.
+
+setns.2
+    Michael Kerrisk
+        EXAMPLE: use O_CLOEXEC when opening namespace file descriptor
+    Michael Kerrisk
+        It is possible to setns() to the caller's current PID namespace
+            The page currently incorrectly says that 'fd' must refer to
+            a descendant PID namespace. However, 'fd' can also refer to
+            the caller's current PID namespace. Verified by experiment,
+            and also comments in kernel/pid_namespace.c (Linux 5.8-rc1).
+
+sync.2
+    Jeff Layton
+        syncfs() now returns errors if writeback fails
+            A patch has been merged for v5.8 that changes how syncfs() reports
+            errors. Change the sync() manpage accordingly.
+
+syscalls.2
+    Michael Kerrisk
+        Add faccessat2(), added in Linux 5.8
+
+sysctl.2
+    Michael Kerrisk
+        glibc removed support for sysctl() starting in version 2.32
+
+atoi.3
+    Arkadiusz Drabczyk
+        Explain disadvantages of atoi()
+    Michael Kerrisk
+        Relocate BUGS section
+    Michael Kerrisk
+        Add NOTES section explaining 0 return value on error
+            And note that this is not specified by POSIX.
+
+fread.3
+    Arkadiusz Drabczyk
+        Add example
+    Arkadiusz Drabczyk
+        Explain that file position is moved after calling fread()/fwrite()
+            Corresponding manpage on FreeBSD already contains that
+            information.
+
+getpt.3
+posix_openpt.3
+pts.4
+    Michael Kerrisk
+        Use the term "pseudoterminal multiplexor device" for /dev/ptmx
+            Let's use some consistent terminology for this device.
+
+posix_memalign.3
+    Bruno Haible
+        Clarify how to free the result of posix_memalign
+
+pthread_rwlockattr_setkind_np.3
+    Carlos O'Donell  [Kumar Kartikeya Dwivedi]
+        Clarify a PTHREAD_RWLOCK_PREFER_WRITER_NP detail
+
+queue.3
+    Alejandro Colomar
+        Remove wrong code from example
+    Alejandro Colomar
+        Comment out text for functions not in glibc (related: 6559169cac)
+
+pts.4
+    Michael Kerrisk
+        Remove NOTES on BSD pseudoterminals
+            This information is already covered better in pty(7). No need to
+            mention it again here.
+
+hosts.5
+    Thomas Bartelsmeier
+        Clarify capability for IPv6 outside of examples
+            Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279
+
+proc.5
+    Jakub Wilk
+        Use "pwd -P" for printing cwd
+            "/bin/pwd" happens to work with the GNU coreutils implementation,
+            which has -P as the default, contrary to POSIX requirements.
+
+            Use "pwd -P" instead, which is shorter, easier to type, and should
+            work everywhere.
+    Arkadiusz Drabczyk
+        Inform that comm in /proc/pid/{stat,status} might also be truncated
+            pgrep for example searches for a process name in /proc/pid/status
+
+resolv.conf.5
+    Michael Kerrisk  [Helge Kreutzmann]
+        Clarify that ip6-bytestring was removed in 2.25
+
+capabilities.7
+    Dan Kenigsberg
+        Clarify that CAP_SYS_NICE relates to *lowering* the nice value
+    Saikiran Madugula
+        CAP_SYS_RESOURCE: add two more items for POSIX message queues
+            CAP_SYS_RESOURCE also allows overriding /proc/sys/fs/mqueue/msg_max
+            and /proc/sys/fs/mqueue/msgsize_max.
+    Michael Kerrisk  [Dan Kenigsberg]
+        Clarify wording around increasing process nice value
+    Michael Kerrisk
+        SEE ALSO: add getpcaps(8)
+
+cgroups.7
+cpuset.7
+    Sven Hoexter
+        Update kernel cgroup documentation references
+            cgroups-v1/v2 documentation got moved to the "admin-guide" subfolder
+            and converted from .txt files to .rst
+
+ip.7
+    Michael Kerrisk  [Stephen Hemminger]
+        Remove mention of ipfw(4) which was in long obsolete ipchains project
+
+man-pages.7
+    Michael Kerrisk
+        Add some notes on generating optimal glyphs
+            Getting nice renderings of ^ ` and ~ requires special
+            steps in the page source.
+
+pty.7
+    Michael Kerrisk
+        Explicitly mention CONFIG_LEGACY_PTYS
+            Explicitly mention CONFIG_LEGACY_PTYS, and note that it is disabled
+            by default since Linux 2.6.30.
+    Michael Kerrisk
+        Relocate a paragraph to NOTES
+
+standards.7
+    Michael Kerrisk
+        Add an entry for POSIX.1-1988
+    Michael Kerrisk  [Geoff Clare]
+        Correct various details in the explanation of XPG/POSIX/SUS
+
+ld.so.8
+    Florian Weimer  [Michael Kerrisk]
+        List more places in which dynamic string tokens are expanded
+            This happens for more than just DT_RPATH/DT_RUNPATH.
+    Arkadiusz Drabczyk
+        Explain that empty entry in LD_LIBRARY_PATH means cwd
+
+zic.8
+    Michael Kerrisk
+        Sync to 2020a tzdb release
+            From https://www.iana.org/time-zones, version 2020a.