memchr.3
Michael Kerrisk
- Add feature text macro requirements for memrchr()
+ Add feature test macro requirements for memrchr()
nextafter.3
Michael Kerrisk
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
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Alejandro Colomar <colomar.6.4.3@gmail.com>
+Alejandro Colomar <alx@kernel.org>
Aleksa Sarai <cyphar@cyphar.com>
Alexander Miller <alex.miller@gmx.de>
Andrea Arcangeli <aarcange@redhat.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>
Add IOCB_CMD_POLL opcode
lseek.2
- Michael Kerrisk
+ Michael Kerrisk [Matthew Wilcox]
ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file
madvise.2
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).