Michael Kerrisk
These interfaces have per-thread semantics
- The page was previously fuzzy about whether the these interfaces
+ The page was previously fuzzy about whether these interfaces
have process-wide or per-thread semantics. (E.g., now the
page states that the calling *thread* (not process) is suspended
until the signal is delivered.)
memchr.3
Michael Kerrisk
- Add feature text macro requirements for memrchr()
+ Add feature test macro requirements for memrchr()
nextafter.3
Michael Kerrisk
Michael Kerrisk
Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
_POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
- obsolete bu _POSIX_C_SOURCE. Retaining mention of it
+ obsolete by _POSIX_C_SOURCE. Retaining mention of it
in the feature test macro requirements section of the
SYNOPSIS doesn't contain important information, and may
mislead readers into actually trying to use this macro.
locale.5
Marko Myllynen
Adjust LC_IDENTIFICATION / abbreviation
- Tiny tweak to locale.5 based on the on ISO/IEC TR 14652:
+ Tiny tweak to locale.5 based on ISO/IEC TR 14652:
http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf
Marko Myllynen
Michael Kerrisk [Per Böhlin]
RLIMIT_CORE is not enforced when piping core dump to a program
Michael Kerrisk
- SEE ALO: add systemd-coredump(8)
+ SEE ALSO: add systemd-coredump(8)
Michael Kerrisk
SEE ALSO: add coredumpctl(1)
to the process is somewhat redundant. Binaries with capabilities
confer capabilities only to those process capability sets, so it's
simpler to just say "confers capabilities to the process".
+
+
+==================== Changes in man-pages-4.15 ====================
+
+Released: 2018-02-02, Palo Alto
+
+
+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:
+
+Adam Liddell <ml+kernel.org@aliddell.com>
+Andrea Parri <parri.andrea@gmail.com>
+Andries E. Brouwer <Andries.Brouwer@cwi.nl>
+Elie Roudninski <xademax@gmail.com>
+Eric Benton <erbenton@comcast.net>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Joel Williamson <jwilliamson@carnegietechnologies.com>
+John Hubbard <jhubbard@nvidia.com>
+Jorgen Hansen <jhansen@vmware.com>
+Keno Fischer <keno@juliacomputing.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@kernel.org>
+NeilBrown <neilb@suse.com>
+Nikola Forró <nforro@redhat.com>
+Nikolay Borisov <nborisov@suse.com>
+Pradeep Kumar <pradeepsixer@gmail.com>
+QingFeng Hao <haoqf@linux.vnet.ibm.com>
+Ricardo Biehl Pasquali <pasqualirb@gmail.com>
+roblabla <man-pages@roblab.la>
+Roman Gushchin <guro@fb.com>
+Shawn Landden <slandden@gmail.com>
+Stefan Hajnoczi <stefanha@redhat.com>
+Stefan Raspl <raspl@linux.vnet.ibm.com>
+Tejun Heo <tj@kernel.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+s390_sthyi.2
+ QingFeng Hao [Michael Kerrisk]
+ New page for s390-specific s390_sthyi(2)
+
+network_namespaces.7
+ Michael Kerrisk
+ New page describing network namespaces
+ Based on content moved from namespaces(7)
+
+vsock.7
+ Stefan Hajnoczi [Jorgen Hansen, Michael Kerrisk]
+ Document the VSOCK socket address family
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+cgroups.7
+ Michael Kerrisk [Tejun Heo]
+ Document cgroups v2 "thread mode"
+ Michael Kerrisk [Tejun Heo]
+ Document cgroup v2 delegation via the 'nsdelegate' mount option
+ Michael Kerrisk
+ Document the cgroup.max.depth and cgroup.max.descendants files
+ Michael Kerrisk
+ Document 'release_agent' mount option
+ Michael Kerrisk [Roman Gushchin]
+ Document /sys/kernel/cgroup/delegate
+ Michael Kerrisk [Roman Gushchin]
+ Document /sys/kernel/cgroup/features
+ Michael Kerrisk [Roman Gushchin]
+ Document cgroups v2 cgroup.stat file
+
+
+Global changes
+--------------
+
+Various pages
+ G. Branden Robinson
+ Standardize on "nonzero"
+ Also add this term to the style guide in man-pages(7).
+
+
+Changes to individual pages
+---------------------------
+
+bpf.2
+ Nikolay Borisov
+ Sync list of supported map types with 4.14 kernel
+
+copy_file_range.2
+ Michael Kerrisk
+ Library support was added in glibc 2.27
+ Shawn Landden
+ glibc provides a user-space emulation where the system call is absent
+ Florian Weimer
+ EFBIG errors are possible, similar to write(2)
+ Michael Kerrisk
+ ERRORS: add EISDIR
+ Michael Kerrisk
+ Order ERRORS alphabetically
+ Michael Kerrisk
+ Add comment to code example explaining use of syscall(2)
+
+fcntl.2
+read.2
+write.2
+ NeilBrown
+ Document "Lost locks" as cause for EIO.
+ If an advisory lock is lost, then read/write requests on any
+ affected file descriptor can return EIO - for NFSv4 at least.
+
+memfd_create.2
+ Michael Kerrisk
+ glibc support for memfd_create() was added in version 2.27
+
+mlock.2
+ Michael Kerrisk
+ Make details for MLOCK_ONFAULT a little more explicit
+ Michael Kerrisk
+ glibc support for mlock2() is added in version 2.27
+
+mmap.2
+ John Hubbard [Michael Hocko]
+ MAP_FIXED is no longer discouraged
+ MAP_FIXED has been widely used for a very long time, yet the man
+ page still claims that "the use of this option is discouraged".
+ John Hubbard
+ MAP_FIXED updated documentation
+ -- Expand the documentation to discuss the hazards in
+ enough detail to allow avoiding them.
+
+ -- Mention the upcoming MAP_FIXED_SAFE flag.
+
+ -- Enhance the alignment requirement slightly.
+
+mount.2
+ Keno Fischer [Michael Kerrisk]
+ Add EINVAL error condition when MS_BINDing MNT_LOCKED submounts
+
+mprotect.2
+pkey_alloc.2
+ Michael Kerrisk
+ Glibc support for memory protection keys was added in version 2.27
+
+perf_event_open.2
+ Michael Kerrisk
+ SEE ALSO: add perf(1)
+
+pkey_alloc.2
+ Michael Kerrisk
+ Clarify description of pkey_alloc() 'flags' argument
+
+prctl.2
+ Michael Kerrisk
+ Defer to capabilities(7) for discussion of the "keep capabilities" flag
+
+recvmmsg.2
+sendmmsg.2
+ Nikola Forró
+ Point out that error handling is unreliable
+
+seccomp.2
+ Michael Kerrisk
+ Clarify that SECCOMP_RET_TRAP SIGSYS signal is thread-directed
+
+syscalls.2
+ Michael Kerrisk
+ Add s390-specific s390_sthyi(2) to syscall list
+
+unshare.2
+ Michael Kerrisk
+ Clarify that EUSERS occurred only until kernel 4.8
+
+errno.3
+ Michael Kerrisk
+ 'errno -s' can be used to search for errors by string in description
+ Michael Kerrisk
+ Add Linux error text corresponding to ENOMEM
+
+fgetpwent.3
+ Michael Kerrisk
+ Add missing ATTRIBUTES preamble
+
+fts.3
+ Michael Kerrisk [Pradeep Kumar]
+ fts_pathlen = strlen(fts_path) + strlen(fts_name)
+
+fuse.4
+ Michael Kerrisk
+ Places errors in alphabetical order (no content changes)
+
+veth.4
+ Michael Kerrisk
+ Add network_namespaces(7)
+
+sysfs.5
+ Michael Kerrisk
+ Refer to cgroups(7) for information about files in /sys/kernel/cgroup
+
+capabilities.7
+ Michael Kerrisk
+ Note which capability sets are affected by SECBIT_NO_SETUID_FIXUP
+ Note explicitly that SECBIT_NO_SETUID_FIXUP is relevant for
+ the permitted, effective, and ambient capability sets.
+ Michael Kerrisk
+ Deemphasize the ancient prctl(2) PR_SET_KEEPCAPS command
+ The modern approach is SECBITS_KEEP_CAPS.
+ Michael Kerrisk
+ Clarify effect of CAP_SETFCAP
+ Make it clear that CAP_SETFCAP allows setting arbitrary
+ capabilities on a file.
+ Michael Kerrisk
+ Clarify which capability sets are effected by SECBIT_KEEP_CAPS
+ This flag has relevance only for the process permitted and
+ effective sets.
+ Michael Kerrisk
+ Rephrase CAP_SETPCAP description
+ * Mention kernel versions.
+ * Place current kernel behavior first
+ Michael Kerrisk
+ SECBIT_KEEP_CAPS is ignored if SECBIT_NO_SETUID_FIXUP is set
+ Michael Kerrisk
+ Ambient set is also cleared when UIDs are set to nonzero value
+
+cgroups.7
+ Michael Kerrisk
+ Add a more complete description of cgroup v1 named hierarchies
+ Michael Kerrisk
+ Add a section on unmounting cgroup v1 filesystems
+ Michael Kerrisk
+ Add subsection describing cgroups v2 subtree delegation
+ Michael Kerrisk
+ Mention ENOENT error that can occur when writing to subtree_control file
+ Michael Kerrisk
+ Add list of currently available version 2 controllers
+ Nikolay Borisov
+ Add information about RDMA controller
+ Michael Kerrisk
+ Rewrite the description of cgroup v2 subtree control
+ Michael Kerrisk [Tejun Heo]
+ Note Linux 4.11 changes to cgroup v2 delegation containment rules
+ Michael Kerrisk
+ systemd(1) nowadays automatically mounts the cgroup2 filesystem
+ Michael Kerrisk
+ Clarify that cgroup.controllers is read-only
+ Michael Kerrisk
+ Elaborate a little on problems of splitting threads across cgroups in v1
+ Michael Kerrisk [Tejun Heo]
+ Tweak the description of delegation of cgroup.subtree_control
+
+ip.7
+ Ricardo Biehl Pasquali
+ INADDR_* values cannot be assigned directly to 's_addr'
+ Michael Kerrisk
+ s/INADDR_ANY/INADDR_LOOPBACK/ in discussion of htonl()
+ INADDR_LOOPBACK is a better example, since it is not
+ byte-order neutral.
+
+namespaces.7
+network_namespaces.7
+ Michael Kerrisk
+ Move content from namespaces(7) to network_namespaces(7)
+
+pid_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add mount_namespaces(7)
+
+sched.7
+ Michael Kerrisk [Andrea Parri]
+ Correctly describe effect of priority changes for RT threads
+ The placement of a thread in the run queue for its new
+ priority depends on the direction of movement in priority.
+ (This appears to contradict POSIX, except in the case of
+ pthread_setschedprio().)
+
+user_namespaces.7
+ Michael Kerrisk
+ Mention NS_GET_OWNER_UID ioctl() operation
+
+
+==================== Changes in man-pages-4.16 ====================
+
+Released: 2018-04-30, 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:
+
+Adam Borowski <kilobyte@angband.pl>
+Andy Owen <andrew.owen@dolby.com>
+Carlos O'Donell <carlos@redhat.com>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Elvira Khabirova <lineprinter@altlinux.org>
+Enrique Garcia <cquike@arcor.de>
+Frederic Brault <fbrault@xyalis.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Howard Johnson <hwj@BridgeportContractor.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+John Hubbard <jhubbard@nvidia.com>
+Jürg Billeter <j@bitron.ch>
+Konstantin Grinemayer <cdlscpmv@gmail.com>
+Konstantin Khlebnikov <khlebnikov@yandex-team.ru>
+Martin Mares <mj@ucw.cz>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Mattias Andrée <maandree@kth.se>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mike Frysinger <vapier@gentoo.org>
+Nikos Mavrogiannopoulos <nmavrogi@redhat.com>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+Ross Zwisler <ross.zwisler@linux.intel.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Serge E. Hallyn <serge@hallyn.com>
+Song Liu <songliubraving@fb.com>
+Tomi Salminen <tsalminen@forcepoint.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+membarrier.2
+ Mathieu Desnoyers [Michael Kerrisk]
+ Document new membarrier commands introduced in Linux 4.16
+ Document the following membarrier commands introduced in
+ Linux 4.16:
+
+ MEMBARRIER_CMD_GLOBAL_EXPEDITED
+ (the old enum label MEMBARRIER_CMD_SHARED is now an
+ alias to preserve header backward compatibility)
+ MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED
+ MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE
+ MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE
+
+mmap.2
+ Jan Kara [Ross Zwisler, Michael Kerrisk]
+ Add description of MAP_SHARED_VALIDATE and MAP_SYNC
+ Michal Hocko [John Hubbard, Michael Kerrisk, Jann Horn]
+ Document new MAP_FIXED_NOREPLACE flag
+ 4.17+ kernels offer a new MAP_FIXED_NOREPLACE flag which allows
+ the caller to atomically probe for a given address range.
+
+readv.2
+io_submit.2
+ Jürg Billeter
+ Document RWF_APPEND added in Linux 4.16
+
+capabilities.7
+ Michael Kerrisk
+ Describe file capability versioning
+ Michael Kerrisk [Serge E. Hallyn]
+ Document namespaced-file capabilities
+ [There's still more work to be done on this new text]
+
+
+Changes to individual pages
+---------------------------
+
+bpf.2
+ Michael Kerrisk
+ Update list of architectures that support JITed eBPF
+ And note kernel version numbers where support is added.
+ Michael Kerrisk
+ Kernel 4.15 added CONFIG_BPF_JIT_ALWAYS_ON
+ This causes the JIT compiler to be always on and
+ forces bpf_jit_enable to 1.
+
+execve.2
+ Michael Kerrisk
+ Note that describing execve as "executing a new process" is misleading
+ This misdescription is so common that it's worth calling it out
+ explicitly.
+ Michael Kerrisk
+ More explicitly describe effect of execve() in the opening paragraph
+
+fallocate.2
+ Michael Kerrisk
+ Since Linux 4.16, Btrfs supports FALLOC_FL_ZERO_RANGE
+
+getrlimit.2
+ Michael Kerrisk
+ CAP_SYS_RESOURCE capability is required in *initial user namespace*
+
+io_submit.2
+ Michael Kerrisk
+ Add kernel version numbers for various 'aio_rw_flags' flags
+ Michael Kerrisk
+ Place 'aio_rw_flags' in alphabetical order
+
+mmap.2
+ Jann Horn
+ MAP_FIXED is okay if the address range has been reserved
+ Clarify that MAP_FIXED is appropriate if the specified address
+ range has been reserved using an existing mapping, but shouldn't
+ be used otherwise.
+ Michael Kerrisk
+ Move the text on MAP_FIXED to NOTES
+ This text has become rather long, making it somewhat
+ unwieldy in the discussion of the mmap() flags. Therefore,
+ move it to NOTES, with a pointer in DESCRIPTION referring
+ the reader to NOTES.
+ Michael Kerrisk [Heinrich Schuchardt]
+ Clarify that when addr==NULL, address chosen by kernel is page-aligned
+ Michael Kerrisk
+ Add a little historical detail on the obsolete MAP_DENYWRITE
+
+mount.2
+ Michael Kerrisk
+ ERRORS: add EBUSY for the case of trying to stack same mount twice
+ Michael Kerrisk
+ Remove a couple of obsolete EBUSY errors
+ As far as I can tell, these EBUSY errors disappeared
+ with the addition of stackable mounts in Linux 2.4.
+
+msgget.2
+semget.2
+shmget.2
+ Michael Kerrisk
+ The purpose of "flags" == 0 is to obtain ID of an existing IPC object
+ This was implied in these pages, but the meaning of "flags" == 0
+ could be more explicit, as indicated by questions such as
+ https://stackoverflow.com/questions/49833569/flag-value-of-semget-function
+
+open.2
+ Jann Horn
+ Document more -ETXTBSY conditions
+ Jakub Wilk
+ Add missing argument for snprintf() in example code
+
+perf_event_open.2
+ Song Liu
+ Add type kprobe and uprobe
+ Two new types kprobe and uprobe are being added to
+ perf_event_open(), which allow creating kprobe or
+ uprobe with perf_event_open. This patch adds
+ information about these types.
+
+ptrace.2
+ Jann Horn
+ Copy retval info for SECCOMP_GET_FILTER to right section
+ The "RETURN VALUE" section made a claim that was incorrect for
+ PTRACE_SECCOMP_GET_FILTER. Explicitly describe the behavior of
+ PTRACE_SECCOMP_GET_FILTER in the "RETURN VALUE" section (as
+ usual), but leave the now duplicate description in the section
+ describing PTRACE_SECCOMP_GET_FILTER, since the
+ PTRACE_SECCOMP_GET_FILTER section would otherwise probably become
+ harder to understand.
+
+readv.2
+ Michael Kerrisk
+ Remove redundant sentence
+
+seccomp.2
+ Michael Kerrisk
+ Note that execve() may change syscall numbers during life of process
+ On a multiarch/multi-ABI platform such as modern x86, each
+ architecture/ABI (x86-64, x32, i386)has its own syscall numbers,
+ which means a seccomp() filter may see different syscall numbers
+ over the life of the process if that process uses execve() to
+ execute programs that has a different architectures/ABIs.
+ Michael Kerrisk
+ Note which architectures support seccomp BPF
+ Michael Kerrisk
+ In EXAMPLE, clearly note that x32 syscalls are >= X32_SYSCALL_BIT
+
+shutdown.2
+ Carsten Grohmann
+ SEE ALSO: add close(2)
+
+syscall.2
+ Adam Borowski
+ Add riscv
+
+wait.2
+ Michael Kerrisk [Robin Kuzmin]
+ wait() and waitpid() block the calling thread (not process)
+
+wait4.2
+ Michael Kerrisk [Martin Mares]
+ Soften the warning against the use of wait3()/wait4()
+ These functions are nonstandard, but there is no replacement.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=199215
+
+crypt.3
+encrypt.3
+ Carlos O'Donell [Michael Kerrisk]
+ Add notes about _XOPEN_CRYPT
+ The distribution may choose not to support _XOPEN_CRYPT in the
+ case that the distribution has transitioned from glibc crypt to
+ libxcrypt.
+
+fseek.3
+ Michael Kerrisk [Andy Owen]
+ ERRORS: EBADF should be ESPIPE
+ Michael Kerrisk
+ Improve EPIPE error text
+
+getcwd.3
+ Carlos O'Donell
+ Mention that "(unreachable)" is no longer returned for glibc >= 2.27.
+
+makedev.3
+ Michael Kerrisk
+ Since glibc 2.28, <sys/types.h> no longer defines these macros
+
+pthread_create.3
+ Frederic Brault
+ Note default thread stack size for several architectures
+
+tsearch.3
+ Jann Horn
+ Clarify items vs nodes
+ The manpage claimed that tsearch() returns a pointer to a data
+ item. This is incorrect; tsearch() returns a pointer to the
+ corresponding tree node, which can also be interpreted as a
+ pointer to a pointer to the data item.
+
+ Since this API is quite unintuitive, also add a clarifying
+ sentence.
+ Jann Horn
+ tdelete() can return dangling pointers
+ POSIX says that deleting the root node must cause tdelete() to
+ return some unspecified non-NULL pointer. Glibc implements it by
+ returning a dangling pointer to the (freed) root node.
+ Therefore, explicitly note that tdelete() may return bad pointers
+ that must not be accessed.
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add patchelf(1)
+
+filesystems.5
+ Michael Kerrisk
+ Add an entry for tmpfs(5)
+
+group.5
+ Michael Kerrisk
+ SEE ALSO: add vigr(8)
+
+passwd.5
+ Michael Kerrisk
+ SEE ALSO: add vipw(8)
+
+sysfs.5
+ Michael Kerrisk
+ Add brief note on /sys/fs/smackfs
+
+tmpfs.5
+ Mike Frysinger
+ Document current mount options
+ Some of this content is moved from the mount(8) man page.
+ Style was based on proc(5) sections.
+ Michael Kerrisk
+ Remove reference to mount(8) for discussion of mount options
+ The mount options are now described in this page.
+ Michael Kerrisk
+ SEE ALSO: add Documentation/vm/transhuge.txt
+ Michael Kerrisk
+ Reformat 'huge' and 'mpol' mount option values as lists
+ Michael Kerrisk
+ Describe 'mpol' mount options
+ Based on text from Documentation/filesystems/tmpfs.txt.
+ Michael Kerrisk
+ Document 'huge' mount options
+ Based on text from Documentation/vm/transhuge.txt.
+ Michael Kerrisk
+ SEE ALSO: add set_mempolicy(2)
+ Michael Kerrisk
+ Document mpol=local mount option
+
+capabilities.7
+ Michael Kerrisk
+ Remove redundant mention of PTRACE_SECCOMP_GET_FILTER
+
+cgroups.7
+ Michael Kerrisk
+ cgroup.events transitions generate POLLERR as well as POLLPRI
+
+mount_namespaces.7
+ Michael Kerrisk
+ Note another case where shared "peer groups" are formed
+
+namespaces.7
+ Michael Kerrisk [Konstantin Khlebnikov]
+ Mention that device ID should also be checked when comparing NS symlinks
+ When comparing two namespaces symlinks to see if they refer to
+ the same namespace, both the inode number and the device ID
+ should be compared. This point was already made clear in
+ ioctl_ns(2), but was missing from this page.
+ Michael Kerrisk
+ Note an idiosyncrasy of /proc/[pid]/ns/pid_for_children
+ /proc/[pid]/ns/pid_for_children has a value only after first
+ child is created in PID namespace. Verified by experiment.
+
+network_namespaces.7
+ Michael Kerrisk
+ Network namespaces isolate the UNIX domain abstract socket namespace
+ Michael Kerrisk
+ Add cross reference to unix(7)
+ For further information on UNIX domain abstract sockets.
+
+posixoptions.7
+ Carlos O'Donell
+ Expand XSI Options groups
+ We define in detail the X/Open System Interfaces i.e. _XOPEN_UNIX
+ and all of the X/Open System Interfaces (XSI) Options Groups.
+
+ The XSI options groups include encryption, realtime, advanced
+ realtime, realtime threads, advanced realtime threads, tracing,
+ streams, and legacy interfaces.
+ Michael Kerrisk
+ Use a more consistent, less cluttered layout for option lists
+ Michael Kerrisk
+ Make function lists more consistent and less cluttered
+ Use more consistent layout for lists of functions, and
+ remove punctuation from the lists to make them less cluttered.
+
+socket.7
+ Michael Kerrisk [Tomi Salminen]
+ Fix error in SO_INCOMING_CPU code snippet
+ The last argument is passed by value, not reference.
+
+time.7
+ Michael Kerrisk [Enrique Garcia]
+ Mention clock_gettime()/clock_settime() rather than [gs]ettimeofday()
+ gettimeofday() is declared obsolete by POSIX. Mention instead
+ the modern APIs for working with the realtime clock.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=199049
+
+unix.7
+ Michael Kerrisk [Rusty Russell]
+ ERRORS: add EBADF for sending closed file descriptor with SCM_RIGHTS
+
+vdso.7
+ Michael Kerrisk
+ VDSO symbols (system calls) are not visible to seccomp(2) filters
+
+xattr.7
+ Michael Kerrisk
+ SEE ALSO: add selinux(8)
+
+ld.so.8
+ Mike Frysinger
+ Make lack of separator escaping explicit
+ Make it clear that the delimiters in LD_PRELOAD, LD_LIBRARY_PATH,
+ and LD_AUDIT cannot be escaped so people don't try various methods
+ (such as \:) to workaround it.
+ Michael Kerrisk
+ Remove unneeded mention of PATH in discussion of LD_LIBRARY_PATH
+ This brief sentence doesn't add value to the text.
+
+
+==================== Changes in man-pages-5.00 ====================
+
+Released: 2019-03-06, 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:
+
+Adam Manzanares <adam.manzanares@wdc.com>
+Alan Jenkins <alan.christopher.jenkins@gmail.com>
+Alec Leamas <leamas.alec@gmail.com>
+Alessandro Vesely <vesely@tana.it>
+Alexander E. Patrakov <patrakov@gmail.com>
+Allison Randal <allison@lohutok.net>
+Amir Goldstein <amir73il@gmail.com>
+Anatoly Borodin <anatoly.borodin@gmail.com>
+Andreas Gruenbacher <agruenba@redhat.com>
+Andreas Westfeld <andreas.westfeld@htw-dresden.de>
+Andrei Vagin <avagin@openvz.org>
+Andrew Price <andy@andrewprice.me.uk>
+Anthony Iliopoulos <ailiopoulos@suse.com>
+Antonio Chirizzi <antonio.chirizzi@gmail.com>
+Antonio Ospite <ao2@ao2.it>
+Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
+Balbir Singh <bsingharora@gmail.com>
+Benjamin Peterson <benjamin@python.org>
+Bernd Petrovitsch <bernd@petrovitsch.priv.at>
+bert hubert <bert.hubert@powerdns.com>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Burkhard Lück <lueck@hube-lueck.de>
+Carlos O'Donell <carlos@redhat.com>
+Claudio Scordino <claudio@evidence.eu.com>
+Daniel Borkmann <daniel@iogearbox.net>
+Daniel Kamil Kozar <dkk089@gmail.com>
+Davidlohr Bueso <dave@stgolabs.net>
+Davidlohr Bueso <dbueso@suse.de>
+David Newall <glibc@davidnewall.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Elliot Hughes <enh@google.com>
+Elvira Khabirova <lineprinter@altlinux.org>
+Emil Fihlman <emil.fihlman@gmail.com>
+Enrico Scholz <enrico.scholz@sigma-chemnitz.de>
+Eric Benton <erbenton@comcast.net>
+Eric Sanchis <eric.sanchis@iut-rodez.fr>
+Eugene Syromiatnikov <esyr@redhat.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Felipe Gasper <felipe@felipegasper.com>
+Florian Weimer <fweimer@redhat.com>
+Frank Theile <ftheile@grundfos.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Goldwyn Rodrigues <rgoldwyn@suse.com>
+Goldwyn Rodrigues <rgoldwyn@suse.de>
+Göran Häggsjö <goran.haggsjo@icloud.com>
+Harry Mallon <hjmallon@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Heiko Carstens <heiko.carstens@de.ibm.com>
+Helge Deller <deller@gmx.de>
+Henry Wilson <henry.wilson@acentic.com>
+Hiroya Ito <hiroyan@gmail.com>
+Howard Johnson <hj@HowardJohnson.name>
+Ian Turner <iturner@janestreet.com>
+Ignat Loskutov <ignat.loskutov@gmail.com>
+Ingo Schwarze <schwarze@usta.de>
+Jakub Wilk <jwilk@jwilk.net>
+James Weigle <jtweigle@uchicago.edu>
+Jann Horn <jannh@google.com>
+Jann Horn <jann@thejh.net>
+Jason A. Donenfeld <Jason@zx2c4.com>
+Jeff Moyer <jmoyer@redhat.com>
+Jens Thoms Toerring <jt@toerring.de>
+Joe Lawrence <joe.lawrence@redhat.com>
+Johannes Altmanninger <aclopte@gmail.com>
+Johannes Liebermann <johanan.liebermann@gmail.com>
+Jonny Grant <jg@jguk.org>
+Joseph C. Sible <josephcsible@gmail.com>
+Joseph Sible <josephcsible@gmail.com>
+Josh Gao <jmgao@google.com>
+Josh Triplett <josh@joshtriplett.org>
+Kees Cook <keescook@chromium.org>
+Keith Thompson <Keith.S.Thompson@gmail.com>
+Keno Fischer <keno@juliacomputing.com>
+Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
+Konst Mayer <cdlscpmv@gmail.com>
+Leah Hanson <lhanson@pivotal.io>
+Lucas De Marchi <lucas.demarchi@intel.com>
+Lucas Werkmeister <mail@lucaswerkmeister.de>
+Luka Macan <Luka.Macan@fer.hr>
+Marc-André Lureau <marcandre.lureau@redhat.com>
+Marcus Gelderie <marcus.gelderie@gmail.com>
+Marcus Gelderie <redmnic@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Mark Schott <schottm@google.com>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Kilgore <mattkilgore12@gmail.com>
+Mattias Engdegård <mattiase@acm.org>
+Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
+Michael Becker <mjbecker@web.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Witten <mfwitten@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mihir Mehta <mihir@cs.utexas.edu>
+Mike Frysinger <vapier@chromium.org>
+Mike Frysinger <vapier@gentoo.org>
+Mike Rapoport <rppt@linux.ibm.com>
+Mike Weilgart <mike.weilgart@verticalsysadmin.com>
+Nadav Har'El <nyh@math.technion.ac.il>
+Nick Gregory <ghost@capsule8.com>
+Niklas Hambüchen <mail@nh2.me>
+Nikola Forró <nforro@redhat.com>
+nixiaoming <nixiaoming@huawei.com>
+Oded Elisha <oded123456@gmail.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Millar <paul.millar@desy.de>
+Philip Dumont <phil@solidstatescientific.com>
+Pierre Chifflier <pollux@debian.org>
+Quentin Monnet <quentin.monnet@netronome.com>
+Radostin Stoyanov <rstoyanov1@gmail.com>
+Robert O'Callahan <robert@ocallahan.org>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+ruschein <ruschein@protonmail.com>
+Sam Varshavchik <mrsam@courier-mta.com>
+Sean Young <sean@mess.org>
+Shawn Landden <shawn@git.icu>
+Simone Piccardi <piccardi@truelite.it>
+snyh <snyh@snyh.org>
+Solal Pirelli <solal.pirelli@gmail.com>
+Stan Schwertly <stan@schwertly.com>
+Stephan Knauss <linux@stephans-server.de>
+Szabolcs Nagy <szabolcs.nagy@arm.com>
+Thomas Posch <kernel.org@online.posch.name>
+Tobias Klauser <tklauser@distanz.ch>
+Troy Engel <troyengel@gmail.com>
+Tycho Andersen <tycho@tycho.ws>
+Tycho Kirchner <tychokirchner@mail.de>
+Vince Weaver <vincent.weaver@maine.edu>
+Wang Nan <wangnan0@huawei.com>
+William Kucharski <william.kucharski@oracle.com>
+Xiao Yang <yangx.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+s390_guarded_storage.2
+ Eugene Syromyatnikov
+ New page documenting s390_guarded_storage(2) s390-specific system call
+
+address_families.7
+ Michael Kerrisk [Eugene Syromyatnikov]
+ New page that contains details of socket address families
+ There is too much detail in socket(2). Move most of it into
+ a new page instead.
+
+bpf-helpers.7
+ Michael Kerrisk [Daniel Borkmann, Quentin Monnet]
+ Add new man page for eBPF helper functions
+ (autogenerated from kernel source files)
+
+
+Removed Pages
+-------------
+
+mdoc.7
+mdoc.samples.7
+ Michael Kerrisk [Ingo Schwarze]
+ Remove mdoc(7) and mdoc.samples(7)
+ groff_mdoc(7) from the groff project provides a better
+ equivalent of mdoc.samples(7) and the 'mandoc' project
+ provides a better mdoc(7). And nowadays, there are virtually
+ no pages in "man-pages" that use mdoc markup.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify_init.2
+fanotify.7
+ nixiaoming [Amir Goldstein, Michael Kerrisk]
+ Document FAN_REPORT_TID
+ fanotify_init.2: add new flag FAN_REPORT_TID
+ fanotify.7: update description of member pid in
+ struct fanotify_event_metadata
+ Amir Goldstein
+ Document FAN_MARK_FILESYSTEM
+ Monitor fanotify events on the entire filesystem.
+ Matthew Bobrowski [Amir Goldstein]
+ Document FAN_OPEN_EXEC and FAN_OPEN_EXEC_PERM
+
+io_submit.2
+ Adam Manzanares
+ Document IOCB_FLAG_IOPRIO
+
+msgctl.2
+semctl.2
+shmctl.2
+ Davidlohr Bueso [Joe Lawrence, Michael Kerrisk]
+ Document STAT_ANY commands
+
+prctl.2
+ Konrad Rzeszutek Wilk [Michael Kerrisk]
+ Document PR_SET_SPECULATION_CTRL and PR_GET_SPECULATION_CTRL
+
+sched_setattr.2
+ Claudio Scordino [Michael Kerrisk]
+ Document SCHED_FLAG_DL_OVERRUN and SCHED_FLAG_RECLAIM
+
+socket.2
+ Tobias Klauser
+ Document AF_XDP
+ Document AF_XDP added in Linux 4.18.
+
+inotify.7
+ Henry Wilson
+ Document IN_MASK_CREATE
+
+unix.7
+ Michael Kerrisk
+ Document SO_PASSSEC
+ Michael Kerrisk
+ Document SCM_SECURITY ancillary data
+
+
+New and changed links
+---------------------
+
+reallocarray.3
+ Michael Kerrisk
+ New link to malloc(3)
+
+precedence.7
+ Josh Triplett
+ Add as a redirect to operator.7
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk [G. Branden Robinson]
+ Use '\e' rather than '\\' to get a backslash
+
+Various pages
+ Michael Kerrisk [Bjarni Ingi Gislason, G. Branden Robinson]
+ Use zero‐width space in appropriate locations
+
+Various pages
+ Michael Kerrisk
+ Clarify the distinction between "file descriptor" and "file description"
+
+Various pages
+ Mike Rapoport
+ Update paths for in-kernel memory management documentation files
+
+A few pages
+ Michael Kerrisk
+ Change references to '2.6.0-test*' series kernels to just '2.6.0'
+
+
+Changes to individual pages
+---------------------------
+
+iconv.1
+ Marko Myllynen
+ SEE ALSO: add uconv(1)
+
+localedef.1
+ Howard Johnson
+ Note that -f and -c, are reversed from what you might expect
+
+time.1
+ Michael Kerrisk [Johannes Altmanninger]
+ Document the -q/--quiet option
+ Jakub Wilk
+ Update bug reporting address
+
+bpf.2
+ Tobias Klauser
+ Update JIT support list for Linux 4.18
+ JIT support for x86-32 was during the Linux 4.18 release cycle.
+ Also correct the entry for MIPS (only MIPS64 is supported).
+ Oded Elisha
+ Fix bug in example
+ Quentin Monnet
+ SEE ALSO: add bpf-helpers(7)
+
+capget.2
+ Michael Kerrisk
+ Remove crufty sentence suggesting use of deprecated functions
+ Remove crufty sentence suggesting use of deprecated capsetp(3) and
+ capgetp(3); the manual page for those functions has long (at least
+ as far back as 2007) noted that they are deprecated.
+ Michael Kerrisk
+ Remove first paragraph, which repeats details from capabilities(7)
+
+chroot.2
+ Michael Kerrisk
+ Mention /proc/[pid]/root
+
+clock_getres.2
+ Michael Kerrisk [Jens Thoms Toerring]
+ CLOCK_MONOTONIC_RAW does not count while the system is suspended
+ Michael Kerrisk [Jens Thoms Toerring]
+ On Linux CLOCK_MONOTONIC counts time that the system has run since boot
+ Michael Kerrisk [Jens Thoms Toerring]
+ CLOCK_MONOTONIC does not count while the system is suspended
+ Michael Kerrisk
+ ERRORS: add EINVAL error for noncanonical clock_settime() value
+
+clone.2
+ Michael Kerrisk
+ Rework discussion of threads and signals
+ The discussion is phrased in terms of signals sent using kill(2),
+ but applies equally to a signal sent by the kernel.
+ Jann Horn
+ Pending CLONE_NEWPID prevents thread creation
+ Michael Kerrisk
+ Clarify the discussion of threads and signals
+ And explicitly introduce the terms "process-directed" and
+ "thread-directed" signals.
+ Eugene Syromyatnikov
+ Add information about clone and clone2 on IA-64
+ Michael Kerrisk
+ ERRORS: EINVAL occurs with CLONE_NEWUSER if !CONFIG_USER_NS
+
+connect.2
+ Benjamin Peterson
+ Document error semantics of nonblocking UNIX domain sockets
+
+epoll_ctl.2
+ Michael Kerrisk
+ Use the term "interest list" consistently
+
+epoll_wait.2
+ Michael Kerrisk
+ Clarify the behavior when epoll_wait()-ing on an empty interest list
+ Michael Kerrisk
+ Note that epoll_wait() round robins through the set of ready descriptors
+
+eventfd.2
+ Michael Kerrisk
+ Move text noting that eventfd() creates a FD earlier in the page
+
+fcntl.2
+ Michael Kerrisk
+ Actual pipe capacity may in practice be less than nominal capacity
+ The number of bytes that can be written to the pipe may be less
+ (sometimes substantially less) than the nominal capacity.
+ Eugene Syromyatnikov
+ Mention that l_sysid is not used even if present
+ Michael Kerrisk
+ Briefly explain the meaning of the 'l_sysid' field in 'struct flock'
+
+futex.2
+ Benjamin Peterson
+ Make the example use C11 atomics rather than GCC builtins
+
+getcpu.2
+ Tobias Klauser [Michael Kerrisk]
+ getcpu() now has a glibc wrapper; remove mention of syscall(2)
+ The glibc wrapper was added in glibc 2.29, release on 1 Feb 2019.
+
+getgid.2
+getpid.2
+getuid.2
+pipe.2
+syscall.2
+ Eugene Syromiatnikov [Michael Kerrisk]
+ Describe 2nd return value peculiarity
+ Some architectures (ab)use second return value register for
+ additional return value in some system calls. Let's describe this.
+
+getgroups.2
+ Michael Kerrisk
+ Note that a process can drop all groups with: setgroups(0, NULL)
+
+getrlimit.2
+ Eugene Syromyatnikov
+ Note that setrlimit(RLIMIT_CPU) doesn't fail
+ Michael Kerrisk
+ Resource limits are process-wide attributes shared by all threads
+ This was already noted in pthreads(7), but bears repeating here.
+ Eugene Syromyatnikov
+ Correct information about large limits on 32-bit architectures
+
+gettid.2
+ Michael Kerrisk
+ Glibc provides a wrapper since version 2.30
+
+gettimeofday.2
+ Michael Kerrisk
+ ERRORS: add EINVAL for noncanonical 'tv' argument to settimeofday()
+
+gettimeofday.2
+clock_getres.2
+ Michael Kerrisk [Jens Thoms Toerring]
+ ERRORS: EINVAL can occur if new real time is less than monotonic clock
+
+getxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk [Andreas Gruenbacher, Enrico Scholz]
+ ERRORS: replace ENOATTR with ENODATA
+ See also https://bugzilla.kernel.org/show_bug.cgi?id=201995
+
+inotify_add_watch.2
+ Paul Millar
+ Add IN_ONLYDIR based error
+ Henry Wilson
+ Note errors that can occur for IN_MASK_CREATE
+
+io_submit.2
+ Jeff Moyer
+ Fix the description of aio_data
+ aio_data is not a kernel-internal field.
+
+madvise.2
+ Michal Hocko [Niklas Hambüchen]
+ MADV_FREE clarify swapless behavior
+
+memfd_create.2
+ Marc-André Lureau
+ Update hugetlb file-sealing support
+ Lucas De Marchi
+ Fix header for memfd_create()
+ Joseph C. Sible
+ _GNU_SOURCE is required
+
+mmap.2
+ Elliott Hughes
+ Explicitly state that the fd can be closed
+ Jann Horn [Michal Hocko, William Kucharski]
+ Fix description of treatment of the hint
+ The current manpage reads as if the kernel will always pick a free
+ space close to the requested address, but that's not the case.
+
+mount.2
+ Michael Kerrisk
+ Clearly distinguish per-mount-point vs per-superblock mount flags
+ Michael Kerrisk
+ MS_SILENT is ignored when changing propagation type
+ Michael Kerrisk
+ Attempts to change MS_SILENT setting during remount are silently ignored
+ Michael Kerrisk [Harry Mallon]
+ Document EROFS for read-only filesystems
+ See https://bugzilla.kernel.org/show_bug.cgi?id=200649
+ Michael Kerrisk
+ Clarify that per-superblock flags are shared during remount
+ Michael Kerrisk
+ Remove crufty sentence about MS_BIND + MS_REMOUNT
+ Michael Kerrisk
+ Mention /proc/PID/mountinfo
+ Many people are unaware of the /proc/PID/mountinfo file. Provide
+ a helpful clue here.
+ Michael Kerrisk
+ Mandatory locking also now requires CONFIG_MANDATORY_FILE_LOCKING
+ Michael Kerrisk [Simone Piccardi]
+ Add MS_STRICTATIME to list of flags that can be used in remount
+ Michael Kerrisk
+ EACCES: note some reasons why a filesystem may be read-only
+ Michael Kerrisk
+ SEE ALSO: add ioctl_iflags(2)
+
+msgop.2
+ Michael Kerrisk
+ Correct the capability description for msgsnd() EACCESS error
+
+nfsservctl.2
+ Michael Kerrisk
+ Add VERSIONS section noting that this system call no longer exists
+
+open.2
+ Lucas Werkmeister
+ Document ENXIO for sockets
+ Michael Kerrisk
+ Clarify a special use case of O_NONBLOCK for devices
+ Eugene Syromiatnikov
+ Mention presence of unused O_RSYNC definition
+ O_RSYNC is defined in <asm/fcntl.h> on HP PA-RISC, but is not
+ used anyway.
+ Eugene Syromiatnikov
+ Document FASYNC usage in Linux UAPI headers
+ Andrew Price
+ Remove O_DIRECT-related quotation
+ Remove a section that adds no benefit to the discussion of O_DIRECT.
+ Michael Kerrisk [Robin Kuzmin]
+ Clarify that O_NONBLOCK has no effect on poll/epoll/select
+
+perf_event_open.2
+ Vince Weaver [Wang Nan]
+ Document the PERF_EVENT_IOC_PAUSE_OUTPUT ioctl
+ The PERF_EVENT_IOC_PAUSE_OUTPUT ioctl was introduced in Linux 4.7.
+ Vince Weaver
+ Fix wording in multiplexing description
+ Vince Weaver
+ Clarify exclude_idle
+ Vince Weaver
+ Document the PERF_EVENT_IOC_QUERY_BPF ioctl
+ Vince Weaver
+ Document the PERF_EVENT_IOC_MODIFY_ATTRIBUTES ioctl
+ Vince Weaver
+ Fix prctl behavior description
+
+pivot_root.2
+ Elvira Khabirova
+ Explain the initramfs case and point to switch_root(8)
+ Joseph Sible [Joseph C. Sible]
+ Document EINVAL if root is rootfs
+
+pkey_alloc.2
+ Michael Kerrisk [Szabolcs Nagy]
+ Switch to glibc prototype in SYNOPSIS
+
+poll.2
+ Michael Kerrisk
+ Note that poll() and ppoll() are not affected by O_NONBLOCK
+
+posix_fadvise.2
+ Eugene Syromyatnikov
+ Describe the difference between fadvise64/fadvise64_64
+
+prctl.2
+ Benjamin Peterson
+ PR_SET_MM_EXE_FILE may now be used as many times as desired
+ Michael Kerrisk
+ Add some further historical details on PR_SET_MM_EXE_FILE
+ Michael Kerrisk [Jann Horn]
+ Explain the circumstances in which the parent-death signal is sent
+ Michael Kerrisk
+ Rework the PR_SET_PDEATHSIG description a little, for easier readability
+ Michael Kerrisk
+ Add additional info on PR_SET_PDEATHSIG
+ The signal is process directed and the siginfo_t->si_pid
+ filed contains the PID of the terminating parent.
+ Michael Kerrisk
+ Note libcap(3) APIs for operating on ambient capability set
+ (However, the libcap APIs do not yet seem to have
+ manual pages...)
+ Michael Kerrisk
+ Mention libcap APIs for operating on capability bounding set
+
+ptrace.2
+ Dmitry V. Levin
+ Do not say that PTRACE_O_TRACESYSGOOD may not work
+ Jann Horn
+ BUGS: ptrace() may set errno to zero
+
+readdir.2
+ Eugene Syromyatnikov
+ Fix struct old_linux_dirent in accordance with current definition
+
+readv.2
+ Xiao Yang [Florian Weimer]
+ Fix wrong errno for an unknown flag
+
+rename.2
+ Michael Kerrisk
+ glibc 2.28 adds library support for renameat2()
+ Tobias Klauser
+ Add feature test macro for renameat2()
+ The glibc wrapper for renameat2() was added in glibc 2.28 and
+ requires _GNU_SOURCE.
+ Eugene Syromiatnikov
+ Some additional notes regarding RENAME_WHITEOUT
+ Lucas Werkmeister [Michael Kerrisk]
+ Add kernel versions for RENAME_NOREPLACE support
+ Michael Kerrisk
+ Rework list of supported filesystems for RENAME_NOREPLACE
+ Tobias Klauser
+ renameat2() now has a glibc wrapper; remove mention of syscall(2)
+
+s390_runtime_instr.2
+ Eugene Syromyatnikov
+ Add a note about runtime_instr.h availability
+
+s390_sthyi.2
+ Eugene Syromyatnikov [Heiko Carstens]
+ Some minor additions
+
+sched_setattr.2
+ Michael Kerrisk
+ Add a bit more detail for SCHED_DEADLINE
+
+sched_setparam.2
+ Michael Kerrisk
+ Clarify that scheduling parameters are per-thread (not per-process)
+
+seccomp.2
+ Michael Kerrisk
+ (Briefly) document SECCOMP_FILTER_FLAG_SPEC_ALLOW
+ Michael Kerrisk
+ SEE ALSO: add bpfc(1)
+
+select.2
+ Michael Kerrisk
+ BUGS: the use of value-result arguments is a design bug
+ Michael Kerrisk [Robin Kuzmin]
+ Note that select() and pselect() are not affected by O_NONBLOCK
+
+select_tut.2
+ Michael Kerrisk [Antonio Chirizzi]
+ Diagnose inet_aton() errors with simple fprintf() (not perror())
+
+setgid.2
+ Michael Kerrisk
+ Clarify EPERM capability requirements with respect to user namespaces
+
+setns.2
+ Michael Kerrisk
+ When joining a user namespace, it must be a descendant user namespace
+ Michael Kerrisk
+ Note capability requirements for changing PID namespace
+ Note capability requirements for changing network, IPC, or UTS namespace
+ Note capability requirements for changing cgroup namespace
+ Michael Kerrisk
+ Some text restructuring and reordering
+
+set_thread_area.2
+ Eugene Syromyatnikov
+ Mention related prctl() requests in SEE ALSO
+ Eugene Syromyatnikov
+ Mention that get_thread_area() is also Linux-specific
+ Eugene Syromyatnikov
+ Describe set_thread_area()/get_thread_area() on m68k/MIPS
+
+setuid.2
+ Michael Kerrisk
+ Clarify EPERM capability requirements with respect to user namespaces
+
+sigaction.2
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Describe obsolete usage of struct sigcontext as signal handler argument
+
+sigsuspend.2
+ Michael Kerrisk
+ Clarify that sigsuspend() suspends the calling *thread*
+
+socket.2
+ Michael Kerrisk
+ Remove references to external docs
+ This information is all in the new address_families(7)
+ Michael Kerrisk
+ Add cross reference to address_families(7)
+ Eugene Syromyatnikov
+ Reinstate AF_VSOCK mention
+ Michael Kerrisk
+ Simplify list of address families
+ Remove many of the details that are in address_families(7)
+ Nikola Forró
+ Remove notes concerning AF_ALG and AF_XDP
+ All address families are now documented in address_families.7.
+ Michael Kerrisk
+ Remove some more obscure protocols from address family list
+ The list of address families in this page is still
+ overwhelmingly long. So let's shorten it.
+ The removed entries are all in address_families(7).
+ Michael Kerrisk
+ Remove a few obsolete protocols
+ Documentation for these remains in address_families(7)
+
+socketpair.2
+ Eugene Syromyatnikov
+ Note that AF_TIPC also supports socketpair(2)
+ Introduced by Linux commit v4.12-rc1~64^3~304^2~1.
+
+stat.2
+ Michael Kerrisk [Alessandro Vesely]
+ ERRORS: ENOENT can occur where a path component is a dangling symlink
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=909789
+ Benjamin Peterson
+ SEE ALSO: add statx(2)
+
+statx.2
+ Tobias Klauser [Michael Kerrisk]
+ statx() now has a glibc wrapper; remove mention of syscall(2)
+
+syscall.2
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Elaborate x32 ABI specifics
+ snyh
+ Fix wrong retval register number in alpha architecture
+ Helge Deller
+ parisc needs care with syscall parameters
+ Michael Kerrisk
+ Rework table to render within 80 columns
+
+syscalls.2
+ Eugene Syromyatnikov
+ Change example of a thin syscall wrapper to chdir()
+ As truncate(3) should dispatch between truncate/truncate64,
+ as noted later in the page.
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Update syscall table
+ Added: arc_gettls, arc_settls, arc_usr_cmpxchg, arch_prctl,
+ atomic_barrier, atomic_cmpxchg_32, bfin_spinlock, breakpoint,
+ clone2, cmpxchg, cmpxchg_badaddr, dma_memcpy, execv, get_tls,
+ getdomainname, getdtablesize, gethostname, getxgid, getxpid,
+ getxuid, metag_get_tls, metag_set_fpu_flags,metag_set_tls,
+ metag_set_global_bit, newfstatat, old_adjtimex, oldumount,
+ or1k_atomic, pread, pwrite, riscv_flush_icache,
+ sched_get_affinity, sched_set_affinity, set_tls, setaltroot,
+ sethae, setpgrp, spill, sram_alloc, sram_free, swapcontext,
+ switch_endian, sys_debug_setcontext, syscall, sysmips, timerfd,
+ usr26, usr32, xtensa.
+
+ Uncommented: memory_ordering
+
+ Renamed: ppc_rtas to rtas (__NR_rtas), ppc_swapcontext to
+ swapcontext (__NR_swapcontext).
+ Eugene Syromyatnikov
+ Note about s390x and old_mmap
+ Michael Kerrisk
+ Add s390_guarded_storage(2)
+ Michael Kerrisk
+ Update syscall list for Linux 4.18
+ Eugene Syromyatnikov
+ Note that not all architectures return errno negated
+ Helge Deller
+ parisc Linux does not any longer emulate HP-UX
+ Michael Kerrisk
+ Comment out details of a few system calls that only ever briefly existed
+
+unshare.2
+ Michael Kerrisk [Shawn Landden]
+ Same EINVAL errors as for clone(2) can also occur with unshare(2)
+ Tycho Andersen
+ Note EINVAL when unsharing pid ns twice
+ The kernel doesn't allow unsharing a pid NS if it has
+ previously been unshared.
+
+ustat.2
+ Michael Kerrisk
+ Starting with version 2.28, glibc no longer provides a wrapper function
+
+vmsplice.2
+ Andrei Vagin
+ Note that vmsplice can splice pages from pipe to memory
+
+wait.2
+ Michael Kerrisk
+ Add some cross references to core(5)
+
+write.2
+ Michael Kerrisk [Nadav Har'El]
+ RETURN VALUE: clarify details of partial write and
+ https://bugzilla.kernel.org/show_bug.cgi?id=197961
+ Goldwyn Rodrigues
+ Add details on partial direct I/O writes
+
+alloca.3
+ Michael Kerrisk [Robin Kuzmin]
+ Prevent any misunderstanding about when allocated memory is released
+
+bsd_signal.3
+ Xiao Yang
+ Fix the wrong version of _POSIX_C_SOURCE
+
+bstring.3
+ Michael Kerrisk [Emil Fihlman]
+ Correct argument list for memmem() prototype
+
+cmsg.3
+ Michael Kerrisk
+ Explain zero-initialization requirement for CMSG_NXTHDR()
+ Michael Kerrisk
+ Remove out of place mention of MSG_CTRUNC
+ This detail is covered in recvmsg(2), and now also in unix(7).
+ Michael Kerrisk
+ Note that CMSG_FIRSTHDR can return NULL
+ Michael Kerrisk
+ Remove unnecessary 'fdptr' intermediate variable in example code
+
+des_crypt.3
+encrypt.3
+ Michael Kerrisk
+ The functions described in these pages are removed in glibc 2.28
+
+dlsym.3
+ Michael Kerrisk
+ Describe a case where a symbol value may be NULL
+
+errno.3
+ Michael Kerrisk [Robert P. J. Day]
+ Mention that errno(1) is part of the 'moreutils' package
+
+exec.3
+ Michael Kerrisk [Eugene Syromyatnikov]
+ Note that SPARC provides an execv() system call
+
+exit.3
+ Mike Frysinger
+ Note wider sysexits.h availability
+
+ferror.3
+ Elliot Hughes
+ Warn about closing the result of fileno()
+
+fnmatch.3
+ Elliott Hughes
+ Clarify "shell wildcard pattern"
+
+getaddrinfo.3
+ Michael Kerrisk [Eric Sanchis]
+ Fix off-by-one error in example client program
+
+getcwd.3
+ Michael Kerrisk
+ Rework text on use of getcwd() system call
+ Make it clear that all of the library functions described on this
+ page will use the getcwd() system call if it is present.
+ Michael Kerrisk
+ Add details on the getcwd() syscall and how it used by libc functions
+ Michael Kerrisk
+ Reorder the text describing "(unreachable)" being returned by getcwd()
+
+getmntent.3
+ Elliot Hughes
+ Clarify that endmntent() should be used rather than fclose()
+
+isatty.3
+ Michael Kerrisk [Jakub Wilk]
+ Most non-tty files nowadays result in the error ENOTTY
+ Historically, at least FIFOs and pipes yielded the error EINVAL.
+
+lockf.3
+ Ian Turner
+ ERRORS: add EINTR
+
+malloc.3
+ Michael Kerrisk
+ Add reference to glibc MallocInternals wiki
+ Michael Kerrisk
+ Note that calloc() detects overflow when multiplying its arguments
+ Michael Kerrisk
+ Since glibc 2.29, reallocarray() is exposed by defining _DEFAULT_SOURCE
+ Info gleaned from glibc NEWS file.
+
+pthread_attr_init.3
+ Michael Kerrisk [Göran Häggsjö, Jakub Wilk]
+ Use correct printf() specifier for "size_t" in example program
+
+pthread_rwlockattr_setkind_np.3
+ Carlos O'Donell
+ Remove bug notes
+
+pthread_setname_np.3
+ Jakub Wilk
+ Explain _np suffix
+ Add text to CONFORMING TO explaining that the "_np"
+ suffix is because these functions are non-portable.
+
+putenv.3
+ Michael Kerrisk
+ Note a glibc extension: putenv("NAME") removes an environment variable
+
+resolver.3
+ Michael Becker
+ Add documentation of res_nclose()
+
+strcmp.3
+ Heinrich Schuchardt
+ Clarify that strcmp() is not locale aware
+
+strcpy.3
+ Matthew Kilgore
+ Fix example code for strncpy, which could pass an incorrect length
+ Michael Kerrisk [Frank Theile]
+ Use "destination" consistently (instead of "target" sometimes)
+
+strfry.3
+ Keith Thompson
+ Remove incorrect reference to rand(3)
+
+string.3
+strlen.3
+strnlen.3
+ Michael Kerrisk [Jakub Wilk]
+ Use 'bytes' not 'characters'
+ This is in line with POSIX terminology.
+
+system.3
+ Michael Kerrisk [Jonny Grant]
+ Use '(char *) NULL' rather than '(char *) 0'
+ Michael Kerrisk
+ Note that system() can fail for the same reasons as fork(2)
+ Arkadiusz Drabczyk
+ Mention that 'errno' is set on error
+
+termios.3
+ Eugene Syromyatnikov
+ Note an XTABS alpha issue
+
+trunc.3
+ Michael Kerrisk [Eric Benton, G. Branden Robinson]
+ Make the description a little clearer
+ Michael Kerrisk
+ Emphasize that the return value is a floating-point number
+
+xcrypt.3
+ Jason A. Donenfeld
+ Warn folks not to use these functions
+
+lirc.4
+ Sean Young
+ Fix broken link
+ Sean Young
+ Document error returns more explicitly
+ Sean Young
+ lirc.h include file is in /usr/include/linux/lirc.h
+ Sean Young [Alec Leamas, Mauro Carvalho Chehab]
+ Remove ioctls and feature bits which were never implemented
+ Sean Young
+ Unsupported ioctl() operations always return ENOTTY
+ Sean Young
+ LIRC_MODE_LIRCCODE has been replaced by LIRC_MODE_SCANCODE
+ Sean Young
+ Document remaining ioctl (LIRC_GET_REC_TIMEOUT)
+ Now all ioctls are documented.
+ Sean Young
+ Timeout reports are enabled by default
+ Sean Young
+ Some devices are send only
+ Sean Young
+ Update SEE ALSO
+ Sean Young
+ LIRC_CAN_SET_REC_DUTY_CYCLE_RANGE was never supported
+ No driver ever supported such a thing.
+ Michael Kerrisk
+ Clarify the description LIRC_SET_REC_TIMEOUT
+
+tty.4
+ Michael Witten
+ Add `vcs(4)' and `pty(7)' to the `SEE ALSO' section
+
+vcs.4
+ Mattias Engdegård [Michael Witten]
+ Fix broken example code
+
+core.5
+ Michael Kerrisk
+ Add cross reference to vdso(7) where "virtual DSO" is mentioned
+
+filesystems.5
+ Eugene Syromyatnikov
+ Mention sysfs(2)
+
+host.conf.5
+ Nikola Forró
+ Clarify glibc versions in which spoof options were removed
+
+proc.5
+ Michael Kerrisk [Philip Dumont]
+ Document /proc/[tid]
+ See also https://bugzilla.kernel.org/show_bug.cgi?id=201441
+ Michael Kerrisk
+ Add an overview section describing the groups of files under /proc
+ Keno Fischer [Robert O'Callahan]
+ Correct description of NStgid
+ Lucas Werkmeister
+ Document fdinfo format for timerfd
+ Stephan Knauss
+ Mention /proc/uptime includes time spent in suspend
+ Michael Kerrisk
+ Reword /proc/PID/fdinfo timerfd field descriptions as a hanging list
+ Michael Kerrisk
+ SEE ALSO: add htop(1) and pstree(1)
+ fs/proc/uptime.c:uptime_proc_show() fetches time using
+ ktime_get_boottime which includes the time spent in suspend.
+ Michael Kerrisk
+ Document /proc/PID/status CoreDumping field
+ Michael Kerrisk
+ Mention choom(1) in discussion of /proc/[pid]/oom_score_adj
+ Michael Kerrisk
+ Add a few details on /proc/PID/fdinfo timerfd
+ Michael Kerrisk
+ Document /proc/meminfo KReclaimable field
+ Michael Kerrisk
+ Explain how to determine top-most mount in /proc/PID/mountinfo
+ Explain how to determine the top-most mount at a particular
+ location by inspecting /proc/PID/mountinfo.
+ Michael Kerrisk [Jakub Wilk]
+ Remove bogus suggestion to use cat(1) to read files containing '\0'
+ Michael Kerrisk
+ Refer to mount(2) for explanation of mount vs superblock options
+ Michael Kerrisk
+ Fix description of /proc/PID/* ownership to account for user namespaces
+ Elvira Khabirova
+ Describe ambiguities in /proc/<pid>/maps
+ Michael Kerrisk [Nick Gregory]
+ Since Linux 4.5, "stack:" is no longer shown in /proc/PID/maps
+ Nikola Forró
+ Document /proc/[pid]/status Speculation_Store_Bypass field
+ Alan Jenkins
+ Vmalloc information is no longer calculated (Linux 4.4)
+ Michael Kerrisk [Alexander E. Patrakov, Jakub Wilk, Michael Kerrisk]
+ Use 'tr '\000' '\n' to display contents of /proc/PID/environ
+ Michael Kerrisk
+ Setting dumpable to 1 reverts ownership of /proc/PID/* to effective IDs
+ Michael Kerrisk
+ Document /proc/meminfo LazyFree field
+ Michael Kerrisk
+ Fix kernel source pathname for soft-dirty documentation
+ Michael Kerrisk
+ /proc/[pid]/status VmPMD field was removed in Linux 4.15
+
+resolv.conf.5
+ Nikola Forró
+ Document no-reload (RES_NPRELOAD) option
+
+tzfile.5
+ Paul Eggert
+ Sync from tzdb upstream
+
+capabilities.7
+ Michael Kerrisk
+ Fix some imprecisions in discussion of namespaced file capabilities
+ The file UID does not come into play when creating a v3
+ security.capability extended attribute.
+ Michael Kerrisk
+ Note that v3 security.attributes are transparently created/retrieved
+ Michael Kerrisk
+ Improve the discussion of when file capabilities are ignored
+ The text stated that the execve() capability transitions are not
+ performed for the same reasons that setuid and setgid mode bits
+ may be ignored (as described in execve(2)). But, that's not quite
+ correct: rather, the file capability sets are treated as empty
+ for the purpose of the capability transition calculations.
+ Michael Kerrisk
+ Rework bounding set as per-thread set in transformation rules
+ Michael Kerrisk
+ Substantially rework "Capabilities and execution of programs by root"
+ Rework for improved clarity, and also to include missing details
+ on the case where (1) the binary that is being executed has
+ capabilities attached and (2) the real user ID of the process is
+ not 0 (root) and (3) the effective user ID of the process is 0
+ (root).
+ Marcus Gelderie
+ Add details about SECBIT_KEEP_CAPS
+ The description of SECBIT_KEEP_CAPS is misleading about the
+ effects on the effective capabilities of a process during a
+ switch to nonzero UIDs. The effective set is cleared based on
+ the effective UID switching to a nonzero value, even if
+ SECBIT_KEEP_CAPS is set. However, with this bit set, the
+ effective and permitted sets are not cleared if the real and
+ saved set-user-ID are set to nonzero values.
+ Marcus Gelderie
+ Mention header for SECBIT constants
+ Mention that the named constants (SECBIT_KEEP_CAPS and others)
+ are available only if the linux/securebits.h user-space header
+ is included.
+ Michael Kerrisk
+ Add text introducing bounding set along with other capability sets
+ Michael Kerrisk [Allison Randal]
+ Update URL for location of POSIX.1e draft standard
+ Michael Kerrisk
+ CAP_SYS_CHROOT allows use of setns() to change the mount namespace
+ Michael Kerrisk [Pierre Chifflier]
+ Ambient capabilities do not trigger secure-execution mode
+ Michael Kerrisk
+ Add a subsection on per-user-namespace "set-user-ID-root" programs
+ Michael Kerrisk
+ Rework discussion of exec and UID 0, correcting a couple of details
+ Clarify the "Capabilities and execution of programs by root"
+ section, and correct a couple of details:
+ * If a process with rUID == 0 && eUID != 0 does an exec,
+ the process will nevertheless gain effective capabilities
+ if the file effective bit is set.
+ * Set-UID-root programs only confer a full set of capabilities
+ if the binary does not also have attached capabilities.
+ Michael Kerrisk
+ Update URL for libcap tarballs
+ The previous location does not seem to be getting updated.
+ (For example, at the time of this commit, libcap-2.26
+ had been out for two months, but was not present at
+ http://www.kernel.org/pub/linux/libs/security/linux-privs.
+ Michael Kerrisk
+ Clarify which capability sets capset(2) and capget(2) apply to
+ capset(2) and capget(2) apply operate only on the permitted,
+ effective, and inheritable process capability sets.
+ Michael Kerrisk
+ Correct the description of SECBIT_KEEP_CAPS
+ Michael Kerrisk
+ Add background details on capability transformations during execve(2)
+ Add background details on ambient and bounding set when
+ discussing capability transformations during execve(2).
+ Michael Kerrisk
+ Document the 'no_file_caps' kernel command-line option
+
+cgroup_namespaces.7
+ Michael Kerrisk [Troy Engel]
+ Clarify the example by making an implied detail more explicit.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=201047
+
+cgroups.7
+ Michael Kerrisk
+ Add more detail on v2 'cpu' controller and realtime threads
+ Explicitly note the scheduling policies that are relevant for the
+ v2 'cpu' controller.
+ Michael Kerrisk
+ Document the use of 'cgroup_no_v1=named' to disable v1 named hierarchies
+ This feature was added in Linux 5.0.
+ Michael Kerrisk [Mike Weilgart]
+ Complete partial sentence re kernel boot options and 'nsdelegate'
+ https://bugzilla.kernel.org/show_bug.cgi?id=201029
+ Michael Kerrisk
+ Reframe the text on delegation to include more details about cgroups v1
+ Michael Kerrisk [Leah Hanson]
+ Rework discussion of writing to cgroup.type file
+ In particular, it is possible to write "threaded" to a
+ cgroup.type file if the current type is "domain threaded".
+ Previously, the text had implied that this was not possible.
+ Michael Kerrisk [Balbir Singh, Marcus Gelderie]
+ Soften the discussion about delegation in cgroups v1
+ Balbir pointed out that v1 delegation was not an accidental
+ feature.
+
+epoll.7
+ Michael Kerrisk
+ Introduce the terms "interest list" and "ready list"
+ Michael Kerrisk
+ Consistently use the term "interest list" rather than "epoll set"
+ Michael Kerrisk
+ Reformat Q&A list
+ Michael Kerrisk
+ Note that edge-triggered notification wakes up only one waiter
+ Note a useful performance benefit of EPOLLET: ensuring that
+ only one of multiple waiters (in epoll_wait()) is woken
+ up when a file descriptor becomes ready.
+ Michael Kerrisk
+ Expand the discussion of the implications of file descriptor duplication
+ In particular, note that it may be difficult for an application
+ to know about the existence of duplicate file descriptors.
+
+feature_test_macros.7
+ Michael Kerrisk [Andreas Westfeld]
+ Add more detail on why FTMs must be defined before including any header
+
+inotify.7
+ Michael Kerrisk [Paul Millar]
+ Note ENOTDIR error that can occur for IN_ONLYDIR
+ Note ENOTDIR error that occurs when requesting a watch on a
+ nondirectory with IN_ONLYDIR.
+
+ip.7
+ Bert Hubert
+ IP_RECVTTL error fixed
+ I need to get the TTL of UDP datagrams from userspace, so I set
+ the IP_RECVTTL socket option. And as promised by ip.7, I then get
+ IP_TTL messages from recvfrom. However, unlike what the manpage
+ promises, the TTL field gets passed as a 32 bit integer.
+
+man.7
+ Michael Kerrisk
+ SEE ALSO: remove mdoc.samples(7)
+
+mount_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add findmnt(8)
+
+namespaces.7
+ Michael Kerrisk
+ List factors that may pin a namespace into existence
+ Various factors may pin a namespace into existence, even when it
+ has no member processes.
+ Michael Kerrisk [Tycho Kirchner]
+ Briefly explain why CAP_SYS_ADMIN is needed to create nonuser namespaces
+ Michael Kerrisk
+ Mention ioctl(2) in discussion of namespaces APIs
+ Michael Kerrisk
+ SEE ALSO: add pam_namespace(8)
+
+pid_namespaces.7
+ Michael Kerrisk
+ Clarify the semantics for the adoption of orphaned processes
+ Because of setns() semantics, the parent of a process may reside
+ in the outer PID namespace. If that parent terminates, then the
+ child is adopted by the "init" in the outer PID namespace (rather
+ than the "init" of the PID namespace of the child).
+ Michael Kerrisk
+ Note a detail of /proc/PID/ns/pid_for_children behavior
+ After clone(CLONE_NEWPID), /proc/PID/ns/pid_for_children is empty
+ until the first child is created. Verified by experiment.
+ Michael Kerrisk
+ Note that a process can do unshare(CLONE_NEWPID) only once
+
+sched.7
+ Michael Kerrisk [Eugene Syromyatnikov]
+ In the kernel source SCHED_OTHER is actually called SCHED_NORMAL
+ Michael Kerrisk
+ SEE ALSO: add ps(1) and top(1)
+ Michael Kerrisk
+ SEE ALSO: add chcpu(1), lscpu(1)
+
+signal.7
+ Michael Kerrisk [Robin Kuzmin]
+ Clarify that sigsuspend() and pause() suspend the calling *thread*
+ Helge Deller
+ Add signal numbers for parisc
+ Michael Kerrisk
+ Unify signal lists into a signal table that embeds standards info
+ Having the signals listed in three different tables reduces
+ readability, and would require more table splits if future
+ standards specify other signals.
+ Michael Kerrisk
+ Reorder the architectures in the signal number lists
+ x86 and ARM are the most common architectures, but currently
+ are in the second subfield in the signal number lists.
+ Instead, swap that info with subfield 1, so the most
+ common architectures are first in the list.
+ Michael Kerrisk
+ Place signal numbers in a separate table
+ The current tables of signal information are unwieldy,
+ as they try to cram in too much information.
+ Michael Kerrisk
+ Insert standards info into tables
+ Michael Kerrisk
+ SEE ALSO: add clone(2)
+
+socket.7
+ Michael Kerrisk
+ Refer reader to unix(7) for information on SO_PASSSEC
+ Michael Kerrisk
+ SEE ALSO: add address_families(7)
+
+socket.7
+unix.7
+ Michael Kerrisk
+ Move text describing SO_PEERCRED from socket(7) to unix(7)
+ This is, AFAIK, an option specific to UNIX domain sockets, so
+ place it in unix(7).
+
+tcp.7
+udp.7
+ Michael Kerrisk
+ Add a reference to socket(7) noting existence of further socket options
+
+unix.7
+ Michael Kerrisk
+ Enhance the description of SCM_RIGHTS
+ The existing description is rather thin. More can be said.
+ Michael Kerrisk
+ There is a limit on the size of the file descriptor array for SCM_RIGHTS
+ The limit is defined in the kernel as SCM_MAX_FD (253).
+ Michael Kerrisk
+ Rework SO_PEERCRED text for greater clarity
+ Michael Kerrisk [Felipe Gasper]
+ Clarify SO_PASSCRED behavior
+ Michael Kerrisk
+ Explicitly note that SO_PASSCRED provides SCM_CREDENTIALS messages
+ Michael Kerrisk
+ If the buffer to receive SCM_RIGHTS FDs is too small, FDs are closed
+ Michael Kerrisk
+ One must send at least one byte of real data with ancillary data
+ Michael Kerrisk
+ Ancillary data forms a barrier when receiving on a stream socket
+ Michael Kerrisk
+ When sending ancillary data, only one item of each type may be sent
+ Michael Kerrisk
+ Improve wording describing socket option argument/return values
+ Michael Kerrisk
+ Clarify treatment of incoming ancillary data if 'msg_control' is NULL
+ Michael Kerrisk
+ Note behavior if buffer to receive ancillary data is too small
+ Michael Kerrisk
+ Fix a minor imprecision in description of SCM_CREDENTIALS
+ Michael Kerrisk
+ Refer reader to socket(7) for information about SO_PEEK_OFF
+
+user_namespaces.7
+ Michael Kerrisk
+ Rework terminology describing ownership of nonuser namespaces
+ Prefer the word "owns" rather than "associated with" when
+ describing the relationship between user namespaces and non-user
+ namespaces. The existing text used a mix of the two terms, with
+ "associated with" being predominant, but to my ear, describing the
+ relationship as "ownership" is more comprehensible.
+
+vdso.7
+ Helge Deller
+ Fix parisc gateway page description
+
+ld.so.8
+ Michael Kerrisk [Florian Weimer, David Newall]
+ Document the --preload command-line option added in glibc 2.30
+ Michael Kerrisk
+ Note delimiters for 'list' in --audit and --inhibit-rpath
+ Michael Kerrisk
+ Place OPTIONS in alphabetical order
+ Michael Kerrisk
+ LD_PRELOAD-ed objects are added to link map in left-to-right order
+
+zdump.8
+ Paul Eggert
+ Sync from tzdb upstream
+
+zic.8
+ Paul Eggert
+ Sync from tzdb upstream
+
+
+==================== Changes in man-pages-5.01 ====================
+
+Released: 2019-05-09, 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:
+
+Abhinav Upadhyay <er.abhinav.upadhyay@gmail.com>
+Andreas Korb <andreas.d.korb@gmail.com>
+Anisse Astier <anisse@astier.eu>
+Brice Goglin <Brice.Goglin@inria.fr>
+Carlos O'Donell <carlos@redhat.com>
+Dr. Jürgen Sauermann <mail@xn--jrgen-sauermann-zvb.de>
+Egmont Koblinger <egmont@gmail.com>
+Elias Benali <stackptr@users.sourceforge.net>
+Elliot Hughes <enh@google.com>
+Florian Weimer <fweimer@redhat.com>
+Hugues Evrard <hevrard@google.com>
+Jakub Nowak <jakub.jakub.nowak@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Keegan Saunders <keeganwsaunders@gmail.com>
+Lucas Werkmeister <mail@lucaswerkmeister.de>
+Marcus Huewe <suse-tux@gmx.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Witten <mfwitten@gmail.com>
+Seth Troisi <sethtroisi@google.com>
+Slavomir Kaslev <kaslevs@vmware.com>
+Vincent Lefevre <vincent@vinc17.net>
+Wladimir Mutel <muwlgr@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+tsearch.3
+ Florian Weimer [Michael Kerrisk]
+ Document the twalk_r() function added in glibc 2.30
+
+
+New and changed links
+---------------------
+
+twalk_r.3
+ Michael Kerrisk
+ New link to twalk(3) page
+
+
+Changes to individual pages
+---------------------------
+
+accept.2
+ Michael Kerrisk
+ Note that 'addrlen' is left unchanged in the event of an error
+ See http://austingroupbugs.net/view.php?id=836.
+
+bpf.2
+ Michael Kerrisk
+ Update kernel version info for JIT compiler
+
+clone.2
+ Michael Kerrisk [Jakub Nowak]
+ CLONE_CHILD_SETTID has effect before clone() returns *in the child*
+ CLONE_CHILD_SETTID may not have had effect by the time clone()
+ returns in the parent, which could be relevant if the
+ CLONE_VM flag is employed. The relevant kernel code is in
+ schedule_tail(), which is called in ret_from_fork()
+ in the child.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=203105
+
+execve.2
+exec.3
+ Michael Kerrisk [Dr. Jürgen Sauermann]
+ Consistently use the term 'pathname' (not 'path')
+
+execve.2
+ Michael Kerrisk
+ Note that stack+environ size is also limited to 3/4 of _STK_LIM
+ In fs/exec.c::prepare_arg_pages(), we have:
+
+ limit = _STK_LIM / 4 * 3;
+ limit = min(limit, bprm->rlim_stack.rlim_cur / 4);
+ Michael Kerrisk [Dr. Jürgen Sauermann]
+ SEE ALSO: refer to exec(3) (rather than execl(3))
+
+pipe.2
+ Michael Kerrisk
+ Note that 'pipefd' is left unchanged in the event of an error
+ See http://austingroupbugs.net/view.php?id=467.
+
+sched_setaffinity.2
+ Michael Kerrisk [Brice Goglin]
+ Correct details of return value of sched_getaffinity() syscall
+
+setfsgid.2
+ Michael Kerrisk
+ Rewrite for improved clarity and defer to setfsuid() for details
+ Rewrite for improved clarity and defer to setfsuid(2) for the
+ rationale of the fsGID rather than repeating the same details
+ in this page.
+
+setfsuid.2
+ Michael Kerrisk
+ Rewrite for improved clarity and to hint history more explicitly
+ The current text reads somewhat clumsily. Rewrite it to introduce
+ the eUID and fsUID in parallel, and more clearly hint at the
+ historical rationale for the fsUID, which is detailed lower in
+ the page.
+
+socketpair.2
+ Michael Kerrisk
+ Clarify that 'sv' is left unchanged in the event of an error
+ See also http://austingroupbugs.net/view.php?id=483.
+
+splice.2
+ Slavomir Kaslev
+ EAGAIN can occur when called on nonblocking file descriptors
+
+syscalls.2
+ Michael Kerrisk [Andreas Korb]
+ Remove crufty text about i386 syscall dispatch table
+ The removed text long ago ceased to be accurate. Nowadays, the
+ dispatch table is autogenerated when building the kernel (via
+ the kernel makefile, arch/x86/entry/syscalls/Makefile).
+
+tee.2
+ Slavomir Kaslev
+ EAGAIN can occur when called on nonblocking file descriptors
+
+fopen.3
+ Elliot Hughes
+ Explain BSD vs glibc "a+" difference
+ Where is the initial read position for an "a+" stream?
+
+ POSIX leaves this unspecified. Most BSD man pages are silent, and
+ MacOS has the ambiguous "The stream is positioned at the end of
+ the file", not differentiating between reads and writes other than
+ to say that fseek(3) does not affect writes. glibc's documentation
+ explicitly specifies that the initial read position is the
+ beginning of the file.
+
+mallinfo.3
+ Elliott Hughes
+ Further discourage use of mallinfo()
+ The BUGS section already explains why you need to be cautious
+ about using mallinfo, but given the number of bug reports we see
+ on Android, it seems not many people are reading that far. Call it
+ out up front.
+
+malloc_trim.3
+ Carlos O'Donell
+ Update trimming information
+ Since glibc 2.8, commit 68631c8eb92, the malloc_trim function has
+ iterated over all arenas and free'd back to the OS all page runs
+ that were free. This allows an application to call malloc_trim to
+ consolidate fragmented chunks and free back any pages it can to
+ potentially reduce RSS usage.
+
+posix_memalign.3
+ Elliot Hughes
+ Some functions set errno
+ True of bionic, glibc, and musl. (I didn't check elsewhere.)
+
+resolver.3
+ Michael Kerrisk [Wladimir Mutel]
+ Mention that some functions set 'h_errno'
+
+stdarg.3
+ Michael Kerrisk [Vincent Lefevre]
+ Remove the NOTES section describing the ancient varargs macros
+ stdarg.h is now 30 years old, and gcc long ago (2004) ceased to
+ implement <varargs.h>. There seems little value in keeping this
+ text.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=202907
+ Michael Kerrisk [Egmont Koblinger]
+ Add a note that "..." in function signature means a variadic function
+ Egmont suggested adding this, because the string "..." appears
+ at several other points in the page, but just to indicate that
+ some text is omitted from example code.
+
+strerror.3
+ Jakub Wilk
+ Don't discuss buffer size for strerror_l()
+ Unlike strerror_r(), strerror_l() doesn't take buffer length as an
+ argument.
+
+strtol.3
+strtoul.3
+ Jakub Wilk
+ SEE ALSO: add strtoimax(3), strtoumax(3)
+
+sysconf.3
+ Michael Kerrisk [Hugues Evrard]
+ Clearly note that _SC_PAGESIZE and _SC_PAGE_SIZE are synonyms
+
+tsearch.3
+ Florian Weimer
+ Do not use const arguments in twalk() callback
+ The const specifier is not part of the prototype (it only applies
+ to the implementation), so showing it here confuses the reader.
+ Michael Kerrisk
+ SYNOPSIS: add missing definition of 'VISIT' type
+ Michael Kerrisk
+ Reformat twalk() and twalk_r() prototypes for easier readability
+
+console_codes.4
+ Jakub Wilk
+ Document that \e[1;n] and \e[2;n] support 16 colors
+ Source: setterm_command() in drivers/tty/vt/vt.c
+
+elf.5
+ Michael Kerrisk [Keegan Saunders]
+ A data segment does not have PF_X
+
+proc.5
+ Michael Witten [Anisse Astier]
+ Add missing Inode field to /proc/net/unix
+
+hostname.7
+ Florian Weimer
+ HOSTALIASES/search path processing is DNS-specific
+ Other NSS modules do not necessarily honor these settings.
+
+inode.7
+ Michael Kerrisk
+ Note that timestamp fields measure time starting at the Epoch
+ Michael Kerrisk
+ Timestamp fields are structures that include a nanosecond component
+ Michael Kerrisk
+ Add references to execve(2) to describe set-UID/set-GID behaviors
+
+
+==================== Changes in man-pages-5.02 ====================
+
+Released: 2019-08-02, 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:
+
+Alan Stern <stern@rowland.harvard.edu>
+Alexey Izbyshev <izbyshev@ispras.ru>
+Amir Goldstein <amir73il@gmail.com>
+Cyrill Gorcunov <gorcunov@gmail.com>
+Eric Sanchis <eric.sanchis@iut-rodez.fr>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Finn O'Leary <finnoleary@inventati.org>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Guillaume Laporte <guillaume.laporte.adm@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Kumar Chaudhary, Naveen <naveen.kumar.chaudhary@intel.com>
+Mark Wielaard <mark@klomp.org>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Kenigsberg <matthewkenigsberg@gmail.com>
+Matthias Hertel <Matthias.Hertel@rohde-schwarz.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Sekletar <msekleta@redhat.com>
+Oleg Nesterov <oleg@redhat.com>
+Palmer Dabbelt <palmer@sifive.com>
+Petr Vaněk <arkamar@atlas.cz>
+Sami Kerola <kerolasa@iki.fi>
+Shawn Landden <shawn@git.icu>
+Thorsten Glaser <tg@mirbsd.de>
+Tobias Klauser <tklauser@distanz.ch>
+Tomas Skäre <tomas.skare@gmail.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify.7
+fanotify_init.2
+fanotify_mark.2
+ Matthew Bobrowski [Amir Goldstein, Jan Kara]
+ Document FAN_REPORT_FID and directory modification events
+
+vdso.7
+ Tobias Klauser [Palmer Dabbelt]
+ Document vDSO for RISCV
+
+Renamed pages
+-------------
+
+sysvipc.7
+ svipc(7) is renamed to sysvipc(7).
+ The name sysvipc is a bit more natural, and is the name used in
+ /proc/sysvipc.
+
+New and changed links
+---------------------
+
+svipc.7
+ Michael Kerrisk
+ Add old name of sysvipc(7) page as a link
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Change reference to svipc(7) to sysvipc(7)
+
+
+Changes to individual pages
+---------------------------
+
+pldd.1
+ G. Branden Robinson [Michael Kerrisk]
+ Document glibc's unbreakage of tool
+ After a longstanding breakage, pldd now works again (glibc 2.30).
+
+bpf.2
+ Michael Kerrisk
+ Correct kernel version for JIT support on s390
+
+chdir.2
+ Michael Kerrisk
+ Add ENOTDIR error for fchdir()
+
+execve.2
+ Michael Kerrisk [Eugene Syromyatnikov]
+ Since Linux 5.1, the limit on the #! line is 255 chars (rather than 127)
+ Shawn Landden [Michael Kerrisk]
+ Add more detail about Shebangs
+ Michael Kerrisk
+ Linux is not alone in ignoring the set-UID and set-GID bits for scripts
+
+mount.2
+ Michael Kerrisk
+ ERRORS: Add a couple of EINVAL errors for MS_MOVE
+ Michael Kerrisk
+ SEE ALSO: add chroot(2) and pivot_root(2)
+
+mprotect.2
+ Mark Wielaard
+ pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0
+
+mprotect.2
+pkey_alloc.2
+ Mark Wielaard [Florian Weimer]
+ _GNU_SOURCE is required for the pkey functions.
+
+pivot_root.2
+ Michael Kerrisk
+ ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation
+ Michael Kerrisk
+ 'new_root' must be a mount point
+ It appears that 'new_root' may not have needed to be a mount
+ point on ancient kernels, but already in Linux 2.4.5 this changed.
+ Michael Kerrisk
+ 'put_old' can't be a mount point with MS_SHARED propagation
+ Michael Kerrisk
+ SEE ALSO: add mount(2)
+
+poll.2
+ Michael Kerrisk [Alan Stern]
+ Note that poll() equivalent code for ppoll() is not quite equivalent
+
+prctl.2
+ Yang Xu [Cyrill Gorcunov]
+ Correct some details for PR_SET_TIMERSLACK
+
+setxattr.2
+ Finn O'Leary [Michael Kerrisk]
+ Add ERANGE to 'ERRORS' section
+
+tkill.2
+ Michael Kerrisk
+ glibc 2.30 provides a wrapper for tgkill()
+
+dlopen.3
+ Michael Kerrisk
+ Clarify the rules for symbol resolution in a dlopen'ed object
+ The existing text wrongly implied that symbol look up first
+ occurred in the object and then in main, and did not mention
+ whether dependencies of main where used for symbol resolution.
+ Michael Kerrisk
+ Clarify when an executable's symbols can be used for symbol resolution
+ The --export-dynamic linker option is not the only way that main's
+ global symbols may end up in the dynamic symbol table and thus be
+ used to satisfy symbol reference in a shared object. A symbol
+ may also be placed into the dynamic symbol table if ld(1)
+ notices a dependency in another object during the static link.
+ Michael Kerrisk
+ An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL
+ Michael Kerrisk
+ Note that symbol use might keep a dlclose'd object in memory
+ Michael Kerrisk
+ On dlclose(), destructors are called when reference count falls to 0
+ Michael Kerrisk
+ Make it clear that RTLD_NODELETE also affects global variables
+ Michael Kerrisk
+ Clarify that constructors are called only when library is first loaded
+
+exec.3
+ Matthew Kenigsberg
+ Explain function groupings
+ I've found the exec man page quite difficult to read when trying
+ to find the behavior for a specific function. Since the names of
+ the functions are inline and the order of the descriptions isn't
+ clear, it's hard to find which paragraphs apply to each function.
+ I thought it would be much easier to read if the grouping based on
+ letters is stated.
+
+getutent.3
+ Michael Kerrisk [Thorsten Glaser]
+ Fix missing include file in EXAMPLE
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=932382
+
+on_exit.3
+ Michael Kerrisk [Sami Kerola]
+ Stack variables may be out of scope when exit handler is invoked
+
+strcat.3
+ Michael Kerrisk [Eric Sanchis]
+ Fix off-by-one error in example code
+
+cpuid.4
+ Michael Kerrisk
+ SEE ALSO: add cpuid(1)
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add ld.so(8)
+
+proc.5
+ Michael Kerrisk
+ Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields
+ These fields are signal masks, not counters.
+ Michael Kerrisk
+ Clarify that various mask fields in /proc/PID/status are in hexadecimal
+
+capabilities.7
+ Michael Kerrisk
+ Add a note about using strace on binaries that have capabilities
+ Michael Kerrisk
+ Add pivot_root(2) to CAP_SYS_ADMIN list
+ Michael Kerrisk
+ CAP_FOWNER also allows modifying user xattrs on sticky directories
+
+cgroup_namespaces.7
+ Michael Kerrisk
+ Some wording fixes to improve clarity
+ Michael Kerrisk
+ In the example shell session, give second shell a different prompt
+
+credentials.7
+ Michael Kerrisk
+ Note that /proc/PID/status shows a process's credentials
+ Michael Kerrisk
+ SEE ALSO: add tcgetsid(3)
+
+fanotify.7
+ Matthew Bobrowski
+ Reword FAN_REPORT_FID data structure inclusion semantics
+ Michael Kerrisk
+ Clarify logic in ESTALE check
+ Michael Kerrisk
+ Reorder text in EXAMPLE
+ Michael Kerrisk
+ Reformat program output to fit in 80 columns
+
+mount_namespaces.7
+ Michael Kerrisk
+ Clarify implications for other NS if mount point is removed in one NS
+ If a mount point is deleted or renamed or removed in one mount
+ namespace, this will cause an object that is mounted at that
+ location in another mount namespace to be unmounted (as verified
+ by experiment). This was implied by the existing text, but it is
+ better to make this detail explicit.
+ Michael Kerrisk
+ SEE ALSO: add pivot_root(2), pivot_root(8)
+
+namespaces.7
+ Michael Kerrisk
+ Note initial values of hostname and domainname in a new UTS namespace
+
+sched.7
+ Michael Kerrisk
+ SEE ALSO: add pthread_getschedparam(3)
+
+signal.7
+ Michal Sekletar [Oleg Nesterov, Michael Kerrisk]
+ Clarify that siginfo_t isn't changed on coalescing
+ Michael Kerrisk
+ Various fields in /proc/PID/status show signal-related information
+ Michael Kerrisk
+ Add subsection on queuing and delivery semantics for standard signals
+
+socket.7
+ Michael Kerrisk
+ select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28
+
+unix.7
+ Michael Kerrisk
+ Note SCM_RIGHTS interaction with RLIMIT_NOFILE
+ If the file descriptors received in SCM_RIGHTS would cause
+ the process to its exceed RLIMIT_NOFILE limit, the excess
+ FDs are discarded.
+
+user_namespaces.7
+ Michael Kerrisk
+ Describe the effect of file-related capabilities inside user namespaces
+ Michael Kerrisk
+ Describe how kernel treats UIDs/GIDs when a process accesses files
+
+vdso.7
+ Tobias Klauser
+ Mention removal of Blackfin port in Linux 4.17
+
+ld.so.8
+ Michael Kerrisk [Matthias Hertel]
+ Note some further details of secure-execution mode
+ Note some further details of the treatment of environment
+ variables in secure execution mode. In particular (as noted by
+ Matthias Hertel), note that ignored environment variables are also
+ stripped from the environment. Furthermore, there are some other
+ variables, not used by the dynamic linker itself, that are also
+ treated in this way (see the glibc source file
+ sysdeps/generic/unsecvars.h).
+
+
+==================== Changes in man-pages-5.03 ====================
+
+Released: 2019-10-11, 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:
+
+Adam Borowski <kilobyte@angband.pl>
+Aleksa Sarai <asarai@suse.de>
+Alexey Budankov <alexey.budankov@linux.intel.com>
+Amir Goldstein <amir73il@gmail.com>
+Andrew Clayton <andrew@digital-domain.net>
+Carlos O'Donell <carlos@redhat.com>
+Christian Brauner <christian@brauner.io>
+Christopher M. Riedl <cmr@informatik.wtf>
+Daniel Colascione <dancol@google.com>
+Dave Carroll <david.carroll@microsemi.com>
+Dave Chinner <dchinner@redhat.com>
+Дилян Палаузов <dilyan.palauzov@aegee.org>
+Dmitry V. Levin <ldv@altlinux.org>
+Don Brace <don.brace@microsemi.com>
+eponymous alias <eponymousalias@yahoo.com>
+Eric Biggers <ebiggers@google.com>
+Eric W. Biederman <ebiederm@xmission.com>
+Florian Weimer <fw@deneb.enyo.de>
+Florin Blanaru <florin.blanaru96@gmail.com>
+Gilbert Wu <gilbert.wu@microsemi.com>
+Ingo Schwarze <schwarze@usta.de>
+Jakub Wilk <jwilk@jwilk.net>
+Kevin Barnett <kevin.barnett@microsemi.com>
+Marko Myllynen <myllynen@redhat.com>
+Matti Moell <Matti.Moell@opensynergy.com>
+Matti Möll <Matti.Moell@opensynergy.com>
+Matt Perricone <matt.perricone@microsemi.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Murthy Bhat <Murthy.Bhat@microsemi.com>
+Nikola Forró <nforro@redhat.com>
+nilsocket <nilsocket@gmail.com>
+Paul Wise <pabs3@bonedaddy.net>
+Philipp Wendler <ml@philippwendler.de>
+Raphael Moreira Zinsly <rzinsly@linux.vnet.ibm.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Reid Priedhorsky <reidpr@lanl.gov>
+Rick Stanley <rstanley@rsiny.com>
+Rob Landley <rob@landley.net>
+Scott Benesh <scott.benesh@microsemi.com>
+Scott Teel <scott.teel@microsemi.com>
+Shawn Anastasio <shawn@anastas.io>
+Simone Piccardi <piccardi@truelite.it>
+Vincent Lefevre <vincent@vinc17.net>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pidfd_open.2
+ Michael Kerrisk [Christian Brauner, Florian Weimer, Daniel Colascione]
+ New page documenting pidfd_open(2)
+
+pidfd_send_signal.2
+ Michael Kerrisk [Florian Weimer, Christian Brauner]
+ New page documenting pidfd_send_signal(2)
+
+pivot_root.2
+ Michael Kerrisk [Eric W. Biederman, Reid Priedhorsky, Philipp Wendler]
+ This page has been completely rewritten, adding a lot of missing
+ details (including the use of pivot_root(".", ".")) and an example
+ program. In addition, the text prevaricating on whether or not
+ pivot_root() might change the root and current working directories has
+ been eliminated, and replaced with a simple description of the behavior
+ of the system call, which has not changed for 19 years, and will not
+ change in the future. Many longstanding errors in the old version of
+ the page have also been corrected.
+
+ipc_namespaces.7
+ Michael Kerrisk
+ New page with content migrated from namespaces(7)
+
+uts_namespaces.7
+ Michael Kerrisk
+ New page with content migrated from namespaces(7)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Christian Brauner, Michael Kerrisk
+ Document CLONE_PIDFD
+ Add an entry for CLONE_PIDFD. This flag is available starting
+ with kernel 5.2. If specified, a process file descriptor
+ ("pidfd") referring to the child process will be returned in
+ the ptid argument.
+
+fanotify_mark.2
+ Jakub Wilk
+ Document FAN_MOVE_SELF
+
+ptrace.2
+ Dmitry V. Levin [Michael Kerrisk]
+ Document PTRACE_GET_SYSCALL_INFO
+
+regex.3
+ Rob Landley
+ Document REG_STARTEND
+
+
+New and changed links
+---------------------
+
+res_nclose.3
+ Michael Kerrisk
+ Add NEW link to resolver.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ SEE ALSO: correct list order
+
+Various pages
+ Michael Kerrisk
+ Remove section number from references to function in its own page
+
+Various pages
+ Michael Kerrisk
+ ERRORS: correct alphabetical order
+
+
+Changes to individual pages
+---------------------------
+
+localedef.1
+ Marko Myllynen
+ Describe recently added options
+ Describe few recently added options (present in glibc-2.29).
+
+clone.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_open(2)
+
+copy_file_range.2
+ Amir Goldstein [Dave Chinner]
+ Kernel v5.3 updates
+
+fanotify_mark.2
+ Jakub Wilk
+ Add kernel version numbers for some FAN_* constants
+
+getdomainname.2
+ Michael Kerrisk
+ Add mention of UTS namespaces
+
+gethostname.2
+ Michael Kerrisk [Jakub Wilk]
+ Mention UTS namespaces
+
+io_submit.2
+ Matti Moell [Matti Möll]
+ Fix kernel version numbers for 'aio_rw_flags' flags
+
+kill.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+mmap.2
+ Nikola Forró
+ Fix EINVAL conditions
+ Since introduction of MAP_SHARED_VALIDATE, in case flags contain
+ both MAP_PRIVATE and MAP_SHARED, mmap() doesn't fail with EINVAL,
+ it succeeds.
+
+ The reason for that is that MAP_SHARED_VALIDATE is in fact equal
+ to MAP_PRIVATE | MAP_SHARED.
+
+mount.2
+ Michael Kerrisk [Reid Priedhorsky]
+ Describe the concept of "parent mounts"
+ Michael Kerrisk
+ NOTES: add subsection heading for /proc/[pid]/{mounts,mountinfo}
+ Michael Kerrisk
+ Rework the text on mount namespaces a little
+ Eliminate the term "Per-process namespaces" and add a reference
+ to mount_namespaces(7).
+
+move_pages.2
+ Yang Xu [Michael Kerrisk]
+ Mark E2BIG as deprecated
+ E2BIG was removed in 2.6.29, we should mark it as deprecated.
+
+perf_event_open.2
+ Michael Kerrisk [Alexey Budankov]
+ SEE ALSO: add Documentation/admin-guide/perf-security.rst
+
+prctl.2
+ Michael Kerrisk
+ Clarify that PR_GET_SPECULATION_CTRL returns value as function result
+ Michael Kerrisk
+ Clarify that PR_MCE_KILL_GET returns value via function result
+ Michael Kerrisk
+ Clarify that PR_GET_FP_MODE returns value as function result
+ Michael Kerrisk
+ RETURN VALUE: add some missing entries
+ Note success return for PR_GET_SPECULATION_CTRL and PR_GET_FP_MODE.
+
+rt_sigqueueinfo.2
+ Michael Kerrisk
+ Note that 'si_code' can't be specified as SI_KERNEL
+ Michael Kerrisk
+ The rules for 'si_code' don't apply when sending a signal to oneself
+ The restriction on what values may be specified in 'si_code'
+ apply only when sending a signal to a process other than the
+ caller itself.
+ Michael Kerrisk
+ Rename 'uinfo' argument to 'info'
+ This is more consistent with the naming in other pages
+ that refer to a 'siginfo_t' structure.
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ RETURN VALUE: sched_getaffinity() syscall differs from the wrapper
+
+setns.2
+ Mike Frysinger
+ Fix CLONE_NEWNS restriction info
+
+sigaction.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+signalfd.2
+ Andrew Clayton, Michael Kerrisk
+ Note about interactions with epoll & fork
+
+statx.2
+ Michael Kerrisk [Simone Piccardi]
+ Clarify details of a case where an invalid 'mask' value may be rejected
+
+syscall.2
+ Shawn Anastasio
+ Add information for powerpc64
+ Michael Kerrisk [Adam Borowski, Florin Blanaru]
+ Update name of syscall instruction for riscv
+
+syscalls.2
+ Michael Kerrisk
+ Add fsconfig(), fsmount(), fsopen(), fspick(), move_mount(), open_tree()
+ Michael Kerrisk [(), Michael(), Kerrisk(),]
+ Add new syscalls in 5.1
+ Add io_uring_enter(), io_uring_register(), io_uring_setup(), and
+ pidfd_send_signal().
+ Michael Kerrisk
+ Add clone3() and pidfd_open()
+
+uname.2
+ Michael Kerrisk
+ Replace reference to namespaces(7) with reference to uts_namespaces(7)
+
+errno.3
+ Rasmus Villemoes
+ Add some comments on EAGAIN/EWOULDBLOCK and EDEADLK/EDEADLOCK
+
+fexecve.3
+ Michael Kerrisk [Simone Piccardi]
+ ENOSYS occurs only if the kernel provides no execveat() syscall
+ Michael Kerrisk [Simone Piccardi]
+ ERRORS: add ENOENT
+
+getauxval.3
+ Raphael Moreira Zinsly
+ Add new cache geometry entries
+
+printf.3
+ Vincent Lefevre
+ Add detail on the first digit with the %e format
+
+pthread_setcancelstate.3
+pthreads.7
+signal-safety.7
+ Carlos O'Donell
+ Describe issues with cancellation points in signal handlers
+
+strtok.3
+ Michael Kerrisk [eponymous alias]
+ Correct description of use of 'saveptr' argument in strtok_r()
+ Michael Kerrisk [eponymous alias]
+ The caller should not modify 'saveptr' between strtok_r() calls
+ Michael Kerrisk
+ Add portability note for strtok_r() '*saveptr' value
+ On some implementations, '*saveptr' must be NULL on first call
+ to strtok_r().
+
+smartpqi.4
+ Murthy Bhat [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
+ Add sysfs entries
+ Gilbert Wu [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
+ Add module param expose ld first
+ Dave Carroll [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
+ Add module param to hide vsep
+
+core.5
+ Paul Wise
+ Explain the new situation with argument splitting
+ Things changed in Linux v5.3-rc3 commit 315c69261dd3 from
+ splitting after template expansion to splitting beforehand.
+
+resolv.conf.5
+ Nikola Forró
+ Update information about search list
+ Since glibc 2.26, the number of domains in the search list is
+ no longer limited.
+
+man-pages.7
+ Michael Kerrisk
+ Relocate and enhance the text on semantic newlines
+ Michael Kerrisk [Paul Wise]
+ Paragraphs should not be separated by blank lines
+
+mount_namespaces.7
+ Michael Kerrisk
+ Explain how a namespace's mount point list is initialized
+ Provide a more detailed explanation of the initialization of
+ the mount point list in a new mount namespace.
+ Michael Kerrisk [Eric W. Biederman]
+ Clarify description of "less privileged" mount namespaces
+ Michael Kerrisk
+ SEE ALSO: refer to example in pivot_root(2)
+ Michael Kerrisk [Eric W. Biederman]
+ It may be desirable to disable propagation after creating a namespace
+ After creating a new mount namespace, it may be desirable to
+ disable mount propagation. Give the reader a more explicit
+ hint about this.
+
+mq_overview.7
+sysvipc.7
+ Michael Kerrisk
+ Adjust references to namespaces(7) to ipc_namespaces(7)
+
+namespaces.7
+ Michael Kerrisk
+ Remove content migrated to new ipc_namespaces(7) page
+ Michael Kerrisk
+ Remove content migrated to uts_namespaces(7)
+ Michael Kerrisk
+ Include manual page references in the summary table of namespace types
+ Make the page more compact by removing the stub subsections that
+ list the manual pages for the namespace types. And while we're
+ here, add an explanation of the table columns.
+
+operator.7
+ Michael Kerrisk [Rick Stanley]
+ Prefix and postfix ++/-- have different precedences
+ Harbison and Steele also agree on this.
+
+signal.7
+ Michael Kerrisk
+ Enhance the text on process-directed and thread-directed signals
+ clone(2) has a good description of these concepts; borrow
+ from it liberally.
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+user_namespaces.7
+ Michael Kerrisk
+ Improve explanation of meaning of ownership of nonuser namespaces
+
+
+==================== Changes in man-pages-5.04 ====================
+
+Released: 2019-11-19, 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:
+
+Andrew Price <anprice@redhat.com>
+Christian Brauner <christian.brauner@ubuntu.com>
+Florian Weimer <fweimer@redhat.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Kenigbolo Meya Stephen <kenigbol@ut.ee>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mikael Magnusson <mikachu@gmail.com>
+Robert Edmonds <edmonds@debian.org>
+Silviu Popescu <silviupopescu1990@gmail.com>
+Torin Carey <torin@tcarey.uk>
+Witold Baryluk <witold.baryluk@gmail.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Michael Kerrisk [Christian Brauner, Jakub Wilk]
+ Document clone3()
+
+wait.2
+ Michael Kerrisk
+ Add P_PIDFD for waiting on a child referred to by a PID file descriptor
+
+bpf-helpers.7
+ Michael Kerrisk
+ Refresh against kernel v5.4-rc7
+
+
+New and changed links
+---------------------
+
+clone3.2
+ Michael Kerrisk
+ New link to clone(2)
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Rename arguments for consistency with clone3()
+ Make the names of the clone() arguments the same as the fields
+ in the clone3() 'args' struct:
+
+ ctid ==> child_pid
+ ptid ==> parent_tid
+ newtls ==> tld
+ child_stack ==> stack
+ Michael Kerrisk
+ Consistently order paragraphs for CLONE_NEW* flags
+ Sometimes the descriptions of these flags mentioned the
+ corresponding section 7 namespace manual page and then the
+ required capabilities, and sometimes the order was the was
+ the reverse. Make it consistent.
+ Michael Kerrisk [Christian Brauner, Jann Horn]
+ EXAMPLE: Allocate child's stack using mmap(2) rather than malloc(3)
+ Christian Brauner suggested mmap(MAP_STACK), rather than
+ malloc(), as the canonical way of allocating a stack for the
+ child of clone(), and Jann Horn noted some reasons why
+ (MAP_STACK exists elsewhere, and mmap() returns a page-aligned
+ block of memory, which is useful if we want to set up a guard
+ page at the end of the stack).
+ Michael Kerrisk [Christian Brauner]
+ Tidy up the description of CLONE_DETACHED
+ The obsolete CLONE_DETACHED flag has never been properly
+ documented, but now the discussion CLONE_PIDFD also requires
+ mention of CLONE_DETACHED. So, properly document CLONE_DETACHED,
+ and mention its interactions with CLONE_PIDFD.
+ Michael Kerrisk [Christian Brauner]
+ Give the introductory paragraph a new coat of paint
+ Change the text in the introductory paragraph (which was written
+ 20 years ago) to reflect the fact that clone*() does more things
+ nowadays.
+ Michael Kerrisk
+ Remove wording that suggests CLONE_NEW* flags are for containers
+ These flags are used for implementing many other interesting
+ things by now.
+ Michael Kerrisk
+ Remove various details that are already covered in namespaces pages
+ Remove details of UTS, IPC, and network namespaces that are
+ already covered in the corresponding namespaces pages in section 7.
+
+clone.2
+proc.5
+ Michael Kerrisk
+ Adjust references to namespaces(7)
+ Adjust references to namespaces(7) to be references to pages
+ describing specific namespace types.
+
+fallocate.2
+ Andrew Price
+ Add gfs2 to the list of punch hole-capable filesystems
+
+ioctl_iflags.2
+ Michael Kerrisk [Robert Edmonds]
+ Emphasize that FS_IOC_GETFLAGS and FS_IOC_SETFLAGS argument is 'int *'
+
+ioctl_list.2
+ Michael Kerrisk
+ Add reference to ioctl(2) SEE ALSO section
+ The referenced section lists various pages that document ioctls.
+
+mmap.2
+ Michael Kerrisk
+ Note that MAP_STACK exists on some other systems
+ Michael Kerrisk
+ Some rewording of the description of MAP_STACK
+ Reword a little to allow for the fact that there are now
+ *two* reasons to consider using this flag.
+
+pidfd_open.2
+ Michael Kerrisk
+ Note the waitid() use case for PID file descriptors
+ Michael Kerrisk
+ Add a subsection header "Use cases for PID file descriptors"
+ Michael Kerrisk
+ Make it a little more explicit the CLONE_PIDFD returns a PID FD
+
+pivot_root.2
+ Michael Kerrisk
+ EXAMPLE: allocate stack using mmap() MAP_STACK rather than malloc()
+
+quotactl.2
+ Yang Xu [Jan Kara]
+ Add some details about Q_QUOTAON
+
+seccomp.2
+cgroups.7
+ Michael Kerrisk
+ Switch to "considerate language"
+
+select.2
+ Michael Kerrisk
+ POLLIN_SET/POLLOUT_SET/POLLEX_SET are now defined in terms of EPOLL*
+ Since kernel commit a9a08845e9acbd224e4ee466f5c1275ed50054e8, the
+ equivalence between select() and poll()/epoll is defined in terms
+ of the EPOLL* constants, rather than the POLL* constants.
+
+wait.2
+ Michael Kerrisk
+ waitid() can be used to wait on children in same process group as caller
+ Since Linux 5.4, idtype == P_PGID && id == 0 can be used to wait
+ on children in same process group as caller.
+ Michael Kerrisk
+ Clarify semantics of waitpid(0, ...)
+ As noted in kernel commit 821cc7b0b205c0df64cce59aacc330af251fa8f7,
+ threads create an ambiguity: what if the calling process's PGID
+ is changed by another thread while waitpid(0, ...) is blocked?
+ So, clarify that waitpid(0, ...) means wait for children whose
+ PGID matches the caller's PGID at the time of the call to
+ waitpid().
+
+getauxval.3
+ Michael Kerrisk [Witold Baryluk]
+ Clarify that AT_BASE_PLATFORM and AT_EXECFN return pointers to strings
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=942207
+
+resolv.conf.5
+ Florian Weimer
+ Attempt clarify domain/search interaction
+ The domain directive is historic at this point; it should not
+ be used.
+
+netdevice.7
+ Michael Kerrisk [Silviu Popescu]
+ Small wording fix in description of SIOCGIFCONF
+ SIOCGIFCONF returns "network layer" addresses (not "transport
+ layer").
+
+uts_namespaces.7
+ Michael Kerrisk
+ Add a little more detail on scope of UTS namespaces
+
+
+==================== Changes in man-pages-5.05 ====================
+
+Released: 2020-02-09, 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:
+
+Adam Borowski <kilobyte@angband.pl>
+Adrian Reber <areber@redhat.com>
+Andy Lutomirski <luto@kernel.org>
+Antonin Décimo <antonin.decimo@gmail.com>
+Benjamin Peterson <benjamin@python.org>
+Brennan Vincent <brennan@materialize.io>
+Christian Brauner <christian.brauner@ubuntu.com>
+Colin Ian King <colin.king@canonical.com>
+Cyril Hrubis <chrubis@suse.cz>
+Daniel Colascione <dancol@google.com>
+Denys Vlasenko <dvlasenk@redhat.com>
+DJ Delorie <dj@redhat.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Jakub Wilk <jwilk@jwilk.net>
+Jashank Jeremy <jashank@rulingia.com.au>
+Joel Fernandes <joel@joelfernandes.org>
+John Hubbard <jhubbard@nvidia.com>
+John Jones <jmjatlanta@gmail.com>
+Joseph C. Sible <josephcsible@gmail.com>
+kevin sztern <kevin.sztern@epita.fr>
+Marko Myllynen <myllynen@redhat.com>
+markus T Metzger <markus.t.metzger@intel.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Salvatore <mike.salvatore@canonical.com>
+Mikhail Golubev <Mikhail.Golubev@opensynergy.com>
+Nick Shipp <ns@segbrk.com>
+Nikola Forró <nforro@redhat.com>
+Peter Gajdos <pgajdos@suse.cz>
+Petr Vorel <pvorel@suse.cz>
+Ponnuvel Palaniyappan <pponnuvel@gmail.com>
+Rich Felker <dalias@libc.org>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+Samuel Thibault <samuel.thibault@ens-lyon.org>
+Sam Varshavchik <mrsam@courier-mta.com>
+Vegard Nossum <vegard.nossum@gmail.com>
+Weitian LI <liweitianux@live.com>
+Will <cassis@tricolore.lu>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+Yu Jian Wu <yujian.wu1@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Adrian Reber [Christian Brauner, Michael Kerrisk]
+ Add clone3() set_tid information
+ Michael Kerrisk
+ Document CLONE_CLEAR_SIGHAND
+
+fcntl.2
+ Joel Fernandes [Michael Kerrisk]
+ Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
+
+memfd_create.2
+ Joel Fernandes
+ Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
+
+loop.4
+ Yang Xu
+ Document LOOP_SET_BLOCK_SIZE
+ Yang Xu
+ Document LOOP_SET_DIRECT_IO
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/vm/unprivileged_userfaultfd
+
+
+Changes to individual pages
+---------------------------
+
+capget.2
+ Michael Kerrisk [Yang Xu]
+ Add missing details in EPERM error for setting inheritable capabilities
+
+clone.2
+ Michael Kerrisk
+ Note that CLONE_THREAD causes similar behavior to CLONE_PARENT
+ The introductory paragraphs note that "the calling process" is
+ normally synonymous with the "the parent process", except in the
+ case of CLONE_PARENT. The same is also true of CLONE_THREAD.
+ Christian Brauner [Michael Kerrisk]
+ Mention that CLONE_PARENT is off-limits for inits
+ Michael Kerrisk [Colin Ian King]
+ Add old EINVAL error for AArch64
+ Michael Kerrisk
+ ERRORS: add EINVAL for use of CLONE_PARENT by an init process
+
+futex.2
+ Ponnuvel Palaniyappan
+ Fix a bug in the example
+
+listen.2
+ Michael Kerrisk [Peter Gajdos]
+ The 'somaxconn' default value has increased to 4096
+
+modify_ldt.2
+set_thread_area.2
+ Andy Lutomirski [Markus T Metzger]
+ Fix type of base_addr
+
+move_pages.2
+ John Hubbard [Michal Hocko]
+ Remove ENOENT from the list of possible return values
+
+open.2
+ Adam Borowski
+ No need for /proc to make an O_TMPFILE file permanent
+ In the example snippet, we already have the fd, thus there's no
+ need to refer to the file by name. And, /proc/ might be not
+ mounted or not accessible.
+ Michael Kerrisk [Joseph C. Sible]
+ In O_TMPFILE example, describe alternative linkat() call
+ This was already shown in an earlier version of the page,
+ but Adam Borowski's patch replaced it with an alternative.
+ Probably, it is better to show both possibilities.
+
+perf_event_open.2
+ Daniel Colascione
+ Mention EINTR for perf_event_open
+
+ptrace.2
+ Denys Vlasenko
+ PTRACE_EVENT_STOP does not always report SIGTRAP
+
+quotactl.2
+ Michael Kerrisk
+ Don't show numeric values of Q_XQUOTAON XFS_QUOTA_?DQ_* flags
+ The programmer should not need to care about the numeric values,
+ and their inclusion is verbosity.
+ Yang Xu [Michael Kerrisk]
+ Add EINVAL error of Q_XQUOTARM operation
+
+stime.2
+ Michael Kerrisk
+ Note that stime() is deprecated
+
+syscall.2
+ Petr Vorel [Cyril Hrubis]
+ Update feature test macro requirements
+
+sysctl.2
+ Michael Kerrisk
+ This system call was removed in Linux 5.5; adjust the page accordingly
+
+userfaultfd.2
+ Yang Xu [Michael Kerrisk]
+ Add EPERM error
+
+cmsg.3
+ Rich Felker
+ Clarify alignment issues and correct method of accessing CMSG_DATA()
+ From an email by Rich Felker:
+
+ It came to my attention while reviewing possible breakage with
+ move to 64-bit time_t that some applications are dereferencing
+ data in socket control messages (particularly SCM_TIMESTAMP*)
+ in-place as the message type, rather than memcpy'ing it to
+ appropriate storage. This necessarily does not work and is not
+ supportable if the message contains data with greater alignment
+ requirement than the header. In particular, on 32-bit archs,
+ cmsghdr has size 12 and alignment 4, but struct timeval and
+ timespec may have alignment requirement 8.
+ Michael Kerrisk [Rich Felker]
+ Modify CMSG_DATA() example to use memcpy()
+ See previous patch to this page for rationale
+
+exit.3
+ Benjamin Peterson [Mike Frysinger]
+ Use hex for the status mask
+
+ftime.3
+ Michael Kerrisk
+ Note that this function is deprecated
+
+getpt.3
+ Samuel Thibault
+ Remove mention of O_NOCTTY
+ The glibc implementation of getpt has actually never been setting
+
+malloc.3
+ Vegard Nossum
+ Clarify realloc() return value
+ Petr Vorel
+ Remove duplicate _GNU_SOURCE
+
+console_codes.4
+ Adam Borowski
+ Document \e[90m to 97, 100 to 107
+ Adam Borowski
+ \e[21m is now underline
+ Since 65d9982d7e523a1a8e7c9af012da0d166f72fc56 (4.17), it follows
+ xterm rather than common sense and consistency, being the only
+ command 1..9 where N+20 doesn't undo what N did. As libvte
+ 0.51.90 got changed the same way, this behaviour will probably
+ stay.
+ Adam Borowski
+ Update \e[38m and \e[48m
+ Supported since cec5b2a97a11ade56a701e83044d0a2a984c67b4 (3.16).
+
+cgroups.7
+ Michael Kerrisk
+ The v2 freezer controller was added in Linux 5.2
+ Michael Kerrisk
+ Split discussion of cgroups.events file and v2 release notification
+ In preparation for adding a description of the "frozen" key.
+ Michael Kerrisk
+ Describe the cgroup.events "frozen" key
+ Michael Kerrisk
+ Improve the discussion of the advantages of v2 release notification
+
+inotify.7
+ Nick Shipp
+ Merge late perror() into fprintf() in example code
+
+netlink.7
+ Antonin Décimo
+ Fix alignment issue in example
+
+packet.7
+ kevin sztern [Michael Kerrisk]
+ Add missing tpacket_auxdata field (tp_vlan_tpid)
+
+rtnetlink.7
+ Antonin Décimo
+ ifa_index is an unsigned int
+
+tcp.7
+ Michael Kerrisk
+ tcp_low_latency is ignored since Linux 4.14
+
+unix.7
+ Michael Kerrisk
+ The PID sent with SCM_CREDENTIALS must match an existing process
+
+vsock.7
+ Mikhail Golubev [Michael Kerrisk]
+ Add missing structure element
+ The structure 'struct sockaddr_vm' has additional element
+ 'unsigned char svm_zero[]' since version v3.9-rc1.
+
+ldconfig.8
+ DJ Delorie
+ Document file filter and symlink pattern expectations
+
+
+==================== Changes in man-pages-5.06 ====================
+
+Released: 2020-04-11, 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:
+
+Alejandro Colomar <alx@kernel.org>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexander Miller <alex.miller@gmx.de>
+Andrea Arcangeli <aarcange@redhat.com>
+André Almeida <andrealmeid@collabora.com>
+Andrei Vagin <avagin@gmail.com>
+Andrew Micallef <andrew.micallef@live.com.au>
+Bart Van Assche <bvanassche@acm.org>
+Benjamin Peterson <benjamin@python.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Christian Brauner <christian@brauner.io>
+devi R.K <devi.feb27@gmail.com>
+Dmitry Safonov <dima@arista.com>
+Eric Biggers <ebiggers@google.com>
+Eric Dumazet <eric.dumazet@gmail.com>
+Eric Rannaud <e@nanocritical.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helge Deller <deller@gmx.de>
+Jakub Wilk <jwilk@jwilk.net>
+Jorgen Hansen <jhansen@vmware.com>
+Julia Suvorova <jusual@mail.ru>
+Keno Fischer <keno@juliacomputing.com>
+Krzysztof Małysa <varqox@gmail.com>
+Marc Lehmann <debian-reportbug@plan9.de>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Wilcox <willy@infradead.org>
+Michael Galassi <michael@galassi.us>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@kernel.org>
+Mike Christie <mchristi@redhat.com>
+Mike Frysinger <vapier@gentoo.org>
+Pablo M. Ronchi <pmronchi@yahoo.com.ar>
+Ricardo Biehl Pasquali <pasqualirb@gmail.com>
+Stefan Hajnoczi <stefanha@redhat.com>
+Stefano Garzarella <sgarzare@redhat.com>
+Thomas Gleixner <tglx@linutronix.de>
+Walter Harms <wharms@bfs.de>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+openat2.2
+ Aleksa Sarai [Michael Kerrisk]
+ Document new openat2(2) syscall
+
+pidfd_getfd.2
+ Michael Kerrisk [Christian Brauner]
+ New manual page documenting the pidfd_getfd() system call
+
+select.2
+ Michael Kerrisk
+ Rewrite DESCRIPTION
+ Improve structure and readability, at the same time incorporating
+ text and details that were formerly in select_tut(2). Also
+ move a few details in other parts of the page into DESCRIPTION.
+ Michael Kerrisk
+ Consolidate the discussion of pselect into a headed subsection
+ Michael Kerrisk
+ Consolidate historical glibc pselect() details under one subhead
+ Michael Kerrisk
+ Consolidate info on usleep() emulation in one place
+ Michael Kerrisk
+ Place the discussion of the self-pipe technique in a headed subsection
+ Michael Kerrisk
+ Note that FD_SET() and FD_CLR() do not return errors
+ Michael Kerrisk
+ Remove details of historical #include requirements
+ The POSIX situation has been the norm for a long time now,
+ and including ancient details overcomplicates the page.
+ Michael Kerrisk
+ Remove some ancient information about pre-POSIX types for 'timeout'
+
+select_tut.2
+ Michael Kerrisk
+ Eliminate duplication of info across select_tut.2 and select2
+ There was a lot of a duplication of info in SYNOPSIS, DESCRIPTION
+ RETURN VALUE, and SEE ALSO. Move all of the info to one place:
+ the select(2) page.
+
+sysvipc.7
+ Michael Kerrisk
+ Rewrite this page as just a summary of the System V IPC APIs
+ All of the other details in this page have by now been moved into
+ the relevant *ctl(2) pages.
+
+time_namespaces.7
+ Michael Kerrisk [Andrei Vagin, Dmitry Safonov, Thomas Gleixner]
+ New page documenting time namespaces
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+arch_prctl.2
+ Keno Fischer
+ Add ARCH_SET_CPUID subcommand
+
+clock_getres.2
+ Benjamin Peterson
+ Document CLOCK_TAI
+ Michael Kerrisk
+ Add CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM
+
+prctl.2
+ Mike Christie [Michal Hocko, Michael Kerrisk, Bart Van Assche]
+ Document PR_SETIO_FLUSHER/GET_IO_FLUSHER
+
+setns.2
+ Michael Kerrisk
+ Document CLONE_NEWTIME
+
+statx.2
+ Eric Biggers
+ Document STATX_ATTR_VERITY
+
+unshare.2
+ Michael Kerrisk
+ Document CLONE_NEWTIME
+
+socket.7
+ Ricardo Biehl Pasquali, Michael Kerrisk
+ Add description of SO_SELECT_ERR_QUEUE
+ Alejandro Colomar [Michael Kerrisk]
+ Document SO_TIMESTAMPNS
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Remove a few mentions of the ancient "Linux libc"
+
+Various pages
+ Michael Kerrisk
+ Global formatting fix: disfavor nonstandard .TP indents
+ In many cases, these don't improve readability, and (when stacked)
+ they sometimes have the side effect of sometimes forcing text
+ to be justified within a narrow column range.
+
+Various pages
+ Michael Kerrisk [Christian Brauner]
+ Fix clumsy wording around "nonnegative file descriptors"
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Helge Deller [Michael Kerrisk]
+ Consecutive calls for CLOCK_MONOTONIC may return same value
+ Consecutive calls to clock_gettime(CLOCK_MONOTONIC) are guaranteed
+ to return MONOTONIC values, which means that they either return
+ the *SAME* time value like the last call, or a later (higher) time
+ value.
+ Eric Rannaud
+ Dynamic POSIX clock devices can return other errors
+ Michael Kerrisk
+ Improve description of CPU-time clocks
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ CLOCK_REALTIME_COARSE is not settable
+ Michael Kerrisk
+ Note that CPU-time clocks are not settable.
+ Explicitly note that CLOCK_PROCESS_CPUTIME_ID and
+ CLOCK_PROCESS_CPUTIME_ID are not settable.
+ Michael Kerrisk
+ Clarify that CLOCK_TAI is nonsettable
+ Michael Kerrisk
+ Clarify that CLOCK_MONOTONIC is system-wide
+ Michael Kerrisk
+ ERRORS: add EINVAL for attempt to set a nonsettable clock
+ Michael Kerrisk
+ Move text in BUGS to NOTES
+ The fact that CLOCK_PROCESS_CPUTIME_ID and
+ CLOCK_PROCESS_CPUTIME_ID are not settable isn't a bug,
+ since POSIX does allow the possibility that these clocks
+ are not settable.
+ Michael Kerrisk
+ SEE ALSO: add time_namespaces(7)
+
+clock_nanosleep.2
+ Michael Kerrisk
+ clock_nanosleep() can also sleep against CLOCK_TAI
+ Michael Kerrisk
+ clock_nanosleep() also supports CLOCK_BOOTTIME
+ Presumably (and from a quick glance at the source code)
+ since Linux 2.6.39, when CLOCK_BOOTTIME was introduced.
+
+clock_nanosleep.2
+timer_create.2
+timerfd_create.2
+ Michael Kerrisk
+ Add various missing errors
+ Mostly verified by testing and reading the code.
+
+ There is unfortunately quite a bit of inconsistency across API~s:
+
+ clock_gettime clock_settime clock_nanosleep timer_create timerfd_create
+
+ CLOCK_BOOTTIME y n (EINVAL) y y y
+ CLOCK_BOOTTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
+ CLOCK_MONOTONIC y n (EINVAL) y y y
+ CLOCK_MONOTONIC_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_MONOTONIC_RAW y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_REALTIME y y y y y
+ CLOCK_REALTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
+ CLOCK_REALTIME_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_TAI y n (EINVAL) y y n (EINVAL)
+ CLOCK_PROCESS_CPUTIME_ID y n (EINVAL) y y n (EINVAL)
+ CLOCK_THREAD_CPUTIME_ID y n (EINVAL) n (EINVAL [2]) y n (EINVAL)
+ pthread_getcpuclockid() y n (EINVAL) y y n (EINVAL)
+
+ [1] The caller must have CAP_WAKE_ALARM, or the error EPERM results.
+
+ [2] This error is generated in the glibc wrapper.
+
+connect.2
+ Michael Kerrisk [Eric Dumazet]
+ Update the details on AF_UNSPEC
+ Update the details on AF_UNSPEC and circumstances in which
+ socket can be reconnected.
+
+dup.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_getfd(2)
+
+epoll_ctl.2
+ Michael Kerrisk
+ Various minor additions and clarifications
+
+epoll_wait.2
+ Michael Kerrisk
+ A few minor additions and rewrites
+
+execve.2
+ Michael Kerrisk
+ Add a subhead for the discussion of effect on process attributes
+ Michael Kerrisk
+ Explicitly note that argv[argc] == NULL in the new program
+ Michael Kerrisk
+ ERRORS: ENOENT does not occur for missing shared libraries
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=12241.
+
+_exit.2
+ Michael Kerrisk
+ Clarify that raw _exit() system call terminates only the calling thread
+
+inotify_add_watch.2
+ Michael Kerrisk
+ EXAMPLE: add reference to example in inotify(7)
+
+io_submit.2
+ Julia Suvorova
+ Add IOCB_CMD_POLL opcode
+
+lseek.2
+ Michael Kerrisk [Matthew Wilcox]
+ ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file
+
+madvise.2
+ Michael Kerrisk [Andrea Arcangeli]
+ Incorporate some (ancient) comments about MADV_HUGEPAGE
+ Back in 2011, a mail from Andrea Arcangeli noted some details
+ that I never got round to incorporating into the manual page.
+
+mmap.2
+ Michael Kerrisk
+ Add a subhead for the 'flags' argument
+ Michael Kerrisk
+ Move some text hidden at the end of DESCRIPTION to NOTES
+
+msgctl.2
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+ Michael Kerrisk
+ Copy information on 'msqid_ds' fields from sysvipc(7)
+
+open.2
+ Michael Kerrisk
+ Clarify that O_NOFOLLOW is relevant (only) for basename of 'pathname'
+ Aleksa Sarai
+ Add references to new openat2(2) page
+ Michael Kerrisk
+ Note EINVAL error for invalid character in basename of 'pathname'
+
+pidfd_open.2
+ Michael Kerrisk
+ Mention pidfd_getfd(2)
+
+poll.2
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ Mention epoll(7) in the introductory paragraph
+ Michael Kerrisk
+ Improve description of EFAULT error
+ Michael Kerrisk
+ Fix description of ENOMEM error
+
+select_tut.2
+ Michael Kerrisk
+ Adjust header file includes in example
+ Employ <sys/select.h>, rather than the historical header files.
+
+semctl.2
+ Michael Kerrisk
+ Copy information on 'semid_ds' fields from sysvipc(7)
+ Michael Kerrisk
+ Add a reference to the example in shmop(2)
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+
+semget.2
+ Michael Kerrisk
+ EXAMPLE: add an example program
+
+semop.2
+ Michael Kerrisk
+ Add a reference to the semop(2) example in shmop(2)
+
+shmctl.2
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+ Michael Kerrisk
+ Note that execute permission is not needed for shmat() SHM_EXEC
+ Michael Kerrisk
+ Copy information on 'shmid_ds' fields from sysvipc(7)
+ Michael Kerrisk
+ Some small improvements to the description of the 'shmid_ds' structure
+
+shmget.2
+ Michael Kerrisk
+ Add a reference to the example in shmop(2)
+
+shmop.2
+ Michael Kerrisk
+ EXAMPLE: add a pair of example programs
+ Add example programs demonstrating usage of shmget(2), shmat(2),
+ semget(2), semctl(2), and semop(2).
+
+sigaction.2
+signal.7
+ Zack Weinberg
+ Document kernel bugs in delivery of signals from CPU exceptions
+
+stat.2
+ Michael Kerrisk
+ Clarify definitions of timestamp fields
+ In particular, make it clear that atime and mtime relate to the
+ file *data*.
+
+syscalls.2
+ Michael Kerrisk
+ Add new Linux 5.6 system calls
+ Michael Kerrisk
+ Note that the 5.x series followed 4.20
+
+timer_create.2
+ Michael Kerrisk
+ timer_create(2) also supports CLOCK_TAI
+ Michael Kerrisk
+ Mention clock_getres(2) for further details on the various clocks
+
+timerfd_create.2
+ Michael Kerrisk [Thomas Gleixner]
+ Note a case where timerfd_settime() can fail with ECANCELED
+ Michael Kerrisk [devi R.K, Thomas Gleixner]
+ Negative changes to CLOCK_REALTIME may cause read() to return 0
+ Michael Kerrisk
+ Rework text for EINVAL for invalid clock ID
+ Michael Kerrisk
+ Refer reader to clock_getres(2) for further details on the clocks
+
+unshare.2
+ Michael Kerrisk
+ Add CLONE_NEWCGROUP and CLONE_NEWTIME to example program
+
+exit.3
+ Michael Kerrisk [Walter Harms]
+ Small improvement to the discussion of 'status' argument
+
+ftok.3
+ Michael Kerrisk
+ EXAMPLE: add a reference to the example in semget(2)
+
+getifaddrs.3
+ Michael Kerrisk [Michael Galassi]
+ EXAMPLE: remove unneeded loop variable
+
+nl_langinfo.3
+ Eugene Syromyatnikov
+ Document era-related locale elements
+ Eugene Syromyatnikov
+ Add information about AM/PM time format locale elements
+ Eugene Syromyatnikov
+ Mention the respective strftime(3) conversion specifications
+
+sem_init.3
+ Michael Kerrisk
+ Add references to example code in shm_open(3) and sem_wait(3)
+
+sem_post.3
+ Michael Kerrisk
+ Add a reference to code example code in shm_open(3)
+
+shm_open.3
+ Michael Kerrisk
+ EXAMPLE: add some example programs
+
+strcmp.3
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk [Andrew Micallef, Walter Harms]
+ Rework text describing return value to be clearer
+ Michael Kerrisk
+ Note that the comparison is done using unsigned char
+ Michael Kerrisk
+ SEE ALSO: add ascii(7)
+
+strftime.3
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Refer to the relevant nl_langinfo(3) items
+ Eugene Syromyatnikov
+ Expand %E and %O description
+ Eugene Syromyatnikov
+ Consistently document fall-back format string
+
+proc.5
+ Mike Frysinger
+ Clarify /proc/[pid]/cmdline mutability
+
+cgroups.7
+ Michael Kerrisk
+ Update list of cgroups v2 controllers
+ Update the list of cgroups v2 controllers (several controllers
+ were missing).
+ Michael Kerrisk
+ Add a subsection on cgroup v2 mount options and include 'nsdelegate'
+ Michael Kerrisk
+ Document the cgroups v2 'memory_localevents' mount option
+ Michael Kerrisk
+ SEE ALSO: add Documentation/admin-guide/cgroup-v2.rst
+
+namespaces.7
+ Michael Kerrisk
+ Add time namespaces information
+ Michael Kerrisk
+ Eliminate some superfluous info from display of /proc/PID/ns links
+
+path_resolution.7
+ Aleksa Sarai
+ Update to mention openat2(2) features
+
+socket.7
+ Michael Kerrisk
+ Note SCM message types for SO_TIMESTAMP and SO_TIMESTAMPNS
+
+tcp.7
+ Michael Kerrisk
+ SEE ALSO: mention Documentation/networking/ip-sysctl.txt
+
+time.7
+ Michael Kerrisk
+ Add small subsection on clocks and time namespaces
+
+unix.7
+ Heinrich Schuchardt
+ Correct example
+
+vsock.7
+ Stefano Garzarella [Jorgen Hansen, Stefan Hajnoczi]
+ Add VMADDR_CID_LOCAL description
+
+
+==================== Changes in man-pages-5.07 ====================
+
+Released: 2020-06-09, 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:
+
+Achilles Gaikwad <agaikwad@redhat.com>
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexander Monakov <amonakov@ispras.ru>
+Alexander Morozov <alexandermv@gmail.com>
+Alexopo Seid <alexopo.ceid@gmail.com>
+Amir Goldstein <amir73il@gmail.com>
+Andi Kleen <andi@firstfloor.org>
+Andrea Galbusera <gizero@gmail.com>
+Arnd Bergmann <arnd@arndb.de>
+Branden Robinson <g.branden.robinson@gmail.com>
+Brian Geffon <bgeffon@google.com>
+Bruno Haible <bruno@clisp.org>
+Chris Lamb <lamby@debian.org>
+Christian Brauner <christian.brauner@ubuntu.com>
+Dave Hansen <dave.hansen@linux.intel.com>
+Dave Martin <Dave.Martin@arm.com>
+David Adam <zanchey@ucc.gu.uwa.edu.au>
+Devin J. Pohly <djpohly@gmail.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Eric Hopper <hopper@omnifarious.org>
+Eric Sandeen <sandeen@redhat.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabien Siron <fabien.siron@epita.fr>
+Florian Weimer <fweimer@redhat.com>
+Gary Perkins <glperkins@lit.edu>
+Geoff Clare <gwc@opengroup.org>
+Goldwyn Rodrigues <rgoldwyn@suse.com>
+Heiko Carstens <heiko.carstens@de.ibm.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helge Kreutzmann <debian@helgefjell.de>
+Ian Rogers <irogers@google.com>
+Idan Katz <idanski1@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jan Moskyto Matejka <mq@ucw.cz>
+Jason Etherton <jason@ethertonltd.co.uk>
+Jeff Moyer <jmoyer@redhat.com>
+John Marshall <John.W.Marshall@glasgow.ac.uk>
+Jonny Grant <jg@jguk.org>
+Joseph C. Sible <josephcsible@gmail.com>
+Jürgen Sauermann <mail@juergen-sauermann.de>
+Kai Mäkisara <kai.makisara@kolumbus.fi>
+Keno Fischer <keno@juliacomputing.com>
+Kirill A. Shutemov <kirill@shutemov.name>
+Kirill Smelkov <kirr@nexedi.com>
+Kir Kolyshkin <kolyshkin@gmail.com>
+Léo Stefanesco <leo.lveb@gmail.com>
+Li Xinhai <lixinhai.lxh@gmail.com>
+Lokesh Gidra <lokeshgidra@google.com>
+Lukas Czerner <lczerner@redhat.com>
+Manfred Spraul <manfred@colorfullife.com>
+Marco Curreli <marcocurreli@tiscali.it>
+Marcus Gelderie <redmnic@gmail.com>
+Martin Doucha <mdoucha@suse.cz>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Nikola Forró <nforro@redhat.com>
+Olivier Gayot <olivier.gayot@sigexec.com>
+Ondrej Slamecka <ondrej@slamecka.cz>
+Paul Eggert <eggert@cs.ucla.edu>
+Peter Schiffer <pschiffe@redhat.com>
+Peter Wu <peter@lekensteyn.nl>
+Petr Vorel <pvorel@suse.cz>
+Piotr Caban <piotr@codeweavers.com>
+Ricardo Castano <ricardo.castano.salinas@gmail.com>
+Richard Cochran <richardcochran@gmail.com>
+Richard Palethorpe <rpalethorpe@suse.com>
+Russell King <rmk+kernel@armlinux.org.uk>
+Stefan Puiu <stefan.puiu@gmail.com>
+Thierry Lelegard <thierry.lelegard@canal-plus.fr>
+Thomas Piekarski <t.piekarski@deloquencia.de>
+Tobias Stoeckmann <tobias@stoeckmann.org>
+Urs Thuermann <urs@isnogud.escape.de>
+Vincent Lefèvre <vincent-srcware@vinc17.net>
+Vlad <cvazir@gmail.com>
+vrafaeli@msn.com
+walter harms <wharms@bfs.de>
+Will Deacon <will@kernel.org>
+Yang Shi <yang.shi@linux.alibaba.com>
+YunQiang Su <syq@debian.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+ioctl_fslabel.2
+ Eric Sandeen
+ New page documenting filesystem get/set label ioctl(2) operations
+
+
+Removed pages
+-------------
+
+ioctl_list.2
+ Michael Kerrisk [Heinrich Schuchardt, Eugene Syromyatnikov]
+ This page was first added more than 20 years ago. Since
+ that time it has seen hardly any update, and is by now
+ very much out of date, as reported by Heinrich Schuchardt
+ and confirmed by Eugene Syromyatnikov.
+
+ As Heinrich says:
+
+ Man-pages like netdevices.7 or ioctl_fat.2 are what is
+ needed to help a user who does not want to read through the
+ kernel code.
+
+ If ioctl_list.2 has not been reasonably maintained since
+ Linux 1.3.27 and hence is not a reliable source of
+ information, shouldn't it be dropped?
+
+ My answer is, yes (but let's move a little info into ioctl(2)).
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+adjtimex.2
+ Arnd Bergmann [Richard Cochran, Michael Kerrisk]
+ Document clock_adjtime(2)
+
+clock_getres.2
+ Richard Cochran [Michael Kerrisk]
+ Explain dynamic clocks
+
+clone.2
+ Christian Brauner, Michael Kerrisk
+ Document the clone3() CLONE_INTO_CGROUP flag
+
+mremap.2
+ Brian Geffon, Michael Kerrisk [Lokesh Gidra]
+ Document MREMAP_DONTUNMAP
+
+open.2
+ Joseph C. Sible [Michael Kerrisk]
+ Document fs.protected_fifos and fs.protected_regular
+
+prctl.2
+ Dave Martin
+ Add PR_SPEC_INDIRECT_BRANCH for SPECULATION_CTRL prctls
+ Dave Martin
+ Add PR_SPEC_DISABLE_NOEXEC for SPECULATION_CTRL prctls
+ Dave Martin
+ Add PR_PAC_RESET_KEYS (arm64)
+
+ptrace.2
+ Joseph C. Sible
+ Document PTRACE_SET_SYSCALL
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/fs/protected_regular
+ Michael Kerrisk
+ Document /proc/sys/fs/protected_fifos
+ Michael Kerrisk
+ Document /proc/sys/fs/aio-max-nr and /proc/sys/fs/aio-nr
+
+New and changed links
+---------------------
+
+clock_adjtime.2
+ Arnd Bergmann
+ New link to adjtimex(2)
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Retitle EXAMPLE section heading to EXAMPLES
+ EXAMPLES appears to be the wider majority usage across various
+ projects' manual pages, and is also what is used in the POSIX
+ manual pages.
+
+Various pages
+ Michael Kerrisk
+ Correct bogus POSIX.1 standards names
+ POSIX.1-2003 ==> POSIX.1-2001 TC1
+ POSIX.1-2004 ==> POSIX.1-2001 TC2
+ POSIX.1-2013 ==> POSIX.1-2008 TC1
+ POSIX.1-2016 ==> POSIX.1-2008 TC2
+
+Various pages
+ Michael Kerrisk
+ Add section number in page cross-reference.
+
+Various pages
+ Kir Kolyshkin
+ Add missing commas in SEE ALSO
+
+Various pages
+ Michael Kerrisk
+ Remove AVAILABILITY section heading
+ In the few pages where this heading (which is "nonstandard" within
+ man-pages) is used, it always immediately follows CONFORMING TO
+ and generally contains information related to standards. Remove
+ the section heading, thus incorporating AVAILABILITY into
+ CONFORMING TO.
+
+Various pages
+ Michael Kerrisk
+ Remove section number in page self-references
+
+Various pages
+ Michael Kerrisk
+ Put SEE ALSO entries in alphabetical order
+
+Various pages
+ Michael Kerrisk
+ Place SH sections in standard order
+ Fix various pages that deviated from the norm described in
+ man-pages(7).
+
+Various "aio" pages
+ Michael Kerrisk [Andi Kleen, Jeff Moyer]
+ Change uses of aio_context_t to io_context_t
+
+
+Changes to individual pages
+---------------------------
+
+bpf.2
+ Peter Wu
+ Update enum bpf_map_type and enum bpf_prog_type
+ Richard Palethorpe
+ Change note on unprivileged access
+ The kernel now allows calls to bpf() without CAP_SYS_ADMIN
+ under some circumstances.
+
+clone.2
+ Michael Kerrisk
+ Add kernel version numbers for clone_args fields
+ Michael Kerrisk
+ Combine separate NOTES sections
+
+close.2
+ Michael Kerrisk [Lukas Czerner, Peter Schiffer, Thierry Lelegard]
+ Note behavior when close() happens in a parallel thread
+ If one thread is blocked in an I/O system call on a file descriptor
+ that is closed in another thread, then the blocking system call
+ does not return immediately, but rather when the I/O operation
+ completes. This surprises some people, but is longstanding
+ behavior.
+
+connect.2
+ Stefan Puiu
+ Can return EACCES because of SELinux
+
+execve.2
+ Michael Kerrisk [Eric Hopper]
+ Changes to the "dumpable" flag may change ownership of /proc/PID files
+ Michael Kerrisk
+ Improve/correct discussion of changes to dumpable flag during execve(2)
+ The details were not quite accurate. Defer to prctl(2)
+ for the more complete picture.
+ Nikola Forró
+ Clarify signal sent to the process on late failure
+ Michael Kerrisk
+ SEE ALSO: add capabilities(7)
+
+fanotify_init.2
+ Amir Goldstein [Matthew Bobrowski]
+ Move out of place entry FAN_REPORT_FID
+ It was inserted in the middle of the FAN_CLASS_ multi flags bit
+ and broke the multi flag documentation.
+ Michael Kerrisk [Alexander Morozov, Amir Goldstein, Jan Kara]
+ Remove mention of FAN_Q_OVERFLOW as an input value in 'mask'
+ See https://bugzilla.kernel.org/show_bug.cgi?id=198569.
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Clarification about FAN_EVENT_ON_CHILD and new events
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Clarification about FAN_MARK_MOUNT and FAN_REPORT_FID
+
+getdents.2
+ Petr Vorel [Michael Kerrisk]
+ Mention glibc support for getdents64()
+ Support was added in glibc 2.30.
+ Chris Lamb
+ Correct linux_dirent definition in example code
+ It is "unsigned long" earlier up in the file
+
+gettid.2
+ Michael Kerrisk [Joseph C. Sible]
+ Document header file and feature test macro requirements for gettid()
+
+ioctl.2
+ Michael Kerrisk
+ SEE ALSO: add ioctl_fslabel(2)
+ Michael Kerrisk
+ Remove mentions of ioctl_list(2)
+ Michael Kerrisk
+ Move subsection on "ioctl structure" from ioctl_list(2) to ioctl(2)
+
+io_setup.2
+ Michael Kerrisk
+ Tweak description of /proc/sys/fs/aio-max-nr
+
+mbind.2
+ Li Xinhai [Michael Kerrisk]
+ Remove note about MPOL_MF_STRICT been ignored
+
+mmap.2
+ Michael Kerrisk [Heinrich Schuchardt]
+ Don't mark MAP_ANON as deprecated
+
+move_pages.2
+ Yang Shi [Michal Hocko]
+ Returning positive value is a new error case
+
+mremap.2
+ Michael Kerrisk
+ Remove mention of "Segmentation fault" in EFAULT text
+ "Segmentation fault" (SIGSEGV) is not exactly the same thing as
+ EFAULT.
+ Michael Kerrisk
+ Reorder some paragraphs in NOTES
+ Michael Kerrisk
+ Move a paragraph from DESCRIPTION to NOTES
+
+msgctl.2
+ Michael Kerrisk
+ Correct description of 'msg_ctime' field
+ Verified by inspecting kernel source.
+
+nfsservctl.2
+ Michael Kerrisk
+ SEE ALSO: add nfsd(7)
+
+open.2
+ Michael Kerrisk
+ Some '*at' APIs have functionality that isn't in conventional APIs
+ Note that another reason to use the *at() APIs is to access
+ 'flags' functionality that is not available in the corresponding
+ conventional APIs.
+ Michael Kerrisk
+ Add a few more APIs to list in "Rationale for openat()..."
+ There have been a few more dirfd APIs added in recent times.
+ Michael Kerrisk
+ Explain ways in which a 'directory file descriptor' can be obtained
+ Michael Kerrisk
+ Add openat2() to list of APIs that take a 'dirfd' argument
+
+openat2.2
+ Michael Kerrisk [Aleksa Sarai]
+ Various changes after feedback from Aleksa Sarai
+
+poll.2
+ Michael Kerrisk
+ Add license to example program
+
+prctl.2
+ Dave Martin
+ Sort prctls into alphabetical order
+ Dave Martin
+ Clarify that prctl can apply to threads
+ The current synopsis for prctl(2) misleadingly claims that prctl
+ operates on a process. Rather, some (in fact, most) prctls operate
+ Dave Martin [Dave Hansen]
+ Document removal of Intel MPX prctls
+ Dave Martin
+ Fix mis-description of thread ID values in procfs
+ Dave Martin
+ Work around bogus constant "maxsig" in PR_SET_PDEATHSIG
+ Michael Kerrisk
+ Add reference to proc(5) for /proc/self/task/[tid]/comm
+ Dave Martin [Michael Kerrisk]
+ Add health warning
+ Dave Martin
+ Clarify the unsupported hardware case of EINVAL
+
+rename.2
+ Michael Kerrisk
+ SEE ALSO: add rename(1)
+
+s390_runtime_instr.2
+ Heiko Carstens [Eugene Syromyatnikov, Michael Kerrisk]
+ Document signum argument behavior change
+ Document that the signum argument is ignored in newer kernels, but
+ that user space should pass a valid real-time signal number for
+ backwards compatibility.
+
+semctl.2
+ Michael Kerrisk [Manfred Spraul]
+ Correct description of sem_ctime field
+
+semget.2
+ Michael Kerrisk
+ Add license to example program
+
+shmctl.2
+ Michael Kerrisk
+ Correct 'shm_ctime' description
+
+shmop.2
+ Michael Kerrisk
+ Add license to example programs
+
+statfs.2
+ Michael Kerrisk [David Adam]
+ Add SMB2 constant to filesystem types list
+
+syscall.2
+ Dave Martin [Will Deacon]
+ arm64: Fix syscall number register size
+ Dave Martin [Russell King]
+ arm: Use real register names for arm/OABI
+
+sysfs.2
+ Michael Kerrisk
+ SEE ALSO: add proc(5) and sysfs(5)
+
+utimensat.2
+ Goldwyn Rodrigues
+ Immutable flag returns EPERM
+ Linux kernel commit 337684a1746f "fs: return EPERM on immutable
+ inode" changed the return value of the utimensat(2) from -EACCES
+ to -EPERM in case of an immutable flag.
+
+wait4.2
+ Michael Kerrisk
+ Update wait3() feature test macro requirements for changes in glibc 2.26
+
+cexp2.3
+ Michael Kerrisk
+ Still not present in glibc 2.31
+
+cmsg.3
+ Michael Kerrisk
+ CONFORMING TO: note which CMSG_* APIs are in current and upcoming POSIX
+
+dirfd.3
+ Michael Kerrisk
+ SEE ALSO: add openat(2)
+
+dlsym.3
+ Alexander Monakov
+ Extend discussion of NULL symbol values
+ Avoid implying that use of IFUNC is the only way to produce a
+ symbol with NULL value. Give more scenarios how a symbol may get
+ NULL value, but explain that in those scenarios dlsym() will fail
+ with Glibc's ld.so due to an implementation inconsistency.
+
+err.3
+ Michael Kerrisk
+ EXAMPLES: use EXIT_FAILURE rather than 1 as exit status
+
+expm1.3
+ Michael Kerrisk
+ The expm1() bogus underflow floating-point exception has been fixed
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6778
+ Michael Kerrisk
+ The bogus invalid floating-point exception bug has been fixed
+ https://www.sourceware.org/bugzilla/show_bug.cgi?id=6814.
+
+fdim.3
+ Michael Kerrisk
+ BUGS: these functions did not set errno on some architectures
+ https://www.sourceware.org/bugzilla/show_bug.cgi?id=6796
+
+ftw.3
+ Michael Kerrisk
+ glibc eventually fixed a regression in FTW_SLN behavior
+ For details, see:
+ https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+ http://austingroupbugs.net/view.php?id=1121
+ https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+
+getauxval.3
+ YunQiang Su
+ MIPS, AT_BASE_PLATFORM passes ISA level
+
+getdtablesize.3
+ Michael Kerrisk
+ Remove redundant statement that getdtablesize() is a library function
+
+malloc.3
+ Michael Kerrisk
+ Add 'reallocarray' in NAME
+ Michael Kerrisk
+ Add VERSIONS section noting when reallocarray() was added to glibc
+
+newlocale.3
+ Michael Kerrisk [Piotr Caban]
+ Fix a valgrind issue in example program
+ See https://bugzilla.kernel.org/show_bug.cgi?id=202977.
+
+nextafter.3
+ Michael Kerrisk
+ Since glibc 2.23, these functions do set errno
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799.
+
+posix_spawn.3
+ Olivier Gayot [Adhemerval Zanella]
+ Clarify by using name of steps rather than syscalls
+ Olivier Gayot [Adhemerval Zanella]
+ Document implementation using clone() since glibc 2.24
+ Olivier Gayot [Adhemerval Zanella]
+ Document POSIX_SPAWN_USEVFORK
+ Added a few lines about POSIX_SPAWN_USEVFORK so that it appears
+ clearly that since glibc 2.24, the flag has no effect.
+ Olivier Gayot [Adhemerval Zanella]
+ Document the POSIX_SPAWN_SETSID attribute
+
+pow.3
+ Michael Kerrisk
+ BUGS: pow() performance problem for some (rare) inputs has been fixed
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=13932
+ Michael Kerrisk
+ Several bugs in glibc's pow() implementation were fixed in glibc 2.16
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=3866.
+ Michael Kerrisk
+ Add a subheading to mark off historical bugs that are now fixed
+
+printf.3
+ Tobias Stoeckmann
+ Prevent signed integer overflow in example
+
+ptsname.3
+ Bruno Haible
+ Fix description of failure behaviour of ptsname_r()
+
+random.3
+ John Marshall
+ Change "RAND_MAX" tp "2^31-1"
+
+scalb.3
+ Michael Kerrisk
+ These functions now correctly set errno for the EDOM and ERANGE cases
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803
+ and https://www.sourceware.org/bugzilla/show_bug.cgi?id=6804
+
+scalbln.3
+ Michael Kerrisk
+ These functions now correctly set errno for the ERANGE case
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803
+
+scanf.3
+ Michael Kerrisk [Jürgen Sauermann]
+ Clarify that 'x' specifier allows a 0x/0X prefix in input string
+
+sem_getvalue.3
+ Michael Kerrisk [Andrea Galbusera]
+ Note that glibc's sem_getvalue() doesn't return EINVAL errors
+ See https://bugzilla.kernel.org/show_bug.cgi?id=204273
+
+setlogmask.3
+ Michael Kerrisk
+ Note that LOG_UPTO() is included in the next POSIX release
+
+shm_open.3
+ Michael Kerrisk
+ Add license to example programs
+
+sincos.3
+ Michael Kerrisk
+ The glibc implementation does now give EDOM for a domain error
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467
+
+stdarg.3
+ Michael Kerrisk
+ SEE ALSO: add vprintf(3), vscanf(3), vsyslog(3)
+
+strcmp.3
+ Michael Kerrisk
+ Add license to example programs
+
+strftime.3
+ Urs Thuermann
+ ISO week number can be 52, add example
+
+y0.3
+ Michael Kerrisk
+ These functions now correctly diagnose a pole error
+ https://sourceware.org/bugzilla/show_bug.cgi?id=6807
+ Michael Kerrisk
+ errno is now correctly set to ERANGE on underflow
+ https://www.sourceware.org/bugzilla/show_bug.cgi?id=6808
+
+loop.4
+ Michael Kerrisk [Vlad]
+ 'lo_flags' is nowadays "r/w"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=203417
+
+veth.4
+ Devin J. Pohly
+ Add a more direct example
+ iproute2 allows you to specify the netns for either side of a veth
+ interface at creation time. Add an example of this to veth(4) so
+ it doesn't sound like you have to move the interfaces in a
+ separate step.
+
+core.5
+ Michael Kerrisk [Jonny Grant]
+ Mention 'sysctl -w' as a way of changing core_pattern setting
+ Michael Kerrisk [Jonny Grant]
+ Note that not dumping core of an unreadable binary is a security measure
+ Michael Kerrisk [Jonny Grant]
+ Explain that core_pattern %e is process/thread 'comm' value
+ The 'comm' value is typically the same as the (possibly
+ truncated) executable name, but may be something different.
+
+filesystems.5
+ Michael Kerrisk
+ SEE ALSO: add sysfs(5) and xfs(5)
+
+locale.5
+ Michael Kerrisk [Helge Kreutzmann]
+ Improve description of 'first_weekday'
+
+proc.5
+ Michael Kerrisk
+ Note kernel version for /proc/PID/smaps VmFlags "wf" flag
+ Michael Kerrisk
+ Add "um" and "uw" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk
+ Add "mp" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk
+ Note kernel version that removed /proc/PID/smaps VmFlags "nl" flag
+ Ian Rogers
+ Add "wf" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk
+ Note kernel version for /proc/PID/smaps VmFlags "dd" flag
+ Michael Kerrisk
+ Add "sf" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk [Kirill A. Shutemov]
+ Remove "mp" under VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk [Eric Hopper]
+ Alert the reader that UID/GID changes can reset the "dumpable" attribute
+ Keno Fischer
+ Fix an outdated note about map_files
+ The restriction to CAP_SYS_ADMIN was removed from map_files in 2015.
+ Michael Kerrisk [Helge Kreutzmann]
+ Better explanation of some /proc/ide fields
+ Michael Kerrisk
+ TASK_COMM_LEN limit includes the terminating '\0'
+ Clarify this detail in the discussion of /proc/[pid]/comm.
+ Michael Kerrisk
+ Add a detail to /proc/[pid]/comm
+ Note the connection to the "%e" specifier in
+ /proc/sys/kernel/core_pattern.
+
+securetty.5
+ Michael Kerrisk [Helge Kreutzmann]
+ Improve wording of .SH one-line description
+
+tzfile.5
+ Michael Kerrisk
+ Sync to 2020a tzdb release
+ From https://www.iana.org/time-zones, version 2020a.
+ Michael Kerrisk
+ Explain UT abbreviation
+
+ascii.7
+ Michael Kerrisk [Helge Kreutzmann]
+ SEE ALSO: fix sort order in entries
+
+bpf-helpers.7
+ Michael Kerrisk
+ Resync against kernel 5.7
+
+cgroups.7
+ Marcus Gelderie
+ Mention cgroup.sane_behavior file
+ The cgroup.sane_behavior file returns the hard-coded value "0" and
+ is kept for legacy purposes. Mention this in the man-page.
+ Michael Kerrisk
+ Note the existence of the clone3() CLONE_INTO_CGROUP flag
+
+credentials.7
+ Michael Kerrisk
+ Alert reader that UID/GID changes can affect process capabilities
+ Michael Kerrisk
+ Changes to process UIDs/GIDs can effect the "dumpable" attribute
+ Michael Kerrisk
+ Add a list of the APIs that change a process's credentials
+
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Fix fanotify_fid.c example
+ Michael Kerrisk
+ Wrap some long lines in example program
+
+fanotify.7
+fanotify_mark.2
+ Amir Goldstein [Matthew Bobrowski]
+ Clarify FAN_ONDIR in output mask
+ FAN_ONDIR was an input only flag before introducing
+ FAN_REPORT_FID. Since the introduction of FAN_REPORT_FID, it can
+ also be in output mask.
+
+hier.7
+ Thomas Piekarski [Gary Perkins]
+ Updating from FHS 2.3 to 3.0
+ See https://bugzilla.kernel.org/show_bug.cgi?id=206693
+
+inotify.7
+ Michael Kerrisk [Jason Etherton]
+ Add missing #include in example program
+
+ip.7
+ Michael Kerrisk [Martin Doucha]
+ Note a few more valid 'protocol' values
+ See https://bugzilla.kernel.org/show_bug.cgi?id=204981
+ Michael Kerrisk
+ SEE ALSO: add netdevice(7)
+
+man-pages.7
+ Michael Kerrisk
+ Rename EXAMPLE to EXAMPLES
+ Michael Kerrisk
+ Describe COPYRIGHT section
+ man-pages doesn't use COPYRIGHT sections in manual pages, but
+ various projects do. Make some recommendations about placement
+ of the section.
+ Michael Kerrisk
+ Add REPORTING BUGS section
+ man-pages doesn't have a REPORTING BUGS section in manual pages,
+ but many other projects do. Make some recommendations about
+ placement of that section.
+ Michael Kerrisk
+ Mention AUTHORS in summary section list
+ Although man-pages doesn't use AUTHORS sections, many projects do
+ use an AUTHORS section in their manual pages, so mention it in
+ man-pages to suggest some guidance on the position at which
+ to place that section.
+
+mount_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add mount(8), umount(8)
+
+namespaces.7
+ Michael Kerrisk
+ Document /proc/sys/user/max_time_namespaces
+
+netlink.7
+ Michael Kerrisk [Idan Katz]
+ Update path for NETLINK_CONNECTOR docs in kernel source tree
+ Michael Kerrisk [Fabien Siron]
+ Note that NETLINK_SOCK_DIAG is preferred over NETLINK_INET_DIAG
+
+pid_namespaces.7
+ Michael Kerrisk
+ Note that /proc/sys/kernel/ns_last_pid is virtualized per PID NS
+ Michael Kerrisk
+ Correct capability requirements for write to /proc/sys/kernel/ns_last_pid
+ CAP_SYS_ADMIN is needed in the user NS that owns the PID NS.
+
+rtnetlink.7
+ Jan Moskyto Matejka [Michael Kerrisk]
+ Add missing RTA_* attributes
+
+standards.7
+ Michael Kerrisk [Geoff Clare]
+ Add some more standards
+ Add: SUSv4 2016 edition, POSIX.1-2017, and SUSv4 2018 edition
+ Michael Kerrisk
+ Remove mention of bogus "POSIX" names
+ The terms POSIX.1-{2003,2004,2013,2016} were inventions of
+ my imagination, as confirmed by consulting Geoff Clare of
+ The Open Group. Remove these names.
+
+symlink.7
+ Michael Kerrisk
+ Describe differences in the treatment of symlinks in the dirname
+ Describe differences in the treatment of symlinks in the dirname
+ part of pathname.
+
+tcp.7
+ Michael Kerrisk [vrafaeli@msn.com]
+ Update info on tcp_syn_retries default value
+ See https://bugzilla.kernel.org/show_bug.cgi?id=202885.
+
+user_namespaces.7
+ Michael Kerrisk [Léo Stefanesco]
+ Clarify that "system time" means "calendar time"
+
+xattr.7
+ Achilles Gaikwad
+ Add attr(1) as relevant page to SEE ALSO
+
+ldconfig.8
+ Florian Weimer
+ Mention new default for --format in glibc 2.32
+
+zdump.8
+ Michael Kerrisk [Marco Curreli, Paul Eggert]
+ Update to latest upstream tz release
+ Look under "Latest version", which is 2020a.
+
+
+==================== Changes in man-pages-5.08 ====================
+
+Released: 2020-08-13, 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:
+
+Alejandro Colomar <alx@kernel.org>
+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!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+prctl.2
+ Dave Martin
+ Add SVE prctls (arm64)
+ Add documentation for 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 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.
+
+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.
+
+
+==================== Changes in man-pages-5.09 ====================
+
+Released: 2020-11-01, 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:
+
+Alejandro Colomar <alx@kernel.org>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexey Budankov <alexey.budankov@linux.intel.com>
+Amir Goldstein <amir73il@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Dave Martin <Dave.Martin@arm.com>
+David Howells <dhowells@redhat.com>
+David Laight <David.Laight@ACULAB.COM>
+Dmitry V. Levin <ldv@altlinux.org>
+Érico Rolim <erico.erc@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Hauke Fath <hf@spg.tu-darmstadt.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+henrik@optoscale.no
+Ira Weiny <ira.weiny@intel.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Jing Peng <pj.hades@gmail.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Konstantin Bukin <kbukin@gmail.com>
+Mark Mossberg <mark.mossberg@gmail.com>
+Marko Hrastovec <marko.hrastovec@gmail.com>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Moore <paul@paul-moore.com>
+Rich Felker <dalias@libc.org>
+Samanta Navarro <ferivoz@riseup.net>
+Serge Hallyn <serge@hallyn.com>
+Simon McVittie <smcv@collabora.com>
+Sridhar Samudrala <sridhar.samudrala@intel.com>
+Stephen Smalley <stephen.smalley.work@gmail.com>
+Steve Hilder <stevehilder@yahoo.co.uk>
+Thomas Piekarski <t.piekarski@deloquencia.de>
+Tony May <tony.may@mediakind.com>
+Tycho Andersen <tycho@tycho.ws>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+circleq.3
+ Alejandro Colomar
+ New page with 'circleq' content extracted from queue(3)
+
+list.3
+ Alejandro Colomar
+ New page with 'list' content extracted from queue(3)
+
+
+pthread_attr_setsigmask_np.3
+ Michael Kerrisk
+ New page for pthread_attr_setsigmask_np() + pthread_attr_getsigmask_np()
+ Add a page documenting the pthread_attr_setsigmask_np(3) and
+ pthread_attr_getsigmask_np(3) functions added in glibc 2.32.
+
+slist.3
+ Alejandro Colomar
+ New page with 'slist' content extracted from queue(3)
+
+stailq.3
+ Alejandro Colomar
+ New page with 'stailq' content extracted from queue(3)
+
+tailq.3
+ Alejandro Colomar
+ New page with 'tailq' content extracted from queue(3)
+
+system_data_types.7
+ Alejandro Colomar, Michael Kerrisk
+ A new page documenting a wide range of system data types.
+
+kernel_lockdown.7
+ David Howells, Heinrich Schuchardt [Michael Kerrisk]
+ New page documenting the Kernel Lockdown feature
+
+queue.7
+ Alejandro Colomar
+ Create summary page for 'queue' APIs
+ The former queue(3) page was rather unwieldy, as it attempted to
+ describe too many APIs. After splitting that content out into a
+ number of smaller pages ( circleq.3, list.3, slist.3, stailq.3,
+ and tailq.3) move the much-reduced queue(3) page, which is now
+ essentially a summary of those APIs, from Section 3 to Section 7.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify_init.2
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Document FAN_REPORT_DIR_FID
+
+fanotify_init.2
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Document FAN_REPORT_NAME
+
+statx.2
+ Ira Weiny
+ Add STATX_ATTR_DAX
+
+strerror.3
+ Michael Kerrisk
+ Document strerrorname_np() and strerrordesc_np()
+ strerrorname_np() and strerrordesc_np() were added in glibc 2.32.
+
+strsignal.3
+ Michael Kerrisk
+ Document sigabbrev_np() and sigdescr_np().
+ sigabbrev_np() and sigdescr_np() were added in glibc 2.32.
+
+loop.4
+ Yang Xu
+ Document LOOP_CONFIGURE ioctl
+ Yang Xu
+ Document LO_FLAGS_DIRECT_IO flag
+
+capabilities.7
+ Michael Kerrisk
+ Document the CAP_CHECKPOINT_RESTORE capability added in Linux 5.9
+
+ip.7
+ Stephen Smalley [Paul Moore]
+ Document IP_PASSSEC for UDP sockets
+
+ip.7
+socket.7
+ Stephen Smalley
+ Document SO_PEERSEC for AF_INET sockets
+ Sridhar Samudrala
+ Document SO_INCOMING_NAPI_ID
+
+socket.7
+unix.7
+ Stephen Smalley [Serge Hallyn, Simon McVittie]
+ Add initial description for SO_PEERSEC
+
+
+New and changed links
+---------------------
+
+aiocb.3
+clock_t.3
+clockid_t.3
+dev_t.3
+div_t.3
+double_t.3
+fenv_t.3
+fexcept_t.3
+FILE.3
+float_t.3
+gid_t.3
+id_t.3
+imaxdiv_t.3
+int8_t.3
+int16_t.3
+int32_t.3
+int64_t.3
+intN_t.3
+intmax_t.3
+intptr_t.3
+lconv.3
+ldiv_t.3
+lldiv_t.3
+off_t.3
+pid_t.3
+ptrdiff_t.3
+regex_t.3
+regmatch_t.3
+regoff_t.3
+siginfo_t.3
+sigset_t.3
+sigval.3
+size_t.3
+ssize_t.3
+suseconds_t.3
+time_t.3
+timer_t.3
+timespec.3
+timeval.3
+uid_t.3
+uint8_t.3
+uint16_t.3
+uint32_t.3
+uint64_t.3
+uintN_t.3
+uintptr_t.3
+va_list.3
+void.3
+ Alejandro Colomar, Michael Kerrisk
+ New links to system_data_types(7)
+
+CIRCLEQ_ENTRY.3
+CIRCLEQ_HEAD.3
+CIRCLEQ_INIT.3
+CIRCLEQ_INSERT_AFTER.3
+CIRCLEQ_INSERT_BEFORE.3
+CIRCLEQ_INSERT_HEAD.3
+CIRCLEQ_INSERT_TAIL.3
+CIRCLEQ_REMOVE.3
+ Alejandro Colomar
+ Link to the new circleq(3) page instead of queue(3)
+
+LIST_EMPTY.3
+LIST_ENTRY.3
+LIST_FIRST.3
+LIST_FOREACH.3
+LIST_HEAD.3
+LIST_HEAD_INITIALIZER.3
+LIST_INIT.3
+LIST_INSERT_AFTER.3
+LIST_INSERT_BEFORE.3
+LIST_INSERT_HEAD.3
+LIST_NEXT.3
+LIST_REMOVE.3
+ Alejandro Colomar
+ Link to the new list.3 page instead of queue.3
+
+SLIST_EMPTY.3
+SLIST_ENTRY.3
+SLIST_FIRST.3
+SLIST_FOREACH.3
+SLIST_HEAD.3
+SLIST_HEAD_INITIALIZER.3
+SLIST_INIT.3
+SLIST_INSERT_AFTER.3
+SLIST_INSERT_HEAD.3
+SLIST_NEXT.3
+SLIST_REMOVE.3
+SLIST_REMOVE_HEAD.3
+ Alejandro Colomar
+ Link to the new slist(3) page instead of queue(3)
+
+STAILQ_CONCAT.3
+STAILQ_EMPTY.3
+STAILQ_ENTRY.3
+STAILQ_FIRST.3
+STAILQ_FOREACH.3
+STAILQ_HEAD.3
+STAILQ_HEAD_INITIALIZER.3
+STAILQ_INIT.3
+STAILQ_INSERT_AFTER.3
+STAILQ_INSERT_HEAD.3
+STAILQ_INSERT_TAIL.3
+STAILQ_NEXT.3
+STAILQ_REMOVE.3
+STAILQ_REMOVE_HEAD.3
+ Alejandro Colomar
+ Link to the new stailq(3) page instead of queue(3)
+
+TAILQ_CONCAT.3
+TAILQ_EMPTY.3
+TAILQ_ENTRY.3
+TAILQ_FIRST.3
+TAILQ_FOREACH.3
+TAILQ_FOREACH_REVERSE.3
+TAILQ_HEAD.3
+TAILQ_HEAD_INITIALIZER.3
+TAILQ_INIT.3
+TAILQ_INSERT_AFTER.3
+TAILQ_INSERT_BEFORE.3
+TAILQ_INSERT_HEAD.3
+TAILQ_INSERT_TAIL.3
+TAILQ_LAST.3
+TAILQ_NEXT.3
+TAILQ_PREV.3
+TAILQ_REMOVE.3
+TAILQ_SWAP.3
+ Alejandro Colomar
+ Link to the new tailq(3) page instead of queue(3)
+
+getcwd.2
+mq_notify.2
+mq_open.2
+mq_timedreceive.2
+mq_timedsend.2
+mq_unlink.2
+ Michael Kerrisk
+ Reinstate links to section 3 pages that document system calls
+ Some of the links removed in commit 247c654385128fd0748 should
+ have been kept, because in some cases there are real system
+ calls whose wrapper functions are documented in Section 3.
+
+queue.3
+ Alejandro Colomar
+ Link to queue(7)
+
+sigabbrev_np.3
+ Michael Kerrisk
+ New link to strsignal.3
+
+sigdescr_np.3
+ Michael Kerrisk
+ New link to strsignal.3
+
+strerrordesc_np.3
+ Michael Kerrisk
+ New link to strerror(3)
+
+strerrorname_np.3
+ Michael Kerrisk
+ New link to strerror(3)
+
+sys_siglist.3
+ Michael Kerrisk
+ New link to strsignal(3)
+
+
+Global changes
+--------------
+
+Various pages
+ Alejandro Colomar
+ Use ``sizeof`` consistently through all the examples in the
+ following way:
+
+ - Use the name of the variable instead of its type as argument for
+ ``sizeof``.
+
+Various pages
+ Alejandro Colomar
+ Use sizeof() to get buffer size (instead of hardcoding macro name)
+
+Various pages
+ Michael Kerrisk
+ Use \(aq instead of ' inside monospace fonts
+ Use \(aq to get an unslanted single quote inside monospace code
+ blocks. Using a simple ' results in a slanted quote inside PDFs.
+
+Various pages
+ Michael Kerrisk, Alejandro Colomar
+ Use C99 style to declare loop counter variables
+ Rather than:
+
+ sometype x;
+
+ for (x = ....; ...)
+
+ use
+
+ for (sometype x = ...; ...)
+
+ This brings the declaration and use closer together (thus aiding
+ readability) and also clearly indicates the scope of the loop
+ counter variable.
+
+Various pages
+ Alejandro Colomar
+ Switch printf() casts to use [u]intmax_t + %ju / %jd
+ Let's move to the 21st century. Instead of casting system data
+ types to long/long long/etc. in printf() calls, instead cast to
+ intmax_t or uintmax_t, the largest available signed/unsigned
+ integer types.
+
+Various pages
+ Alejandro Colomar
+ Omit 'int' keyword for 'short', 'long' and 'long long' types
+
+Various pages
+ Alejandro Colomar
+ Remove unneeded casts
+
+Various pages
+ Alejandro Colomar
+ In printf(): s/0x%/%#/ except when followed by X instead of x
+ Use printf()'s '#' flag character to prepend the string "0x".
+
+ However, when the number is printed in uppercase, and the prefix
+ is in lowercase, the string "0x" needs to be manually written.
+
+Various pages
+ Michael Kerrisk
+ Use C99-style declarations for readability
+ Rather than writing things such as:
+
+ struct sometype *x;
+ ...
+ x = malloc(sizeof(*x));
+
+ let's use C99 style so that the type info is in the same line as
+ the allocation:
+
+ struct sometype *x = malloc(sizeof(*x));
+
+Various pages
+ Alejandro Colomar
+ Cast to 'unsigned long' rather than 'long' when printing with "%lx"
+
+stdarg.3
+ Alejandro Colomar
+ Declare variables with different types in different lines
+ In particular, don's mix a variable and a pointer declaration
+ on the same line: TYPE x, *p;
+
+
+Changes to individual pages
+---------------------------
+
+memusage.1
+ Michael Kerrisk
+ EXAMPLES: remove doubled calculations
+ The same calculations are repeated in malloc() and printf() calls.
+ For better readability, do the calculations once.
+ Michael Kerrisk
+ Use %zu rather than %zd when printing 'size_t' values
+
+clock_getres.2
+ Alejandro Colomar
+ EXAMPLES: use 'const' when appropriate
+ Alejandro Colomar [Jakub Wilk]
+ Cast 'time_t' to 'int' for printf() and fix the length modifiers
+ Michael Kerrisk [Tony May]
+ Fix type and variable name in dynamic clock code example
+
+clone.2
+ Michael Kerrisk
+ CAP_CHECKPOINT_RESTORE can now be used to employ 'set_tid'
+
+epoll_ctl.2
+ Michael Kerrisk
+ epoll instances can be nested to a maximum depth of 5
+ This limit appears to be an off-by-one count against
+ EP_MAX_NESTS (4).
+ Michael Kerrisk
+ Move some version info from CONFORMING TO to VERSIONS
+
+eventfd.2
+ Alejandro Colomar
+ Use 'PRIxN' macros when printing C99 fixed-width integer types
+
+futex.2
+ Alejandro Colomar
+ Use appropriate types
+
+getdents.2
+ Alejandro Colomar
+ SYNOPSIS: add missing header and feature test macro
+
+intro.2
+intro.3
+credentials.7
+feature_test_macros.7
+standards.7
+ Michael Kerrisk
+ SEE ALSO: add system_data_types(7)
+
+ioctl_ns.2
+stat.2
+ Alejandro Colomar [Konstantin Bukin]
+ Fix signedness of printf specifiers
+
+membarrier.2
+ Alejandro Colomar
+ Note that glibc does not provide a wrapper
+
+mprotect.2
+ Alejandro Colomar
+ Use "%p" rather than casting to 'long' when printing pointer values
+
+mq_getsetattr.2
+ Alejandro Colomar
+ Use 'const' when appropriate
+
+msgop.2
+ Yang Xu
+ Add restriction on ENOSYS error
+
+open.2
+ Michael Kerrisk [henrik@optoscale.no]
+ ERRORS: add EBUSY
+
+openat.2
+ Alejandro Colomar
+ SYNOPSIS: return long
+ The Linux kernel uses long as the return type for this syscall.
+ As glibc provides no wrapper, use the same type the kernel uses.
+
+open_by_handle_at.2
+ Alejandro Colomar
+ Use "%u" rather than "%d" when printing 'unsigned int' values
+
+perf_event_open.2
+ Alexey Budankov
+ Update the man page with CAP_PERFMON related information
+
+recv.2
+send.2
+ Michael Kerrisk
+ Add cross references to pages with further info about ancillary data
+
+sched_getattr.2
+ Aleksa Sarai
+ Update to include changed size semantics
+
+seccomp.2
+ Michael Kerrisk [Jann Horn]
+ Warn reader that SECCOMP_RET_TRACE can be overridden
+ Highlight to the reader that if another filter returns a
+ higher-precedence action value, then the ptracer will not
+ be notified.
+ Michael Kerrisk [Rich Felker]
+ Warn against the use of SECCOMP_RET_KILL_THREAD
+ Killing a thread with SECCOMP_RET_KILL_THREAD is very likely
+ to leave the rest of the process in a broken state.
+ Michael Kerrisk [Rich Felker]
+ EXAMPLES: use SECCOMP_RET_KILL_PROCESS rather than SECCOMP_RET_KILL
+ Alejandro Colomar
+ Use ARRAY_SIZE() macro instead of raw sizeof division
+
+setns.2
+ Michael Kerrisk
+ Correct the version for time namespace support
+
+sigaction.2
+ Michael Kerrisk [Alejandro Colomar]
+ Use correct POSIX type for siginfo_t.si_value
+
+syscalls.2
+ Michael Kerrisk
+ Move system calls from discontinued ports out of main syscall list
+ Various ports that had their own indigenous system calls have
+ been discontinued. Remove those system calls (none of which had
+ manual pages!) to a separate part of the page, to avoid
+ cluttering the main list of system calls.
+ Michael Kerrisk
+ Add close_range (Linux 5.9)
+
+timerfd_create.2
+ Alejandro Colomar
+ Use 'PRIxN' macros when printing C99 fixed-width integer types
+
+userfaultfd.2
+ Michael Kerrisk
+ Use a better type (uint64_t) for 'len' in EXAMPLES
+ Alejandro Colomar
+ Use 'PRIx64' rather than "%llx" when printing 64-bit fixed-width types
+
+argz_add.3
+envz_add.3
+ Michael Kerrisk [Jonny Grant]
+ Point out that 'error_t' is an integer type
+
+bsearch.3
+ Alejandro Colomar
+ Fix intermediate type and remove unneeded casts
+
+bswap.3
+ Jakub Wilk
+ Use strtoull() for parsing 64-bit numbers
+
+dlopen.3
+ Michael Kerrisk
+ Clarify DT_RUNPATH/DT_RPATH details
+ It is the DT_RUNPATH/DT_RPATH of the calling object (not the
+ executable) that is relevant for the library search. Verified
+ by experiment.
+
+errno.3
+ Michael Kerrisk [Alejandro Colomar]
+ Note that the pthreads APIs do not set errno
+
+fopencookie.3
+ Alejandro Colomar
+ printf()'s .* expects an int; cast accordingly
+ Alejandro Colomar
+ Fix bugs in example
+
+fread.3
+ Alejandro Colomar
+ Move ARRAY_SIZE logic into macro
+
+freeaddrinfo.3
+ Marko Hrastovec
+ Fix memory leaks in freeaddrinfo() examples
+
+getline.3
+ Alejandro Colomar
+ Use %zd rather than %zu when printing 'ssize_t' values
+
+lseek64.3
+ Michael Kerrisk
+ Since glibc 2.28. the 'llseek' symbol is no longer available
+
+mallinfo.3
+ Michael Kerrisk
+ The 'usmblks' field is nowadays always 0
+
+offsetof.3
+ Alejandro Colomar
+ Use "%zu" rather than "%zd" when printing 'size_t' values
+
+perror.3
+ Michael Kerrisk
+ sys_errlist and sys_nerr are no longer exposed by <stdio.h>
+ The change came with the release of glibc 2.32.
+
+posix_fallocate.3
+ Érico Rolim
+ Add EOPNOTSUPP error code.
+
+psignal.3
+strsignal.3
+ Michael Kerrisk
+ Consolidate information on 'sys_siglist' in one page (strsignal(3))
+
+pthread_attr_init.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_attr_init(3)
+
+pthread_attr_init.3
+pthread_create.3
+pthread_getattr_np.3
+ Michael Kerrisk
+ Use correct type (size_t) for some variables
+
+pthread_getattr_np.3
+ Alejandro Colomar
+ Use "%zu" and "%zx" when printing 'size_t' values
+
+pthread_sigmask.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_attr_setsigmask_np(3)
+
+qsort.3
+ Alejandro Colomar
+ Fix casts
+ Alejandro Colomar
+ SYNOPSIS: move code from queue.3 to stailq.3
+
+regex.3
+ Alejandro Colomar
+ Add example program
+ Alejandro Colomar
+ Remove unnecessary include
+
+strsignal.3
+ Michael Kerrisk [Hauke Fath]
+ Note that starting with v2.32, glibc no longer exports 'sys_siglist'
+ Michael Kerrisk
+ Further addition on version range for sys_siglist
+ Michael Kerrisk
+ Note that 'sys_siglist' is nonstandard
+
+strtod.3
+ Jonathan Wakely
+ Fix return value for underflow
+
+strtol.3
+ Alejandro Colomar
+ EXAMPLES: simplify errno checking
+ Alejandro Colomar
+ EXAMPLES: as the default base, use special value 0
+ Alejandro Colomar
+ EXAMPLES: delimit output string using ""
+
+tsearch.3
+ Alejandro Colomar
+ Simplify type usage and remove unneeded casts
+ Alejandro Colomar
+ Use size_t for malloc() argument
+
+loop.4
+ Yang Xu
+ Add some details about lo_flags
+
+core.5
+ Alejandro Colomar
+ Use adequate type
+
+locale.5
+ Florian Weimer
+ Decimal points, thousands separators must be one character
+
+proc.5
+ Michael Kerrisk
+ Update capability requirements for accessing /proc/[pid]/map_files
+ Jann Horn [Mark Mossberg]
+ Document inaccurate RSS due to SPLIT_RSS_COUNTING
+ Michael Kerrisk
+ Note "open file description" as (better) synonym for "file handle"
+
+resolv.5
+ Florian Weimer
+ Document the trust-ad option
+
+aio.7
+ Alejandro Colomar
+ Use perror() directly
+
+bpf-helpers.7
+ Michael Kerrisk [Jakub Wilk]
+ Resync with current kernel source
+
+capabilities.7
+ Michael Kerrisk
+ Under CAP_SYS_ADMIN, group "sub-capabilities" together
+ CAP_BPF, CAP_PERFMON, and CAP_CHECKPOINT_RESTORE have all been
+ added to split out the power of CAP_SYS_ADMIN into weaker pieces.
+ Group all of these capabilities together in the list under
+ CAP_SYS_ADMIN, to make it clear that there is a pattern to these
+ capabilities.
+ Michael Kerrisk
+ CAP_SYS_ADMIN implies CAP_CHECKPOINT_RESTORE
+ But the latter, weaker capability is preferred.
+ Michael Kerrisk
+ Add kernel doc reference for CAP_PERFMON
+
+fanotify.7
+ Alejandro Colomar
+ Pass array to read(2) directly instead of a pointer to it
+
+fanotify.7
+fanotify_mark.2
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Generalize documentation of FAN_REPORT_FID
+
+feature_test_macros.7
+ Jakub Wilk
+ Update list of macros that inhibit default definitions
+
+man.7
+ Michael Kerrisk [G. Branden Robinson]
+ Clarify that alternating typeface macros print arguments without spaces
+
+man-pages.7
+ Michael Kerrisk
+ Add some more requests re code examples
+ Michael Kerrisk
+ Soften the statement that ideal programs should be short
+
+namespaces.7
+ Michael Kerrisk
+ A 'time_for_children' symlink can also pin a namespace
+
+pid_namespaces.7
+ Michael Kerrisk
+ Update capability requirements for /proc/sys/kernel/ns_last_pid
+
+pthreads.7
+ Michael Kerrisk
+ Explicitly note that pthreads APIs return an errno-style value on error
+
+rtld-audit.7
+ Florian Weimer [Carlos O'Donell]
+ Clarify la_version handshake
+ Returning its argument without further checks is almost always
+ wrong for la_version.
+ Alejandro Colomar
+ Use "%u" rather than "%d" when printing 'unsigned int' values
+
+sigevent.7
+ Michael Kerrisk
+ Note that 'sigev_notify_thread_id' is Linux-specific
+
+socket.7
+ Michael Kerrisk
+ SEE ALSO: add ipv6(7)
+
+
+==================== 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 <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Amir Goldstein <amir73il@gmail.com>
+Arusekk <arek_koz@o2.pl>
+Baruch Siach <baruch@tkos.co.il>
+Bill Allombert <ballombe@debian.org>
+Colin Ian King <colin.king@canonical.com>
+Dave Martin <Dave.Martin@arm.com>
+Davide Giorgio <davide@giorgiodavide.it>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jan Kara <jack@suse.cz>
+Jing Peng <pj.hades@gmail.com>
+John A. Leuenhagen <john@zlima12.com>
+Mathias Rav <m@git.strova.dk>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Crowe <mac@mcrowe.com>
+Namhyung Kim <namhyung@gmail.com>
+Peter Oskolkov <posk@google.com>
+Philip Rowlands <linux-kernel@dimebar.com>
+Rob Landley <rob@landley.net>
+Ross Zwisler <zwisler@chromium.org>
+Sebastian Kirmayer <sebastian@kirmayer.de>
+наб <nabijaczleweli@nabijaczleweli.xyz>
+
+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].
+
+mount.2
+statfs.2
+ Ross Zwisler
+ Add NOSYMFOLLOW flags to mount(2) and statfs(2)
+
+
+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
+
+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.
+
+
+==================== Changes in man-pages-5.11 ====================
+
+Released: 2021-03-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:
+
+Alejandro Colomar <alx@kernel.org>
+Alessandro Bono <alessandro.bono369@gmail.com>
+Alyssa Ross <hi@alyssa.is>
+Bastien Roucariès <rouca@debian.org>
+Bruno Haible <bruno@clisp.org>
+Christian Brauner <christian.brauner@ubuntu.com>
+Ciprian Dorin Craciun <ciprian.craciun@gmail.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Dmitry Vorobev <dvorobev@cloudflare.com>
+edef <edef@edef.eu>
+Enke Chen <enkechen2020@gmail.com>
+Gabriel Krisman Bertazi <krisman@collabora.com>
+Ganimedes Colomar <gacoan.linux@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jens Axboe <axboe@kernel.dk>
+Johannes Pfister <johannes.pfister@josttech.ch>
+Johannes Wellhöfer <johannes.wellhofer@gmail.com>
+John Morris <john@zultron.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Manfred Spraul <manfred@colorfullife.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Minchan Kim <minchan@kernel.org>
+Pádraig Brady <P@draigBrady.com>
+Pali Rohár <pali@kernel.org>
+Palmer Dabbelt <palmerdabbelt@google.com>
+Paran Lee <p4ranlee@gmail.com>
+Peter H. Froehlich <peter.hans.froehlich@gmail.com>
+Philipp Schuster <phip1611@gmail.com>
+Stephen Kitt <steve@sk2.org>
+Steve Grubb <sgrubb@redhat.com>
+Suren Baghdasaryan <surenb@google.com>
+Szunti <szunti@gmail.com>
+Valentin Kettner <vakevk@gmail.com>
+Vincent Lefevre <vincent@vinc17.net>
+Walter Franzini <walter.franzini@gmail.com>
+Walter Harms <wharms@bfs.de>
+Willem de Bruijn <willemb@google.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+close_range.2
+ Stephen Kitt, Michael Kerrisk [Christian Brauner]
+ New page documenting close_range(2)
+
+process_madvise.2
+ Suren Baghdasaryan, Minchan Kim [Michal Hocko, Alejandro Colomar,
+ Michael Kerrisk]
+ Document process_madvise(2)
+
+fileno.3
+ Michael Kerrisk
+ Split fileno(3) content out of ferror(3) into new page
+ fileno(3) differs from the other functions in various ways.
+ For example, it is governed by different standards,
+ and can set 'errno'. Conversely, the other functions
+ are about examining the status of a stream, while
+ fileno(3) simply obtains the underlying file descriptor.
+ Furthermore, splitting this function out allows
+ for some cleaner upcoming changes in ferror(3).
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+epoll_wait.2
+ Willem de Bruijn [Dmitry V. Levin]
+ Add documentation of epoll_pwait2()
+ Expand the epoll_wait() page with epoll_pwait2(), an epoll_wait()
+ variant that takes a struct timespec to enable nanosecond
+ resolution timeout.
+
+fanotify_init.2
+fanotify.7
+ Jan Kara [Steve Grubb]
+ Document FAN_AUDIT flag and FAN_ENABLE_AUDIT
+
+madvise.2
+ Michael Kerrisk
+ Add descriptions of MADV_COLD and MADV_PAGEOUT
+ Taken from process_madvise(2).
+
+openat2.2
+ Jens Axboe
+ Add RESOLVE_CACHED
+
+prctl.2
+ Gabriel Krisman Bertazi
+ Document Syscall User Dispatch
+
+mallinfo.3
+ Michael Kerrisk
+ Document mallinfo2() and note that mallinfo() is deprecated
+ Document the mallinfo2() function added in glibc 2.33.
+ Update example program to use mallinfo2()
+
+system_data_types.7
+ Alejandro Colomar
+ Add off64_t to system_data_types(7)
+
+ld.so.8
+ Michael Kerrisk
+ Document the --argv0 option added in glibc 2.33
+
+
+New and changed links
+---------------------
+
+epoll_pwait2.2
+ Dmitry V. Levin
+ New link to epoll_wait(2)
+
+mallinfo2.3
+ Michael Kerrisk
+ New link to mallinfo(3)
+
+off64_t.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+
+Global changes
+--------------
+
+Various pages
+ Alejandro Colomar
+ SYNOPSIS: Use 'restrict' in prototypes
+ This change has been completed for *all* relevant pages
+ (around 135 pages in total).
+
+Various pages
+ Alejandro Colomar [Zack Weinberg]
+ Remove unused <sys/types.h>
+ The manual pages are already inconsistent in which headers need
+ to be included. Right now, not all of the types used by a
+ function have their required header included in the SYNOPSIS.
+
+ If we were to add the headers required by all of the types used by
+ functions, the SYNOPSIS would grow too much. Not only it would
+ grow too much, but the information there would be less precise.
+
+ Having system_data_types(7) document each type with all the
+ information about required includes is much more precise, and the
+ info is centralized so that it's much easier to maintain.
+
+ So let's document only the include required for the function
+ prototype, and also the ones required for the macros needed to
+ call the function.
+
+ <sys/types.h> only defines types, not functions or constants, so
+ it doesn't belong to man[23] (function) pages at all.
+
+ I ignore if some old systems had headers that required you to
+ include <sys/types.h> *before* them (incomplete headers), but if
+ so, those implementations would be broken, and those headers
+ should probably provide some kind of warning. I hope this is not
+ the case.
+
+ [mtk: Already in 2001, POSIX.1 removed the requirement to
+ include <sys/types.h> for many APIs, so this patch seems
+ well past due.]
+
+A few pages
+ Alejandro Colomar
+ Add notes about missing glibc wrappers
+
+_exit.2
+abort.3
+err.3
+exit.3
+pthread_exit.3
+setjmp.3
+ Alejandro Colomar
+ SYNOPSIS: Use 'noreturn' in prototypes
+ Use standard C11 'noreturn' in these manual page for
+ functions that do not return.
+
+Various pages
+ Ganimedes Colomar [Alejandro Colomar]
+ Normalize SYNOPSIS notes about nonexistent glibc wrappers
+ To easily distinguish documentation about glibc wrappers from
+ documentation about kernel syscalls, let's have a normalized
+ 'Note' in the SYNOPSIS, and a further explanation in the page body
+ (NOTES in most of them), as already happened in many (but not all)
+ of the manual pages for syscalls without a wrapper. Furthermore,
+ let's normalize the messages, following membarrier.2 (because it's
+ already quite extended), so that it's easy to use grep to find
+ those pages.
+ Normalize NOTES about nonexistent glibc wrappers
+ This commit normalizes texts under sections other than SYNOPSIS
+ (most of them in NOTES).
+
+
+Global changes (formatting fixes and minor edits)
+-------------------------------------------------
+
+Various pages
+ Michael Kerrisk
+ ERRORS: remove redundant statement that 'errno' is set
+ This is implied in every other manual page. There is no need to
+ state it explicitly in these pages.
+
+Various pages
+ Michael Kerrisk
+ Use periods more consistently inside code comments
+ In general, complete sentences in free-standing comments
+ should be terminated by periods.
+
+A few pages
+ Michael Kerrisk
+ Better table formatting
+ In particular, allow for rendering in widths different from
+ (especially less than) 80 columns.
+
+Various pages
+ Michael Kerrisk
+ Consistency fix-up in FTMs
+ Generally, place '||' at start of a line, rather than the end of
+ the previous line.
+
+ Rationale: this placement clearly indicates that each piece
+ is an alternative.
+
+Various pages
+ Michael Kerrisk [Alejandro Colomar]
+ Bring more whitespace consistency in SYNOPSIS
+ The use of vertical white space in the SYNOPSIS sections
+ is rather inconsistent. Make it more consistent, subject to the
+ following heuristics:
+
+ * Prefer no blank lines between function signatures by default.
+ * Where many functions are defined in the SYNOPSIS, add blank
+ lines where needed to improve readability, possibly by using
+ blank lines to separate logical groups of functions.
+
+Various pages
+ Alejandro Colomar
+ Consistently use 'unsigned int'
+ Most pages use 'unsigned int' (and the kernel too).
+ Make them all do so.
+
+Various pages
+ Michael Kerrisk
+ Various improvements in wording in RETURN VALUE
+
+Various pages
+ Michael Kerrisk
+ s/Glibc versions </Glibc </ in Feature Test Macro discussions
+ Use a more compact notation that will render less wide
+ on the terminal.
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, "to indicate the cause of the error"
+ is changed to "to indicate the error".
+
+Various pages
+ Michael Kerrisk
+ Add missing .nf/.fi in FTM info
+
+Various pages
+ Michael Kerrisk
+ Simplify mark-up for Feature Test Macro requirements
+ Different source styles are used in different pages to achieve the
+ same formatted output, and in some cases the source mark-up is a
+ rather convoluted combination of .RS/.RE/.TP/.PD macros. Simplify
+ this greatly, and unify all of the pages to use more or less the
+ same source code style. This makes the source code rather easier
+ to read, and may simplify future scripted global changes.
+
+ The feature test macro info is currently bracketed by .nf/.fi
+ pairs. This is not strictly necessary (i.e., it makes no
+ difference to the rendered output), but for the moment we keep
+ these "brackets" in case they may be replaced with something else.
+
+Various pages
+ Michael Kerrisk
+ Use real minus signs in pathnames
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, reword various cases saying that 'errno' is set
+ "appropriately" to "is set to indicate the error".
+
+Various pages
+ Michael Kerrisk
+ Improve formatting in ATTRIBUTES
+ Make the formatting more consistent inside the tables in the
+ ATTRIBUTES sections. Make the source code more uniform; in
+ particular, eliminate the use of custom tweaks using
+ 'lbwNN'/'lwNN' and .br macros. In addition, ensure that
+ hyphenation and text justification do not occur inside the tables.
+
+Various pages
+ Michael Kerrisk
+ Use .nf/.fi in SYNOPSIS
+ The majority of pages use .nf/.fi in SYNOPSIS, but there are
+ still many that don't and use .br to achieve newlines. Fix many
+ of those. This brings greater consistency to the pages, which
+ eases editing and may ease future scripted edits to the pages.
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, miscellaneous descriptions of the setting
+ of 'errno' are reworded to the norm of "is set to indicate
+ the error".
+
+Various pages
+ Michael Kerrisk
+ Use "\-" to generate real minus in circumstances where appropriate
+ Use \- for math formulas, pathnames, manual page cross references,
+ etc.
+
+Various pages
+ Michael Kerrisk
+ Inside code blocks (.EX/.EE) use \- to get real minus signs
+ A real minus can be cut and pasted...
+
+Various pages
+ Alejandro Colomar
+ Remove explicit blank lines, replacing them with .PP when appropriate
+
+Various pages
+ Michael Kerrisk
+ Use internally consistent continuation indents in SYNOPSIS
+ In the SYNOPSIS, a long function prototype may need to be
+ continued over to the next line. The continuation line is
+ indented according to the following rules:
+
+ 1. If there is a single such prototype that needs to be continued,
+ then align the continuation line so that when the page is
+ rendered on a fixed-width font device (e.g., on an xterm) the
+ continuation line starts just below the start of the argument
+ list in the line above. (Exception: the indentation may be
+ adjusted if necessary to prevent a very long continuation line
+ or a further continuation line where the function prototype is
+ very long.)
+
+ Thus:
+
+ int tcsetattr(int fd, int optional_actions,
+ const struct termios *termios_p);
+
+ 2. But, where multiple functions in the SYNOPSIS require
+ continuation lines, and the function names have different
+ lengths, then align all continuation lines to start in the
+ same column. This provides a nicer rendering in PDF output
+ (because the SYNOPSIS uses a variable width font where
+ spaces render narrower than most characters).
+
+ Thus:
+
+ int getopt(int argc, char * const argv[],
+ const char *optstring);
+ int getopt_long(int argc, char * const argv[],
+ const char *optstring,
+ const struct option *longopts, int *longindex);
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, fix some instances stating that 'errno' is set
+ "appropriately" to instead say "to indicate the error".
+
+Various System V IPC pages
+ Michael Kerrisk
+ Improve wording describing RETURN VALUE and setting of 'errno'
+
+
+Changes to individual pages
+---------------------------
+
+alloc_hugepages.2
+ Michael Kerrisk
+ CONFORMING TO: reword to reflect that these system calls are long gone
+
+cacheflush.2
+ Alejandro Colomar
+ Update SYNOPSIS for glibc wrapper
+ Glibc uses 'void *' instead of 'char *'.
+ And the prototype is declared in <sys/cachectl.h>.
+
+clone.2
+ Valentin Kettner
+ Fix types in clone_args
+ A file descriptor is an int so it should be stored through an int
+ pointer while parent_tid should have the same type as child_tid
+ which is pid_t pointer.
+
+close.2
+ Michael Kerrisk
+ SEE ALSO: add close_range(2)
+
+copy_file_range.2
+ Alejandro Colomar
+ Document glibc wrapper instead of kernel syscall
+ Glibc uses 'off64_t' instead of 'loff_t'.
+
+delete_module.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ The Linux kernel uses 'unsigned int' instead of 'int' for the
+ 'flags' parameter. As glibc provides no wrapper, use the same
+ type the kernel uses.
+
+epoll_create.2
+ Michael Kerrisk
+ CONFORMING TO: mention that epoll_create1() is Linux-specific
+
+epoll_wait.2
+ Michael Kerrisk
+ CONFORMING TO: mention that epoll_pwait() is Linux-specific
+
+execve.2
+ Palmer Dabbelt
+ Correct the versions of Linux that don't have ARG_MAX argv/envp size
+
+execveat.2
+ Alejandro Colomar
+ Fix prototype
+ It's been 6 years since execveat(2) was added to the kernel,
+ and there's still no glibc wrapper. Let's document the kernel
+ syscall prototype.
+
+getcpu.2
+ Michael Kerrisk [Alejandro Colomar]
+ Rewrite page to describe glibc wrapper function
+ Since glibc 2.29, there is a wrapper for getcpu(2).
+ The wrapper has only 2 arguments, omitting the unused
+ third system call argument. Rework the manual page
+ to reflect this.
+
+getgid.2
+getuid.2
+ Michael Kerrisk
+ Note that these interfaces never modify 'errno'
+ See https://www.austingroupbugs.net/view.php?id=511
+ and the POSIX.1-2008 specifications of the interfaces.
+
+gethostname.2
+ Michael Kerrisk
+ Update FTM requirements for gethostname()
+
+getpagesize.2
+getdtablesize.3
+ Michael Kerrisk
+ Update/correct FTM requirements
+
+getrusage.2
+ Michael Kerrisk
+ Starting in 2.33, glibc no longer provides vtimes()
+
+ioctl_tty.2
+ Michael Kerrisk
+ Reformat argument type information
+ The current mark-up renders poorly. To resolve this, move
+ the type information into a separate line.
+
+ipc.2
+ Alejandro Colomar
+ Fix prototype parameter types
+
+kcmp.2
+ Michael Kerrisk
+ Since Linux 5.12, kcmp() availability is unconditional
+ kcmp() is no longer dependent on CONFIG_CHECKPOINT_RESTORE.
+
+keyctl.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ The Linux kernel uses 'unsigned long'.
+ There's no reason to use the typedef '__kernel_ulong_t'.
+
+lookup_dcookie.2
+ Alejandro Colomar
+ Use standard types: u64 -> uint64_t
+
+madvise.2
+ Michael Kerrisk
+ SEE ALSO: add process_madvise(2)
+
+mlock.2
+ Alejandro Colomar
+ mlock2(): Fix prototype parameter types
+ The documented prototype for mlock2() was a mix of the
+ glibc wrapper prototype and the kernel syscall prototype.
+ Let's document the glibc wrapper prototype, which is shown below.
+ Michael Kerrisk
+ CONFORMING TO: note more explicitly which APIs are in the standards
+
+mmap2.2
+ Alejandro Colomar
+ Fix prototype parameter types
+ There are many slightly different prototypes for this syscall,
+ but none of them is like the documented one.
+ Of all the different prototypes,
+ let's document the asm-generic one.
+
+mount.2
+ Michael Kerrisk
+ Note that the 'data' argument can be NULL
+
+move_pages.2
+ Alejandro Colomar
+ Add notes about missing glibc wrappers
+
+open.2
+rename.2
+ Alyssa Ross
+ Refer to tmpfs rather than shmem
+ If I'm understanding correctly, tmpfs is a filesystem built on
+ shmem, so I think it's more correct (and probably much more
+ widely understandable) to refer to tmpfs here.
+
+pciconfig_read.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ Use the glibc prototypes instead of the kernel ones.
+ Exception: use 'int' instead of 'enum'.
+
+pidfd_open.2
+ Michael Kerrisk
+ Note the process_madvise(2) use case for PID file descriptors
+
+readlink.2
+ Michael Kerrisk [Jonny Grant]
+ Emphasize that the returned buffer is not null-terminated
+
+s390_pci_mmio_write.2
+ Alejandro Colomar
+ SYNOPSIS: Add 'const' qualifier
+ s390_pci_mmio_write() uses 'const void *' instead of 'void *'.
+
+sched_setattr.2
+ Alejandro Colomar
+ Add note about missing glibc wrappers
+
+semctl.2
+ Yang Xu [Alejandro Colomar, Manfred Spraul]
+ Correct SEM_STAT_ANY description
+
+socketcall.2
+ Alejandro Colomar
+ Add note about missing glibc wrapper
+
+splice.2
+ Alejandro Colomar
+ Use 'off64_t' instead of 'loff_t'
+ The kernel syscall uses 'loff_t', but the glibc wrapper uses 'off64_t'.
+ Let's document the wrapper prototype, as in other pages.
+
+spu_create.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter type
+ The 'flags' parameter of spu_create() uses 'unsigned int'.
+
+spu_run.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ The 2nd and 3rd parameters of spu_run() use 'uint32_t *'.
+
+stat.2
+ Jonathan Wakely [Alejandro Colomar]
+ Remove <unistd.h> from SYNOPSIS
+ There seems to be no reason <unistd.h> is shown here, so remove it.
+ Michael Kerrisk
+ Move the obsolete _BSD_SOURCE FTM to the end of the FTM info
+
+syscall.2
+ Peter H. Froehlich
+ Update superh syscall convention
+
+syscalls.2
+ Michael Kerrisk
+ Add epoll_pwait2()
+
+tkill.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ All but the last parameters of t[g]kill() use 'pid_t',
+ both in the kernel and glibc.
+
+vmsplice.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter type
+ The 3rd parameter of vmsplice() uses 'size_t' in glibc.
+
+bstring.3
+ Michael Kerrisk
+ SEE ALSO: add string(3)
+
+circleq.3
+list.3
+slist.3
+stailq.3
+tailq.3
+ Alejandro Colomar
+ Improve readability, especially in SYNOPSIS
+
+circleq.3
+ Alejandro Colomar
+ Fix CIRCLEQ_LOOP_*() return type
+
+crypt.3
+ Michael Kerrisk
+ Reformat FTM info (in preparation for next patch)
+ Michael Kerrisk
+ Update crypt() FTM requirements to note glibc 2.28 changes
+
+ecvt.3
+gcvt.3
+ Michael Kerrisk
+ Update FTM requirements
+
+error.3
+ Michael Kerrisk [Alejandro Colomar, Walter Harms]
+ Clarify the meaning of 'status==0' for error(3)
+
+ferror.3
+ Michael Kerrisk
+ Remove fileno(3) content that was migrated to new fileno(3) page
+ Michael Kerrisk
+ Add a RETURN VALUE section
+ Michael Kerrisk
+ POSIX.1-2008: these functions won't change 'errno' if 'stream' is valid
+ See https://www.austingroupbugs.net/view.php?id=401.
+
+fread.3
+ Alessandro Bono
+ EXAMPLES: swap size and nmemb params
+ It works both ways, but this one feels more right. We are reading
+ four elements sizeof(*buffer) bytes each.
+
+fseeko.3
+ Michael Kerrisk
+ Move info about obsolete FTM from SYNOPSIS to NOTES
+ This makes the SYNOPSIS more consistent with other pages.
+
+ftime.3
+ Michael Kerrisk
+ glibc 2.33 has removed ftime()
+
+ftw.3
+ Alejandro Colomar
+ SYNOPSIS: Remove duplicate header
+
+gethostbyname.3
+ Michael Kerrisk
+ Move mention of <sys/socket.h> from SYNOPSIS to DESCRIPTION
+ The functions are all declared in <netdb.h>. <sys/socket.h> is only
+ needed for the AF_* constants.
+
+gethostid.3
+ Michael Kerrisk
+ Update FTM requirements for gethostid()
+
+get_phys_pages.3
+ Alejandro Colomar [Jakub Wilk]
+ glibc gets the info from sysinfo(2) since 2.23
+
+grantpt.3
+ptsname.3
+unlockpt.3
+ Michael Kerrisk
+ Remove mention of _XOPEN_SOURCE_EXTENDED FTM
+ This rather ancient FTM is not mentioned in other pages for
+ reasons discussed in feature_test_macros(7). Remove this FTM
+ from the three pages where it does appear.
+
+malloc.3
+ Alejandro Colomar [Johannes Pfister]
+ Document that realloc(p, 0) is specific to glibc and nonportable
+
+malloc_hook.3
+ Alejandro Colomar
+ SYNOPSIS: Use 'volatile' in prototypes
+
+malloc_trim.3
+ Dmitry Vorobev
+ Remove mention of free() call
+ 'malloc_trim' was and is never called from the 'free' function.
+
+pthread_create.3
+ Michael Kerrisk [Paran Lee]
+ Fix undeclared variable error in example program
+ Michael Kerrisk
+ Fix a signedness error in the example code
+
+puts.3
+ Michael Kerrisk
+ Reorder functions more logically (group related functions together)
+
+qecvt.3
+ Michael Kerrisk
+ Update feature test macro requirements
+
+setbuf.3
+ Michael Kerrisk
+ POSIX doesn't require errno to be unchanged after successful setbuf()
+ See https://www.austingroupbugs.net/view.php?id=397#c799
+
+setlocale.3
+ Michael Kerrisk [Alejandro Colomar, Bruno Haible]
+ Restructure a particularly difficult sentence
+
+simpleq.3
+stailq.3
+queue.7
+SIMPLEQ_*.3
+ Alejandro Colomar
+ Document SIMPLEQ_*() as an alias to STAILQ_*() macros
+
+strerror.3
+ Alejandro Colomar
+ strerrorname_np() and strerrordesc_np() first appeared on glibc 2.32
+
+string.3
+ Michael Kerrisk
+ SEE ALSO: add bstring(3)
+
+system.3
+ Alejandro Colomar [Ciprian Dorin Craciun]
+ Document bug and workaround when the command name starts with a hyphen
+
+environ.7
+ Bastien Roucariès
+ Reorder the text
+ Move the text describing how to set environment variable before
+ the list(s) of variables in order to improve readability.
+ Bastien Roucariès
+ Document convention of string in environ
+ Document the name=value system and that nul byte is forbidden.
+ Bastien Roucariès
+ Document that HOME, LOGNAME, SHELL, USER are set at login time
+ and point to the su(1) manual page.
+ Bastien Roucariès
+ Add see also ld.so(8) for LD_ variables
+ Michael Kerrisk [Bastien Roucariès]
+ Improve the description of PATH
+ Add more details of how PATH is used, and mention the legacy
+ use of an empty prefix.
+ Bastien Roucariès [Alejandro Colomar, Bastien Roucaries, Vincent Lefevre]
+ Document valid values of pathnames for SHELL, PAGER and EDITOR/VISUAL
+ Michael Kerrisk [Bastien Roucariès]
+ Note the default if PAGER is not defined
+ Michael Kerrisk
+ Be a little more precise when discussing 'exec'
+ Say "execve(2)" instead of "exec(3)", and note that this step
+ starts a new program (not a new process!).
+ Michael Kerrisk [Bastien Roucariès]
+ Relocate and reword the mention of _GNU_SOURCE
+
+man-pages.7
+ Michael Kerrisk
+ Document "acknowledgement" as the preferred spelling
+ Michael Kerrisk
+ Add some notes on comments in example code
+ Michael Kerrisk
+ Add a FORMATTING AND WORDING CONVENTIONS section
+ In man-pages-5.11, a large number of pages were edited to achieve
+ greater consistency in the SYNOPSIS, RETURN VALUE and ATTRIBUTES
+ sections. To avoid future inconsistencies, try to capture some of
+ the preferred conventions in text in man-pages(7).
+ Michael Kerrisk
+ Note some rationale for the use of real minus signs
+
+netdevice.7
+ Pali Rohár [Alejandro Colomar]
+ Update documentation for SIOCGIFADDR SIOCSIFADDR SIOCDIFADDR
+
+netlink.7
+ Pali Rohár [Alejandro Colomar]
+ Fix minimal Linux version for NETLINK_CAP_ACK
+ NETLINK_CAP_ACK option was introduced in commit 0a6a3a23ea6e which first
+ appeared in Linux version 4.3 and not 4.2.
+ Pali Rohár [Alejandro Colomar]
+ Remove IPv4 from description
+ rtnetlink is not only used for IPv4
+ Philipp Schuster
+ Clarify details of netlink error responses
+ Make it clear that netlink error responses (i.e., messages with
+ type NLMSG_ERROR (0x2)), can be longer than sizeof(struct
+ nlmsgerr). In certain circumstances, the payload can be longer.
+
+shm_overview.7
+ Michael Kerrisk
+ SEE ALSO: add memfd_create(2)
+
+sock_diag.7
+ Pali Rohár [Alejandro Colomar]
+ Fix recvmsg() usage in the example
+
+tcp.7
+ Enke Chen
+ Documentation revision for TCP_USER_TIMEOUT
+
+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@kernel.org>
+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
+
+
+==================== Changes in man-pages-5.13 ====================
+
+Released: 2021-08-27, 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>
+Alan Peakall <Alan.Peakall@helpsystems.com>
+Alejandro Colomar <alx@kernel.org>
+Alexis Wilke <alexis@m2osw.com>
+Askar Safin <safinaskar@mail.ru>
+Christian Brauner <christian.brauner@ubuntu.com>
+Christophe Leroy <christophe.leroy@csgroup.eu>
+Christopher Yeleighton <giecrilj@stegny.2a.pl>
+Cristian Morales Vega <christian.morales.vega@gmail.com>
+Dan Robertson <dan@dlrobertson.com>
+Darrick J. Wong <djwong@kernel.org>
+Dominique Brazziel <dbrazziel@snet.net>
+EmanueleTorre <torreemanuele6@gmail.com>
+Eric W. Biederman <ebiederm@xmission.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Jakub Wilk <jwilk@jwilk.net>
+James O. D. Hunt <jamesodhunt@gmail.com>
+Jonny Grant <jg@jguk.org>
+Kees Cook <keescook@chromium.org>
+Kir Kolyshkin <kolyshkin@gmail.com>
+Kurt Kanzenbach <kurt@linutronix.de>
+kXuan <kxuanobj@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Weiß <michael.weiss@aisec.fraunhofer.de>
+NeilBrown <neilb@suse.de>
+Nora Platiel <nplatiel@gmx.us>
+Pali Rohár <pali@kernel.org>
+Peter Collingbourne <pcc@google.com>
+Richard Palethorpe <rpalethorpe@suse.com>
+Rodrigo Campos <rodrigo@kinvolk.io>
+Sagar Patel <sagarmp@cs.unc.edu>
+Serge E. Hallyn <serge@hallyn.com>
+Sergey Petrakov <kr@spmail.info>
+Stefan Kanthak <stefan.kanthak@nexgo.de>
+Štěpán Němec <stepnem@gmail.com>
+Thomas Gleixner <tglx@linutronix.de>
+Thomas Voss <thomasavoss@protonmail.com>
+Viet Than <thanhoangviet@gmail.com>
+Will Manley <will@williammanley.net>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+mount_setattr.2
+ Christian Brauner [Alejandro Colomar, Michael Kerrisk]
+ New manual page documenting the mount_setattr() system call
+
+
+Removed Pages
+-------------
+
+getumask.3
+ Michael Kerrisk
+ This function was never implemented on Linux. It seems pointless to
+ retain such a page 20 years after it was written.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+futex.2
+ Kurt Kanzenbach [Alejandro Colomar, Thomas Gleixner, Michael Kerrisk]
+ Document FUTEX_LOCK_PI2
+
+ioctl_tty.2
+ Pali Rohár [Alejandro Colomar, Michael Kerrisk]
+ Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2
+
+pidfd_open.2
+ Michael Kerrisk
+ Document PIDFD_NONBLOCK
+
+seccomp_unotify.2
+ Rodrigo Campos [Alejandro Colomar]
+ Document SECCOMP_ADDFD_FLAG_SEND
+
+sigaction.2
+ Peter Collingbourne [Alejandro Colomar, Michael Kerrisk]
+ Document SA_EXPOSE_TAGBITS and the flag support detection protocol
+
+statx.2
+ NeilBrown
+ Document STATX_MNT_ID
+
+capabilities.7
+user_namespaces.7
+ Michael Kerrisk, Kir Kolyshkin [Alejandro Colomar]
+ Describe CAP_SETFCAP for mapping UID 0
+
+mount_namespaces.7
+ Michael Kerrisk [Christian Brauner, Eric W. Biederman]
+ More clearly explain the notion of locked mounts
+ For a long time, this manual page has had a brief discussion of
+ "locked" mounts, without clearly saying what this concept is, or
+ why it exists. Expand the discussion with an explanation of what
+ locked mounts are, why mounts are locked, and some examples of the
+ effect of locking.
+
+user_namespaces.7
+ Michael Kerrisk
+ Document /proc/PID/projid_map
+
+ld.so.8
+ Michael Kerrisk
+ Document --list-tunables option added in glibc 2.33
+
+
+Global changes
+--------------
+
+A few pages
+ Michael Kerrisk
+ ERRORS: correct alphabetic order
+
+A few pages
+ Michael Kerrisk
+ Place SEE ALSO entries in correct order
+
+A few pages
+ Michael Kerrisk
+ Arrange .SH sections in correct order
+
+Various pages
+ Michael Kerrisk
+ Fix EBADF error description
+ Make the description of the EBADF error for invalid 'dirfd' more
+ uniform. In particular, note that the error only occurs when the
+ pathname is relative, and that it occurs when the 'dirfd' is
+ neither valid *nor* has the value AT_FDCWD.
+
+Various pages
+ Michael Kerrisk
+ ERRORS: combine errors into a single alphabetic list
+ These pages split out extra errors for some APIs into a separate
+ list. Probably, the pages are easier to ready if all errors are
+ combined into a single list.
+
+ Note that there still remain a few pages where the errors are
+ listed separately for different APIs. For the moment, it seems
+ best to leave those pages as is, since the error lists are
+ largely distinct in those pages.
+
+Various pages
+ Michael Kerrisk
+ Terminology clean-up: "mount point" ==> "mount"
+ Many times, these pages use the terminology "mount point", where
+ "mount" would be better. A "mount point" is the location at which
+ a mount is attached. A "mount" is an association between a
+ filesystem and a mount point.
+
+accept.2
+access.2
+getpriority.2
+mlock.2
+ Michael Kerrisk
+ ERRORS: combine errors into a single list
+ These pages split out errors into separate lists (perhaps per API,
+ perhaps "may" vs "shall", perhaps "Linux-specific" vs
+ standard(??)), but there's no good reason to do this. It makes
+ the error list harder to read, and is inconsistent with other
+ pages. So, combine the errors into a single list.
+
+fanotify_mark.2
+futimesat.2
+mount_setattr.2
+statx.2
+symlink.2
+mkfifo.3
+ Michael Kerrisk
+ Refer the reader to openat(2) for explanation of why 'dirfd' is useful
+
+Various pages
+ Thomas Voss [Alejandro Colomar]
+ Consistently use '*argv[]'
+
+
+Changes to individual pages
+---------------------------
+
+iconv.1
+iconvconfig.8
+ Michael Kerrisk [Christopher Yeleighton]
+ FILES: note that files may be under /usr/lib64 rather than /usr/lib
+ See https://bugzilla.kernel.org/show_bug.cgi?id=214163
+
+ldd.1
+ Alejandro Colomar [EmanueleTorre]
+ Fix example command
+
+add_key.2
+keyctl.2
+request_key.2
+ Michael Kerrisk [Dominique Brazziel]
+ Note that the "libkeyutils" package provides <keyutils.h>
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992377
+
+close_range.2
+ Michael Kerrisk, Alejandro Colomar
+ Glibc 2.34 has added a close_range() wrapper
+
+execve.2
+ Michael Kerrisk [Nora Platiel]
+ The pathname given to interpreter is not necessarily absolute
+ Michael Kerrisk
+ SEE ALSO: getauxval(3)
+ getauxval(3) is useful background regarding execve(2).
+
+fanotify_mark.2
+ Michael Kerrisk
+ ERRORS: add missing EBADF error for invalid 'dirfd'
+
+ioctl_tty.2
+ Pali Rohár [Alejandro Colomar]
+ Update DTR example
+ Do not include unused (and incompatible) header file termios.h and
+ include required header files for puts() and close() functions.
+
+mount.2
+ Michael Kerrisk
+ ERRORS: add EPERM error for case where a mount is locked
+ Refer the reader to mount_namespaces(7) for details.
+ Michael Kerrisk
+ SEE ALSO: add mount_setattr(2)
+
+open.2
+ Michael Kerrisk
+ Explicitly describe the EBADF error that can occur with openat()
+ In particular, specifying an invalid file descriptor number
+ in 'dirfd' can be used as a check that 'pathname' is absolute.
+ Michael Kerrisk
+ Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH
+ Michael Kerrisk
+ Add mount_setattr(2) to list of 'dirfd' APIs
+
+open_by_handle_at.2
+ Michael Kerrisk
+ ERRORS: add missing EBADF error for invalid 'dirfd'
+
+readv2.2
+ Will Manley [Alejandro Colomar]
+ Note preadv2(..., RWF_NOWAIT) bug in BUGS section
+
+readv.2
+pipe.7
+ Michael Kerrisk [наб]
+ Make text on pipe writes more general to avoid a confusion in writev(2)
+
+seccomp.2
+ Eric W. Biederman [Kees Cook]
+ Clarify that bad system calls kill the thread (not the process)
+
+syscalls.2
+ Michael Kerrisk
+ Add quotactl_fd(); remove quotactl_path()
+ quotactl_path() was never wired up in Linux 5.13.
+ It was replaced instead by quotactl_fd(),
+ Michael Kerrisk
+ Add system calls that are new in 5.13
+
+umount.2
+ Michael Kerrisk
+ ERRORS: add EINVAL for case where mount is locked
+
+wait.2
+ Richard Palethorpe [Alejandro Colomar]
+ Add ESRCH for when pid == INT_MIN
+ Michael Kerrisk
+ ERRORS: document EAGAIN for waitid() on a PID file descriptor
+
+getaddrinfo.3
+ Alejandro Colomar [Cristian Morales Vega]
+ Note that 'errno' is set in parallel with EAI_SYSTEM
+
+getauxval.3
+ Michael Kerrisk
+ SEE ALSO: add execve(2)
+
+getopt.3
+ James O. D. Hunt [Alejandro Colomar]
+ Further clarification of 'optstring'
+
+pthread_setname_np.3
+ Michael Kerrisk [Alexis Wilke]
+ EXAMPLES: remove a bug by simplifying the code
+
+strlen.3
+wcslen.3
+ Michael Kerrisk [Alejandro Colomar, Jonny Grant]
+ Recommend alternatives where input buffer might not be null-terminated
+
+strstr.3
+ Alejandro Colomar [Stefan Kanthak]
+ Document special case for empty needle
+
+termios.3
+ Pali Rohár [Alejandro Colomar]
+ SPARC architecture has 4 different Bnnn constants
+ Pali Rohár [Alejandro Colomar]
+ Add information how to set baud rate to any other value
+ Pali Rohár [Alejandro Colomar]
+ Use bold style for Bnn and EXTn macro constants
+ Pali Rohár [Alejandro Colomar]
+ Document missing baud-rate constants
+
+tsearch.3
+ Michael Kerrisk
+ NAME: add twalk_r
+
+wcstok.3
+ Jakub Wilk
+ Fix type mismatch in the example
+
+proc.5
+ Michael Kerrisk
+ Add /proc/PID/projid_map, referring reader to user_namespaces(7)
+ Michael Kerrisk
+ Remove duplicated /proc/[pid]/gid_map entry
+
+mount_namespaces.7
+ Michael Kerrisk
+ Terminology clean-up: "mount point" ==> "mount"
+ Many times, this page uses the terminology "mount point", where
+ "mount" would be better. A "mount point" is the location at which
+ a mount is attached. A "mount" is an association between a
+ filesystem and a mount point.
+ Michael Kerrisk
+ SEE ALSO: add mount_setattr(2)
+
+namespaces.7
+ Štěpán Němec [Alejandro Colomar]
+ Fix confusion caused by text reorganization
+
+path_resolution.7
+ Michael Kerrisk [Askar Safin]
+ Improve description of trailing slashes
+ See https://bugzilla.kernel.org/show_bug.cgi?id=212385
+
+posixoptions.7
+ Alejandro Colomar [Alan Peakall]
+ Fix legacy functions list (s/getcwd/getwd/)
+
+user_namespaces.7
+ Kir Kolyshkin [Alejandro Colomar]
+ Fix a reference to a kernel document
+ Michael Kerrisk [Eric W. Biederman]
+ Add a definition of "global root"
+
+vdso.7
+ Michael Kerrisk [Christophe Leroy]
+ Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc
+ Alejandro Colomar [Christophe Leroy]
+ Add y2038 compliant gettime for ppc/32
+
+
+==================== Changes in man-pages-6.00 ====================
+
+Released: 2022-10-09, València
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+
+"Darrick J. Wong" <darrick.wong@oracle.com>
+"Dr. Jürgen Sauermann" <mail@xn--jrgen-sauermann-zvb.de>
+"Dr. Wolfgang Armbruster" <dr.w.e.armbruster@gmail.com>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+"M. Welinder" <mwelinder@gmail.com>
+"Theodore Ts'o" <tytso@mit.edu>
+"Todd C. Miller" <Todd.Miller@sudo.ws>
+"Valentin V. Bartenev" <vbart@nginx.com>
+<pellucida@tutanota.com>
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Ahelenia Ziemiańska (наб) <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Aleksander Baranowski <alex@euro-linux.com>
+Alexander Viro <viro@zeniv.linux.org.uk>
+Alexei Starovoitov <ast@kernel.org>
+Amir Goldstein <amir73il@gmail.com>
+Andrea Cervesato <andrea.cervesato@suse.com>
+Andreas Dilger <adilger@dilger.ca>
+Andrew Morton <akpm@linux-foundation.org>
+Andrew Morton <akpm@osdl.org>
+Andrew Persons <andrewscottpersons@gmail.com>
+Andrew Wock <ajwock@gmail.com>
+Anna Schumaker <anna.schumaker@netapp.com>
+Arnd Bergmann <arnd@arndb.de>
+Avinash Sonawane <rootkea@gmail.com>
+Axel Rasmussen <axelrasmussen@google.com>
+Benjamin Peterson <benjamin@python.org>
+Benoit Lecocq <benoit@openbsd.org>
+Bjarni Ingi Gislason <bjarniig@vortex.is>
+Brett Holman <bholman.devel@gmail.com>
+CIFS <linux-cifs@vger.kernel.org>
+Carlos O'Donell <carlos@redhat.com>
+Charan Teja Reddy <quic_charante@quicinc.com>
+Christian Aistleitner <christian@quelltextlich.at>
+Christian Brauner <brauner@kernel.org>
+Christoph Hellwig <hch@infradead.org>
+Cyril Hrubis <chrubis@suse.cz>
+Daniel Borkmann <daniel@iogearbox.net>
+Dave Chinner <dchinner@redhat.com>
+Dave Kemper <saint.snit@gmail.com>
+David Hildenbrand <david@redhat.com>
+David Howells <dhowells@redhat.com>
+David Laight <David.Laight@ACULAB.COM>
+David Sletten <david.paul.sletten@gmail.com>
+David Ward <david.ward@gatech.edu>
+Davide Benini <davide.benini@gmail.com>
+Donald Buczek <buczek@molgen.mpg.de>
+Elliott Hughes <enh@google.com>
+Eric Biggers <ebiggers@kernel.org>
+Eric Dumazet <edumazet@google.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabian <fabian@ritter-vogt.de>
+Florian Weimer <fweimer@redhat.com>
+GUO Zihua <guozihua@huawei.com>
+Gabriel Krisman Bertazi <krisman@collabora.com>
+Greg Banks <gbanks@linkedin.com>
+Greg Kroah-Hartman <gregkh@linuxfoundation.org>
+Grzegorz Szpetkowski <gszpetkowski@gmail.com>
+Günther Noack <guenther@unix-ag.uni-kl.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Huang Pei <huangpei@loongson.cn>
+Ian Abbott <abbotti@mev.co.uk>
+Ian Lance Taylor <iant@google.com>
+Ingo Schwarze <schwarze@openbsd.org>
+Jakub Sitnicki <jakub@cloudflare.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Jayprakash Ray <r.jay3283@gmail.com>
+JeanHeyd Meneide <wg14@soasis.org>
+Jeff Layton <jlayton@kernel.org>
+Jens Gustedt <jens.gustedt@inria.fr>
+Jeremy Kerr <jk@codeconstruct.com.au>
+Jesse Rosenstock <jmr@google.com>
+Joseph Myers <joseph@codesourcery.com>
+Kir Kolyshkin <kolyshkin@gmail.com>
+Klemens Nanni <kn@openbsd.org>
+Kuniyuki Iwashima <kuniyu@amazon.co.jp>
+Linus Torvalds <torvalds@linuxfoundation.org>
+Lucien Gentis <lucien.gentis@waika9.com>
+Luis Henriques <lhenriques@suse.de>
+Luis Lozano <llozano@chromium.org>
+Marco Bonelli <marco@mebeim.net>
+Masatake YAMATO <yamato@redhat.com>
+Matheus Tavares <matheus.bernardino@usp.br>
+Mathnerd314 <mathnerd314.gph@gmail.com>
+Matthew Bobrowski <repnop@google.com>
+Matthew Wilcox <willy@infradead.org>
+Melker Narikka <meklu@meklu.org>
+Michael Kearney <mikekearney85@hotmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mickaël Salaün <mic@linux.microsoft.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Kravetz <mike.kravetz@oracle.com>
+Mike Rapoport <rppt@linux.ibm.com>
+Miklos Szeredi <miklos@szeredi.hu>
+Nadav Amit <nadav.amit@gmail.com>
+NeilBrown <neilb@suse.de>
+Nicolas Boichat <drinkcat@chromium.org>
+Nikola Forró <nforro@redhat.com>
+Olga Kornievskaia <aglo@umich.edu>
+Oscar Salvador <osalvador@suse.de>
+Pali Rohár <pali@kernel.org>
+Pankaj Gupta <pankaj.gupta@ionos.com>
+Patrick Reader <_@pxeger.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Peter Xu <peterx@redhat.com>
+Petr Vorel <pvorel@suse.cz>
+Pádraig Brady <P@draigBrady.com>
+Quentin Monnet <quentin.monnet@netronome.com>
+Ralf Baechle <ralf@linux-mips.org>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Randall <rsbecker@nexbridge.com>
+Rich Felker <dalias@libc.org>
+Robert Schneider <robert.schneider03@sap.com>
+Rumen Telbizov <rumen.telbizov@menlosecurity.com>
+Sam James <sam@gentoo.org>
+Samanta Navarro <ferivoz@riseup.net>
+Sean Young <sean@mess.org>
+Simon Branch <simonmbranch@gmail.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Stephen Kitt <steve@sk2.org>
+Steve French <sfrench@samba.org>
+Suren Baghdasaryan <surenb@google.com>
+Theo de Raadt <deraadt@openbsd.org>
+Theodore Dubois <tbodt@google.com>
+Tilman Schmidt <tilman@imap.cc>
+Tobias Stoeckmann <tobias@stoeckmann.org>
+Topi Miettinen <toiwoton@gmail.com>
+Trevor Woerner <twoerner@gmail.com>
+Trond Myklebust <trond.myklebust@hammerspace.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vito Caputo <vcaputo@pengaru.com>
+Walter Harms <wharms@bfs.de>
+Wei Wang <weiwan@google.com>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Yuchung Cheng <ycheng@google.com>
+Zack Weinberg <zack@owlfolio.org>
+enh <enh@google.com>
+glibg10b <pugonfireyt@gmail.com>
+nick black <nickblack@linux.com>
+zhangkui <zhangkui@oppo.com>
+Ævar Arnfjörð Bjarmason <avarab@gmail.com>
+Štěpán Němec <stepnem@smrk.net>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man2/
+ landlock_add_rule.2
+ landlock_create_ruleset.2
+ landlock_restrict_self.2
+ memfd_secret.2
+
+man2type/
+ open_how.2type
+
+man3/
+ _Generic.3
+
+man3const/
+ NULL.3const
+
+man3head/
+ sysexits.h.3head
+
+man3type/
+ aiocb.3type
+ blkcnt_t.3type
+ blksize_t.3type
+ cc_t.3type
+ clock_t.3type
+ clockid_t.3type
+ dev_t.3type
+ div_t.3type
+ double_t.3type
+ epoll_event.3type
+ fenv_t.3type
+ id_t.3type
+ intN_t.3type
+ intmax_t.3type
+ intptr_t.3type
+ iovec.3type
+ itimerspec.3type
+ lconv.3type
+ mode_t.3type
+ off_t.3type
+ ptrdiff_t.3type
+ regex_t.3type
+ size_t.3type
+ sockaddr.3type
+ stat.3type
+ time_t.3type
+ timer_t.3type
+ timespec.3type
+ timeval.3type
+ tm.3type
+ va_list.3type
+ void.3type
+
+man7/
+ landlock.7
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+epoll_wait.2
+ epoll_pwait2(2)
+
+fanotify_init.2
+ FAN_REPORT_PIDFD
+
+fanotify_mark.2
+ FAN_FS_ERROR
+ FAN_MARK_EVICTABLE
+ FAN_RENAME
+ FAN_REPORT_TARGET_FID
+
+madvise.2
+ MADV_POPULATE_READ
+ MADV_POPULATE_WRITE
+
+pipe.2
+ O_NOTIFICATION_PIPE
+
+process_madvise.2
+ MADV_WILLNEED
+
+send.2
+ MSG_FASTOPEN
+
+userfaultfd.2
+ UFFD_USER_MODE_ONLY
+
+proc.5
+ /proc/[pid]/pagemap bit 57
+
+fanotify.7
+ /proc/sys/fs/fanotify/max_queued_events
+ /proc/sys/fs/fanotify/max_user_group
+ /proc/sys/fs/fanotify/max_user_marks
+
+tcp.7
+ TCP_FASTOPEN
+ TCP_FASTOPEN_CONNECT
+
+
+New and changed links
+---------------------
+
+man3/
+ strftime_l.3
+
+man3type/
+ epoll_data.3type
+ epoll_data_t.3type
+ fexcept_t.3type
+ float_t.3type
+ gid_t.3type
+ imaxdiv_t.3type
+ in6_addr.3type
+ in_addr.3type
+ in_addr_t.3type
+ in_port_t.3type
+ int16_t.3type
+ int32_t.3type
+ int64_t.3type
+ int8_t.3type
+ ldiv_t.3type
+ lldiv_t.3type
+ loff_t.3type
+ off64_t.3type
+ pid_t.3type
+ regmatch_t.3type
+ regoff_t.3type
+ sa_family_t.3type
+ sockaddr_in.3type
+ sockaddr_in6.3type
+ sockaddr_storage.3type
+ sockaddr_un.3type
+ socklen_t.3type
+ speed_t.3type
+ ssize_t.3type
+ suseconds_t.3type
+ tcflag_t.3type
+ uid_t.3type
+ uint16_t.3type
+ uint32_t.3type
+ uint64_t.3type
+ uint8_t.3type
+ uintN_t.3type
+ uintmax_t.3type
+ uintptr_t.3type
+ useconds_t.3type
+
+
+Global changes
+--------------
+
+- Man dirs:
+
+ - Move definitions of types to separate pages in man2type/ and
+ man3type/. Previously, they were spread (and duplicated) in other
+ pages, or in system_data_types.7 (with links in man3/).
+
+ - Add man3head/ for pages that document header files.
+
+ - Add man3const/ for pages that document constants.
+
+- Licenses:
+
+ - Use SPDX-License-Indentiffier for licenses specified by SPDX
+ (including the newly-added Linux-man-pages-copyleft). This reduces
+ the overhead text at the top of most manual page source files.
+ License texts have been moved to LICENSES/.
+
+- Build system:
+
+ - Add several make(1) targets to lint the manual pages, and also lint
+ and build the C programs contained in them. Use of these targets
+ requires unreleased versions of software, such as groff-1.23.0, so
+ it's not yet intended to be used by the public.
+
+ - Add targets to build tarballs of the repository.
+
+- man(7) source:
+
+ - Improve consistency of man(7) source. Also, reduce the number of
+ warnings that groff(1) and mandoc(7) emit when parsing the pages
+ with the highest warning level. Most of these fixes were found
+ thanks to the new `make lint-man` target.
+
+- Manual pages sections:
+
+ - Title (.TH):
+
+ - Remove 5th argument to TH (middle-header).
+
+ - Specify "Linux man-pages" and the version in the 4th argument
+ (left-footer).
+
+ - Add the LIBRARY section. This section standardizes a way to
+ document the library that provides a given interface.
+
+ - Add the CAVEATS section. BUGS and NOTES were serving that purpose
+ before, but CAVEATS is more appropriate.
+
+ - Rename the CONFORMING TO section to STANDARDS for consistency with
+ other projects, such as the BSDs.
+
+ - SYNOPSIS: Add the ISO C2X [[deprecated]] attribute for functions
+ that have been deprecated or removed.
+
+ - EXAMPLES: Improve consistency of C source code. Also, reduce the
+ number of warnings that several linting tools emit.
+
+ - COLOPHON: Remove section (its purpose is now served by the title).
+
+- Repository:
+
+ - CONTRIBUTING, README, INSTALL: Document important changes in the
+ project organization.
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.01 ====================
+
+Released: 2022-10-18, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+Agostino Sarubbo <ago@gentoo.org>
+Alejandro Colomar <alx@kernel.org>
+Amir Goldstein <amir73il@gmail.com>
+Darrick J. Wong <djwong@kernel.org>
+Eric Biggers <ebiggers@google.com>
+Grigoriy <grigoriyremvar@protonmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Matthew Bobrowski <repnop@google.com>
+Michael Tokarev <mjt@tls.msk.ru>
+Mike Gilbert <floppym@gentoo.org>
+Nicolás A. Ortega Froysa <nicolas@ortegas.org>
+Pierre Labastie <pierre.labastie@neuf.fr>
+Sam James <sam@gentoo.org>
+Steve Izma <sizma@golden.net>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+EOF.3const
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify_mark.2
+ FAN_MARK_IGNORE
+
+open.2, statx.2
+ STATX_DIOALIGN
+
+feature_test_macros.7
+ _FORTIFY_SOURCE=3
+ _TIME_BITS
+
+
+Global changes
+--------------
+
+- Build system:
+
+ - Update manual page dates (TH 3rd argument) when creating the tarball
+ with 'make dist'. This removes the need for a tstamp commit before
+ each release.
+
+ - Don't print spurious errors from the Makefile that are not relevant.
+
+- Manual pages' sections:
+
+ - Title (.TH):
+
+ - Remove the hardcoded date (TH 3rd argument), and replace it by a
+ placeholder that should be changed when creating the tarball.
+ This removes the need for a tstamp commit before each release.
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.02 ====================
+
+Released: 2022-12-22, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+1092615079 <1092615079@qq.com>
+Aaron Schrab <aaron@schrab.com>
+Agostino Sarubbo <ago@gentoo.org>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Alex Colomar <alx.manpages@gmail.com>
+Amir Goldstein <amir73il@gmail.com>
+Andrew Clayton <andrew@digital-domain.net>
+Andrew Pinski <pinskia@gmail.com>
+Andries E. Brouwer <aeb@cwi.nl>
+Darrick J. Wong <djwong@kernel.org>
+Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
+Eric Biggers <ebiggers@google.com>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Grigoriy <grigoriyremvar@protonmail.com>
+Grzegorz Szymaszek <gszymaszek@short.pl>
+Helge Kreutzmann <debian@helgefjell.de>
+Ian Abbott <abbotti@mev.co.uk>
+Iker Pedrosa <ipedrosa@redhat.com>
+Ingo Schwarze <schwarze@openbsd.org>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+JeanHeyd Meneide <wg14@soasis.org>
+Jun Ishiguro <algon.0320@gmail.com>
+Luca Versari <veluca93@gmail.com>
+Luis Javier Merino <ninjalj@gmail.com>
+Mario Blättermann <mario.blaettermann@gmail.com>
+Martin Sebor <msebor@redhat.com>
+Martin Uecker <uecker@tugraz.at>
+Matthew Bobrowski <repnop@google.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Tokarev <mjt@tls.msk.ru>
+Mike Frysinger <vapier@gentoo.org>
+Mike Gilbert <floppym@gentoo.org>
+Minchan Kim <minchan@kernel.org>
+Nicolás A. Ortega Froysa <nicolas@ortegas.org>
+Pali Rohár <pali@kernel.org>
+Pierre Labastie <pierre.labastie@neuf.fr>
+Sam James <sam@gentoo.org>
+Serge Hallyn <serge@hallyn.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Steve Izma <sizma@golden.net>
+Suren Baghdasaryan <surenb@google.com>
+Thomas Voss <mail@thomasvoss.com>
+Tycho Andersen <tycho@tycho.pizza>
+Xi Ruoyao <xry111@xry111.site>
+Zach O'Keefe <zokeefe@google.com>
+Zack Weinberg <zack@owlfolio.org>
+
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man3/
+ static_assert.3
+ strcpy.3
+ stpncpy.3
+ strncat.3
+
+man3const/
+ EOF.3const
+ EXIT_SUCCESS.3const
+
+man7/
+ string_copying.7
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ioctl_tty.2
+ TIOCSERGETLSR
+ TIOCSER_TEMT
+
+madvise.2
+ MADV_COLLAPSE
+
+syscall.2
+ loongarch
+
+
+New and changed links
+---------------------
+
+man3/
+ _Static_assert.3 (static_assert(3))
+ stpcpy.3 (strcpy(3))
+ strcat.3 (strcpy(3))
+ strncpy.3 (stpncpy(3))
+ stpecpy.3 (string_copying(7))
+ stpecpyx.3 (string_copying(7))
+ ustpcpy.3 (string_copying(7))
+ ustr2stp.3 (string_copying(7))
+ zustr2stp.3 (string_copying(7))
+ zustr2ustp.3 (string_copying(7))
+
+man3const/
+ EXIT_FAILURE.3const (EXIT_SUCCESS(3const))
+
+
+Global changes
+--------------
+
+- Use correct letter case in manual page titles, instead of uppercase.
+
+- Use \" t comments when appropriate (Lintian needs this).
+
+- SYNOPSIS:
+
+ - Add _Nullable for functions that receive NULL as a meaningful
+ input.
+
+ - Use VLA syntax to clarify the meaning of size parameters, rather
+ than hiding it in possibly-confusing text. This syntax is not
+ accepted by any compilers, though.
+
+ - Use [[noreturn]] instead of noreturn, which will be deprecated
+ soon.
+
+- Repository documentation:
+
+ - Added significant documentation about the repository and the
+ project in the root of the repository in different files.
+ Starting from the README, anyone passing by should be able to
+ understand how the project works and be directed to other
+ documentation files. These files also document the release
+ process.
+
+ - Michael has been busy lately, and he is no longer maintaining
+ the project. The in-repository documentation mentioned above has
+ been updated to reflect that.
+
+
+Changes to individual pages
+---------------------------
+
+copy_file_range.2
+ Fix wrong kernel version information
+
+process_madvise.2
+ Fix capability and ptrace requirements
+
+madvise.2
+ Update Transparent Huge Pages file/shmem documentation for
+ Linux 5.4+.
+
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.03 ====================
+
+Released: 2023-02-12, Xulilla
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+Aaron Peter Bachmann <aaron_ng@inode.at>
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Alex Colomar <alx.manpages@gmail.com>
+Arsen Arsenović <arsen@aarsen.me>
+Bernd Petrovitsch <bernd@petrovitsch.priv.at>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+Colin Cross <ccross@google.com>
+Cristian Rodríguez <crrodriguez@opensuse.org>
+Deri James <deri@chuzzlewit.myzen.co.uk>
+Elliott Hughes <enh@google.com>
+Eric Biggers <ebiggers@kernel.org>
+Florian Weimer <fweimer@redhat.com>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+Günther Noack <gnoack3000@gmail.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Ian Abbott <abbotti@mev.co.uk>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Engelhardt <jengelh@inai.de>
+"Jason A. Donenfeld" <Jason@zx2c4.com>
+Jonny Grant <jg@jguk.org>
+Joseph Myers <joseph@codesourcery.com>
+Kees Cook <keescook@chromium.org>
+Lennart Jablonka <humm@ljabl.com>
+Mario Blaettermann <mario.blaettermann@gmail.com>
+Mark Galeck <markgaleck@gmail.com>
+Namhyung Kim <namhyung@kernel.org>
+Nick Gregory <nick@nickgregory.me>
+Pasha Tatashin <tatashin@google.com>
+Paul Eggert <eggert@cs.ucla.edu>
+<Radisson97@gmx.de>
+Sam James <sam@gentoo.org>
+Samanta Navarro <ferivoz@riseup.net>
+"Serge E. Hallyn" <serge@hallyn.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Suren Baghdasaryan <surenb@google.com>
+Thomas Weißschuh <linux@weissschuh.net>
+Walter Harms <wharms@bfs.de>
+Wilco Dijkstra <Wilco.Dijkstra@arm.com>
+Zack Weinberg <zack@owlfolio.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man3/
+ arc4random.3
+ powerof2.3
+ roundup.3
+
+man3head/
+ printf.h.3head
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ PERF_COUNT_SW_BPF_OUTPUT
+ PERF_COUNT_SW_CGROUP_SWITCHES
+ PERF_FORMAT_LOST
+ PERF_RECORD_MISC_MMAP_BUILD_ID
+ PERF_RECORD_MISC_SWITCH_OUT_PREEMPT
+ PERF_SAMPLE_CODE_PAGE_SIZE
+ PERF_SAMPLE_DATA_PAGE_SIZE
+ PERF_SAMPLE_WEIGHT_STRUCT
+
+ struct perf_event_attr::build_id
+ struct perf_event_attr::inherit_thread
+ struct perf_event_attr::remove_on_exec
+ struct perf_event_attr::sigtrap
+ struct perf_event_attr::aux_sample_size
+ struct perf_event_attr::sig_data
+
+ union perf_sample_weight
+
+ struct read_format::values[]::lost
+
+ struct::weight
+ struct::data_page_size
+ struct::code_page_size
+ struct::size
+ struct::data
+
+ struct:: ::build_id_size
+ struct:: ::build_id
+
+prctl.2
+ PR_SET_VMA
+ PR_SET_VMA_ANON_NAME
+
+
+New and changed links
+---------------------
+
+man3/
+ arc4random_buf.3 (arc4random(3))
+ arc4random_uniform.3 (arc4random(3))
+ register_printf_modifier.3 (printf.h(3head))
+ register_printf_specifier.3 (printf.h(3head))
+ register_printf_type.3 (printf.h(3head))
+
+man3const/
+ PA_CHAR.3const (printf.h(3head))
+ PA_DOUBLE.3const (printf.h(3head))
+ PA_FLAG_LONG.3const (printf.h(3head))
+ PA_FLAG_LONG_DOUBLE.3const (printf.h(3head))
+ PA_FLAG_LONG_LONG.3const (printf.h(3head))
+ PA_FLAG_PTR.3const (printf.h(3head))
+ PA_FLAG_SHORT.3const (printf.h(3head))
+ PA_FLOAT.3const (printf.h(3head))
+ PA_INT.3const (printf.h(3head))
+ PA_LAST.3const (printf.h(3head))
+ PA_POINTER.3const (printf.h(3head))
+ PA_STRING.3const (printf.h(3head))
+ PA_WCHAR.3const (printf.h(3head))
+ PA_WSTRING.3const (printf.h(3head))
+
+man3type/
+ printf_arginfo_size_function.3type (printf.h(3head))
+ printf_function.3type (printf.h(3head))
+ printf_info.3type (printf.h(3head))
+ printf_va_arg_function.3type (printf.h(3head))
+
+
+Global changes
+--------------
+
+- Build system:
+ - Add scripts to produce a book of the Linux man-pages.
+ - Add lint-c-cppcheck to the make(1) targets to run the cppcheck(1)
+ linter.
+
+- TH:
+ - Use correct letter case in page titles. This started in 6.02, but
+ there were still many cases left.
+
+- SYNOPSIS:
+ - Mark some functions as deprecated.
+
+- STANDARDS:
+ - Remove most references to ISO C89. We still document it in
+ standards(7), but it's an ancient language version that this
+ project
+ regards as obsolescent, so in the STANDARDS sections for APIs we
+ only take into account C99 and later and POSIX.1-2001 and later
+ (with few exceptions where older standards are relevant).
+
+- ffix:
+ - Change \- to - where appropriate
+ - Improve readability of numbers:
+ - Show BCD magic numbers that are meaningful in hex as hex,
+ rather than weird decimal numbers.
+ - Use IEC multipliers.
+ - Format ranges consistently using interval notation: [min, max].
+
+- srcfix:
+ - Use \[] escapes.
+
+
+Changes to individual pages
+---------------------------
+
+timespec.3type
+ Update tv_nsec according to C2x.
+
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.04 ====================
+
+Released: 2023-04-03, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Andrew Clayton <andrew@digital-domain.net>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+"Carlos O'Donell" <carlos@redhat.com>
+Christian Brauner <brauner@kernel.org>
+Christoph Lameter <cl@linux.com>
+Dmitry Goncharov <dgoncharov@users.sf.net>
+"Dmitry V. Levin" <ldv@strace.io>
+Elliott Hughes <enh@google.com>
+Elvira Khabirova <lineprinter0@gmail.com>
+Fotios Valasiadis <fvalasiad@gmail.com>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+Guy Shefy <guyshefyb@gmail.com>
+Günther Noack <gnoack3000@gmail.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Iker Pedrosa <ipedrosa@redhat.com>
+Jack Pearson <jack@pearson.onl>
+Jakub Wilk <jwilk@jwilk.net>
+Marco Bonelli <marco@mebeim.net>
+Matt Jolly <Matt.Jolly@footclan.ninja>
+Mickaël Salaün <mic@digikod.net>
+Nate Eldredge <nate@thatsmathematics.com>
+Oskari Pirhonen <xxc3ncoredxx@gmail.com>
+Patrick Reader <_@pxeger.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Smith <psmith@gnu.org>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Rodrigo Campos <rodrigo@sdfg.com.ar>
+Samanta Navarro <ferivoz@riseup.net>
+Serge Hallyn <serge@hallyn.com>
+Simon Horman <simon.horman@corigine.com>
+Timo Stark <t.stark@nginx.com>
+Tom Schwindl <schwindl@posteo.de>
+"Valentin V. Bartenev" <vbartenev@gmail.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vladislav Ivanishin <vlad@ispras.ru>
+Willem de Bruijn <willemb@google.com>
+Wu Zhenyu <wuzhenyu@ustc.edu>
+Yedidyah Bar David <didi@redhat.com>
+Younes Manton <younes.m@gmail.com>
+<imachug@yandex.ru>
+<pabeni@redhat.com>
+
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+proc.5
+ KPF_PGTABLE (Linux 4.18)
+
+landlock.7
+ LANDLOCK_ACCESS_FS_REFER (Linux 5.19)
+ LANDLOCK_ACCESS_FS_TRUNCATE (Linux 6.02)
+
+udp.7
+ UDP_GRO (Linux 5.0)
+ UDP_SEGMENT (Linux 4.18)
+
+
+Global changes
+--------------
+
+- Sections:
+ - Add HISTORY.
+ - HISTORY: Restore C89 references.
+ - Repurpose VERSIONS.
+ - Simplify STANDARDS.
+ - SYNOPSIS: Mark several functions as deprecated.
+
+- Build system:
+ - Support installing in different mandirs
+ (e.g., man3typedir='/usr/share/man/man3').
+ - Support installing compressed pages (Z='.gz').
+ - Support installing link pages as symlinks (LINK_PAGES='symlink').
+ - Add make(1) 'check' target. This has been split from 'lint'.
+ 'lint' will check the source code, and 'check' will check the
+ rendered pages (as a user will read them). There are currently
+ several pages that fail this `make check`, and distributors that
+ depend on this can workaround it by touching a few files:
+
+ $ make check -k -j >/dev/null 2>/dev/null;
+ $ make check -k 2>/dev/null;
+ GREP .tmp/man/man1/memusage.1.check-catman.touch
+ TROFF .tmp/man/man2/fanotify_init.2.cat.set
+ TROFF .tmp/man/man2/gettimeofday.2.cat.set
+ TROFF .tmp/man/man2/s390_sthyi.2.cat.set
+ GREP .tmp/man/man3/mallopt.3.check-catman.touch
+ TROFF .tmp/man/man3/unlocked_stdio.3.cat.set
+ TROFF .tmp/man/man4/console_codes.4.cat.set
+ TROFF .tmp/man/man4/lirc.4.cat.set
+ GREP .tmp/man/man4/smartpqi.4.check-catman.touch
+ GREP .tmp/man/man4/veth.4.check-catman.touch
+ TROFF .tmp/man/man5/proc.5.cat.set
+ GREP .tmp/man/man5/slabinfo.5.check-catman.touch
+ TROFF .tmp/man/man5/tzfile.5.cat.set
+ TROFF .tmp/man/man7/address_families.7.cat.set
+ TROFF .tmp/man/man7/ascii.7.cat.set
+ TROFF .tmp/man/man7/bpf-helpers.7.cat.set
+ GREP .tmp/man/man7/keyrings.7.check-catman.touch
+ GREP .tmp/man/man7/uri.7.check-catman.touch
+ TROFF .tmp/man/man8/tzselect.8.cat.set
+ TROFF .tmp/man/man8/zdump.8.cat.set
+ TROFF .tmp/man/man8/zic.8.cat.set
+
+ After touching the previous files, `make check` will succeed:
+
+ $ make check -k 2>/dev/null | awk '{print $2}' | xargs touch;
+ $ make check -j >/dev/null;
+ $ echo $?
+ 0
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.05 ====================
+
+Released: 2023-08-01, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+"David S. Miller" <davem@davemloft.net>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+A. Wilcox <AWilcox@wilcox-tech.com>
+Adam Dobes <adobes@redhat.com>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alan Cox <alan@llwyncelyn.cymru>
+Alejandro Colomar <alx@kernel.org>
+Alexei Starovoitov <ast@kernel.org>
+Andreas Schwab <schwab@suse.de>
+Andrew Clayton <andrew@digital-domain.net>
+Andrew Morton <akpm@linux-foundation.org>
+Avinesh Kumar <akumar@suse.de>
+Bastien Roucariès <rouca@debian.org>
+Bjarni Ingi Gislason <bjarniig@simnet.is>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+Bruno Haible <bruno@clisp.org>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Colin Watson <cjwatson@debian.org>
+Cyril Hrubis <chrubis@suse.cz>
+DJ Delorie <dj@redhat.com>
+Daniel Verkamp <daniel@drv.nu>
+David Howells <dhowells@redhat.com>
+Dirk Gouders <dirk@gouders.net>
+Dmitry Goncharov <dgoncharov@users.sf.net>
+Eli Zaretskii <eliz@gnu.org>
+Elliott Hughes <enh@google.com>
+Eric Biggers <ebiggers@google.com>
+Eric Blake <eblake@redhat.com>
+Eric Wong <e@80x24.org>
+Fangrui Song <maskray@google.com>
+Florian Weimer <fweimer@redhat.com>
+Gavin Smith <gavinsmith0123@gmail.com>
+Guillem Jover <guillem@hadrons.org>
+Günther Noack <gnoack@google.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Igor Sysoev <igor@sysoev.ru>
+Ingo Schwarze <schwarze@openbsd.org>
+Jakub Jelinek <jakub@redhat.com>
+Jakub Sitnicki <jakub@cloudflare.com>
+Jakub Wilk <jwilk@jwilk.net>
+Johannes Weiner <hannes@cmpxchg.org>
+John Gilmore <gnu@toad.com>
+John Hubbard <jhubbard@nvidia.com>
+John Scott <jscott@posteo.net>
+Jonathan Corbet <corbet@lwn.net>
+Jonathan Wakely <jwakely@redhat.com>
+Joseph Myers <joseph@codesourcery.com>
+Josh Triplett <josh@joshtriplett.org>
+Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
+Larry McVoy <lm@mcvoy.com>
+Lennart Jablonka <humm@ljabl.com>
+Linus Heckemann <git@sphalerite.org>
+Lukas Javorsky <ljavorsk@redhat.com>
+Marcos Fouces <marcos@debian.org>
+Mario Blaettermann <mario.blaettermann@gmail.com>
+Martin (Joey) Schulze <joey@infodrom.org>
+Masami Hiramatsu <mhiramat@kernel.org>
+Masatake YAMATO <yamato@redhat.com>
+Matthew House <mattlloydhouse@gmail.com>
+Matthew Wilcox (Oracle) <willy@infradead.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Weiß <michael.weiss@aisec.fraunhofer.de>
+Mickaël Salaün <mic@digikod.net>
+Mike Frysinger <vapier@gentoo.org>
+Mike Kravetz <mike.kravetz@oracle.com>
+Mingye Wang <arthur200126@gmail.com>
+Nadav Amit <namit@vmware.com>
+Nick Desaulniers <ndesaulniers@google.com>
+Oskari Pirhonen <xxc3ncoredxx@gmail.com>
+Paul E. McKenney <paulmck@kernel.org>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Floyd <pjfloyd@wanadoo.fr>
+Paul Smith <psmith@gnu.org>
+Philip Guenther <guenther@gmail.com>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Reuben Thomas <rrt@sc3d.org>
+Rich Felker <dalias@libc.org>
+Richard Biener <richard.guenther@gmail.com>
+Sam James <sam@gentoo.org>
+Serge Hallyn <serge@hallyn.com>
+Seth David Schoen <schoen@loyalty.org>
+Siddhesh Poyarekar <siddhesh@gotplt.org>
+Simon Horman <simon.horman@corigine.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Steffen Nurpmeso <steffen@sdaoden.eu>
+Szabolcs Nagy <nsz@port70.net>
+Thomas Weißschuh <thomas@t-8ch.de>
+Tom Schwindl <schwindl@posteo.de>
+Tomáš Golembiovský <tgolembi@redhat.com>
+Torbjorn SVENSSON <torbjorn.svensson@foss.st.com>
+Ulrich Drepper <drepper@redhat.com>
+Vahid Noormofidi <vnoormof@nvidia.com>
+Vlastimil Babka <vbabka@suse.cz>
+Wilco Dijkstra <Wilco.Dijkstra@arm.com>
+Xi Ruoyao <xry111@xry111.site>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Yedidyah Bar David <didi@redhat.com>
+Zack Weinberg <zack@owlfolio.org>
+Zijun Zhao <zijunzhao@google.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man2/
+ ioctl_pipe.2
+
+man3/
+ regex.3
+
+man5/
+ erofs.5
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+bpf.2
+ EAGAIN
+
+ioctl_userfaultfd.2
+ UFFD_FEATURE_EXACT_ADDRESS
+
+prctl.2
+ PR_GET_AUXV
+
+recv.2
+ MSG_CMSG_CLOEXEC
+
+statx.2
+ STAT_ATTR_MOUNT_ROOT
+
+syscall.2
+ ENOSYS
+
+resolv.conf.5
+ no-aaaa
+ RES_NOAAAA
+
+tmpfs.5
+ CONFIG_TRANSPARENT_HUGEPAGE
+
+ip.7
+ IP_LOCAL_PORT_RANGE
+
+rtnetlink.7
+ IFLA_PERM_ADDRESS
+
+
+New and changed links
+---------------------
+
+man3type/
+ regex_t.3type (regex(3))
+ regmatch_t.3type (regex(3))
+ regoff_t.3type (regex(3))
+
+
+Global changes
+--------------
+
+- Types:
+ - Document functions using off64_t as if they used off_t (except
+ for lseek64()).
+
+- Build system:
+ - Keep file modes in the release tarball.
+ - Fix symlink installation (`make install LINK_PAGES=symlink`).
+ - Add support for using bzip2(1), lzip(1), and xz(1) when installing
+ pages and creating release tarballs.
+ - Create reproducible release tarballs.
+ - Move makefiles from lib/ to share/mk/.
+ - Support mdoc(7) pages.
+ - Relicense Makefiles as GPL-3.0-or-later.
+ - Build PostScript and PDF manual pages.
+ - Add support for running our build system on arbitrary source
+ trees; this makes it possible to easily run our linters on another
+ project's manual pages as easily as `make lint MANDIR=~/src/groff`
+
+- Licenses:
+ - Relicense ddp.7 from VERBATIM_ONE_PARA to Linux-man-pages-copyleft.
+ - Relicense dir_colors.5 from LDPv1 to GPL-2.0-or-later.
+ - Use new SPDX license identifiers:
+ - Linux-man-pages-1-para (was VERBATIM_ONE_PARA)
+ - Linux-man-pages-copyleft-2-para (was VERBATIM_TWO_PARA)
+ - Linux-man-pages-copyleft-var (was VERBATIM_PROF)
+
+- ffix:
+ - use `\%`
+ - un-bracket tbl(1) tables
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.06 ====================
+
+Released: 2024-02-12, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+"G. Branden Robinson" <branden@debian.org>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+"Huang, Ying" <ying.huang@intel.com>
+"Serge E. Hallyn" <serge@hallyn.com>
+Adhemerval Zanella Netto <adhemerval.zanella@linaro.org>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Alexander Kozhevnikov <mentalisttraceur@gmail.com>
+Alexey Tikhonov <atikhono@redhat.com>
+Amir Goldstein <amir73il@gmail.com>
+Andreas Schwab <schwab@issan.informatik.uni-dortmund.de>
+Andreas Schwab <schwab@linux-m68k.org>
+Andreas Schwab <schwab@suse.de>
+Andriy Utkin <andriy_utkin@fastmail.com>
+Arnav Rawat <rawat.arnav@gmail.com>
+Arnd Bergmann <arnd@arndb.de>
+Aurelien Jarno <aurel32@debian.org>
+Avinesh Kumar <akumar@suse.de>
+Axel Rasmussen <axelrasmussen@google.com>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+Bruno Haible <bruno@clisp.org>
+Carlos O'Donell <carlos@redhat.com>
+Catalin Marinas <catalin.marinas@arm.com>
+Christian Brauner <brauner@kernel.org>
+Christopher Lameter <cl@os.amperecomputing.com>
+Colin Watson <cjwatson@debian.org>
+DJ Delorie <dj@redhat.com>
+David Mosberger <davidm@hpl.hp.com>
+Deri James <deri@chuzzlewit.myzen.co.uk>
+Don Brace <don.brace@microchip.com>
+Elliott Hughes <enh@google.com>
+Florent Revest <revest@chromium.org>
+Florian Lehner <dev@der-flo.net>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Geoff Keating <geoffk@ozemail.com.au>
+Gobinda Das <godas@redhat.com>
+Greg Kroah-Hartman <gregkh@linuxfoundation.org>
+Guillem Jover <guillem@hadrons.org>
+Guo Ren <guoren@kernel.org>
+Guo Ren <guoren@linux.alibaba.com>
+Günther Noack <gnoack@google.com>
+Hanno Böck <hanno@hboeck.de>
+Helge Kreutzmann <debian@helgefjell.de>
+Iker Pedrosa <ipedrosa@redhat.com>
+Ingo Schwarze <schwarze@openbsd.org>
+Ingo Schwarze <schwarze@usta.de>
+Jakub Jelinek <jakub@redhat.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Engelhardt <jengelh@inai.de>
+Jan Kara <jack@suse.cz>
+John Watts <contact@jookia.org>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Kees Cook <keescook@chromium.org>
+Kevin Barnett <kevin.barnett@microchip.com>
+Kuniyuki Iwashima <kuniyu@amazon.com>
+Lee Griffiths <poddster@gmail.com>
+Luis Chamberlain <mcgrof@kernel.org>
+Maciej Żenczykowski <maze@google.com>
+Mario Blaettermann <mario.blaettermann@gmail.com>
+Matthew House <mattlloydhouse@gmail.com>
+Matthias Gerstner <matthias.gerstner@suse.com>
+Max Kellermann <max.kellermann@ionos.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Miguel de Icaza <miguel@nuclecu.unam.mx>
+Mike McGowen <mike.mcgowen@microchip.com>
+Mike Rapoport (IBM) <rppt@kernel.org>
+Morten Welinder <mwelinder@gmail.com>
+Muhammad Usama Anjum <usama.anjum@collabora.com>
+Oskari Pirhonen <xxc3ncoredxx@gmail.com>
+Patch by Xavier Leroy <Xavier.Leroy@inria.fr>.
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Smith <psmith@gnu.org>
+Peter Xu <peterx@redhat.com>
+Petr Vorel <pvorel@suse.cz>
+Philip Blundell <pb@nexus.co.uk>
+Renzo Davoli <renzo@cs.unibo.it>
+Reported by Ralf Corsepius <corsepiu@faw.uni-ulm.de>.
+Reported by Sam Roberts <sroberts@uniserve.com>.
+Richard Henderson <richard@gnu.ai.mit.edu>
+Richard Henderson <rth@cygnus.com>
+Richard Henderson <rth@tamu.edu>
+Rik van Riel <riel@surriel.com>
+Roland McGrath <roland@gnu.org>
+Sam James <sam@gentoo.org>
+Sambit Nayak <sambitnayak@gmail.com>
+Samuel Thibault <samuel.thibault@ens-lyon.org>
+Sargun Dhillon <sargun@sargun.me>
+Sascha Grunert <saschagrunert@gmail.com>
+Sascha Grunert <sgrunert@redhat.com>
+Scott Benesh <scott.benesh@microchip.com>
+Scott Teel <scott.teel@microchip.com>
+Serge Hallyn <serge@hallyn.com>
+Sergei Gromeniuk <sgromeni@redhat.com>
+Shahab Ouraie <shahabouraie@gmail.com>
+Shani Leviim <sleviim@redhat.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Thorsten Kukuk <kukuk@suse.com>
+Tom Schwindl <schwindl@posteo.de>
+Tomáš Golembiovský <tgolembi@redhat.com>
+Ulrich Drepper <drepper@cygnus.com>
+Ulrich Drepper <drepper@redhat.com>
+Wolfram Gloger <wg@wolfram.dent.med.uni-muenchen.de>
+Wolfram Gloger <wmglo@dent.med.uni-muenchen.de>
+Xavier Leroy <Xavier.Leroy@inria.fr>
+Xi Ruoyao <xry111@xry111.site>
+Yafang Shao <laoar.shao@gmail.com>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Zack Weinberg <zack@owlfolio.org>
+Štěpán Němec <stepnem@smrk.net>
+Дилян Палаузов <dilyan.palauzov@aegee.org>
+наб <nabijaczleweli@nabijaczleweli.xyz>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man2/
+ ioctl_pagemap_scan.2
+
+man3/ (taken from glibc's linuxthreads)
+ pthread_cond_init.3
+ pthread_condattr_init.3
+ pthread_key_create.3
+ pthread_mutex_init.3
+ pthread_mutexattr_setkind_np.3
+ pthread_once.3
+
+man5/
+ proc.5 (split into many small pages)
+ proc_apm.5
+ proc_buddyinfo.5
+ proc_bus.5
+ proc_cgroups.5
+ proc_cmdline.5
+ proc_config.gz.5
+ proc_cpuinfo.5
+ proc_crypto.5
+ proc_devices.5
+ proc_diskstats.5
+ proc_dma.5
+ proc_driver.5
+ proc_execdomains.5
+ proc_fb.5
+ proc_filesystems.5
+ proc_fs.5
+ proc_ide.5
+ proc_interrupts.5
+ proc_iomem.5
+ proc_ioports.5
+ proc_kallsyms.5
+ proc_kcore.5
+ proc_key-users.5
+ proc_keys.5
+ proc_kmsg.5
+ proc_kpagecgroup.5
+ proc_kpagecount.5
+ proc_kpageflags.5
+ proc_ksyms.5
+ proc_loadavg.5
+ proc_locks.5
+ proc_malloc.5
+ proc_meminfo.5
+ proc_modules.5
+ proc_mtrr.5
+ proc_partitions.5
+ proc_pci.5
+ proc_pid.5
+ proc_pid_attr.5
+ proc_pid_autogroup.5
+ proc_pid_auxv.5
+ proc_pid_cgroup.5
+ proc_pid_clear_refs.5
+ proc_pid_cmdline.5
+ proc_pid_comm.5
+ proc_pid_coredump_filter.5
+ proc_pid_cpuset.5
+ proc_pid_cwd.5
+ proc_pid_environ.5
+ proc_pid_exe.5
+ proc_pid_fd.5
+ proc_pid_fdinfo.5
+ proc_pid_io.5
+ proc_pid_limits.5
+ proc_pid_map_files.5
+ proc_pid_maps.5
+ proc_pid_mem.5
+ proc_pid_mountinfo.5
+ proc_pid_mounts.5
+ proc_pid_mountstats.5
+ proc_pid_net.5
+ proc_pid_ns.5
+ proc_pid_numa_maps.5
+ proc_pid_oom_score.5
+ proc_pid_oom_score_adj.5
+ proc_pid_pagemap.5
+ proc_pid_personality.5
+ proc_pid_projid_map.5
+ proc_pid_root.5
+ proc_pid_seccomp.5
+ proc_pid_setgroups.5
+ proc_pid_smaps.5
+ proc_pid_stack.5
+ proc_pid_stat.5
+ proc_pid_statm.5
+ proc_pid_status.5
+ proc_pid_syscall.5
+ proc_pid_task.5
+ proc_pid_timers.5
+ proc_pid_timerslack_ns.5
+ proc_pid_uid_map.5
+ proc_pid_wchan.5
+ proc_profile.5
+ proc_scsi.5
+ proc_slabinfo.5
+ proc_stat.5
+ proc_swaps.5
+ proc_sys.5
+ proc_sys_abi.5
+ proc_sys_debug.5
+ proc_sys_dev.5
+ proc_sys_fs.5
+ proc_sys_kernel.5
+ proc_sys_net.5
+ proc_sys_proc.5
+ proc_sys_sunrpc.5
+ proc_sys_user.5
+ proc_sys_vm.5
+ proc_sysrq-trigger.5
+ proc_sysvipc.5
+ proc_tid_children.5
+ proc_timer_list.5
+ proc_timer_stats.5
+ proc_tty.5
+ proc_uptime.5
+ proc_version.5
+ proc_vmstat.5
+ proc_zoneinfo.5
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+man2/
+ access.2
+ AT_EMPTY_PATH
+
+ execve.2
+ E2BIG
+
+ ioctl_userfaultfd.2
+ UFFDIO_API handshake
+ UFFDIO_POISON
+ UFFD_FEATURE_WP_ASYNC
+
+ mbind.2
+ MPOL_F_NUMA_BALANCING
+
+ prctl.2
+ PR_SET_MDWE
+ PR_GET_MDWE
+
+ set_thread_area.2
+ C-SKY
+
+ utimensat.2
+ AT_EMPTY_PATH
+
+man3/
+ stdio.3
+ fmemopen(3)
+ fopencookie(3)
+ open_memstream(3)
+ open_wmemstream(3)
+
+man4/
+ smartpqi.4
+ ctrl_ready_timeout
+ enable_stream_detection
+ ssd_smart_path_enabled
+ enable_r5_writes
+ enable_r6_writes
+ lunid
+ unique_id
+ path_info
+ raid_bypass_cnt
+ sas_ncq_prio_enable
+
+man5/
+ proc_pid_status.5 (previously, proc.5)
+ Seccomp_filters
+
+ tmpfs.5
+ size/blocks=0
+ nr_inodes=0
+
+man8/
+ ld.so.8
+ --list-diagnostics
+ --glibc-hwcaps-mask
+ --glibc-hwcaps-prepend
+
+
+New and changed links
+---------------------
+
+man5/
+ proc_mounts.5 (proc_pid_mounts(5))
+ proc_net.5 (proc_pid_net(5))
+ proc_pid_gid_map.5 (proc_pid_uid_map(5))
+ proc_pid_oom_adj.5 (proc_pid_oom_score_adj(5))
+ proc_self.5 (proc_pid(5))
+ proc_thread-self.5 (proc_pid_task(5))
+ proc_tid.5 (proc_pid_task(5))
+
+
+Removed links
+-------------
+
+man3/
+ stpecpy.3
+ stpecpyx.3
+ ustpcpy.3
+ ustr2stp.3
+ zustr2stp.3
+ zustr2ustp.3
+
+
+Global changes
+--------------
+
+- Build system
+ - Update PDF book for groff-1.23.0.
+ - Add targets to [un]install intro(*) pages separately.
+ - Support manual pages in other projects, so that our build system
+ can be used to for example lint them.
+ - Reject non-GNU make(1).
+ - Add target to build the PDF book.
+
+- man*/
+ - Add some consistency in the use of man(7).
+ - Split proc(5) into many small pages.
+ - Import pages from old linuxthreads (glibc), with their git
+ history (from both glibc and Debian).
+ - Rewrite a large part of the documentation for string-copying
+ functions.
+ - Say ISO/IEC instead of ISO where appropriate, and be consistent in
+ the formatting of names of ISO or ISO/IEC standards.
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.7 =====================
+
+Released: 2024-03-19, València
+
+
+New and rewritten pages
+-----------------------
+
+man3/
+ TIMEVAL_TO_TIMESPEC.3
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+man2/
+ process_madvise.2
+ process_madvise() glibc wrapper
+
+
+New and changed links
+---------------------
+
+man3/
+ TIMESPEC_TO_TIMEVAL.3 (TIMEVAL_TO_TIMESPEC(3))
+
+
+Global changes
+--------------
+
+- Build system
+ - Reorganize build system
+ - Clarify dependencies
+ - Clarify configurable variables
+ - Add 'distcheck' target
+ - Ignore known warnings
+ - Replace uses of man2html(1) by grohtml(1)
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, or the authors of changes, use git(1).