semop.2
mtk
Added BUG: in some circumstances, a process that is
- waiting for a semaphore to become zero is not not woken
+ waiting for a semaphore to become zero is not woken
up when the value does actually reach zero.
http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2
frexp.3
Volker Reichelt / mtk
- Fixed to point out that that frexp() returns a number whose
+ Fixed to point out that frexp() returns a number whose
*absolute* value is >= 0.5 and < 1. Amended the example
program to demonstrate this.
crypt.3
mtk, after a Fedora downstream patch
Describe additional encryption algorithms.
- See also: https://bugzilla.redhat.com/show_bug.cgi?id=428280.
+ See also: https://bugzilla.redhat.com/show_bug.cgi?id=428280.
errno.3
mtk
Michael Kerrisk
Linux now imposes a floor on the ARG_MAX limit
Starting with Linux 2.6.23, the ARG_MAX limit became
- settable via (1/4 of) RLIMIT_STACK. This broke ABI
- compatibility if RLIMIT_STACK was set such that ARG_MAX
- was < 32 pages. Document the fact that since 2.6.25
- Linux imposes a floor on ARG_MAX, so that the old limit
- of 32 pages is guaranteed.
+ settable via (1/4 of) RLIMIT_STACK. This broke ABI
+ compatibility if RLIMIT_STACK was set such that ARG_MAX
+ was < 32 pages. Document the fact that since 2.6.25
+ Linux imposes a floor on ARG_MAX, so that the old limit
+ of 32 pages is guaranteed.
For some background on the changes to ARG_MAX in
- kernels 2.6.23 and 2.6.25, see:
+ kernels 2.6.23 and 2.6.25, see:
http://sourceware.org/bugzilla/show_bug.cgi?id=5786
http://bugzilla.kernel.org/show_bug.cgi?id=10095
http://thread.gmane.org/gmane.linux.kernel/646709/focus=648101,
checked into 2.6.25 as
- commit a64e715fc74b1a7dcc5944f848acc38b2c4d4ee2.
+ commit a64e715fc74b1a7dcc5944f848acc38b2c4d4ee2.
Also some reordering/rewording of the discussion of ARG_MAX.
Michael Kerrisk
Note lack of glibc wrapper; caller must use syscall(2)
Glibc doesn't (and quite probably won't) include a
- wrapper for this system call. Therefore, point out that
- potential callers will need to use syscall(2), and rewrite
- the RETURN VALUE text to show things as they would be if
- syscall() is used.
+ wrapper for this system call. Therefore, point out that
+ potential callers will need to use syscall(2), and rewrite
+ the RETURN VALUE text to show things as they would be if
+ syscall() is used.
Michael Kerrisk
Refer reader to posix_fallocate(3) for portable interface
Add a para to start of page that points out that this is the
low-level, Linux-specific API, and point the reader to
- posix_fallocate(3) for the portable API.
+ posix_fallocate(3) for the portable API.
getdents.2
readdir.3
Michael Kerrisk
s/dirent/linux_dirent/
The structure isn't currently defined in glibc headers,
- and the kernel name of the structure is 'linux_dirent' (as
+ and the kernel name of the structure is 'linux_dirent' (as
was already used in some, but not all, places in this page).
getrlimit.2
Michael Kerrisk
Split umount*() out into a separate page
The length of this page means that it's becoming difficult
- to parse which info is specific to mount() versus
- umount()/umount2(), so split the umount material out into
- its own page.
+ to parse which info is specific to mount() versus
+ umount()/umount2(), so split the umount material out into
+ its own page.
pause.2
Michael Kerrisk
Michael Kerrisk
s/dirent/old_linux_dirent/
Nowadays, this is the name of the structure in the
- kernel sources.
+ kernel sources.
Michael Kerrisk
Remove words "which may change"
These words are slightly bogus: although the interface
- is obsolete, for ABI-compatibility reasons, the kernel folk
- should never be changing this interface.
+ is obsolete, for ABI-compatibility reasons, the kernel folk
+ should never be changing this interface.
Michael Kerrisk
Remove header files from SYNOPSIS
glibc doesn't provide any support for readdir(2),
Michael Kerrisk
These interfaces have per-thread semantics
- The page was previously fuzzy about whether the these interfaces
+ The page was previously fuzzy about whether these interfaces
have process-wide or per-thread semantics. (E.g., now the
page states that the calling *thread* (not process) is suspended
until the signal is delivered.)
Michael Kerrisk
Explain how thread's pending signal set is defined
The pending set is the union of per-thread pending signals
- and process-wide pending signals.
+ and process-wide pending signals.
sigprocmask.2
Michael Kerrisk
hsearch.3
André Goddard Rosa
Call hdestroy() after using hash table created by hcreate(),
- for the sake of completeness
+ for the sake of completeness
mq_getattr.3
Michael Kerrisk
Global fix: s/mount-point namespace/mount namespace/
This is more consistent with the term "mounts namespace"
used in the 2008 ACM SIGOPS paper, "Virtual servers
- and and checkpoint/restart in mainstream Linux".
+ and checkpoint/restart in mainstream Linux".
(I avoided the "s", because using the plural strikes me
as klunky English, and anyway we don't talk about
the "PIDs namespace" or the "networks namespace", etc..)
Michael Kerrisk
PTHREAD_INHERIT_SCHED is default for inherit scheduler attribute
In EXAMPLE, note that PTHREAD_INHERIT_SCHED is the default for
- the inherit scheduler attribute attribute.
+ the inherit scheduler attribute.
syslog.3
Masanari Iida
added. (strerror() was already in the list in POSIX.1-2001.)
Michael Kerrisk
Tweak text on sigpause() cancellation point
- In POSIX.1-2009, this function moves from the "must be"
+ In POSIX.1-2008, this function moves from the "must be"
to the "may be" list.
Michael Kerrisk
Add ref to signal(7) for further info on use of real-time signals
syscalls.2
Michael Kerrisk
Note that getpmsg(2) and putmsg(2) are unimplemented
- See See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771
timerfd_create.2
Michael Kerrisk
memchr.3
Michael Kerrisk
- Add feature text macro requirements for memrchr()
+ Add feature test macro requirements for memrchr()
nextafter.3
Michael Kerrisk
udp.7
Michael Kerrisk
Add FIONREAD warning.
- Warn that FIONREAD can't can't distinguish case of a zero-length
+ Warn that FIONREAD can't distinguish case of a zero-length
datagram from the case where no datagrams are available.
fstatat.2
Michael Kerrisk [David Howells]
Document AT_NO_AUTOMOUNT
- This flag was added in Linux 2.6.38.
+ This flag was added in Linux 2.6.38.
lseek.2
Michael Kerrisk [Eric Blake, Sunil Mushran]
socket.7
Pavel Emelyanov
SO_BINDTODEVICE is now readable
- SO_BINDTODEVICE is readable since since kernel 3.8.
+ SO_BINDTODEVICE is readable since kernel 3.8.
==================== Changes in man-pages-3.49 ====================
and the wrapper function in the introductory text.
Michael Kerrisk
Update feature test macro requirements
- The requirements quietly changed changed in glibc 2.14
+ The requirements quietly changed in glibc 2.14
See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
Michael Kerrisk [Mike Frysinger]
unshare.2
Michael Kerrisk
Update feature test macro requirements
- The requirements quietly changed changed in glibc 2.14
+ The requirements quietly changed in glibc 2.14
See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
sched_getcpu.3
Michael Kerrisk
Update feature test macro requirements
- The requirements quietly changed changed in glibc 2.14
+ The requirements quietly changed in glibc 2.14
See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
Neil Horman
Document the SO_RXQ_OVFL socket option
Michael Kerrisk
- Add kernel version number for SO_RXQ_OVFL
+ Add kernel version number for SO_RXQ_OVFL
New and changed links
"fileutils", which long ago become coreutils, and the
piece under NOTES note some behavior of sync(2)
that ceased to be true many years ago. The man-pages
- project generally focuses on only Linux kernel and
+ project generally focuses on only Linux kernel and
(g)libc interfaces, so this sync(8) page doesn't really
- belong. Furthermore, coreutils has a sync(1) page which
- covers the same command. After discussions on the
- coreutils list, I've decided to retire this page from
- man-pages.
+ belong. Furthermore, coreutils has a sync(1) page which
+ covers the same command. After discussions on the
+ coreutils list, I've decided to retire this page from
+ man-pages.
Changes to individual pages
---------------------------
Inspired by a patch from Maria Guseva.
Maria Guseva [Silvan Jegen]
LD_DEBUG is effective in secure-execution mode if /etc/suid-debug exists
+
+
+==================== Changes in man-pages-4.04 ====================
+
+Released: 2015-12-29, 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:
+
+Alexander Monakov <amonakov@ispras.ru>
+Andries E. Brouwer <Andries.Brouwer@cwi.nl>
+Archie Cobbs <archie.cobbs@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Colin Rice <colin@daedrum.net>
+Darren Hart <dvhart@infradead.org>
+Davidlohr Bueso <dave@stgolabs.net>
+Dmitry V. Levin <ldv@altlinux.org>
+Eric B Munson <emunson@akamai.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+H.J. Lu <hjl.tools@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Laurent Georget <laurent.georget@supelec.fr>
+Lennart Poettering <lennart@poettering.net>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mike Frysinger <vapier@gentoo.org>
+Pádraig Brady <P@draigBrady.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Pavel Machek <pavel@ucw.cz>
+Phil Blundell <pb@pbcl.net>
+Richard Voigt <richardvoigt@gmail.com>
+Rich Felker <dalias@libc.org>
+Rusty Russell <rusty@rustcorp.com.au>
+Thomas Gleixner <tglx@linutronix.de>
+Tom Gundersen <teg@jklm.no>
+Torvald Riegel <triegel@redhat.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vlastimil Babka <vbabka@suse.cz>
+Walter Harms <wharms@bfs.de>
+Zack Weinberg <zackw@panix.com>
+
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+futex.2
+ Michael Kerrisk, Thomas Gleixner, Torvald Riegel [Davidlohr Bueso, Heinrich Schuchardt, Darren Hart, Rusty Russell, Pavel Machek, Rich Felker]
+ Rewrite and massively expand page
+
+membarrier.2
+ Mathieu Desnoyers [Michael Kerrisk]
+ New page documenting membarrier() system call
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+mlock.2
+ Eric B Munson [Michal Hocko, Vlastimil Babka, Michael Kerrisk]
+ Document mlock2(2) and MCL_ONFAULT
+
+
+New and changed links
+---------------------
+
+mlock2.2
+ Eric B Munson
+ New link to mlock.2
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ ERRORS: standardize text for EMFILE error
+
+Various pages
+ Michael Kerrisk
+ ERRORS: standardize error text for ENOTSOCK error
+
+Various pages
+ Michael Kerrisk
+ ERRORS: standardize text for ENFILE error
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk
+ SEE ALSO: add vdso(7)
+
+epoll_create.2
+ Michael Kerrisk
+ ERRORS: add another EMFILE error case
+
+fanotify_init.2
+ Michael Kerrisk
+ ERRORS: add an EMFILE error case
+
+fork.2
+ Michael Kerrisk
+ Child of MT-process is restricted to async-signal-safe functions
+
+getcpu.2
+ Michael Kerrisk
+ SEE ALSO: add vdso(7)
+
+getrlimit.2
+ Michael Kerrisk [Lennart Poettering]
+ The init of measurement for RLIMIT_RSS is bytes, not pages
+
+get_robust_list.2
+ Michael Kerrisk
+ Reword EINVAL error text
+
+gettimeofday.2
+ Carlos O'Donell
+ Expand on the historical meaning of tz_dsttime
+ Michael Kerrisk
+ SEE ALSO: add vdso(7)
+
+inotify_init.2
+ Michael Kerrisk
+ ERRORS: add an EMFILE error case
+
+personality.2
+ Dmitry V. Levin
+ Note kernel and glibc versions that introduced this system call
+
+poll.2
+ Richard Voigt
+ timeout_ts is a pointer, so use -> not . for member access
+ Michael Kerrisk
+ Shorten name of timeout argument for ppoll()
+ The name is overly long, and does not hint at the fact
+ that this argument is a pointer. Fix this by renaming:
+ s/timeout_ts/tmo_p/
+
+sendfile.2
+ Laurent Georget
+ Document more ERRORS
+
+sigreturn.2
+ Michael Kerrisk
+ SEE ALSO: add vdso(7)
+
+socketcall.2
+ Michael Kerrisk
+ Since Linux 4.3, x86-32 provides direct system calls for the sockets API
+
+time.2
+ Zack Weinberg
+ Explain why the glibc time() wrapper never sets 'errno'
+ Michael Kerrisk [H.J. Lu]
+ Where time() is provided by vDSO, an invalid address may give SIGSEGV
+ Michael Kerrisk [Paul Eggert]
+ Describe EOVERFLOW details
+ Michael Kerrisk
+ SEE ALSO: add vdso(7)
+ Michael Kerrisk
+ Rename 't' argument to 'tloc'
+
+dlerror.3
+ Michael Kerrisk [Jonny Grant]
+ Clarify that the string returned by dlerror() is null terminated
+
+dlopen.3
+ Michael Kerrisk
+ Include a shell session showing build/run in EXAMPLE
+ Michael Kerrisk
+ Change arguments to main() to "void" in EXAMPLE
+
+drand48.3
+ Michael Kerrisk [Vincent Lefevre]
+ Correct descriptions of ranges returned by these functions
+ See http://bugs.debian.org/803459
+
+errno.3
+ Michael Kerrisk
+ Note probable cause of ENFILE error
+
+fnmatch.3
+ Pádraig Brady
+ Describe the FNM_EXTMATCH flag and pattern syntax
+
+iconv.3
+ Andries E. Brouwer
+ NOTES: describe correct usage for flushing partially buffered input
+
+random_r.3
+ Michael Kerrisk [Archie Cobbs]
+ Clarify need to use initstate_r()
+
+tzset.3
+ Carlos O'Donell
+ Clarify "daylight" and remove erroneous note
+
+random.4
+ Michael Kerrisk [Tom Gundersen]
+ Rework example scripts to assume 'poolsize' unit is bits, not bytes
+ Michael Kerrisk [Walter Harms]
+ Use modern command substitution syntax in shell session log
+
+proc.5
+ Michael Kerrisk
+ Reaching /proc/sys/fs/file-max limit normally produces an ENFILE error
+
+futex.7
+ Heinrich Schuchardt
+ SEE ALSO updates
+ Michael Kerrisk
+ Note some other locking primitives that are built with futexes
+ Heinrich Schuchardt
+ NPTL, avoid abbreviation
+ Michael Kerrisk
+ Note that a futex is 4 bytes on all platforms
+
+vdso.7
+ Michael Kerrisk
+ Add note on strace(1) and vDSO
+
+ld.so.8
+ H.J. Lu [Michael Kerrisk]
+ Document LD_PREFER_MAP_32BIT_EXEC
+ Michael Kerrisk
+ Clarify setting of LD_BIND_NOT
+ Michael Kerrisk
+ Clarify setting of LD_DYNAMIC_WEAK
+ Michael Kerrisk
+ Clarify setting of LD_TRACE_PRELINKING
+ Michael Kerrisk
+ Clarify some details for LD_SHOW_AUXV
+
+
+==================== Changes in man-pages-4.05 ====================
+
+Released: 2016-03-15, 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:
+
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Akihiro Suda <suda.kyoto@gmail.com>
+Alan Aversa <alan.aversa@cox.net>
+Alan Cox <etchedpixels@gmail.com>
+Alec Leamas <leamas.alec@gmail.com>
+Alex Henrie <alexhenrie24@gmail.com>
+Alexander Miller <alex.miller@gmx.de>
+Andreas Gruenbacher <agruenba@redhat.com>
+Andreas Schwab <schwab@suse.de>
+Anna Schumaker <Anna.Schumaker@Netapp.com>
+Askar Safin <safinaskar@mail.ru>
+Bill O. Gallmeister <bgallmeister@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Chris Pick <kernel@chrispick.com>
+Christoph Hellwig <hch@infradead.org>
+Craig Gallek <kraig@google.com>
+Darrick J. Wong <darrick.wong@oracle.com>
+Davidlohr Bueso <dave@stgolabs.net>
+Dmitry V. Levin <ldv@altlinux.org>
+Dr. Tobias Quathamer <toddy@debian.org>
+Eric Blake <eblake@redhat.com>
+Eric Dumazet <edumazet@google.com>
+Florian Weimer <fweimer@redhat.com>
+Gabriel Corona <gabriel.corona@enst-bretagne.fr>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Ivan Shapovalov <intelfx@intelfx.name>
+Jakub Wilk <jwilk@jwilk.net>
+Jason Baron <jbaron@akamai.com>
+Jason Vas Dias <jason.vas.dias@gmail.com>
+Jérémie Galarneau <jeremie.galarneau@efficios.com>
+Jeremy Harris <jeharris@redhat.com>
+Joachim Wuttke <j.wuttke@fz-juelich.de>
+Joe Stein <joeaarons@gmail.com>
+John Stultz <john.stultz@linaro.org>
+Josh Triplett <josh@joshtriplett.org>
+Kondo, Naoya <kondo-naoya@jp.fujitsu.com>
+Krzysztof Adamski <k@japko.eu>
+Manfred Spraul <manfred@colorfullife.com>
+Marianne CHEVROT <blackmoor@openmailbox.org>
+Marko Myllynen <myllynen@redhat.com>
+Mark Post <mpost@suse.com>
+Martin Gebert <Murphy.Gebert@gmx.de>
+Mats Wichmann <mats@linuxfoundation.org>
+Matt Zimmerman <mdz@debian.org>
+Michael Kerrisk <mtk.manpages@gmail.com>`
+Mike Frysinger <vapier@gentoo.org>
+Minchan Kim <minchan@kernel.org>
+Naoya Kondo <kondo-naoya@jp.fujitsu.com>
+Naresh Kamboju <naresh.kernel@gmail.com>
+Nikola Forró <nforro@redhat.com>
+Nikos Mavrogiannopoulos <nmav@gnutls.org>
+Orion Poplawski <orion@cora.nwra.com>
+Pakin Yury <zxwarior@yandex.ru>
+Patrick Donnelly <batrick@batbytes.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Pluzhnikov <ppluzhnikov@google.com>
+Peter Hurley <peter@hurleysoftware.com>
+Peter Wu <peter@lekensteyn.nl>
+Petr Gajdos <pgajdos@suse.cz>
+Philip Semanchuk <linux_kernel.20.ick@spamgourmet.com>
+Rasmus Villemoes <Rasmus.Villemoes@decode.is>
+Rich Felker <dalias@aerifal.cx>
+Simon Que <sque@chromium.org>
+Stephan Bergmann <sbergman@redhat.com>
+Stéphane Aulery <lkppo@free.fr>
+Stephen Hurd <shurd@sasktel.net>
+Vincent Bernat <bernat@luffy.cx>
+William Preston <wpreston@suse.de>
+Yuri Kozlov <yuray@komyakino.ru>
+Zefram <zefram@fysh.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+copy_file_range.2
+ Anna Schumaker [Darrick J. Wong, Christoph Hellwig, Michael Kerrisk]
+ New page documenting copy_file_range()
+ copy_file_range() is a new system call for copying ranges of data
+ completely in the kernel. This gives filesystems an opportunity to
+ implement some kind of "copy acceleration", such as reflinks or
+ server-side-copy (in the case of NFS).
+
+personality.2
+ Michael Kerrisk
+ This page has been greatly expanded, to add descriptions of
+ personality domains.
+
+fmemopen.3
+ Michael Kerrisk [Adhemerval Zanella]
+ Significant reworking of this page:
+ * Rework discussion of the (obsolete) binary mode
+ * Split open_memstream(3) description into a separate page.
+ * Note various fmemopen() bugs that were fixed in glibc 2.22
+ * Greatly expand description of 'mode' argument
+ * Rework description of 'buf' and 'len' arguments
+ * Expand discussion of "current position" for fmemopen() stream
+
+ntp_gettime.3
+ Michael Kerrisk
+ New page describing ntp_gettime(3) and ntp_gettimex(3)
+
+open_memstream.3
+ Michael Kerrisk
+ New page created by split of fmemopen(3).
+ At the same time, add and rework a few details in the text.
+
+posix_spawn.3
+ Bill O. Gallmeister, Michael Kerrisk
+ New man page documenting posix_spawn(3) and posix_spawnp(3)
+
+readdir.3
+ Michael Kerrisk [Florian Weimer]
+ Split readdir_r() content into separate page
+ As suggested by Florian Weimer:
+
+ It may make sense to move this documentation to a separate
+ manual page, specific to readdir_r. This will keep the
+ readdir() documentation nice and crisp. Most programmers
+ will never have to consult all these details.
+ Michael Kerrisk
+ Near complete restructuring of the page and add some further details
+ Michael Kerrisk [Florian Weimer, Rich Felker, Paul Eggert]
+ Add a lot more detail on portable use of the 'd_name' field
+
+readdir_r.3
+ Michael Kerrisk [Florian Weimer]
+ New page created after split of readdir(3).
+ Michael Kerrisk [Florian Weimer]
+ Explain why readdir_r() is deprecated and readdir() is preferred
+ Michael Kerrisk [Florian Weimer]
+ Remove misleading code example using pathconf()
+
+lirc.4
+ Alec Leamas
+ New page documenting lirc device driver
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+adjtimex.2
+ Michael Kerrisk
+ Document ntp_adjtime(3)
+
+epoll_ctl.2
+ Michael Kerrisk [Jason Baron]
+ Document EPOLLEXCLUSIVE
+
+madvise.2
+ Minchan Kim [Michael Kerrisk]
+ Document MADV_FREE
+ Document the MADV_FREE flag added to madvise() in Linux 4.5.
+
+proc.5
+ Michael Kerrisk
+ Document CmaTotal and CmaFree fields of /proc/meminfo
+ Michael Kerrisk
+ Document additional /proc/meminfo fields
+ Document DirectMap4k, DirectMap4M, DirectMap2M, DirectMap1G
+ Michael Kerrisk
+ Document MemAvailable /proc/meminfo field
+ Michael Kerrisk
+ Document inotify /proc/PID/fdinfo entries
+ Michael Kerrisk
+ Document fanotify /proc/PID/fdinfo entries
+ Michael Kerrisk
+ Add some kernel version numbers for /proc/PID/fdinfo entries
+ Michael Kerrisk [Patrick Donnelly]
+ /proc/PID/fdinfo displays the setting of the close-on-exec flag
+ Note also the pre-3.1 bug in the display of this info.
+
+socket.7
+ Craig Gallek [Michael Kerrisk, Vincent Bernat]
+ Document some BPF-related socket options
+ Document the behavior and the first kernel version for each of the
+ following socket options:
+
+ SO_ATTACH_FILTER
+ SO_ATTACH_BPF
+ SO_ATTACH_REUSEPORT_CBPF
+ SO_ATTACH_REUSEPORT_EBPF
+ SO_DETACH_FILTER
+ SO_DETACH_BPF
+ SO_LOCK_FILTER
+
+
+New and changed links
+---------------------
+
+isalpha_l.3
+ Michael Kerrisk
+ New link to isalpha.3
+
+longjmp.3
+ Michael Kerrisk
+ Replace page with link to setjmp(3), which now incorporates longjmp()
+
+ntp_adjtime.3
+ Michael Kerrisk
+ New link to adjtimex(2)
+
+ntp_gettimex.3
+ Michael Kerrisk
+ New link to ntp_gettime.3
+
+open_wmemstream.3
+ Michael Kerrisk
+ Update link to point to new open_memstream(2) page
+
+posix_spawnp.3
+ Michael Kerrisk
+ New link to new posix_spawn.3 page
+
+siglongjmp.3
+ Michael Kerrisk
+ Rewire link to point to setjmp(3)
+
+strerror_l.3
+ Michael Kerrisk
+ New link to strerror.3
+ Fix missing link
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Update FTM requirements (_DEFAULT_SOURCE)
+ Michael Kerrisk
+ Update feature test macro requirements
+ Update to use _DEFAULT_SOURCE, and also changes brought by
+ glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.
+
+Various pages
+ Michael Kerrisk
+ Simplify FTM requirements
+ Looking at <features.h> (or feature_test_macros(7)), one can
+ see that when _XOPEN_SOURCE is defined with the value 700
+ (or greater), then _POSIX_C_SOURCE is defined with the value
+ 200809L (or greater). Therefore, terms in the man pages such as
+
+ _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
+
+ can be simplified to:
+
+ _POSIX_C_SOURCE\ >=\ 200809L
+
+Various pages
+ Michael Kerrisk
+ Simplify FTM requirements
+ Looking at <features.h> (or feature_test_macros(7)), one can
+ see that when _XOPEN_SOURCE is defined with the value 600
+ (or greater), then _POSIX_C_SOURCE is defined with the value
+ 200112L (or greater). Therefore, terms in the man pages such as
+
+ _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
+
+ can be simplified to:
+
+ _POSIX_C_SOURCE\ >=\ 200112L
+
+Various pages
+ Michael Kerrisk
+ Simplify FTM requirements
+ _XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
+ requirements in various pages.
+
+Various pages
+ Michael Kerrisk
+ Remove "or 'cc -std=c99'" from SYNOPSIS
+ Under the FTM requirements all of these pages document the
+ requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
+ documents that "cc -std=c99" produces the same effect as defining
+ _ISOC99_SOURCE. So, all of these pages don't additionally need
+ to specify "or 'cc -std=c99'" under the FTM requirements
+ in the SYNOPSIS. Removing that redundant text also simplifies
+ the SYNOPSIS a little.
+
+Various pages
+ Michael Kerrisk
+ Simplify FTM requirements
+ Looking at <features.h> (or feature_test_macros(7)), one can
+ see that when _XOPEN_SOURCE is defined with the value 600
+ (or greater), then _POSIX_C_SOURCE is defined with the value
+ 200112L (or greater). Therefore, terms in the man pages such as
+
+ _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
+
+ can be simplified to:
+
+ _POSIX_C_SOURCE\ >=\ 200112L
+
+Various pages
+ Michael Kerrisk
+ Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
+ _XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
+ subsequent standards). _XOPEN_SOURCE >= 500 produces the same
+ effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
+ the SYNOPSIS of various ages that contain:
+
+ _XOPEN_SOURCE\ >=\ 500 ||
+ _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+
+ to just:
+
+ _XOPEN_SOURCE\ >=\ 500
+
+ This has the following benefits:
+
+ a) Simplifying the SYNOPSIS by removing ancient
+ historical information.
+
+ b) Preventing users from being misled into using
+ _XOPEN_SOURCE_EXTENDED in new source code.
+
+Various pages
+ Michael Kerrisk
+ Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
+ _POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
+ obsolete by _POSIX_C_SOURCE. Retaining mention of it
+ in the feature test macro requirements section of the
+ SYNOPSIS doesn't contain important information, and may
+ mislead readers into actually trying to use this macro.
+ A few mentions of it are maintained in a some pages where
+ defining _POSIX_SOURCE inhibits some behavior.
+
+Various sockets-related pages
+ Michael Kerrisk [Carlos O'Donell]
+ Use consistent argument/variable names for socket addresses and lengths
+ As noted by Carlos, there's quite a bit of inconsistency across
+ pages. Use 'addr' and 'addrlen' consistently in variables and
+ function arguments.
+
+Various pages
+ Michael Kerrisk
+ Wording fix: "current file offset" ==> "file offset"
+ "File offset" is the preferred POSIX terminology.
+
+Various pages
+ Michael Kerrisk
+ Word "descriptor" more precisely
+ Use either "file descriptor" or "message queue descriptor".
+
+Various pages
+ Michael Kerrisk
+ ERRORS: add reference to signal(7) in description of EINTR
+
+
+Changes to individual pages
+---------------------------
+
+locale.1
+ Marko Myllynen
+ Add "locale -c charmap" as an example
+ Addresses https://bugzilla.kernel.org/show_bug.cgi?id=104511.
+
+localedef.1
+ Marko Myllynen
+ Add hint on purpose of --no-archive
+ Indicate why using --no-archive might be a good idea. The issue
+ is that if you create a custom locale with localedef(1) and put
+ it to the locale archive then during the next glibc upgrade the
+ locale archive is updated as well and your custom locale is gone.)
+
+accept.2
+ Michael Kerrisk
+ ERRORS: improve description for EBADF
+
+adjtimex.2
+ Michael Kerrisk [John Stultz]
+ Various improvements after feedback from John Stultz
+ Michael Kerrisk
+ Remove FTM requirements
+ It seems that adjtimex() never needed _BSD_SOURCE (and my
+ earlier commit 5918743bc8b02b was simply a blunder).
+ Michael Kerrisk
+ Split EINVAL error cases
+ Michael Kerrisk
+ Note treatment of out-of-range buf.offset
+ Michael Kerrisk
+ Don't refer reader to adjtime(3)
+ Probably, it's not wise to suggest adjtime(3) as the more
+ portable API. Rather, ntp_adjtime(3) should be used.
+ Michael Kerrisk [Naresh Kamboju]
+ Update details of buf.offset EINVAL error
+ Michael Kerrisk
+ SEE ALSO: add ntp_gettime(3)
+ Michael Kerrisk
+ Improve description of some PPS timex fields
+ Michael Kerrisk
+ Add ATTRIBUTES section
+ William Preston [Petr Gajdos]
+ Update a detail in adjtimex return value description
+ Michael Kerrisk
+ Note range constraints and clamping for ADJ_FREQUENCY
+
+bdflush.2
+ Michael Kerrisk
+ Note that glibc support for this system call went away in version 2.23
+
+bind.2
+ Michael Kerrisk
+ Improve description of ENOENT error
+
+bpf.2
+ Michael Kerrisk
+ Document close-on-exec semantics
+ The close-on-exec file descriptor flag is automatically enabled
+ for FDs returned by bpf().
+
+chmod.2
+ Michael Kerrisk
+ Clarify terminology (file mode versus file permission bits)
+
+chown.2
+ Michael Kerrisk
+ ERRORS: improve EBADF description
+
+clone.2
+unshare.2
+ Michael Kerrisk
+ Remove mention of _BSD_SOURCE and _SVID_SOURCE
+ The right way to expose declarations for these Linux-specific
+ system calls was always _GNU_SOURCE. Mentioning the historical
+ use of _BSD_SOURCE and _SVID_SOURCE just clouds the issue.
+
+connect.2
+ Michael Kerrisk
+ ERRORS: improve EBADF description
+
+create_module.2
+ Michael Kerrisk
+ Glibc 2.23 removed last vestiges of support for this system call
+
+delete_module.2
+ Michael Kerrisk
+ Glibc 2.23 removed last vestiges of support for this system call
+
+epoll_ctl.2
+ Michael Kerrisk
+ Document ELOOP error for circular monitoring loops
+
+eventfd.2
+ Michael Kerrisk
+ Note that eventfd info is available in /proc/PID/fdinfo
+
+execve.2
+ Michael Kerrisk [Krzysztof Adamski]
+ Add EPERM error for capabilities check of capability-dumb binaries
+ Michael Kerrisk
+ Add reference to ld-linux.so(8)
+ Michael Kerrisk
+ SEE ALSO: add system(3)
+
+fanotify_init.2
+ Michael Kerrisk
+ Note kernel version that allowed O_CLOEXEC for event_f_flags
+
+fcntl.2
+flock.2
+ Michael Kerrisk
+ SEE ALSO: add lslocks(8)
+
+fcntl.2
+ Michael Kerrisk [Jason Vas Dias]
+ Rework description of F_SETOWN
+ As suggested by Jason, make it clearer that I/O signalling
+ requires the use of both F_SETOWN and O_ASYNC. While we're at,
+ make a few other cleanups to the text.
+ Michael Kerrisk
+ Remove mention of _BSD_SOURCE to get definition of F_SETOWN/F_GETOWN
+ This usage went away in glibc 2.20, and the simplest remedy
+ is just to omit mention of it.
+
+futex.2
+ Michael Kerrisk
+ FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT
+
+get_kernel_syms.2
+ Michael Kerrisk
+ Note that glibc does not support this system call
+
+init_module.2
+ Michael Kerrisk
+ Glibc 2.23 removed last vestiges of support for this system call
+
+ioctl_list.2
+ Heinrich Schuchardt
+ Include uapi/linux/wireless.h
+ Add the list of wireless IOCTLs.
+ Heinrich Schuchardt
+ Path to sockios.h
+ sockios.h is now in include/uapi
+ Heinrich Schuchardt
+ Add reference to netdevice.7
+ netdevice.7 describes most of the IOCTLs of sockios.h
+ Heinrich Schuchardt
+ Transfer structure (wireless.h IOCTLs)
+ The sole parameter to be passed to the wireless.h IOCTLs is
+ of type struct iwreq *.
+
+ioperm.2
+ Michael Kerrisk [Alex Henrie]
+ ioperm.2: Permissions are inherited across fork(2)
+ See https://bugzilla.kernel.org/show_bug.cgi?id=99911
+
+iopl.2
+ Michael Kerrisk [Alex Henrie]
+ Permissions are not inherited across fork(2) or preserved on execve(2)
+ See https://bugzilla.kernel.org/show_bug.cgi?id=99901
+
+lseek.2
+ Michael Kerrisk
+ FUSE now supports SEEK_HOLE and SEEK_DATA
+ Michael Kerrisk
+ NFS supports SEEK_HOLE and SEEK_DATA
+
+ Michael Kerrisk
+ SEE ALSO: add open(2)
+
+madvise.2
+ Michael Kerrisk
+ Clarify MADV_HWPOISON wording to say that it applies to a page range
+
+mknod.2
+ Michael Kerrisk
+ SEE ALSO: add mknod(1)
+
+mount.2
+ Michael Kerrisk
+ SEE ALSO: add findmnt(8)
+
+open.2
+ Michael Kerrisk
+ NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo
+ Mark Post [Petr Gajdos]
+ O_TMPFILE support is now provided bt Btrfs
+
+pipe.2
+ Michael Kerrisk [Eric Blake]
+ Note treatment of 'pipefd' on error
+
+poll.2
+ Michael Kerrisk [Josh Triplett]
+ Document spurious EAGAIN error that can occur on other systems
+ Light reworking of text proposed by Josh Triplett.
+
+readlink.2
+ Michael Kerrisk
+ Clarify EINVAL error description
+
+recv.2
+ Heinrich Schuchardt
+ Equivalence to read()
+ Describe the recv(2)-read(2) and the recvfrom(2)-recv(2)
+ equivalences for zero-valued arguments.
+ Michael Kerrisk
+ MSG_WAITALL has no effect for datagram sockets
+
+recv.2
+cmsg.3
+ Nikola Forró
+ Fix type of cmsg_len member of cmsghdr structure
+ The type shown for cmsg_len member of cmsghdr structure is socklen_t,
+ but the actual type used by glibc and the kernel is size_t.
+ The information was obtained from glibc source code:
+ http://bit.ly/21m1RMp
+ Michael Kerrisk
+ Note that cmsg_len is typed as socklen_t in POSIX.1
+
+
+sched_setaffinity.2
+ Michael Kerrisk [Florian Weimer, Florian Weimer]
+ Warn that CPU_ALLOC() may allocate a slightly CPU set than requested
+ Michael Kerrisk [Florian Weimer]
+ Add reference to CPU_ALLOC(3)
+
+sched_setattr.2
+ Michael Kerrisk [Akihiro Suda]
+ EPERM depends on affinity mask of target thread, not calling thread
+
+select.2
+ Michael Kerrisk [Josh Triplett]
+ Document spurious EAGAIN error that can occur on other systems
+ Light reworking of text proposed by Josh Triplett.
+ Nikos Mavrogiannopoulos
+ Mention the 'fd_set' size limitation early and refer to poll(2)
+ Change this because of the serious limitation of select()
+ imposing a limit on the range of file descriptors that can
+ be monitored. This is currently mentioned too late in the
+ documentation (in the NOTES section). The man page should
+ warn early and refer to poll(2) as soon as possible.
+ Michael Kerrisk
+ Add details on the glibc fixed-size fd_set limitation
+ No modern application should use select() on Linux.
+
+select_tut.2
+ Michael Kerrisk
+ Some readability fixes to example program
+ Michael Kerrisk
+ Better variable names in example program
+ Michael Kerrisk
+ Simplify 'if' logic in example program
+ Michael Kerrisk
+ Use correct type (socklen_t) for addrlen
+
+semctl.2
+ Michael Kerrisk [Davidlohr Bueso, Manfred Spraul, Philip Semanchuk]
+ NOTES: note when 'sempid' is set on various implementations
+ See https://bugzilla.kernel.org/show_bug.cgi?id=112271 and
+ http://thread.gmane.org/gmane.linux.kernel/2162754/
+ Subject: [PATCH] Don't set sempid in semctl syscall.
+ Date: 2016-02-26 12:21:38 GMT
+
+semop.2
+ Michael Kerrisk
+ Tweak comment describing 'sempid'
+
+sendfile.2
+ Askar Safin
+ Fix incorrect description in text referring to splice(2)
+ Michael Kerrisk
+ SEE ALSO: add copy_file_range(2)
+
+setpgid.2
+ Michael Kerrisk
+ Correct/simplify FTM requirements for BSD setpgrp() and getpgrp()
+
+signalfd.2
+ Michael Kerrisk
+ Note that signalfd info is available in /proc/PID/fdinfo
+
+sigprocmask.2
+ Michael Kerrisk [Mike Frysinger]
+ Explicitly refer the reader to sigsetops(3)
+ This man page did not make it obvious which functions
+ should be used for manipulating signals sets, nor where
+ those functions were documented.
+
+socketpair.2
+ Michael Kerrisk [Eric Blake]
+ Note treatment of 'sv' on error
+
+splice.2
+ Askar Safin
+ Improve description of 0 return value.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=90911
+
+statfs.2
+ Michael Kerrisk [Jakub Wilk]
+ Use consistent case for hex constants
+
+sync.2
+ Christoph Hellwig
+ Clarify description and document the Linux data integrity guarantees
+
+syscall.2
+ Mike Frysinger
+ Add more architectures and improve error documentation
+ Move the error register documentation into the main table rather
+ than listing them in sentences after the fact.
+
+ Add sparc error return details.
+
+ Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/
+ tile/xtensa.
+
+syscalls.2
+ Michael Kerrisk
+ Add copy_file_range(2)
+
+times.2
+ Kondo, Naoya
+ Fix an incorrect description in NOTES
+ The text has an incorrect description in NOTES, it says
+ that (2^32/HZ) - 300 is about 429 million. It is correct
+ only if HZ=10 which does not look common today. So just
+ removing "(i.e., about 429 million)" is good enough.
+
+truncate.2
+ Michael Kerrisk
+ SEE ALSO: add truncate(1)
+
+uselib.2
+ Michael Kerrisk
+ Mention CONFIG_USELIB
+ Michael Kerrisk
+ Note that glibc does not support this (obsolete) system call
+
+wait.2
+wait4.2
+ Michael Kerrisk
+ Rename the "status" argument to "wstatus"
+ The fact that exit(3)/_exit(2) has an argument called
+ "status" and the same name is used in the arguments to the
+ wait*() calls can a little too easily lead the user into
+ thinking that the two arguments hold the same information,
+ when of course they don't. So, use a different name
+ for the argument of the wait*() functions, to reduce
+ the chances of such confusion.
+
+backtrace.3
+ Michael Kerrisk [Martin Gebert]
+ Small fixes to example program
+
+clearenv.3
+ Michael Kerrisk [Matt Zimmerman]
+ Clarify the use and effect of clearenv()
+ See http://bugs.debian.org/679323
+ Michael Kerrisk
+ Variables can be added to the environment after calling clearenv()
+
+clog10.3
+ Michael Kerrisk
+ Show an alternative equivalence for clog10()
+ Michael Kerrisk
+ Update CONFORMING TO
+ Fix grammar error and add C11.
+
+dl_iterate_phdr.3
+ Michael Kerrisk [Paul Pluzhnikov]
+ Describe 'struct dl_phdr_info' fields added in glibc 2.4
+ See https://bugzilla.kernel.org/show_bug.cgi?id=103011
+ Michael Kerrisk [Simon Que]
+ Note that first object visited by 'callback' is the main program
+ See https://bugzilla.kernel.org/show_bug.cgi?id=94141
+
+errno.3
+ Michael Kerrisk
+ Add some explanation of ENOENT error
+
+exec.3
+ Michael Kerrisk
+ SEE ALSO: add system(3)
+
+exp.3
+ Michael Kerrisk [Joachim Wuttke]
+ SEE ALSO: add expm1(3)
+
+fopen.3
+ Michael Kerrisk
+ SEE ALSO: add open_memstream(3)
+
+fts.3
+ Michael Kerrisk
+ BUGS: glibc-2.23 now has LFS support for the fts functions
+
+gamma.3
+ Michael Kerrisk [Alan Cox]
+ gamma() was documented in SVID 2
+
+getaddrinfo.3
+ Michael Kerrisk [Andreas Schwab, Orion Poplawski]
+ Update FTM requirements for glibc 2.22
+ Since glibc 2.22 getaddrinfo() etc. are only declared for
+ POSIX.1-2001 or later.
+
+getcwd.3
+ Michael Kerrisk
+ SEE ALSO: add pwd(1)
+
+opendir.3
+ Michael Kerrisk
+ Help the reader by explicitly mentioning the use of readdir(3)
+
+perror.3
+ Michael Kerrisk
+ Suggest use of strerror(3) in place of deprecated 'sys_errlist'
+
+posix_fallocate.3
+ Jérémie Galarneau
+ ERRORS: add EINTR
+ The glibc implementation of posix_fallocate(), which calls
+ fallocate(), may be interrupted. The fallocate() emulation
+ also makes use of pread()/pwrite(), which may also be
+ interrupted.
+
+posix_memalign.3
+ Michael Kerrisk [Eric Blake]
+ Note posix_memalign()'s treatment of 'memptr' on error
+
+pthread_setaffinity_np.3
+ Michael Kerrisk
+ SEE ALSO: add CPU_SET(3)
+
+queue.3
+ Dr. Tobias Quathamer
+ Remove double CONFORMING TO section
+
+rcmd.3
+ Nikola Forró
+ Add missing condition concerning .rhosts file
+ The list of conditions determining if iruserok() and ruserok()
+ functions automatically fail is incomplete. According to glibc
+ source code, the functions also fail if the .rhosts file
+ is hard linked anywhere.
+
+setbuf.3
+ Michael Kerrisk
+ SEE ALSO: add stdbuf(1)
+
+setjmp.3
+ Michael Kerrisk
+ Rewrite and merge longjmp()/siglongjmp() discussion into this page
+ The discussion of nonlocal gotos is much easier to read if
+ setjmp() and longjmp() are discussed in the same page. While
+ we're at it, rework almost the entire text and add several
+ more details.
+ Michael Kerrisk
+ Note the interactions of longjmp() and non-async-signal-safe functions
+ POSIX.1-2008 TC2 adds explicit text on this point.
+ See http://austingroupbugs.net/view.php?id=516#c1195
+ Michael Kerrisk
+ Explain why nonlocal gotos make code harder to maintain
+ Michael Kerrisk
+ Reword warning on longjmp() to function that has already returned
+ Michael Kerrisk
+ Remove reference to obsolete _XOPEN_SOURCE_EXTENDED
+
+sleep.3
+ Michael Kerrisk
+ SEE ALSO: add sleep(1)
+
+strftime.3
+ Michael Kerrisk [Jeremy Harris]
+ Note which 'tm' fields are used to calculate each output string
+ See https://bugzilla.redhat.com/show_bug.cgi?id=1162218
+
+strlen.3
+ Michael Kerrisk [Alan Aversa]
+ CONFORMING TO: add C11
+
+system.3
+ Michael Kerrisk
+ SEE ALSO: add execve(2)
+
+termios.3
+ Dr. Tobias Quathamer
+ Document line length in canonical mode
+ See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673
+ See https://bugs.debian.org/797479
+ Michael Kerrisk
+ SEE ALSO: add tty(1)
+ Michael Kerrisk [Peter Hurley]
+ Further improvements to recent tweaks of canonical mode 4096 char limit
+
+timegm.3
+ Michael Kerrisk [Stephen Hurd, Mats Wichmann]
+ Remove sample implementation of timegm()
+ Stephen and Mats both question the wisdom of showing a portable
+ *non-thread-safe* implementation of timegm(), and I find it
+ hard to disagree. So, remove this code.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=103701
+ Michael Kerrisk
+ Expand DESCRIPTION a little
+
+st4.4
+ Dr. Tobias Quathamer
+ Remove spurious copyright section
+
+tty_ioctl.4
+ Michael Kerrisk
+ SEE ALSO: add ldattach(1)
+
+elf.5
+ Michael Kerrisk [Gabriel Corona, Mike Frysinger]
+ Fix description of STV_PROTECTED
+ Michael Kerrisk
+ Improve description of STV_DEFAULT
+ Michael Kerrisk
+ Improve description of STV_HIDDEN
+ Chris Pick
+ Remove erroneous, duplicate SHN_* section
+ Michael Kerrisk [Chris Pick]
+ Reword discussion of range values a little
+
+gai.conf.5
+ Michael Kerrisk
+ Add VERSIONS section
+
+group.5
+ Michael Kerrisk
+ SEE ALSO: add groups(2)
+ SEE ALSO: add gpasswd(1)
+ SEE ALSO: add sg(1)
+ SE ALSO: add gshadow(5)
+ SEE ALSO: add chgrp(1)
+
+locale.5
+ Marko Myllynen [Mike Frysinger]
+ tel + fax are deprecated
+
+nsswitch.conf.5
+ Nikola Forró
+ Update NSS compatibility mode description
+
+utmp.5
+ Michael Kerrisk
+ SEE ALSO: add lslogins(1)
+
+aio.7
+ Andreas Gruenbacher
+ Improve example
+ When aio_sigevent.sigev_notify is set to SIGEV_SIGNAL, signal
+ handlers called for asynchronous I/O operations will have
+ si->si_code set to SI_ASYNCIO. Check to make sure that
+ si->si_value.sival_ptr is defined.
+
+capabilities.7
+ Michael Kerrisk
+ Explain safety check for capability-dumb binaries
+ Michael Kerrisk
+ SEE ALSO: add sg(1), su(1)
+ SEE ALSO: add id(1), group(5), passwd(5)
+
+credentials.7
+ Michael Kerrisk
+ SEE ALSO: add groups(2)
+
+environ.7
+ Michael Kerrisk
+ Describe the Bourne "NAME=value command" syntax
+ Michael Kerrisk
+ Add some details describing hos shell's environment is initialized
+ Michael Kerrisk
+ Note that child of fork(2) inherits copy of parent's environment
+ Michael Kerrisk
+ SEE ALSO: add pam_env(3)
+
+epoll.7
+ Michael Kerrisk
+ Mention that epoll info is available via /proc/PID/fdinfo
+
+fanotify.7
+ Michael Kerrisk
+ Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries
+
+
+feature_test_macros.7
+ Michael Kerrisk
+ Add a summary of some FTM key points
+ Michael Kerrisk
+ Give an early hint about some macros being defined by default
+ Michael Kerrisk
+ Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED
+ Emphasize that defining _XOPEN_SOURCE >=500 produces same
+ effects as defining _XOPEN_SOURCE_EXTENDED.
+ Michael Kerrisk
+ Note that man pages don't mention _XOPEN_SOURCE_EXTENDED
+ As per previous commit, mention of _XOPEN_SOURCE_EXTENDED
+ has generally been removed from the man pages.
+ Michael Kerrisk
+ Note effects of "cc -std=c99" and "cc -std=c11"
+ Michael Kerrisk
+ Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details
+ Michael Kerrisk
+ Clarify that _XOPEN_SOURCE_EXTENDED is obsolete
+ Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified
+ in the standard.
+
+inotify.7
+ Michael Kerrisk
+ Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries
+
+ip.7
+ Eric Dumazet
+ Document IP_BIND_ADDRESS_NO_PORT socket option
+
+mq_overview.7
+ Michael Kerrisk
+ Note that the close-on-exec flag is automatically set on MQ descriptors
+
+namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add lsns(1)
+ lsns(1) was recently added in util-linux, probably to appear
+ in next release (2.28?).
+
+pipe.7
+ Michael Kerrisk [Jason Vas Dias]
+ Clarify that I/O signalling requires use of both F_SETOWN and O_ASYNC
+ Michael Kerrisk
+ SEE ALSO: add mkfifo(1)
+
+signal.7
+ Michael Kerrisk
+ Note the interactions of longjmp() and non-async-signal-safe functions
+ See http://austingroupbugs.net/view.php?id=516#c1195.
+
+socket.7
+ Michael Kerrisk
+ SEE ALSO: add pcap(3)
+ SEE ALSO: add wireshark(1) and tcpdump(8)
+
+standards.7
+ Michael Kerrisk
+ Add POSIX.1-2008 TC2 (POSIX.1-2016)
+
+svipc.7
+ Michael Kerrisk
+ Tweak description of 'sempid'
+ Michael Kerrisk
+ SEE ALSO: add lsipc(1)
+
+symlink.7
+ Michael Kerrisk [Zefram]
+ Some "magic" symlinks have permissions other than 0777
+ See https://bugs.debian.org/743525
+
+time.7
+ Michael Kerrisk
+ SEE ALSO: add timeout(1)
+ SEE ALSO: add ntp_adjtime(3) and ntp_gettime(3)
+
+unicode.7
+ Dr. Tobias Quathamer
+ Document private use areas
+ See https://bugs.debian.org/285444
+
+unix.7
+ Heinrich Schuchardt
+ Add example
+ A complete example demonstrating the usage of sockets for local
+ interprocess communication is added.
+ Michael Kerrisk
+ Introduce term "sequenced-packet" for SOCK_SEQPACKET
+ Michael Kerrisk
+ Some wording improvements
+
+
+==================== Changes in man-pages-4.06 ====================
+
+Released: 2016-05-09, Oslo
+
+
+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:
+
+Alexander Miller <alex.miller@gmx.de>
+Alon Bar-Lev <alon.barlev@gmail.com>
+Benjamin Poirier <bpoirier@suse.com>
+Christoph Hellwig <hch@lst.de>
+Colin Ian King <colin.king@canonical.com>
+Dr. Tobias Quathamer <toddy@debian.org>
+Ed Avis <eda@waniasset.com>
+Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jakub Wilk <jwilk@jwilk.net>
+Jordan Birks <birkses@hotmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Nikola Forró <nforro@redhat.com>
+Rasmus Villemoes <linux@rasmusvillemoes.dk>
+Serge E. Hallyn <serge@hallyn.com>
+Serge Hallyn <serge.hallyn@ubuntu.com>
+Valery Reznic <valery_reznic@yahoo.com>
+Zubair Lutfullah Kakakhel <Zubair.Kakakhel@imgtec.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+cgroups.7
+ Serge Hallyn, Michael Kerrisk
+ New page documenting cgroups
+
+cgroup_namespaces.7
+ Michael Kerrisk [Serge Hallyn]
+ New page describing cgroup namespaces
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Michael Kerrisk
+ Document CLONE_NEWCGROUP
+
+readv.2
+ Christoph Hellwig
+ Document preadv2() and pwritev2()
+setns.2
+ Michael Kerrisk
+ Document CLONE_NEWCGROUP
+
+unshare.2
+ Michael Kerrisk
+ Document CLONE_NEWCGROUP
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Michael Kerrisk [Rasmus Villemoes]
+ Note that coarse clocks need architecture and VDSO support
+
+clone.2
+fork.2
+ Nikola Forró
+ Document ERESTARTNOINTR error code
+
+clone.2
+ Michael Kerrisk [Colin Ian King]
+ ERRORS: add EINVAL for improperly aligned 'child_stack' value
+
+execve.2
+ Michael Kerrisk [Valery Reznic]
+ Since Linux 2.6.28, recursive script interpretation is supported
+
+fcntl.2
+ Michael Kerrisk
+ Note that mandatory locking is now governed by a configuration option
+
+fsync.2
+ Michael Kerrisk [Georg Sauthoff]
+ Give some examples of files where sync can fail with EINVAL
+
+getrlimit.2
+ Michael Kerrisk
+ SEE ALSO: add cgroups(7)
+
+ioctl_fat.2
+ Heinrich Schuchardt
+ Use %04x to print volume ID
+ Leading zeroes should be used when display a FAT volume ID.
+
+ioprio_set.2
+ Michael Kerrisk
+ SEE ALSO: add cgroups(7)
+
+lseek.2
+ Michael Kerrisk
+ Note that 'off_t' is an integer data type defined by POSIX
+
+memfd_create.2
+ Michael Kerrisk
+ Note that memfd_create() does not have a glibc wrapper
+
+mount.2
+ Michael Kerrisk
+ MS_MANDLOCK requires CAP_SYS_ADMIN (since Linux 4.5)
+
+quotactl.2
+ Michael Kerrisk
+ Document Q_GETNEXTQUOTA and Q_XGETNEXTQUOTA
+ Michael Kerrisk
+ Rework/reorder ERRORS list
+ Make into a single alphabetically ordered list
+ Michael Kerrisk
+ Note kernel version that removed Q_GETSTATS
+ Michael Kerrisk
+ Add kernel version for G_GETINFO, Q_SETINFO, and Q_GETFMT
+
+readv.2
+ Michael Kerrisk
+ Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
+
+semctl.2
+ Michael Kerrisk
+ From kernel 4.6, Linux now updates 'sempid' on SETALL operations
+
+sigaction.2
+ Michael Kerrisk
+ Document SEGV_BNDERR
+ Michael Kerrisk
+ Document SEGV_PKUERR
+
+syscalls.2
+ Michael Kerrisk
+ Add preadv2() and pwritev2()
+
+write.2
+ Michael Kerrisk
+ Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
+
+makedev.3
+ Mike Frysinger
+ Use <sys/sysmacros.h> in SYNOPSIS
+ Defining these functions via <sys/types.h> causes problems for
+ some folk. As noted by Zack Wein:
+
+ libstdc++ force-enables _GNU_SOURCE, which means people
+ writing in C++ _can't_ avoid these nonstandard macros by
+ using a strict conformance mode.
+
+ Since glibc has basically always used <sys/sysmacros.h>,
+ update the docs to have people include that instead.
+ Michael Kerrisk
+ NOTES: mention that <sys/types.h> may also define these macros
+
+popen.3
+ Nikola Forró
+ RETURN VALUE: describe successful case
+ Reference:
+ http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
+ http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html
+
+strtod.3
+ Michael Kerrisk [Ed Avis]
+ Improve a detail in RETURN VALUE
+
+core.5
+ Michael Kerrisk
+ Document /proc/sys/kernel/core_pipe_limit
+
+locale.5
+ Marko Myllynen
+ Adjust LC_IDENTIFICATION / abbreviation
+ 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
+ Update LC_ADDRESS after glibc change
+ This patch updates locale.5 to match the recent glibc change
+ in commit a837257199ffab76237385b830cc7b6179fc2f18
+ Marko Myllynen
+ Complete LC_COLLATE
+ Here's the first attempt to (almost) complete the locale.5 manual
+ page by documenting all (but perhaps one) of the missing
+ LC_COLLATE keywords.
+ Mike Frysinger
+ country_car: Add a better description
+
+
+nsswitch.conf.5
+ Marko Myllynen
+ Document group merging
+ Document the recently merged glibc group merge support.
+ Glibc commit ced8f8933673f4efda1d666d26a1a949602035ed
+ https://sourceware.org/glibc/wiki/Proposals/GroupMerging
+
+proc.5
+ Michael Kerrisk
+ Move /proc/PID/cgroup discussion to cgroups(7) page
+ Michael Kerrisk
+ Add some background on why /proc/PID/mountinfo was added
+ Michael Kerrisk
+ Improve description of /proc/PID/mountinfo 'root' field
+ Michael Kerrisk
+ Add pointer to cgroups(7) for documentation of /proc/cgroups
+ Michael Kerrisk
+ Add reference to core(5) for info on /proc/sys/kernel/core_pipe_limit
+
+cpuset.7
+ Michael Kerrisk
+ SEE ALSO: add cgroups(7)
+
+ip.7
+ Benjamin Poirier
+ Fix incorrect sockopt name
+ "IP_LEAVE_GROUP" does not exist. It was perhaps a confusion with
+ MCAST_LEAVE_GROUP. Change the text to IP_DROP_MEMBERSHIP which has
+ the same function as MCAST_LEAVE_GROUP and is documented in the
+ ip.7 man page.
+
+ Reference:
+ Linux kernel net/ipv4/ip_sockglue.c do_ip_setsockopt()
+
+namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add cgroups(7), cgroup_namespaces(7)
+
+vdso.7
+ Zubair Lutfullah Kakakhel [Mike Frysinger]
+ Update for MIPS
+ Document the symbols exported by the MIPS VDSO.
+ VDSO support was added from kernel 4.4 onwards.
+
+ See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso
+ Michael Kerrisk [Rasmus Villemoes]
+ The __kernel_clock_* interfaces don't support *_COARSE clocks on PowerPC
+
+ld.so.8
+ Michael Kerrisk [Alon Bar-Lev]
+ Document use of $ORIGIN, $LIB, and $PLATFORM in environment variables
+ These strings are meaningful in LD_LIBRARY_PATH and LD_PRELOAD.
+
+
+==================== Changes in man-pages-4.07 ====================
+
+Released: 2016-07-17, Ulm
+
+
+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:
+
+Alec Leamas <leamas.alec@gmail.com>
+Andrey Vagin <avagin@openvz.org>
+Andy Lutomirski <luto@amacapital.net>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Chris Gassib <position0x45@hotmail.com>
+Christoph Hellwig <hch@lst.de>
+Darren Hart <dvhart@infradead.org>
+Darrick J. Wong <darrick.wong@oracle.com>
+Élie Bouttier <elie@bouttier.eu>
+Eric Biggers <ebiggers3@gmail.com>
+Eric W. Biederman <ebiederm@xmission.com>
+Florian Weimer <fweimer@redhat.com>
+Håkon Sandsmark <hsandsma@cisco.com>
+Iustin Pop <iustin@k1024.org>
+Jacob Willoughby <jacob@spacemonkey.com>
+Jakub Wilk <jwilk@jwilk.net>
+James H Cownie <james.h.cownie@intel.com>
+Jann Horn <jann@thejh.net>
+John Wiersba <jrw32982@yahoo.com>
+Jörn Engel <joern@purestorage.com>
+Josh Triplett <josh@kernel.org>
+Kai Mäkisara <kai.makisara@kolumbus.fi>
+Kees Cook <keescook@chromium.org>
+Keno Fischer <keno@juliacomputing.com>
+Li Peng <lip@dtdream.com>
+Marko Kevac <marko@kevac.org>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michał Zegan <webczat_200@poczta.onet.pl>
+Miklos Szeredi <mszeredi@redhat.com>
+Mitch Walker <mitch@gearnine.com>
+Neven Sajko <nsajko@gmail.com>
+Nikos Mavrogiannopoulos <nmav@redhat.com>
+Omar Sandoval <osandov@fb.com>
+Ori Avtalion <ori@avtalion.name>
+Rahul Bedarkar <rahulbedarkar89@gmail.com>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+Rob Landley <rob@landley.net>
+Shawn Landden <shawn@churchofgit.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Stephen Smalley <sds@tycho.nsa.gov>
+Szabolcs Nagy <szabolcs.nagy@arm.com>
+Thomas Gleixner <tglx@linutronix.de>
+Tobias Stoeckmann <tobias@stoeckmann.org>
+Tom Callaway <tcallawa@redhat.com>
+Tom Gundersen <teg@jklm.no>
+Vince Weaver <vincent.weaver@maine.edu>
+W. Trevor King <wking@tremily.us>
+"Yuming Ma(马玉明)" <mayuming@le.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+ioctl_fideduperange.2
+ Darrick J. Wong [Christoph Hellwig, Michael Kerrisk]
+ New page documenting the FIDEDUPERANGE ioctl
+ Document the FIDEDUPERANGE ioctl, formerly known as
+ BTRFS_IOC_EXTENT_SAME.
+
+ioctl_ficlonerange.2
+ Darrick J. Wong [Christoph Hellwig, Michael Kerrisk]
+ New page documenting FICLONE and FICLONERANGE ioctls
+ Document the FICLONE and FICLONERANGE ioctls, formerly known as
+ the BTRFS_IOC_CLONE and BTRFS_IOC_CLONE_RANGE ioctls.
+
+nextup.3
+ Michael Kerrisk
+ New page documenting nextup(), nextdown(), and related functions
+
+mount_namespaces.7
+ Michael Kerrisk [Michael Kerrisk]
+ New page describing mount namespaces
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+mount.2
+ Michael Kerrisk
+ Document flags used to set propagation type
+ Document MS_SHARED, MS_PRIVATE, MS_SLAVE, and MS_UNBINDABLE.
+ Michael Kerrisk
+ Document the MS_REC flag
+
+ptrace.2
+ Michael Kerrisk [Kees Cook, Jann Horn, Eric W. Biederman, Stephen Smalley]
+ Document ptrace access modes
+
+proc.5
+ Michael Kerrisk
+ Document /proc/[pid]/timerslack_ns
+ Michael Kerrisk
+ Document /proc/PID/status 'Ngid' field
+ Michael Kerrisk
+ Document /proc/PID/status fields: 'NStgid', 'NSpid', 'NSpgid', 'NSsid'
+ Michael Kerrisk
+ Document /proc/PID/status 'Umask' field
+
+
+New and changed links
+---------------------
+
+preadv2.2
+pwritev2.2
+ Michael Kerrisk
+ New links to readv(2)
+
+nextdown.3
+nextdownf.3
+nextdownl.3
+nextupf.3
+nextupl.3
+ Michael Kerrisk
+ New links to nextup(3)
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ Add a little more detail on why ldd is unsafe with untrusted executables
+ Michael Kerrisk
+ Add more detail on the output of ldd
+
+localedef.1
+ Marko Myllynen
+ Drop --old-style description
+ The glibc upstream decided to drop localedef(1) --old-style
+ option [1] altogether, I think we can do the same with
+ localedef(1), the option hasn't done anything in over 16
+ years and I doubt anyone uses it.
+
+add_key.2
+ Mitch Walker
+ Empty payloads are not allowed in user-defined keys
+
+chroot.2
+ Michael Kerrisk
+ SEE ALSO: add pivot_root(2)
+
+clone.2
+ Michael Kerrisk
+ Add reference to mount_namespaces(7) under CLONE_NEWNS description
+
+fork.2
+ Michael Kerrisk
+ Add ENOMEM error for PID namespace where "init" has died
+
+futex.2
+ Michael Kerrisk
+ Correct an ENOSYS error description
+ Since Linux 4.5, FUTEX_CLOCK_REALTIME is allowed with FUTEX_WAIT.
+ Michael Kerrisk [Darren Hart]
+ Remove crufty text about FUTEX_WAIT_BITSET interpretation of timeout
+ Since Linux 4.5, FUTEX_WAIT also understands
+ FUTEX_CLOCK_REALTIME.
+ Michael Kerrisk [Thomas Gleixner]
+ Explain how to get equivalent of FUTEX_WAIT with an absolute timeout
+ Michael Kerrisk
+ Describe FUTEX_BITSET_MATCH_ANY
+ Describe FUTEX_BITSET_MATCH_ANY and FUTEX_WAIT and FUTEX_WAKE
+ equivalences.
+ Michael Kerrisk
+ Note that at least one bit must be set in mask for BITSET operations
+ At least one bit must be set in the 'val3' mask supplied for the
+ FUTEX_WAIT_BITSET and FUTEX_WAKE_BITSET operations.
+ Michael Kerrisk [Thomas Gleixner, Darren Hart]
+ Fix descriptions of various timeouts
+ Michael Kerrisk
+ Clarify clock default and choices for FUTEX_WAIT
+
+getitimer.2
+ Michael Kerrisk
+ Substantial rewrites to various parts of the page
+ Michael Kerrisk [Tom Callaway]
+ Change license to note that page may be modified
+ The page as originally written carried text that said the page may
+ be freely distributed but made no statement about modification.
+ In the 20+ years since it was first written, the page has in fact
+ seen repeated, sometimes substantial, modifications, and only a
+ small portion of the original text remains. One could I suppose
+ rewrite the last few pieces that remain from the original,
+ but as the largest contributor to the pages existing text,
+ I'm just going to relicense it to explicitly note that
+ modification is permitted. (I presume the failure by the
+ original author to grant permission to modify was simply an
+ oversight; certainly, the large number of people who have
+ changed the page have taken that to be the case.)
+
+ See also https://bugzilla.kernel.org/show_bug.cgi?id=118311
+
+get_mempolicy.2
+ Michael Kerrisk [Jörn Engel]
+ Correct rounding to 'maxnodes' (bits, not bytes)
+ Michael Kerrisk [Jörn Engel]
+ Fix prototype for get_mempolicy()
+ In numaif.h, 'addr' is typed as 'void *'
+
+getpriority.2
+ Michael Kerrisk
+ Make discussion of RLIMIT_NICE more prominent
+ The discussion of RLIMIT_NICE was hidden under the EPERM error,
+ where it was difficult to find. Place some relevant text in
+ DESCRIPTION.
+ Michael Kerrisk
+ Note that getpriority()/setpriority deal with same attribute as nice(2)
+ Michael Kerrisk [Robin Kuzmin]
+ Clarify equivalence between lower nice value and higher priority
+
+get_robust_list.2
+ Michael Kerrisk
+ get_robust_list() is governed by PTRACE_MODE_READ_REALCREDS
+
+ioctl.2
+ Michael Kerrisk
+ SEE ALSO: add ioctl_fideduperange(2) and ioctl_ficlonerange(2)
+
+kcmp.2
+ Michael Kerrisk
+ kcmp() is governed by PTRACE_MODE_READ_REALCREDS
+ Shawn Landden
+ Note about SECURITY_YAMA
+kill.2
+ Michael Kerrisk [John Wiersba]
+ Clarify the meaning if sig==0
+
+lookup_dcookie.2
+ Michael Kerrisk
+ SEE ALSO: add oprofile(1)
+
+mmap.2
+ Michael Kerrisk [Rahul Bedarkar]
+ EXAMPLE: for completeness, add munmap() and close() calls
+
+mount.2
+ Michael Kerrisk
+ Restructure discussion of 'mountflags' into functional groups
+ The existing text makes no differentiation between different
+ "classes" of mount flags. However, certain flags such as
+ MS_REMOUNT, MS_BIND, MS_MOVE, etc. determine the general
+ type of operation that mount() performs. Furthermore, the
+ choice of which class of operation to perform is performed in
+ a certain order, and that order is significant if multiple
+ flags are specified. Restructure and extend the text to
+ reflect these details.
+ Michael Kerrisk
+ Relocate text on multimounting and mount stacking to NOTES
+ The text was somewhat out of place in its previous location;
+ NOTES is a better location.
+ Michael Kerrisk
+ Remove version numbers attached to flags that are modifiable on remount
+ This information was simply bogus. Mea culpa.
+ Michael Kerrisk
+ Refer reader to mount_namespaces(7) for details on propagation types
+ Michael Kerrisk
+ SEE ALSO: s/namespaces(7)/mount_namespaces(7)/
+ Omar Sandoval
+ MS_BIND still ignores mountflags
+ This is clear from the do_mount() function in the kernel as of v4.6.
+ Michael Kerrisk
+ Note the default treatment of ATIME flags during MS_REMOUNT
+ The behavior changed in Linux 3.17.
+ Michael Kerrisk
+ Clarify that MS_MOVE ignores remaining bits in 'mountflags'
+ Michael Kerrisk
+ Note kernel version that added MS_MOVE
+ Michael Kerrisk
+ MS_NOSUID also disables file capabilities
+ Michael Kerrisk
+ Relocate/demote/rework text on MS_MGC_VAL
+ The use of this constant has not been needed for 15 years now.
+ Michael Kerrisk
+ Clarify that 'source' and 'target' are pathnames, and can refer to files
+ Michael Kerrisk
+ Update example list of filesystem types
+ Put more modern examples in; remove many older examples.
+ Michael Kerrisk
+ MS_LAZYTIME and MS_RELATIME can be changed on remount
+ Michael Kerrisk
+ Explicitly note that MS_DIRSYNC setting cannot be changed on remount
+ Michael Kerrisk
+ Move text describing 'data' argument higher up in page
+ In preparation for other reworking.
+ Michael Kerrisk
+ Since Linux 2.6.26, bind mounts can be made read-only
+
+open.2
+ Eric Biggers
+ Refer to correct functions in description of O_TMPFILE
+
+pciconfig_read.2
+ Michael Kerrisk [Tom Callaway]
+ Change license to note that page may be modified
+ Niki Rahimi, the author of this page, has agreed that it's okay
+ to change the license to note that the page can be modified.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=118311
+
+perf_event_open.2
+ Michael Kerrisk
+ If pid > 0, the operation is governed by PTRACE_MODE_READ_REALCREDS
+ Jann Horn
+ Document new perf_event_paranoid default
+ Keno Fischer [Vince Weaver]
+ Add a note that dyn_size is omitted if size == 0
+ The perf_output_sample_ustack in kernel/events/core.c only writes
+ a single 64 bit word if it can't dump the user registers. From the
+ current version of the man page, I would have expected two 64 bit
+ words (one for size, one for dyn_size). Change the man page to
+ make this behavior explicit.
+
+prctl.2
+ Michael Kerrisk
+ Some wording improvements in timer slack description
+ Michael Kerrisk
+ Refer reader to discussion of /proc/[pid]/timerslack_ns
+ Under discussion of PR_SET_TIMERSLACK, refer the reader to
+ the /proc/[pid]/timerslack_ns file, documented in proc(5).
+
+process_vm_readv.2
+ Michael Kerrisk
+ Rephrase permission rules in terms of a ptrace access mode check
+
+ptrace.2
+ Michael Kerrisk [Jann Horn]
+ Update Yama ptrace_scope documentation
+ Reframe the discussion in terms of PTRACE_MODE_ATTACH checks,
+ and make a few other minor tweaks and additions.
+ Michael Kerrisk, Jann Horn
+ Note that user namespaces can be used to bypass Yama protections
+ Michael Kerrisk
+ Note that PTRACE_SEIZE is subject to a ptrace access mode check
+ Michael Kerrisk
+ Rephrase PTRACE_ATTACH permissions in terms of ptrace access mode check
+
+quotactl.2
+ Michael Kerrisk [Jacob Willoughby]
+ 'dqb_curspace' is in bytes, not blocks
+ This error appears to have been injected into glibc
+ when copying some headers from BSD.
+
+ See https://bugs.debian.org/825548
+
+recv.2
+ Michael Kerrisk [Tom Gundersen]
+ With pending 0-length datagram read() and recv() with flags == 0 differ
+
+setfsgid.2
+setfsuid.2
+ Jann Horn [Michael Kerrisk]
+ Fix note about errors from the syscall wrapper
+ See sysdeps/unix/sysv/linux/i386/setfsuid.c in glibc-2.2.1.
+ (This code is not present in modern glibc anymore.)
+ Michael Kerrisk
+ Move glibc wrapper notes to "C library/kernel differences" subsection
+
+sysinfo.2
+ Michael Kerrisk
+ Rewrite and update various pieces
+
+umask.2
+ Michael Kerrisk
+ NOTES: Mention /proc/PID/status 'Umask' field
+
+umount.2
+ Michael Kerrisk
+ SEE ALSO: add mount_namespaces(7)
+
+unshare.2
+ Michael Kerrisk
+ Add reference to mount_namespaces(7) under CLONE_NEWNS description
+
+utimensat.2
+ Michael Kerrisk [Rob Landley]
+ Note that the glibc wrapper disallows pathname==NULL
+
+wait.2
+ Michael Kerrisk
+ Since Linux 4.7, __WALL is implied if child being ptraced
+ Michael Kerrisk
+ waitid() now (since Linux 4.7) also supports __WNOTHREAD/__WCLONE/__WALL
+
+assert.3
+ Nikos Mavrogiannopoulos
+ Improved description
+ Removed text referring to text not being helpful to users. Provide
+ the error text instead to allow the reader to determine whether it
+ is helpful. Recommend against using NDEBUG for programs to
+ exhibit deterministic behavior. Moved description ahead of
+ recommendations.
+ Michael Kerrisk
+ Clarify details of message printed by assert()
+
+fmax.3
+fmin.3
+ Michael Kerrisk
+ SEE ALSO: add fdim(3)
+
+getauxval.3
+ Cownie, James H
+ Correct AT_HWCAP result description
+
+inet_pton.3
+ Stefan Puiu
+ Mention byte order
+
+malloc_hook.3
+ Michael Kerrisk
+ glibc 2.24 removes __malloc_initialize_hook
+
+memmem.3
+ Michael Kerrisk [Shawn Landden]
+ Note that memmem() is present on some other systems
+
+mkdtemp.3
+mktemp.3
+ Michael Kerrisk
+ SEE ALSO: add mktemp(1)
+
+printf.3
+ Michael Kerrisk [Shawn Landden]
+ Note support in other C libraries for %m and %n
+
+strcasecmp.3
+ Michael Kerrisk [Ori Avtalion]
+ Make details of strncasecmp() comparison clearer
+
+strcat.3
+ Michael Kerrisk
+ Add a program that shows the performance characteristics of strcat()
+ In honor of Joel Spolksy's visit to Munich, let's start educating
+ Schlemiel The Painter.
+
+strtoul.3
+ Michael Kerrisk
+ SEE ALSO: add a64l(3)
+
+strxfrm.3
+ Michael Kerrisk [Florian Weimer]
+ Remove NOTES section
+ strxfrm() and strncpy() are not precisely equivalent in the
+ POSIX locale, so this NOTES section was not really correct.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=104221
+
+console_codes.4
+console_ioctl.4
+tty.4
+vcs.4
+charsets.7
+ Marko Myllynen
+ Remove console(4) references
+ 0f9e647 removed the obsolete console(4) page but we still have few
+ references to it. The patch below removes them or converts to refs
+ to console_ioctl(4) where appropriate.
+
+console_ioctl.4
+ Michael Kerrisk [Chris Gassib]
+ The argument to KDGETMODE is an 'int'
+
+lirc.4
+ Alec Leamas
+ Update after upstreamed lirc.h, bugfixes.
+
+st.4
+ Kai Mäkisara
+ Fix description of read() when block is larger than request
+ Kai Mäkisara
+ Update MTMKPART for kernels >= 4.6
+ Update the description of the MTMKPART operation of MTIOCTOP to match
+ the changes in kernel version 4.6.
+
+charmap.5
+ Marko Myllynen
+ Clarify keyword syntax
+ Updates charmap(5) to match the syntax all the glibc
+ charmap files are using currently.
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add readelf(1)
+
+locale.5
+ Marko Myllynen
+ Document missing keywords, minor updates
+ Marko Myllynen
+ Clarify keyword syntax
+ Marko Myllynen
+ Adjust conformance
+
+proc.5
+namespaces.7
+ Michael Kerrisk
+ Move /proc/PID/mounts information to proc(5)
+ There was partial duplication, and some extra information
+ in namespaces(7). Move everything to proc(5).
+
+proc.5
+ Michael Kerrisk
+ /proc/PID/fd/* are governed by PTRACE_MODE_READ_FSCREDS
+ Permission to dereference/readlink /proc/PID/fd/* symlinks is
+ governed by a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ /proc/PID/timerslack_ns is governed by PTRACE_MODE_ATTACH_FSCREDS
+ Permission to access /proc/PID/timerslack_ns is governed by
+ a PTRACE_MODE_ATTACH_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ Document /proc/PID/{maps,mem,pagemap} access mode checks
+ Permission to access /proc/PID/{maps,pagemap} is governed by a
+ PTRACE_MODE_READ_FSCREDS ptrace access mode check.
+
+ Permission to access /proc/PID/mem is governed by a
+ PTRACE_MODE_ATTACH_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ Note /proc/PID/stat fields that are governed by PTRACE_MODE_READ_FSCREDS
+ Michael Kerrisk
+ /proc/PID/{cwd,exe,root} are governed by PTRACE_MODE_READ_FSCREDS
+ Permission to dereference/readlink /proc/PID/{cwd,exe,root} is
+ governed by a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ /proc/PID/io is governed by PTRACE_MODE_READ_FSCREDS
+ Permission to access /proc/PID/io is governed by
+ a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ /proc/PID/{personality,stack,syscall} are governed by PTRACE_MODE_ATTACH_FSCREDS
+ Permission to access /proc/PID/{personality,stack,syscall} is
+ governed by a PTRACE_MODE_ATTACH_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ /proc/PID/{auxv,environ,wchan} are governed by PTRACE_MODE_READ_FSCREDS
+ Permission to access /proc/PID/{auxv,environ,wchan} is governed by
+ a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ Move shared subtree /proc/PID/mountinfo fields to mount_namespaces(7)
+ Move information on shared subtree fields in /proc/PID/mountinfo
+ to mount_namespaces(7).
+ Michael Kerrisk ["Yuming Ma(马玉明)"]
+ Note that /proc/net is now virtualized per network namespace
+ Michael Kerrisk
+ Add references to mount_namespaces(7)
+
+repertoiremap.5
+ Marko Myllynen
+ Clarify keyword syntax
+
+utmp.5
+ Michael Kerrisk
+ SEE ALSO: add logname(1)
+
+capabilities.7
+ Michael Kerrisk [Andy Lutomirski]
+ Note on SECURE_NO_CAP_AMBIENT_RAISE for capabilities-only environment
+ Michael Kerrisk
+ Add a detail on use of securebits
+
+cgroup_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add namespaces(7)
+
+cgroups.7
+ Michael Kerrisk
+ ERRORS: add mount(2) EBUSY error
+
+cp1251.7
+cp1252.7
+iso_8859-1.7
+iso_8859-15.7
+iso_8859-5.7
+koi8-r.7
+koi8-u.7
+ Marko Myllynen
+ Add some charset references
+ Add some references to related charsets here and there.
+
+credentials.7
+ Michael Kerrisk
+ SEE ALSO: add runuser(1)
+ SEE ALSO: add newgrp(1)
+ SEE ALSO: add sudo(8)
+
+feature_test_macros.7
+ Michael Kerrisk
+ Emphasize that applications should not directly include <features.h>
+
+man-pages.7
+ Michael Kerrisk
+ Clarify which sections man-pages provides man pages for
+ Michael Kerrisk [Josh Triplett]
+ Add a few more details on formatting conventions
+ Add some more details for Section 1 and 8 formatting.
+ Separate out formatting discussion into commands, functions,
+ and "general".
+
+namespaces.7
+ Michael Kerrisk
+ /proc/PID/ns/* are governed by PTRACE_MODE_READ_FSCREDS
+ Permission to dereference/readlink /proc/PID/ns/* symlinks is
+ governed by a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
+ Michael Kerrisk
+ Nowadays, file changes in /proc/PID/mounts are notified differently
+ Exceptional condition for select(), (E)POLLPRI for (e)poll
+ Michael Kerrisk
+ Remove /proc/PID/mountstats description
+ This is a duplicate of information in proc(5).
+ Michael Kerrisk
+ Refer to new mount_namespaces(7) for information on mount namespaces
+
+netlink.7
+ Andrey Vagin
+ Describe netlink socket options
+ Michael Kerrisk
+ Rework version information
+ (No changes in technical details.)
+
+pid_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add namespaces(7)
+
+unix.7
+ Michael Kerrisk
+ Move discussion on pathname socket permissions to DESCRIPTION
+ Michael Kerrisk
+ Expand discussion of socket permissions
+ Michael Kerrisk
+ Fix statement about permissions needed to connect to a UNIX domain socket
+ Read permission is not required (verified by experiment).
+ Michael Kerrisk
+ Clarify ownership and permissions assigned during socket creation
+ Michael Kerrisk [Carsten Grohmann]
+ Update text on socket permissions on other systems
+ At least some of the modern BSDs seem to check for write
+ permission on a socket. (I tested OpenBSD 5.9.) On Solaris 10,
+ some light testing suggested that write permission is still
+ not checked on that system.
+ Michael Kerrisk
+ Note that umask / permissions have no effect for abstract sockets
+ W. Trevor King
+ Fix example code: 'ret' check after accept populates 'data_socket'
+ Michael Kerrisk
+ Move some abstract socket details to a separate subsection
+ Michael Kerrisk
+ Note that abstract sockets automatically disappear when FDs are closed
+
+user_namespaces.7
+ Michael Kerrisk [Michał Zegan]
+ Clarify meaning of privilege in a user namespace
+ Having privilege in a user NS only allows privileged
+ operations on resources governed by that user NS. Many
+ privileged operations relate to resources that have no
+ association with any namespace type, and only processes
+ with privilege in the initial user NS can perform those
+ operations.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=120671
+ Michael Kerrisk [Michał Zegan]
+ List the mount operations permitted by CAP_SYS_ADMIN
+ List the mount operations permitted by CAP_SYS_ADMIN in a
+ noninitial userns.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=120671
+ Michael Kerrisk [Michał Zegan]
+ CAP_SYS_ADMIN allows mounting cgroup filesystems
+ See https://bugzilla.kernel.org/show_bug.cgi?id=120671
+ Michael Kerrisk
+ Clarify details of CAP_SYS_ADMIN and cgroup v1 mounts
+ With respect to cgroups version 1, CAP_SYS_ADMIN in the user
+ namespace allows only *named* hierarchies to be mounted (and
+ not hierarchies that have a controller).
+ Michael Kerrisk
+ Clarify CAP_SYS_ADMIN details for mounting FS_USERNS_MOUNT filesystems
+ Michael Kerrisk
+ Correct user namespace rules for mounting /proc
+ Michael Kerrisk
+ Describe a concrete example of capability checking
+ Add a concrete example of how the kernel checks capabilities in
+ an associated user namespace when a process attempts a privileged
+ operation.
+ Michael Kerrisk
+ Correct kernel version where XFS added support for user namespaces
+ Linux 3.12, not 3.11.
+ Michael Kerrisk
+ SEE ALSO: add ptrace(2)
+ SEE ALSO: add cgroup_namespaces(7)
+
+utf-8.7:
+ Shawn Landden
+ Include RFC 3629 and clarify endianness which is left ambiguous
+ The endianness is suggested by the order the bytes are displayed,
+ but the text is ambiguous.
+
+
+==================== Changes in man-pages-4.08 ====================
+
+Released: 2016-10-08, 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:
+
+Arnaud Gaillard <arnaud.mgaillard@gmail.com>
+Bill Pemberton <wfp5p@worldbroken.com>
+Carlos O'Donell <carlos@redhat.com>
+Christoph Hellwig <hch@lst.de>
+David Turner <novalis@novalis.org>
+Dr. Tobias Quathamer <toddy@debian.org>
+Elliott Hughes <enh@google.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Hu Keping <hukeping@huawei.com>
+Igor Liferenko <igor.liferenko@gmail.com>
+Ivan Kharpalev <ivan.kharpalev@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jann Horn <jann@thejh.net>
+Josh Triplett <josh@joshtriplett.org>
+Keno Fischer <keno@juliacomputing.com>
+Laurent Georget <laurent.georget@supelec.fr>
+Local Lembke <logan@blackhillsinfosec.com>
+Mats Wichmann <mats@wichmann.us>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Crowe <mac@mcrowe.com>
+Mike Frysinger <vapier@gentoo.org>
+Namhyung Kim <namhyung@gmail.com>
+Nikola Forró <nforro@redhat.com>
+Patrick McLean <patrickm@gaikai.com>
+Peter Wu <peter@lekensteyn.nl>
+Petr Cermak <petrcermak@chromium.org>
+Quentin Rameau <quinq@fifth.space>
+Ray Bellis <ray@isc.org>
+Rich Felker <dalias@libc.org>
+Ruben Kerkhof <ruben@rubenkerkhof.com>
+Sam Varshavchik <mrsam@courier-mta.com>
+Sebastian Andrzej Siewior <bigeasy@linutronix.de>
+Siward de Groot <siward@wanadoo.nl>
+Sloane Bernstein <sloane@cpanel.net>
+Stefan Tauner <tauner@technikum-wien.at>
+Tim Savannah <kata198@gmail.com>
+Ursache Vladimir <f35f22fan@gmail.com>
+Zefram <zefram@fysh.org>
+王守堰 <wangshouyan@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+quotactl.2
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Updated information regarding disk quota flags
+ Added information regarding DQF_SYS_FILE flag; updated definition
+ of V1_DQF_RSQUASH, which has been defined privately and defined
+ publicly as DQF_ROOT_SQUASH.
+ Eugene Syromyatnikov
+ Updated information regarding XFS-specific quotactl subcommands
+ Added information regarding structure definitions used for
+ XFS-specific subcommands, updated flag constants, added
+ information regarding ignored syscall arguments, added notes on
+ usage of kernel UAPI header.
+ Eugene Syromyatnikov
+ Additions regarding project quotas
+ Added information regarding presence of project quotas.
+
+bswap.3
+ Michael Kerrisk
+ New page documenting bswap_16(), bswap_32(), and bswap_64()
+
+cgroups.7
+ Michael Kerrisk
+ Substantial rewrites, additions, and corrections.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+readv.2
+ Michael Kerrisk
+ Document the pwritev2() RWF_SYNC and RWF_DSYNC flags
+
+proc.5
+ Michael Kerrisk
+ Document /proc/PID/seccomp
+ Jann Horn
+ Document /proc/[pid]/task/[tid]/children
+ Document the /proc/[pid]/task/[tid]/children interface from
+ CRIU, and more importantly, document why it's usually not
+ a good interface.
+
+
+New and changed links
+---------------------
+
+bswap_16.3
+bswap_32.3
+bswap_64.3
+ New link to new bswap.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Fix section ordering
+ Various pages had sections in an order different from
+ that prescribed in man-pages(7).
+
+Various pages
+ Michael Kerrisk [Mike Frysinger]
+ Consistently use /proc/[pid] (not /proc/PID)
+
+Various pages
+ Michael Kerrisk
+ Fix order of SEE ALSO entries
+ Entries should be ordered first by section, and then alphabetically
+ within the section.
+
+Various pages
+ Michael Kerrisk
+ Order ERRORS alphabetically
+
+Various pages
+ Michael Kerrisk
+ Remove section number from page self reference
+ Fix places where pages refer to the function that they describe
+ and include a section number in that reference. Such references
+ cause some HTML-rendering tools to create self-references in the
+ page.
+
+A few pages
+ Michael Kerrisk
+ Eliminate groff "cannot adjust line" warnings
+
+
+Changes to individual pages
+---------------------------
+
+pldd.1
+ Michael Kerrisk [Carlos O'Donell]
+ Note gdb(1) command that can be used as a replacement for pldd
+ Taken from Carlos O'Donnell's suggestion in
+ https://sourceware.org/bugzilla/show_bug.cgi?id=18035#c2
+ Michael Kerrisk
+ BUGS: pldd has not worked since glibc 2.19
+
+accept.2
+ Michael Kerrisk
+ Mention epoll(7) alongside poll()/select()
+ Michael Kerrisk
+ Demote discussion of DECNet to NOTES
+ DECNet ceased to be important long ago...
+
+adjtimex.2
+ Nikola Forró
+ Fix kernel version references
+
+chroot.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SYS_CHROOT
+
+clone.2
+ Keno Fischer [Josh Triplett]
+ Adjust syscall prototype and expand CLONE_SETTLS description
+ Michael Kerrisk [Josh Triplett, Josh Triplett]
+ Document raw syscall interfaces on various other architectures
+ Michael Kerrisk
+ Change types for 'ptid' and 'ctid' in syscall prototypes
+ These types changed from 'void *' to 'int *' back in Linux 3.8.
+ Michael Kerrisk
+ EINVAL is generated by glibc wrapper for NULL 'fn' or 'child_stack'
+ Clarify that this error is produced by the wrapper function, not
+ the underlying system call. In particular, the point is that the
+ raw system call can accommodate a NULL pointer for 'child_stack'.
+ Michael Kerrisk [Elliott Hughes]
+ Make the implications of CLONE_FILES more explicit
+ If CLONE_FILES is not set, the duplicated FDs nevertheless share
+ file offset and status flags via the open file description.
+ Michael Kerrisk
+ Mention kcmp() under notes
+
+close.2
+ Michael Kerrisk
+ Add mention of the close-on-exec flag
+ Michael Kerrisk
+ Clarify discussion noting that close() does not flush buffer cache
+
+epoll_wait.2
+ Mike Crowe
+ Clarify that the timeout is measured against CLOCK_MONOTONIC
+
+execve.2
+ Michael Kerrisk
+ Mention use of 'environ' to access environment list
+ Michael Kerrisk
+ Note that real UID, real GID, and supplementary GIDs are unchanged
+
+fanotify_init.2
+ Heinrich Schuchardt
+ Update BUGS information
+
+fcntl.2
+ Michael Kerrisk
+ Note an important detail of F_SETOWN permission rules for signals
+ F_SETOWN records the caller's credentials at the time of
+ the fcntl() call, and it is these saved credentials that
+ are used for subsequent permission checks.
+ Michael Kerrisk
+ Make the description of the effect of close-on-exec a little clearer
+ Michael Kerrisk
+ Clarify that F_GETFD and F_GETFL return flags via the function result
+
+fork.2
+ Michael Kerrisk
+ PID of new process also does not match any existing session ID
+
+fsync.2
+ Michael Kerrisk
+ SEE ALSO: add pwritev(2)
+ Since Linux 4.7, pwritev() has flags related to I/O
+ integrity completion.
+
+getdomainname.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SYS_ADMIN
+
+getgroups.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SETGID
+
+gethostname.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SYS_ADMIN
+
+getrlimit.2
+ Michael Kerrisk
+ Note user namespace semantics for CAP_SYS_RESOURCE
+
+getsid.2
+ Michael Kerrisk
+ Rework description to be somewhat clearer
+ Michael Kerrisk
+ Correct the definition of "session ID"
+
+getunwind.2
+ Michael Kerrisk
+ Simplify text referring to vdso(7)
+ The detail given here is redundant, since this info is also
+ in vdso(7).
+
+kcmp.2
+ Michael Kerrisk
+ Add an example program
+
+kill.2
+ Michael Kerrisk
+ Note the user namespace requirement for CAP_KILL
+
+killpg.2
+ Michael Kerrisk
+ Refer reader to kill(2) for signal permission rules
+
+mlock.2
+ Sebastian Andrzej Siewior
+ Document that fork() after mlock() may be a bad idea in a RT process
+
+mmap.2
+ Jann Horn
+ Describe treatment of 'offset' for MAP_ANONYMOUS
+ Michael Kerrisk [Siward de Groot]
+ Small improvement to description of MAP_SHARED
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=6887
+
+msgctl.2
+msgget.2
+msgop.2
+semctl.2
+semget.2
+semop.2
+shmctl.2
+shmget.2
+shmop.2
+ Michael Kerrisk
+ Note the user namespace requirements for CAP_IPC_OWNER
+
+open.2
+ Michael Kerrisk
+ Clarify user namespace capability requirements for O_NOATIME
+ Michael Kerrisk
+ NOTES: kcmp() can be used to test if two FDs refer to the same OFD
+ Michael Kerrisk
+ F2FS support for O_TMPFILE was added in Linux 3.16
+ Michael Kerrisk
+ Clarify the rules about how the group ID of a new file is determined
+
+prctl.2
+ Michael Kerrisk
+ Refer to proc(5) for effects of dumpability on ownership of /proc/PID/*
+ Michael Kerrisk
+ ERRORS: Add EACCES error for PR_SET_SECCOMP-SECCOMP_MODE_FILTER
+ Michael Kerrisk
+ Simplify list of cases where "dumpable" attribute is reset
+ Michael Kerrisk
+ Note user namespace requirements for PR_CAPBSET_DROP CAP_SETPCAP
+
+readlink.2
+ Michael Kerrisk [Ursache Vladimir]
+ Make example program handle links that report a size of zero
+ Some "magic" symlinks created by the kernel (e.g., those under
+ /proc and /sys) report 'st_size' as zero. Modify the example
+ program to handle that possibility.
+ Michael Kerrisk
+ Emphasize that truncation of returned buffer generates no error
+
+readv.2
+ Michael Kerrisk [Christoph Hellwig]
+ Clarify that RWF_DSYNC and RWF_SYNC apply only to data being written
+ Michael Kerrisk
+ Add preadv2() and pwritev2() to NAME line
+
+reboot.2
+ Michael Kerrisk
+ Note user namespace requirements around CAP_SYS_BOOT
+
+rename.2
+ Michael Kerrisk [Tim Savannah]
+ Clarify that ERRORS may cause rename to fail (not to be nonatomic)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SYS_NICE
+
+seccomp.2
+ Michael Kerrisk
+ CAP_SYS_ADMIN is required only in caller's user namespace
+
+select_tut.2
+ Peter Wu
+ Fix various issues in example program
+
+seteuid.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SETUID and CAP_SETGID
+
+setgid.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SETGID
+
+setpgid.2
+ Michael Kerrisk
+ Add a reference to credentials(7)
+
+setpgid.2
+setsid.2
+ Michael Kerrisk
+ Relocate some text on sessions and sessions leaders
+ Some text that was in setpgid(2) is better placed in setsid(2).
+
+setresuid.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SETUID
+
+setreuid.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SETUID and CAP_SETGID
+
+setsid.2
+ Michael Kerrisk
+ Refer to credentials(7) for details for details on controlling terminal
+ Refer to credentials(7) for details of how a session obtains
+ a controlling terminal.
+
+set_thread_area.2
+ Michael Kerrisk
+ Add get_thread_area() to NAME
+
+setuid.2
+ Michael Kerrisk
+ Note user namespace requirements for CAP_SETUID
+
+sigprocmask.2
+ Keno Fischer
+ Expand/clarify libc/kernel sigset_t difference
+
+stat.2
+ Michael Kerrisk [Ursache Vladimir, Mats Wichmann]
+ Improve discussion of 'st_size' for /proc and /sys files
+ Michael Kerrisk
+ _BSD_SOURCE and _SVID_SOURCE no longer expose nanosecond timestamps
+
+umask.2
+ Michael Kerrisk
+ Provide a rationale for the existence of /proc/PID/status 'Umask' field
+
+wait.2
+ Michael Kerrisk
+ Remove erroneous statement that waitpid() is implemented via wait4()
+ There is a fallback to wait4(), but only if the kernel does
+ not provide a waitpid() system call.
+
+bindresvport.3
+rcmd.3
+ip.7
+ Michael Kerrisk
+ Note user namespace requirements for CAP_NET_BIND_SERVICE
+
+byteorder.3
+ Michael Kerrisk
+ SEE ALSO: add bswap(3)
+
+dlopen.3
+ Michael Kerrisk
+ dlmopen() is still broken in glibc 2.24
+
+endian.3
+ Michael Kerrisk
+ SEE ALSO: add bswap(3)
+
+ffs.3
+ Michael Kerrisk [Stefan Tauner]
+ Correct feature test macro requirements
+
+fmemopen.3
+ Michael Kerrisk [Rich Felker]
+ Remove bogus suggestion to use setbuffer()
+
+getlogin.3
+ Michael Kerrisk
+ Update feature test macro requirements for cuserid()
+
+getumask.3
+ Michael Kerrisk
+ Note that getumask() is still unavailable in glibc 2.24
+ Michael Kerrisk
+ Point to umask(2) for a thread-safe way to discover process's umask
+
+mkstemp.3
+ Quentin Rameau
+ Fix _POSIX_C_SOURCE value for mkstemp()
+ The correct _POSIX_C_SOURCE value has always been 200809L,
+ not 200112L.
+
+pthread_join.3
+ Michael Kerrisk [Mats Wichmann]
+ Note that the caller might do clean up after joining with a thread
+ Michael Kerrisk [王守堰]
+ Clarify use of 'retval' pointer
+
+resolver.3
+ Ray Bellis
+ Correct arguments to res_ninit(res_state statep)
+
+strverscmp.3
+ Michael Kerrisk
+ Add an example program
+
+wcstombs.3
+ Michael Kerrisk [Igor Liferenko]
+ wcsrtombs() does not provide thread-safe interface to same functionality
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360
+
+core.5
+ Mike Frysinger [Michael Kerrisk]
+ Add more details for output paths and the crash handler
+ People sometimes assume that the crash handler runs in the same
+ context as the crashing process. They would be incorrect :).
+
+proc.5
+ Mike Frysinger
+ Clarify the root symlink and mount namespaces
+ If the target process is in a different mount namespace, the root
+ symlink actually shows that view of the filesystem.
+ Michael Kerrisk [Mike Frysinger]
+ Expand discussion of /proc/[pid]/root
+ Add a shell example showing that /proc/[pid]/root is more
+ than a symlink. Based on an example provided by Mike Frysinger
+ in an earlier commit message.
+ Michael Kerrisk
+ Explain rules determining ownership of /proc/PID/* files
+ Describe the effect of the "dumpable" attribute on ownership
+ of /proc/PID files.
+ Michael Kerrisk
+ Note effect of 'suid_dumpable' on ownership of /proc/PID files
+ Michael Kerrisk
+ Refer to ptrace(2) for info on effect of suid_dumpable on ptraceability
+ Michael Kerrisk
+ Add reference to core(5) in discussion of 'suid_dumpable'
+ Michael Kerrisk
+ Note that 'suid_dumpable' mode 1 is insecure
+ Michael Kerrisk
+ Document /proc/meminfo '+ShmemHugePages' and 'ShmemPmdMapped' fields
+ Michael Kerrisk
+ Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields
+ Michael Kerrisk
+ Document /proc/PID/status 'HugetlbPages' field
+ Michael Kerrisk [Zefram]
+ Clarify that /proc/PID/statm 'shared' field counts *resident* pages
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360
+ Michael Kerrisk
+ Add reference to umask(2) in discussion of /proc/PID/status 'Umask'
+ Michael Kerrisk
+ Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks
+ Michael Kerrisk
+ Note changes to config option governing /proc/[pid]/task/[tid]/children
+ Michael Kerrisk
+ Clarify description of /proc/PID/statm 'lib' and 'dt' fields
+ These fields are always zero since Linux 2.6.
+ Namhyung Kim [Petr Cermak]
+ Add description of CLEAR_REFS_MM_HIWATER_RSS
+ Michael Kerrisk
+ Update example VM values in /proc/PID/status
+
+capabilities.7
+ Michael Kerrisk
+ Add note about nosuid to file capabilities section
+ Michael Kerrisk
+ SEE ALSO: add proc(5)
+ Michael Kerrisk
+ SEE ALSO: add setsid(2) and setpgid(2)
+
+glob.7
+ Michael Kerrisk [Arnaud Gaillard]
+ Clarify that syntactically incorrect patterns are left unchanged
+
+packet.7
+ Michael Kerrisk
+ Clarify user namespace requirements for CAP_NET_RAW
+
+pipe.7
+ Michael Kerrisk [Patrick McLean]
+ Document FIONREAD
+
+raw.7
+ Michael Kerrisk
+ Clarify user namespace requirements for CAP_NET_RAW
+ Also remove mention of UID 0 as a method or creating
+ a raw socket. As far as I can tell from reading the
+ kernel source (net/ipv4/af_inet.c), this is not true.
+
+socket.7
+ Michael Kerrisk
+ SIOCSPGRP: refer to fcntl(2) F_SETOWN for correct permission rules
+ The permission rules described for SIOCCPGRP are wrong. Rather
+ than repeat the rules here, just refer the reader to fcntl(2),
+ where the rules are described for F_SETOWN.
+
+unix.7
+ Michael Kerrisk [Laurent Georget, Ivan Kharpalev]
+ Remove mention of recvmsg() from discussion of EPIPE error
+ See https://bugzilla.kernel.org/show_bug.cgi?id=137351
+
+ld.so.8
+ Michael Kerrisk
+ Expand description of LD_DEBUG
+ Provide a list of the categories, and note that multiple
+ categories can be specified.
+ Michael Kerrisk
+ Add glibc version for LD_USE_LOAD_BIAS
+ Michael Kerrisk
+ Clarify text describing whether secure-mode programs preload libraries
+ Michael Kerrisk
+ Remove discussion of environment variables understood by libc5
+ libc5 disappeared long ago, so cease cluttering up this page
+ with those ancient details. Thus, remove discussion of the
+ following environment variables: LD_AOUT_LIBRARY_PATH,
+ LD_AOUT_PRELOAD, LD_KEEPDIR, LD_NOWARN, and LDD_ARGV0.
+ Michael Kerrisk
+ Remove text with ancient libc4 and Linux libc details
+ Michael Kerrisk
+ Remove mention of "ELF only"
+ Drawing a distinction between ELF-only features versus a,out
+ ceased to be relevant long ago, so cluttering the page
+ with "ELF-only" serves no purpose.
+
+
+
+==================== Changes in man-pages-4.09 ====================
+
+Released: 2016-12-12, 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:
+
+Afzal Mohammed <afzal.mohd.ma@gmail.com>
+Andrew Clayton <andrew@digital-domain.net>
+Carlos O'Donell <carlos@redhat.com>
+Christoph Lameter <cl@linux.com>
+Daniel Baluta <daniel.baluta@gmail.com>
+Daniel Berrange <berrange@redhat.com>
+Daniel Wagner <wagi@monom.org>
+Darrick J. Wong <darrick.wong@oracle.com>
+Dave Hansen <dave.hansen@intel.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Dr. Tobias Quathamer <toddy@debian.org>
+Elliott Hughes <enh@google.com>
+Eric W. Biederman <ebiederm@xmission.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Igor Liferenko <igor.liferenko@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jann Horn <jann@thejh.net>
+Jeremy Harris <jgh@redhat.com>
+Kees Cook <keescook@chromium.org>
+Keno Fischer <keno@juliacomputing.com>
+Laurent Georget <laurent.georget@supelec.fr>
+Laurent Georget <laurent@lgeorget.eu>
+Marcos Mello <marcosfrm@gmail.com>
+Michael Hausenblas <michael.hausenblas@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Galbraith <efault@gmx.de>
+Miroslav Koskar <mk@mkoskar.com>
+Nikos Mavrogiannopoulos <nmav@redhat.com>
+Omar Sandoval <osandov@fb.com>
+Pavel Emelyanov <xemul@virtuozzo.com>
+Piotr Kwapulinski <kwapulinski.piotr@gmail.com>
+Siddhesh Poyarekar <siddhesh@sourceware.org>
+Theodore Ts'o <tytso@mit.edu>
+Vegard Nossum <vegard.nossum@oracle.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vince Weaver <vincent.weaver@maine.edu>
+Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
+Wang Long <long.wanglong@huawei.com>
+Willy Tarreau <w@1wt.eu>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pkey_alloc.2
+ Dave Hansen [Michael Kerrisk]
+ New page documenting pkey_alloc(2) and pkey_free(2)
+
+pthread_getattr_default_np.3
+ Michael Kerrisk
+ New page documenting pthread_getattr_default_np(3) and pthread_setattr_default_np(3)
+
+strfromd.3
+ Wainer dos Santos Moschetta
+ New page documenting strfromd(3), strfromf(3), and strfroml(3)
+ The ISO/IEC TS 18661-1 specifies the strfrom() class
+ of functions that convert a float-point value to string.
+
+fuse.4
+ Keno Fischer [Michael Kerrisk]
+ New page describing /dev/fuse
+ This is my writeup of a basic description of /dev/fuse after
+ playing with it for a few hours today. It is of course woefully
+ incomplete, and since I neither have a use case nor am working
+ on this code, I will not be in a position to expand it in the
+ near future. However, I'm hoping this could still serve as a
+ handy reference for others looking at this interface.
+
+ [mtk: Notwithstanding the incompleteness of this page,
+ it's a good base for future extension.]
+
+tmpfs.5
+ Michael Kerrisk
+ New page documenting the tmpfs filesystem
+
+pkeys.7
+ Dave Hansen [Michael Kerrisk]
+ New page with overview of Memory Protection Keys
+
+random.7
+ Michael Kerrisk [Theodore Ts'o, Nikos Mavrogiannopoulos, Laurent Georget]
+ New page providing an overview of interfaces for obtaining randomness
+ Contains material extracted from getrandom(2) and random(4),
+ as well as new material.
+
+sock_diag.7
+ Pavel Emelyanov, Dmitry V. Levin
+ New page documenting NETLINK_SOCK_DIAG interface
+
+close.2
+getpriority.2
+nice.2
+timer_create.2
+timerfd_create.2
+random.4
+elf.5
+proc.5
+sched.7
+ Various authors
+ These pages also saw substantial updates, as described under
+ "Changes to individual pages".
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+mmap.2
+ Michael Kerrisk
+ Add (much) more detail on MAP_GROWSDOWN
+
+mprotect.2
+ Dave Hansen
+ Document the new pkey_mprotect() system call
+ Eugene Syromyatnikov
+ Document PROT_SEM, PROT_SAO, PROT_GROWSUP, and PROT_GROWSDOWN
+
+prctl.2
+ Eugene Syromyatnikov
+ Document PR_SET_FP_MODE and PR_GET_FP_MODE
+
+perf_event_open.2
+ Vince Weaver
+ PERF_RECORD_SWITCH support
+ Linux 4.3 introduced two new record types for recording context
+ switches: PERF_RECORD_SWITCH and PERF_RECORD_SWITCH_CPU_WIDE.
+ Vince Weaver
+ Add PERF_SAMPLE_BRANCH_CALL branch sample type
+ Vince Weaver
+ PERF_SAMPLE_BRANCH_IND_JUMP branch_sample_type
+ Linux 4.2 added a new branch_sample_type: PERF_SAMPLE_BRANCH_IND_JUMP
+ Vince Weaver
+ Document PERF_RECORD_MISC_PROC_MAP_PARSE_TIMEOUT
+ Vince Weaver
+ Document sample_max_stack and /proc/sys/kernel/perf_event_max_stack
+ Linux 4.8 added a new sample_max_stack parameter, as well as
+ /proc/sys/kernel/perf_event_max_stack which limits it and a new
+ EOVERFLOW error return.
+ Dave Hansen
+ PERF_RECORD_LOST_SAMPLES record type
+ Linux 4.2 added a new record type: PERF_RECORD_LOST_SAMPLES
+ It is generated when hardware samples (currently only Intel PEBS)
+ are lost.
+
+ptrace.2
+ Michael Kerrisk
+ Document PTRACE_SECCOMP_GET_FILTER
+ Michael Kerrisk
+ Document PTRACE_GET_THREAD_AREA and PTRACE_SET_THREAD_AREA
+
+namespaces.7
+ Michael Kerrisk [Eric W. Biederman]
+ Document the NS_GET_USERNS and NS_GET_PARENT ioctl() operations
+
+sched.7
+ Michael Kerrisk [Mike Galbraith]
+ Document the autogroup feature
+ Includes documenting autogroup nice value
+ Michael Kerrisk
+ Autogrouping breaks traditional semantics of nice in many cases
+ When autogrouping is enabled (the default in many distros)
+ there are many traditional use cases where the nice value
+ ceases to have any effect.
+ Michael Kerrisk
+ Add a subsection on nice value and group scheduling
+
+
+New and changed links
+---------------------
+
+killpg.2
+ Michael Kerrisk
+ New link to relocated killpg(3) page
+
+pkey_free.2
+ Michael Kerrisk
+ New link to new pkey_alloc(2) page
+
+pkey_mprotect.2
+ Michael Kerrisk
+ New link to mprotect(2)
+
+pthread_setattr_default_np.3
+ Michael Kerrisk
+ New link to new pthread_getattr_default_np.3
+
+strfromf.3
+ Wainer dos Santos Moschetta
+ New link to strfromd(3)
+
+strfroml.3
+ Wainer dos Santos Moschetta
+ New link to strfromd(3)
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Remove ancient libc4 and libc5 details
+ It's nearly 20 years now since Linux libc went away.
+ Remove some ancient details from the pages.
+
+Various pages
+ Michael Kerrisk
+ Add cross references to new tmpfs(5) page
+
+Various pages
+ Michael Kerrisk
+ Change section number from 2 to 3 in killpg() references
+
+
+Changes to individual pages
+---------------------------
+
+accept.2
+ Michael Kerrisk
+ Remove editorializing comments about 'socklen_t'
+ Michael Kerrisk
+ Simplify the discussion of 'socklen_t'
+ We don't really need to list the old OSes in this discussion.
+
+adjtimex.2
+clock_getres.2
+gettimeofday.2
+ Michael Kerrisk
+ SEE ALSO: add hwclock(8)
+
+bind.2
+connect.2
+getpeername.2
+getsockname.2
+getsockopt.2
+ Michael Kerrisk
+ Replace discussion of 'socklen_t' with reference to accept(2)
+ The discussion of 'socklen_t' editorializes and is repeated
+ across several pages. Replace it with a reference to accept(2),
+ where some details about this type are provided.
+
+chmod.2
+ Michael Kerrisk
+ SEE ALSO: add chmod(1)
+
+chown.2
+ Michael Kerrisk
+ SEE ALSO: add chgrp(1) and chown(1)
+
+chroot.2
+ Michael Kerrisk
+ SEE ALSO: add chroot(1)
+
+clone.2
+ Michael Kerrisk
+ The CLONE_*_SETTID operations store TID before return to user space
+ CLONE_PARENT_SETTID and CLONE_CHILD_SETTID store the new
+ TID before clone() returns to user space
+
+close.2
+ Michael Kerrisk [Daniel Wagner]
+ Rework and greatly extend discussion of error handling
+ Further clarify that an error return should be used only
+ for diagnostic or remedial purposes.
+ Michael Kerrisk
+ Other UNIX implementations also close the FD, even if reporting an error
+ Looking at some historical source code suggests
+ that the "close() always closes regardless of error return"
+ behavior has a long history, predating even POSIX.1-1990.
+ Michael Kerrisk
+ Note that future POSIX plans to require that the FD is closed on error
+ See http://austingroupbugs.net/view.php?id=529#c1200.
+ Michael Kerrisk
+ Clarify the variation in EINTR behavior per POSIX and other systems
+
+fallocate.2
+ Darrick J. Wong
+ Document behavior with shared blocks
+ Note that FALLOC_FL_UNSHARE may use CoW to unshare blocks to
+ guarantee that a disk write won't fail with ENOSPC.
+
+fanotify_mark.2
+ Heinrich Schuchardt
+ Mention FAN_Q_OVERFLOW
+ To receive overflow events it is necessary to set this bit
+ in fanotify_mark().
+
+fcntl.2
+ Michael Kerrisk
+ F_GETPIPE_SZ allocates next power-of-2 multiple of requested size
+ Add some detail about current implementation, since this helps
+ the user understand the effect of the user pipe limits added in
+ Linux 4.5 (described in pipe(7)).
+ Michael Kerrisk
+ Add EPERM that occurs for F_SETPIPE_SZ when user pipe limit is reached
+
+fideduperange.2
+ Darrick J. Wong [Omar Sandoval]
+ Fix the discussion of maximum sizes
+ Fix the discussion of the limitations on the dest_count and
+ src_length parameters to the fideduperange ioctl() to reflect
+ what's actually in the kernel.
+
+fsync.2
+ Michael Kerrisk
+ SEE ALSO: add fileno(3)
+ fileno(3) is useful if one is combining fflush(3)/fclose(3)
+ and fsync(2).
+ Michael Kerrisk
+ SEE ALSO: add fflush(3)
+
+getgroups.2
+ Andrew Clayton
+ FTM requirements fix for setgroups(2)
+
+gethostname.2
+ Michael Kerrisk
+ SEE ALSO: add hostname(1)
+
+get_mempolicy.2
+ Michael Kerrisk
+ Note that 'addr' must be NULL when 'flags' is 0
+
+getpriority.2
+ Michael Kerrisk
+ Warn that autogrouping voids the effect of 'nice' in many cases
+ Refer the reader to sched(7) for the details.
+ Michael Kerrisk
+ Expand discussion of getpriority() return value
+ Michael Kerrisk
+ The nice value supplied to setpriority() is clamped
+ Note that the nice value supplied to setpriority() is clamped
+ to the permitted range.
+ Michael Kerrisk
+ Improve description of setpriority() return value
+
+getpriority.2
+sched.7
+ Michael Kerrisk
+ Move nice value details from getpriority(2) to sched(7)
+ Centralizing these details in sched(7) is more logical.
+
+getrandom.2
+random.4
+ Michael Kerrisk
+ Consolidate and improve discussion on usage of randomness
+ Currently, recommendations on how to consume randomness are
+ spread across both getrandom(2) and random(4) and the general
+ opinion seems to be that the text in getrandom(2) does a
+ somewhat better job. Consolidate the discussion to a single
+ page (getrandom(2)) and address some of the concerns
+ expressed about the existing text in random(4).
+ [Some of this text ultimately made its way into the new
+ random(7) page.]
+
+getrandom.2
+ Michael Kerrisk
+ Remove material incorporated into random(7)
+ Michael Kerrisk
+ Note advantages of fact that getrandom() doesn't use file descriptors
+ Michael Kerrisk
+ Clarify that getrandom() is not "reading" from /dev/{random,urandom}
+
+getrlimit.2
+ Michael Kerrisk
+ Refer to sched(7) in discussion of RLIMIT_RTPRIO and RLIMIT_RTTIME
+ Michael Kerrisk
+ Describe the range of the RLIMIT_NICE limit
+ Michael Kerrisk
+ Refer to sched(7) in the discussion of RLIMIT_NICE
+ Michael Kerrisk
+ SEE ALSO: add credentials(7)
+
+ioctl_ficlonerange.2
+ioctl_fideduperange.2
+ Darrick J. Wong
+ Clarify the behavior of the FIDEDUPERANGE ioctl
+
+kill.2
+ Michael Kerrisk
+ SEE ALSO: add kill(1)
+
+mbind.2
+ Michael Kerrisk [Christoph Lameter]
+ Memory policy is a per-thread attribute, not a per-process attribute
+
+mbind.2
+set_mempolicy.2
+ Piotr Kwapulinski [Christoph Lameter, Michael Kerrisk]
+ Add MPOL_LOCAL NUMA memory policy documentation
+
+mount.2
+ Michael Kerrisk
+ SEE ALSO: add mountpoint(1)
+
+mprotect.2
+ Michael Kerrisk
+ CONFORMING TO: note that pkey_mprotect() is Linux-specific
+
+nice.2
+ Michael Kerrisk
+ Warn that autogrouping voids the effect of 'nice' in many cases
+ Michael Kerrisk
+ CONFORMING TO: Remove an ancient SVr4 detail on errno values
+ Michael Kerrisk
+ Rework discussion of nice() return value and standards conformance
+ Make the text a little clearer. In particular, clarify that the
+ raw system call (still) returns 0 on success.
+ Michael Kerrisk
+ Clarify the range of the nice value, and note that it is clamped
+ Michael Kerrisk
+ Add mention of RLIMIT_NICE
+ Michael Kerrisk
+ Move discussion of handling the -1 success return to RETURN VALUE
+ This detail was rather hidden in NOTES. Also, rework the text
+ a little.
+ Michael Kerrisk
+ Clarify that nice() changes the nice value of the calling *thread*
+ Michael Kerrisk
+ Add "C library/kernel differences" subsection heading
+ Michael Kerrisk
+ Add reference to sched(7) for further details on the nice value
+
+open.2
+ Michael Kerrisk
+ ubifs supports O_TMPFILE starting with Linux 4.9
+ Michael Kerrisk
+ Document ENOMEM that occurs when opening FIFO because of pipe hard limit
+
+perf_event_open.2
+ Vince Weaver
+ Add cycles field in LBR records
+ Linux 4.3 added a cycles field to the PERF_SAMPLE_BRANCH_STACK
+ last branch records.
+ Vince Weaver
+ Update time_shift sample code
+ Linux 4.3 improved the accuracy of the clock/ns conversion routines.
+ Michael Kerrisk
+ Clarify the use of signals for capturing overflow events
+
+pipe.2
+ Michael Kerrisk
+ Add ENFILE error for user pipe hard limit reached
+
+prctl.2
+ Eugene Syromyatnikov
+ Some additional details regarding the PR_GET_UNALIGNED operation
+ Eugene Syromyatnikov
+ Note the output buffer size for PR_GET_TID_ADDRESS operation on x32/n32
+ Michael Kerrisk
+ Remove numeric definitions of PR_FP_MODE_FR and PR_FP_MODE_FRE bits
+
+ptrace.2
+ Keno Fischer
+ Document the behavior of PTRACE_SYSEMU stops
+ Keno Fischer
+ Expand documentation PTRACE_EVENT_SECCOMP traps
+ In Linux 4.8, the order of PTRACE_EVENT_SECCOMP and
+ syscall-entry-stops was reversed. Document both behaviors and
+ their interaction with the various forms of restart.
+
+quotactl.2
+ Eugene Syromyatnikov
+ Describe Q_XQUOTASYNC, which is present but no-op in recent kernels
+
+reboot.2
+ Wang Long
+ Note errors for invalid commands inside a PID namespace
+
+sched_setattr.2
+ Michael Kerrisk
+ Fix cross reference for further info on the nice value
+ The information moved from getpriority(2) to sched(7).
+
+sched_setscheduler.2
+ Michael Kerrisk [Daniel Berrange]
+ Mention SCHED_DEADLINE
+ Give the reader a clue that there is another policy
+ available that can't be set via sched_setscheduler(2).
+
+seccomp.2
+ Jann Horn
+ Document changed interaction with ptrace
+ Before kernel 4.8, the seccomp check will not be run again
+ after the tracer is notified. Fixed in kernel 4.9.
+ Michael Kerrisk
+ NOTES: mention ptrace(PTRACE_SECCOMP_GET_FILTER) to dump seccomp filters
+
+set_mempolicy.2
+ Michael Kerrisk
+ Reformat list of modes
+
+setsid.2
+ Michael Kerrisk
+ Improve wording of text on calling setsid() after fork()+_exit()
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
+ List sched(7), because setsid(2) is part of the machinery
+ of autogrouping.
+
+sigaction.2
+ Dave Hansen
+ Further documentation of SEGV_PKUERR
+
+signalfd.2
+ Michael Kerrisk
+ Document ssi_addr_lsb field of signalfd_siginfo
+
+symlink.2
+ Michael Kerrisk
+ SEE ALSO: add namei(1)
+
+sync_file_range.2
+ Michael Kerrisk
+ Fix description for ESPIPE error
+ A file descriptor can't refer to a symbolic link.
+
+syscalls.2
+ Michael Kerrisk
+ Add pkey_alloc(), pkey_free(), and pkey_mprotect()
+ New system calls in Linux 4.9.
+ Michael Kerrisk
+ Add ppc_swapcontext(2)
+
+timer_create.2
+ Michael Kerrisk
+ Document CLOCK_BOOTTIME
+ Michael Kerrisk
+ Document CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM
+
+timerfd_create.2
+ Michael Kerrisk
+ Document CLOCK_BOOTTIME, CLOCK_REALTIME_ALARM, and CLOCK_BOOTTIME_ALARM
+ Michael Kerrisk
+ Document TFD_TIMER_CANCEL_ON_SET
+ Michael Kerrisk
+ Rework discussion on relative and absolute timers
+
+unlink.2
+ Michael Kerrisk
+ SEE ALSO: add unlink(2)
+
+utime.2
+utimensat.2
+ Michael Kerrisk
+ SEE ALSO: add touch(1)
+
+wait.2
+ Michael Kerrisk
+ On some architectures, waitpid() is a wrapper that calls wait4().
+
+atof.3
+ Wainer dos Santos Moschetta
+ SEE ALSO: add strfromd(3)
+
+ctime.3
+ Michael Kerrisk
+ Add ERRORS section
+ Michael Kerrisk
+ RETURN VALUE: describe return values more explicitly
+
+errno.3
+ Michael Kerrisk [Igor Liferenko]
+ Add glibc error text for EILSEQ
+
+fclose.3
+fflush.3
+ Michael Kerrisk
+ SEE ALSO: add fileno(2)
+
+getlogin.3
+ Michael Kerrisk
+ Remove deprecated _REENTRANT from FTM requirements for getlogin_r()
+ Michael Kerrisk
+ SEE ALSO: add logname(1)
+
+isalpha.3
+ Michael Kerrisk
+ Note circumstances where 'c' must be cast to 'unsigned char'
+
+killpg.3
+ Michael Kerrisk
+ Move killpg.2 from section to section 3
+
+mallopt.3
+ Michael Kerrisk [Siddhesh Poyarekar]
+ Document 0 as default value of M_ARENA_MAX and explain its meaning
+ Michael Kerrisk
+ Improve description of M_ARENA_TEST
+ Michael Kerrisk
+ Document default value for M_ARENA_TEST
+ Michael Kerrisk
+ Note default value of M_PERTURB
+
+mbsnrtowcs.3
+ Michael Kerrisk [Igor Liferenko]
+ Note behavior of mbsnrtowcs() for an incomplete character
+ Note the behavior of mbsnrtowcs() when an incomplete character
+ is found at end of the input buffer.
+
+mbstowcs.3
+wcstombs.3
+ Michael Kerrisk [Igor Liferenko]
+ Improve language relating to "initial state"
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=839705
+
+mbstowcs.3
+ Michael Kerrisk [Igor Liferenko]
+ Add missing include to example program
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=845172
+
+mq_close.3
+ Michael Kerrisk
+ DESCRIPTION: add reference to mq_notify(3)
+
+mq_open.3
+ Eugene Syromyatnikov
+ Clarification regarding usage of mq_flags attribute in mq_open()
+
+mq_receive.3
+mq_send.3
+ Eugene Syromyatnikov
+ Clarification regarding reasons behind EBADF
+
+printf.3
+ Wainer dos Santos Moschetta
+ SEE ALSO: add strfromd(3)
+
+pthread_attr_init.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_setattr_default_np(3)
+
+pthread_create.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_setattr_default_np(3)
+
+ptsname.3
+ Michael Kerrisk
+ Note that ptsname_r() is proposed for future inclusion in POSIX.1
+ Michael Kerrisk
+ CONFORMING TO:: clarify that only ptsname() is standardized (so far)
+
+remainder.3
+ Michael Kerrisk
+ Note fix to remainder(nan(""), 0) handling
+ The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6779
+ has been fixed in glibc 2.15.
+ Michael Kerrisk
+ Document fixes for EDOM handling for range errors
+ The bug http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783
+ was fixed in glibc 2.15.
+
+setjmp.3
+ Michael Kerrisk
+ _BSD_SOURCE must be *explicitly* defined to get BSD setjmp() semantics
+
+strtod.3
+ Wainer dos Santos Moschetta
+ SEE ALSO: add strfromd(3)
+
+tgamma.3
+ Michael Kerrisk
+ Document fixes to give ERANGE for underflow range error
+ The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6810
+ was fixed in glibc 2.19.
+
+timegm.3
+ Michael Kerrisk
+ Add ERRORS section
+ Michael Kerrisk [Vincent Lefevre]
+ Add RETURN VALUE section
+
+tmpnam.3
+ Michael Kerrisk
+ Properly document tmpnam_r(3)
+
+toupper.3
+ Michael Kerrisk
+ Note circumstances where 'c' must be cast to 'unsigned char'
+
+ttyname.3
+ Michael Kerrisk
+ SEE ALSO: add tty(1)
+
+console_ioctl.4
+ Michael Kerrisk
+ Add brief descriptive text for KDGKBMODE modes
+ Miroslav Koskar
+ Add K_OFF keyboard mode
+
+random.4
+ Michael Kerrisk
+ Add reference to new random(7) page
+ Michael Kerrisk
+ Rework formatting of /proc interfaces
+ Make the information easier to parse by formatting the file
+ descriptions as hanging lists. No significant content changes.
+ Nikos Mavrogiannopoulos [Laurent Georget]
+ Provide a more accurate description of /dev/urandom
+ This documents the "property" of /dev/urandom of being able to
+ serve numbers prior to pool being initialized, and removes any
+ suggested usages of /dev/random which are disputable
+ (i.e., one-time pad). Document the fact /dev/random is only
+ suitable for applications which can afford indeterminate delays
+ since very few applications can do so. Smooth the alarming
+ language about a theoretical attack, and mention that its
+ security depends on the cryptographic primitives used by the
+ kernel, as well as the total entropy gathered.
+ Michael Kerrisk [Laurent Georget, Theodore Ts'o]
+ Improve discussion of /dev/urandom, blocking reads, and signals
+ The text currently states that O_NONBLOCK has no effect for
+ /dev/urandom, which is true. It also says that reads from
+ /dev/urandom are nonblocking. This is at the least confusing.
+ If one attempts large reads (say 10MB) from /dev/urandom
+ there is an appreciable delay, and interruption by a signal
+ handler will result in a short read. Amend the text to
+ reflect this.
+
+elf.5
+ Mike Frysinger
+ Add subsection headers at major points
+ The current pages dumps all the content into one big DESCRIPTION
+ with no real visual break up between logically independent
+ sections. Add some subsection headers to make it easier to
+ read and scan.
+ Mike Frysinger
+ Document notes
+ Document the Elf{32,64}_Nhdr structure, the sections/segments that
+ contain notes, and how to interpret them. I've been lazy and only
+ included the GNU extensions here, especially as others are not
+ defined in the elf.h header file as shipped by glibc.
+
+filesystems.5
+ Michael Kerrisk
+ SEE ALSO: add fuse(4)
+
+proc.5
+ Dave Hansen
+ Describe new ProtectionKey 'smaps' field
+ Michael Kerrisk
+ Add example ProtectionKey output for 'smaps' file
+ Michael Kerrisk
+ Add pointers to sched(7) for autogroup files
+ sched(7) describes /proc/sys/kernel/sched_autogroup_enabled
+ and /proc/PID/autogroup.
+ Michael Kerrisk
+ Add /proc/sys/fs/pipe-user-pages-{hard,soft} entries
+ Michael Kerrisk
+ Improve description of the KernelPageSize and MMUPageSize 'smaps' fields
+ Michael Kerrisk
+ Rework 'smaps' ProtectionKey text and add some details
+ Michael Kerrisk
+ Mention lslocks(8) in discussion of /proc/locks
+ Michael Kerrisk
+ Describe Shmem field of /proc/meminfo
+ Michael Kerrisk
+ Rework 'smaps' VmFlags text, and add kernel version and example output
+
+proc.5
+pipe.7
+ Michael Kerrisk
+ Move /proc/sys/fs/pipe-max-size content from proc(5) to pipe(7)
+
+resolv.conf.5
+ Carlos O'Donell [Florian Weimer]
+ Timeout does not map to resolver API calls
+
+utmp.5
+ Michael Kerrisk
+ SEE ALSO: add users(1)
+
+capabilities.7
+ Michael Kerrisk
+ CAP_SYS_ADMIN governs ptrace(2) PTRACE_SECCOMP_GET_FILTER
+ Michael Kerrisk
+ CAP_SYS_ADMIN allows privileged ioctl() operations on /dev/random
+
+cgroups.7
+ Michael Kerrisk
+ Add details on 'cpu' CFS bandwidth control
+
+credentials.7
+ Michael Kerrisk
+ SEE ALSO: add setpriv(1)
+ Michael Kerrisk
+ SEE ALSO: add shadow(5)
+
+feature_test_macros.7
+ Michael Kerrisk [Zack Weinberg]
+ Note that _REENTRANT and _THREAD_SAFE are now deprecated
+ Michael Kerrisk
+ Note that "cc -pthread" defines _REENTRANT
+
+inotify.7
+ Michael Kerrisk
+ Note a subtlety of event generation when monitoring a directory
+
+libc.7
+ Michael Kerrisk
+ Add a note on why glibc 2.x uses the soname libc.so.6
+ Michael Kerrisk
+ Add a few historical details on Linux libc4 and libc5
+ Just for historical interest. Details taken from
+ http://www.linux-m68k.org/faq/glibcinfo.html.
+
+mdoc.7
+ Michael Kerrisk
+ Add a cross-reference to groff_mdoc(7)
+
+mount_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add user_namespaces(7)
+
+mount_namespaces.7
+user_namespaces.7
+ Michael Kerrisk
+ Migrate subsection on mount restrictions to mount_namespaces(7)
+ This section material in the user_namespaces(7) page was written
+ before the creation of the mount_namespaces(7) manual page.
+ Nowadays, this material properly belongs in the newer page.
+
+netlink.7
+ Dmitry V. Levin
+ Document NETLINK_INET_DIAG rename to NETLINK_SOCK_DIAG
+ Dmitry V. Levin
+ Add references to sock_diag(7)
+
+pid_namespaces.7
+ Michael Kerrisk
+ Refer to namespaces(7) for information about NS_GET_PARENT
+
+pipe.7
+ Michael Kerrisk, Vegard Nossum [Vegard Nossum]
+ Document /proc files controlling memory usage by pipes
+ Document /proc/sys/fs/pipe-max-size and
+ /proc/sys/fs/pipe-user-pages-{soft,hard}.
+ Michael Kerrisk
+ Document pre-Linux 4.9 bugs in pipe limit checking
+
+sched.7
+ Michael Kerrisk
+ Add a new introductory paragraph describing the nice value
+ Michael Kerrisk
+ Add more precise details on CFS's treatment of the nice value
+ Michael Kerrisk
+ Mention RLIMIT_NICE in the discussion of the nice value
+ Michael Kerrisk
+ NOTES: mention cgroups CPU controller
+ Michael Kerrisk
+ Add introductory sentence mentioning CFS scheduler
+ Michael Kerrisk
+ Add nice(2), getpriority(2), and setpriority(2) to API list
+ Michael Kerrisk
+ Make it clearer that SCHED_OTHER is always scheduled below real-time
+ Michael Kerrisk
+ Give the page a more generic NAME
+ The page isn't just about APIs.
+
+standards.7
+ Michael Kerrisk
+ POSIX.1-2016 (POSIX.1-2008 TC2) has now been released
+
+symlink.7
+ Michael Kerrisk
+ SEE ALSO: add namei(1)
+
+uri.7
+ Jakub Wilk
+ Use "example.com" as example domain
+
+user_namespaces.7
+ Michael Kerrisk
+ Add reference to namespaces(7) for NS_GET_USERNS operation
+ Michael Kerrisk
+ Add reference to namespaces(7) for NS_GET_PARENT operation
+
+
+==================== Changes in man-pages-4.10 ====================
+
+Released: 2017-03-13, Paris
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adam Martindale <adam.john.martindale@gmail.com>
+Alex <psybin@riseup.net>
+Anders Thulin <anders@thulin.name>
+Andreas Gruenbacher <agruenba@redhat.com>
+Brian Masney <masneyb@onstation.org>
+Casey Schaufler <casey@schaufler-ca.com>
+David Howells <dhowells@redhat.com>
+Erik Kline <ekline@gmail.com>
+Erik Roland van der Meer <ervdmeer@gmail.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabjan Sukalia <fsukalia@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helmut Eller <eller.helmut@gmail.com>
+Hugo Guiroux <hugo.guiroux@gmail.com>
+Ian Jackson <ijackson@chiark.greenend.org.uk>
+Jakub Wilk <jwilk@jwilk.net>
+Jann Horn <jannh@google.com>
+Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
+John Wiersba <jrw32982@yahoo.com>
+Jon Jensen <jon@endpoint.com>
+Kai NODA <nodakai@gmail.com>
+KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
+Keno Fischer <keno@juliacomputing.com>
+Kent Fredic <kentfredric@gmail.com>
+Krzysztof Kulakowski <krzysztof.kulakowski@intel.com>
+Maik Zumstrull <maik@zumstrull.net>
+Mat Martineau <mathew.j.martineau@linux.intel.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@chromium.org>
+Nadav Har'El <nyh@math.technion.ac.il>
+Namhyung Kim <namhyung@gmail.com>
+Nicolas Biscos <nicolas.biscos+man7@gmail.com>
+Omar Sandoval <osandov@osandov.com>
+Paul Fee <paul.f.fee@gmail.com>
+Reverend Homer <mk.43.ecko@gmail.com>
+Rob Landley <rob@landley.net>
+Sergey Polovko <sergey@polovko.me>
+Steven Luo <steven@steven676.net>
+Tadeusz Struk <tadeusz.struk@intel.com>
+Vincent Bernat <vincent@bernat.im>
+Vivenzio Pagliari <vivenzio.pagliari@nokia.com>
+Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
+Willy Tarreau <w@1wt.eu>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+add_key.2
+ Michael Kerrisk [Eugene Syromyatnikov, David Howells]
+ Major improvements and additions
+ The page has doubled in length.
+
+ioctl_iflags.2
+ Michael Kerrisk
+ New page describing inode flags and ioctl() operations
+
+ioctl_ns.2
+ Michael Kerrisk
+ New page created by splitting ioctl(2) operations out of namespaces(7)
+
+keyctl.2
+ Michael Kerrisk, Eugene Syromyatnikov [David Howells, Mat Martineau]
+ A vast number of additions and improvements
+ The page has gone from somewhat over 100 lines to well over
+ 1000 lines and now more or less documents the complete interface
+ provided by this system call.
+
+getentropy.3
+ Michael Kerrisk
+ New page documenting getentropy(3)
+ getentropy(3) is added to glibc in version 2.25.
+
+keyrings.7
+ David Howells
+ New page (written by David Howells) adopted from keyutils
+ Since this page documents kernel-user-space interfaces,
+ it makes sense to have it as part of man-pages, rather
+ than the keyutils package.
+ Michael Kerrisk [Eugene Syromyatnikov, David Howells]
+ Very many additions and improvements
+ Michael Kerrisk
+ Document /proc/keys
+ Michael Kerrisk
+ Document /proc/sys/kernel/keys/persistent_keyring_expiry
+ Michael Kerrisk
+ Document /proc/key-users
+ Michael Kerrisk
+ Document /proc/sys/kernel/keys/gc_delay
+ Michael Kerrisk
+ Document /proc files that define key quotas
+
+persistent-keyring.7
+ Michael Kerrisk
+ New page (written by David Howells) adopted from keyutils
+ Since this page documents kernel-user-space interfaces,
+ it makes sense to have it as part of man-pages, rather
+ than the keyutils package.
+ Michael Kerrisk
+ Various clean-ups and additions
+
+process-keyring.7
+ Michael Kerrisk
+ New page (written by David Howells) adopted from keyutils
+ Since this page documents kernel-user-space interfaces,
+ it makes sense to have it as part of man-pages, rather
+ than the keyutils package.
+ Michael Kerrisk
+ Various additions and improvements
+
+request_key.2
+ Michael Kerrisk, Eugene Syromyatnikov [David Howells]
+ Very many additions and improvements
+ The page is now three times its former length.
+
+session-keyring.7
+ Michael Kerrisk
+ New page (written by David Howells) adopted from keyutils
+ Since this page documents kernel-user-space interfaces,
+ it makes sense to have it as part of man-pages, rather
+ than the keyutils package.
+ Michael Kerrisk
+ Various reworking and additions
+
+signal-safety.7
+ Michael Kerrisk
+ New page created by migrating the signal-safety discussion from
+ signal(7). Along the way some more details got added.
+ Michael Kerrisk [KASAKI Motohiro]
+ Note async-signal-safety problems caused by pthread_atfork()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=25292
+ Michael Kerrisk [KASAKI Motohiro]
+ Note glibc deviations from POSIX requirements
+ See https://bugzilla.kernel.org/show_bug.cgi?id=25292
+
+thread-keyring.7
+ Michael Kerrisk
+ New page (written by David Howells) adopted from keyutils
+ Since this page documents kernel-user-space interfaces,
+ it makes sense to have it as part of man-pages, rather
+ than the keyutils package.
+ Michael Kerrisk
+ Various rewordings and additions
+
+user-keyring.7
+ Michael Kerrisk
+ New page (written by David Howells) adopted from keyutils
+ Since this page documents kernel-user-space interfaces,
+ it makes sense to have it as part of man-pages, rather
+ than the keyutils package.
+ Michael Kerrisk
+ Various reworking and improvements
+
+user-session-keyring.7
+ Michael Kerrisk
+ New page (written by David Howells) adopted from keyutils
+ Since this page documents kernel-user-space interfaces,
+ it makes sense to have it as part of man-pages, rather
+ than the keyutils package.
+ Michael Kerrisk
+ Various rewordings and additions
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+bzero.3
+ Michael Kerrisk
+ Document explicit_bzero() (new in glibc 2.25)
+ Also, reword the description of bzero somewhat.
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/vm/user_reserve_kbytes
+ Michael Kerrisk
+ Document /proc/sys/vm/admin_reserve_kbytes
+ Michael Kerrisk
+ Document /proc/sys/fs/mount-max
+ Michael Kerrisk
+ Document /proc/PID/status 'NoNewPrivs' field
+
+
+New and changed links
+---------------------
+
+explicit_bzero.3
+ Michael Kerrisk
+ New link to bzero.3
+
+
+Changes to individual pages
+---------------------------
+
+chmod.2
+ Michael Kerrisk
+ ERRORS: add EPERM error for immutable/append-only file
+
+chown.2
+ Michael Kerrisk
+ ERRORS: add EPERM error for immutable/append-only file
+
+chroot.2
+ Michael Kerrisk
+ SEE ALSO: add switch_root(8)
+
+clock_getres.2
+ Michael Kerrisk
+ Note POSIX.1 requirements re relative time services and CLOCK_REALTIME
+
+clone.2
+ Michael Kerrisk
+ clone() does not execute fork handlers
+
+execve.2
+ Michael Kerrisk
+ Rework text describing when effective IDs aren't transformed by execve()
+ Michael Kerrisk
+ File capabilities can be ignored for the same reasons as set-UID/set-GID
+ Michael Kerrisk
+ The 'no_new_privs' bit inhibits transformations of the effective IDs
+
+fork.2
+ Michael Kerrisk
+ cgroup PIDs controller may also be trigger for EAGAIN error
+
+fsync.2
+ Michael Kerrisk
+ SEE ALSO: add posix_fadvise(2)
+
+getrandom.2
+ Michael Kerrisk
+ Remove getentropy(3) details and defer to new getentropy(3) page
+ Michael Kerrisk
+ Starting with glibc 2.25, getrandom() is now declared in <sys/random.h>
+ Michael Kerrisk
+ glibc support was added in version 2.25
+
+getrlimit.2
+ Michael Kerrisk
+ Document role of RLIMIT_NOFILE for FD passing over UNIX sockets
+
+getxattr.2
+listxattr.2
+ Andreas Gruenbacher
+ Document E2BIG errors
+
+inotify_add_watch.2
+ Michael Kerrisk
+ Note "inode" as a synonym for "filesystem object"
+ Consistent with clarifications just made in inotify(7).
+
+ioctl.2
+ Michael Kerrisk
+ SEE ALSO: add ioctl_ns(2), ioctl_iflags(2)
+
+ioctl_fat.2
+ Brian Masney
+ Correctly reference volume ID instead of volume label
+
+kcmp.2
+ Michael Kerrisk
+ Mention the clone(2) flags relating to various kcmp() 'type' values
+ Michael Kerrisk
+ KCMP_FILE: note reasons why FDs may refer to same open file description
+
+link.2
+ Michael Kerrisk
+ When using linkat() AT_EMPTY_PATH, 'olddirfd' must not be a directory
+ Michael Kerrisk
+ ERRORS: add EPERM for immutable/append-only files
+ Michael Kerrisk
+ Note limits where EMLINK is encountered on ext4 and Btrfs
+
+listxattr.2
+ Michael Kerrisk
+ Eliminate extra E2BIG error text
+ Andreas' patch added a second description of E2BIG that
+ was (mostly) more detailed than the existing text. Combine
+ the two texts.
+
+lseek.2
+ Michael Kerrisk
+ O_APPEND overrides the effect of lseek() when doing file writes
+ Michael Kerrisk
+ Remove ancient info about whence values and return values on old systems
+ Michael Kerrisk
+ Remove slightly bogus advice about race conditions
+ The page already (by now) contains a reference to open(2)
+ for a discussion of open file descriptions. Leave it at that,
+ since the reader can then deduce how things work.
+
+madvise.2
+ Michael Kerrisk
+ Note that madvise() is generally about improving performance
+
+mbind.2
+ Krzysztof Kulakowski [Michael Kerrisk]
+ Update MPOL_BIND description
+ The behavior of MPOL_BIND changed in Linux 2.6.26.
+
+mincore.2
+ Michael Kerrisk
+ SEE ALSO: add madvise(2), posix_fadvise(2), posix_madvise(3)
+
+mlock.2
+ Michael Kerrisk
+ Note pre-4.9 bug in RLIMIT_MEMLOCK accounting for overlapping locks
+ Michael Kerrisk
+ SEE ALSO: add mincore(2)
+
+mmap.2
+ Michael Kerrisk
+ mincore(2) can be used to discover which pages of a mapping are resident
+
+mount.2
+ Michael Kerrisk [Rob Landley]
+ Refer to mount_namespaces(7) for details of default propagation type
+
+nanosleep.2
+ Michael Kerrisk
+ Describe "creeping sleep" problem
+ nanosleep() has a problem if used in a program that catches
+ signals and those signals are delivered at a very high rate.
+ Describe the problem, and note that clock_nanosleep(2)
+ provides a solution.
+ Michael Kerrisk
+ BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6
+
+open.2
+ Michael Kerrisk
+ Make it clear that O_APPEND implies atomicity
+ Michael Kerrisk
+ Clarify distinction between file creation flags and file status flags
+ Michael Kerrisk
+ Note ambiguity of ELOOP error when using O_NOFOLLOW
+ Michael Kerrisk
+ Restructure O_NOFOLLOW text for easier parsing
+ Michael Kerrisk
+ Clarify that O_NOFOLLOW is now in POSIX
+
+poll.2
+select.2
+ Nicolas Biscos
+ Add a reference to the sigset discussion in sigprocmask(2)
+ A little while back, I added a note to sigprocmask.2 that
+ discussed the difference between the libc's and the kernel's
+ sigset_t structures. I added that note, because I saw this being
+ done wrong in a tool tracing system calls (causing subtle bugs).
+ As it turns out, the same bugs existed for ppoll and pselect, for
+ the same reason. I'm hoping by adding the reference here, future
+ writers of similar tools will find that discussion and not make
+ the same mistake.
+
+posix_fadvise.2
+ Michael Kerrisk
+ Mention /proc/sys/vm/drop_caches
+ It may be helpful for the reader of this page to know about
+ /proc/sys/vm/drop_caches.
+ Michael Kerrisk
+ Reorganize some text
+ Details for various flags were hidden under NOTES.
+ Move them to DESCRIPTION, to make the details more
+ obvious.
+ Michael Kerrisk
+ One can use open(2) + mmap(2) + mincore(2) as a 'fincore'
+ Note that open(2) + mmap(2) + mincore(2) can be used to get a view
+ of which pages of a file are currently cached.
+ Michael Kerrisk [Maik Zumstrull]
+ Note that POSIX_FADV_DONTNEED *may* try to write back dirty pages
+ Michael Kerrisk
+ SEE ALSO: mincore(2)
+
+prctl.2
+ Michael Kerrisk
+ Clarify that the ambient capability set is per-thread
+ Keno Fischer
+ Be more precise in what causes dumpable to reset
+ Michael Kerrisk
+ The no_new_privs setting is per-thread (not per-process)
+ Michael Kerrisk
+ Mention /proc/PID/status 'NoNewPrivs' field
+ Michael Kerrisk
+ Add reference to seccomp(2) in discussion of PR_SET_NO_NEW_PRIVS
+
+ptrace.2
+ Omar Sandoval
+ Clarify description of PTRACE_O_EXITKILL
+
+read.2
+ Michael Kerrisk [Kai NODA]
+ Rework text in DESCRIPTION that talks about limits for 'count'
+ See https://bugzilla.kernel.org/show_bug.cgi?id=86061
+ Michael Kerrisk [Steven Luo]
+ Remove crufty text about EINTR and partial read
+ Remove bogus text saying that POSIX permits partial read
+ to return -1/EINTR on interrupt by a signal handler.
+ That statement already ceased to be true in SUSv1 (1995)!
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=193111
+
+readv.2
+ Michael Kerrisk
+ Remove generic advice about mixing stdio and syscalls on same file
+ There is nothing specific to readv()/writev() about this advice.
+
+recv.2
+ Michael Kerrisk [Vincent Bernat]
+ Remove duplicate paragraph
+ man-pages-1.34 included changes that duplicated an existing
+ paragraph. Remove that duplicate.
+ Michael Kerrisk
+ SEE ALSO: add ip(7), ipv6(7), tcp(7), udp(7), unix(7)
+
+remap_file_pages.2
+ Michael Kerrisk
+ remap_file_pages() has been replaced by a slower in-kernel emulation
+
+send.2
+ Michael Kerrisk
+ SEE ALSO: add ipv6(7), socket(7), unix(7)
+
+setxattr.2
+ Michael Kerrisk
+ ERRORS: add EPERM for immutable/append-only files
+
+signalfd.2
+ Michael Kerrisk
+ signalfd() doesn't play well with helper programs spawned by libraries
+ See https://lwn.net/Articles/415684/.
+ Michael Kerrisk
+ signalfd can't be used to receive synchronously generated signals
+ Signals such as the SIGSEGV that results from an invalid
+ memory access can be caught only with a handler.
+
+stat.2
+ Michael Kerrisk
+ EXAMPLE: extend program to also show ID of the containing device
+ Michael Kerrisk
+ NOTES: mention fstatat() AT_NO_AUTOMOUNT in discussion of automounting
+
+statfs.2
+ Namhyung Kim
+ Add more filesystem types
+ Add missing magic numbers from /usr/include/linux/magic.h
+
+syscall.2
+ Mike Frysinger
+ Add endian details with 64-bit splitting
+ Architectures that split 64-bit values across register pairs
+ usually do so according to their C ABI calling convention (which
+ means endianness). Add some notes to that effect, and change the
+ readahead example to show a little endian example (since that is
+ way more common than big endian).
+
+ Also start a new list of syscalls that this issue does not apply
+ to.
+ Mike Frysinger
+ Note parisc handling of aligned register pairs
+ While parisc would normally have the same behavior as ARM/PowerPC,
+ they decide to write shim syscall stubs to unpack/realign rather
+ than expose the padding to userspace.
+
+tkill.2
+ Jann Horn
+ Document EAGAIN error for real-time signals
+
+truncate.2
+ Michael Kerrisk
+ Note use of ftruncate() for POSIX shared memory objects
+
+unlink.2
+ Michael Kerrisk
+ ERRORS: add EPERM error for immutable/read-only files
+
+vfork.2
+ Michael Kerrisk
+ Explain why the child should not call exit(3)
+ Michael Kerrisk
+ Another reason to use vfork() is to avoid overcommitting memory
+ Michael Kerrisk
+ Note some caveats re the use of vfork()
+ Inspired by Rich Felker's post at http://ewontfix.com/7/.
+ See also https://sourceware.org/bugzilla/show_bug.cgi?id=14749 and
+ See also https://sourceware.org/bugzilla/show_bug.cgi?id=14750.
+ Michael Kerrisk
+ SEE ALSO: add _exit(2)
+
+write.2
+ Michael Kerrisk [Kai NODA]
+ Alert the reader that there is a limit on 'count'
+ See https://bugzilla.kernel.org/show_bug.cgi?id=86061
+
+aio_suspend.3
+ Michael Kerrisk
+ Note that the glibc implementation is not async-signal-safe
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=13172
+
+backtrace.3
+ Michael Kerrisk
+ SEE ALSO: add addr2line(1) and gdb(1)
+
+bcmp.3
+bcopy.3
+bzero.3
+memccpy.3
+memchr.3
+memcmp.3
+memcpy.3
+memfrob.3
+memmem.3
+memmove.3
+memset.3
+ Michael Kerrisk
+ SEE ALSO: add bstring(3)
+
+exec.3
+ Michael Kerrisk
+ execl() and execle() were not async-signal-safe before glibc 2.24
+
+fopen.3
+ Michael Kerrisk [Helmut Eller]
+ Describe freopen() behavior for NULL pathname argument
+ See https://bugzilla.kernel.org/show_bug.cgi?id=191261
+ Michael Kerrisk
+ Note the open(2) flags that correspond to the 'mode' argument
+ Michael Kerrisk
+ Change argument name: 'path' to 'pathname'
+ For consistency with open(2).
+ Michael Kerrisk
+ Add subsection headings for each function
+
+fts.3
+ Michael Kerrisk
+ Use better argument name for fts_children() and fts_set()
+ Michael Kerrisk
+ Fix minor error in FTSENT structure definition
+ Michael Kerrisk
+ Improve explanation of 'fts_errno'
+ Michael Kerrisk
+ Give a hint that there are further fields in the FTSENT structure
+ Michael Kerrisk
+ Clarify meaning of zero as 'instr' value for fts_set()
+
+ftw.3
+ Michael Kerrisk
+ Correctly handle use of stat info for FTW_NS in example program
+ Michael Kerrisk
+ Clarify that stat buffer is undefined for FTW_NS
+
+getline.3
+ Michael Kerrisk
+ EXAMPLE: better error handling
+ Michael Kerrisk [Kent Fredic]
+ EXAMPLE: handle null bytes in input
+ Jann Horn
+ Document ENOMEM error case
+ see the error handling in libio/iogetdelim.c
+ Michael Kerrisk
+ EXAMPLE: specify file to be opened as command-line argument
+ Michael Kerrisk
+ Use better variable name in example program
+
+getmntent.3
+ Michael Kerrisk [Anders Thulin]
+ Prefer '\\' as the escape to get a backslash
+ See https://bugzilla.kernel.org/show_bug.cgi?id=191611
+
+getopt.3
+ Michael Kerrisk
+ Reword discussion of error handling and reporting
+ The existing description was hard to understand. Break
+ it into a bullet list that separates out the details
+ in a manner that is easier to parse.
+ Michael Kerrisk
+ Correct details of use of <stdio.h> to get getopt() declaration
+ Michael Kerrisk [John Wiersba]
+ Remove some redundant text
+
+mq_open.3
+ Michael Kerrisk [Adam Martindale]
+ Include definition of the 'mq_attr' structure in this man page
+ Make the reader's life a little easier by saving them from
+ having to refer to mq_getattr(3).
+
+mq_send.3
+ Michael Kerrisk [Adam Martindale]
+ Refer to mq_overview(7) for details on range of message priority
+
+__ppc_set_ppr_med.3
+ Wainer dos Santos Moschetta
+ Note need for _ARCH_PWR8 macro
+ The _ARCH_PWR8 macro must be defined to get the
+ __ppc_set_ppr_very_low() and __ppc_set_ppr_med_high()
+ definitions.
+
+printf.3
+ Michael Kerrisk
+ Document nonstandard 'Z' modifier
+ Michael Kerrisk
+ Document 'q' length modifier
+ Michael Kerrisk [Erik Roland van der Meer]
+ Fix a small bug in example code
+ Move the second call to va_end(ap) to above the if-block that
+ precedes it, so that the va_list 'ap' will be cleaned up in
+ all cases.
+ Michael Kerrisk [Nadav Har'El]
+ As a nonstandard extension, GNU treats 'll' and 'L' as synonyms
+ See https://bugzilla.kernel.org/show_bug.cgi?id=190341.
+ Michael Kerrisk
+ Add references to setlocale(3) in discussions of locales
+ Michael Kerrisk
+ SEE ALSO: remove bogus self reference (dprintf(3))
+
+random.3
+ Michael Kerrisk
+ Relocate information of "optimal" value of initstate() 'n' argument
+ The information was a bit hidden in NOTES.
+
+random_r.3
+ Michael Kerrisk [Jan Ziak]
+ 'buf.state' must be initialized to NULL before calling initstate_r()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=192801.
+ Michael Kerrisk
+ Add some usage notes for setstate_r()
+ Michael Kerrisk
+ Note that 'buf' records a pointer to 'statebuf'
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=3662.
+ Michael Kerrisk
+ Add BUGS section pointing out the weirdness of the initstate_r() API
+
+resolver.3
+ Michael Kerrisk
+ RES_AAONLY, RES_PRIMARY, RES_NOCHECKNAME, RES_KEEPTSIG are deprecated
+ These options were never implemented; since glibc 2.25, they
+ are deprecated.
+ Michael Kerrisk
+ The RES_NOIP6DOTINT is removed in glibc 2.25
+ Michael Kerrisk
+ Note that RES_BLAST was unimplemented and is now deprecated
+ Michael Kerrisk
+ RES_USE_INET6 is deprecated since glibc 2.25
+ Michael Kerrisk
+ RES_USEBSTRING was removed in glibc 2.25
+
+resolver.3
+resolv.conf.5
+ Michael Kerrisk
+ Note that RES_USEBSTRING defaults to off
+
+scandir.3
+ Michael Kerrisk [Ian Jackson]
+ Fix errors in example program
+ See http://bugs.debian.org/848231.
+ Michael Kerrisk
+ Improve logic of the example program
+
+scanf.3
+ Michael Kerrisk
+ Document the quote (') modifier for decimal conversions
+
+sem_post.3
+setjmp.3
+ Michael Kerrisk
+ SEE ALSO: add signal-safety(7)
+
+sem_wait.3
+ Michael Kerrisk [Fabjan Sukalia]
+ Remove statement that SA_RESTART does not cause restarting
+ This has not been true since Linux 2.6.22. The description
+ of EINTR maintains a reference to signal(7), which explains
+ the historical details.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=192071
+
+sleep.3
+ Michael Kerrisk [Mike Frysiner]
+ Note that sleep() is implemented via nanosleep(2)
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
+ Michael Kerrisk [Mike Frysinger]
+ Note that sleep() sleeps for a real-time number of seconds
+ See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
+ Michael Kerrisk
+ Convert BUGS text to "Portability notes" subsection
+ The existing text is not a bug, as such.
+ Michael Kerrisk
+ DESCRIPTION: minor reworking
+
+strerror.3
+ Heinrich Schuchardt
+ Indicate reasonable buffer size for strerror_r() and strerror_l()
+ Add a hint which buffer size is needed for
+ strerror_r() and strerror_l().
+
+strverscmp.3
+ Michael Kerrisk [Vivenzio Pagliari]
+ Fix comparison error in example program
+
+system.3
+ Michael Kerrisk
+ In the glibc implementation, fork handlers are not executed by system()
+
+random.4
+ Michael Kerrisk [Jon Jensen]
+ Note that entropy_avail will be a number in the range 0..4096
+
+core.5
+ Michael Kerrisk
+ Clarify that dumping program's initial CWD is root directory
+ Michael Kerrisk
+ The target of core dump piping can also be a script
+
+filesystems.5
+ Michael Kerrisk
+ SEE ALSO: add btrfs(5), nfs(5), tmpfs(5)
+
+intro.5
+ Michael Kerrisk
+ Document the reality that by now Section 5 also covers filesystems
+ There are by now, from various filesystem projects, various
+ pages in Section 5 that document different filesystems.
+ Change intro(5) to reflect that.
+
+ Documented after following: http://bugs.debian.org/847998
+
+proc.5
+ Mike Frysinger [Michael Kerrisk]
+ Clarify /proc/pid/environ behavior
+ /proc/pid/environ reflects process environment at
+ *start* of program execution; it is set at time of execve(2)
+ Michael Kerrisk
+ Add reference to slabinfo(5) in discussion of /proc/meminfo 'Slab' field
+ Michael Kerrisk
+ Add entries for "keys" files that refer reader to keyrings(7)
+ Michael Kerrisk
+ Remove duplicate /proc/[pid]/seccomp entry
+ Michael Kerrisk
+ Mention other system calls that create 'anon_inode' file descriptors
+ Mention a few other system calls that create file descriptors
+ that display an 'anon_inode' symlink in /proc/PID/fd
+ Michael Kerrisk
+ Add some detail on overcommit_memory value 1
+ Michael Kerrisk
+ Add reference to vdso(7) in discussion of /proc/PID/maps
+
+resolv.conf.5
+ Michael Kerrisk
+ ip6-bytestring was removed in glibc 2.25
+ Michael Kerrisk
+ The ipc-dotint and no-ip6-dotint options were removed in glibc 2.25
+ Michael Kerrisk
+ The 'inet6' option is deprecated since glibc 2.25
+
+slabinfo.5
+ Michael Kerrisk
+ SEE ALSO: add slabtop(1)
+
+capabilities.7
+ Michael Kerrisk [Casey Schaufler]
+ Add subsection with notes to kernel developers
+ Provide some notes to kernel developers considering how to choose
+ which capability should govern a new kernel feature.
+ Michael Kerrisk
+ Further enhance the recommendation against new uses of CAP_SYS_ADMIN
+ Michael Kerrisk
+ Explicitly point from CAP_SYS_ADMIN to "Notes for kernel developers"
+ Michael Kerrisk
+ Add another case for CAP_DAC_READ_SEARCH
+ Michael Kerrisk
+ Refer to execve(2) for the reasons that file capabilities may be ignored
+ Michael Kerrisk
+ Document a new use of CAP_SYS_RESOURCE
+ Michael Kerrisk
+ Add some more operations governed by CAP_SYS_ADMIN
+ Michael Kerrisk
+ Adjust references to chattr(1) to point to ioctl_iflags(2)
+
+environ.7
+ Michael Kerrisk
+ Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations
+
+inotify.7
+ Michael Kerrisk
+ Point out that inotify monitoring is inode based
+
+ip.7
+ Michael Kerrisk
+ SEE ALSO: add ip(8)
+
+man.7
+uri.7
+ Jakub Wilk
+ Use "www.kernel.org" in example URLs
+ Apparently www.kernelnotes.org is now a spam site.
+
+mount_namespaces.7
+ Michael Kerrisk [Rob Landley]
+ Rework the discussion of defaults for mount propagation types
+ Add rather more detail. In particular, note the cases where the
+ default propagation type is MS_PRIVATE vs MS_SHARED.
+
+namespaces.7
+ Michael Kerrisk
+ EXAMPLE: fix an error in shell session
+ Michael Kerrisk
+ EXAMPLE: rename the example program
+ Use a more generic name, since this program may be expanded
+ in various ways in the future.
+ Michael Kerrisk
+ SEE ALSO: add ip-netns(8)
+ Michael Kerrisk
+ Remove content split out into ioctl_ns(2)
+
+netlink.7
+ Michael Kerrisk
+ NETLINK_IP6_FW went away in Linux 3.5
+ Michael Kerrisk
+ NETLINK_W1 went away in Linux 2.6.18
+ Michael Kerrisk
+ Add NETLINK_SCSITRANSPORT to list
+ Michael Kerrisk
+ Add NETLINK_RDMA to list
+ Michael Kerrisk
+ NETLINK_FIREWALL was removed in Linux 3.5
+ Michael Kerrisk
+ NETLINK_NFLOG was removed in Linux 3.17
+ Jakub Wilk
+ Update libnl homepage URL
+ The original URL is 404.
+
+pid_namespaces.7
+user_namespaces.7
+ Michael Kerrisk
+ Adjust references to namespaces(7) to ioctl_ns(2)
+
+pid_namespaces.7
+ Keno Fischer
+ CLONE_SIGHAND|CLONE_VM|CLONE_NEWPID is no longer disallowed
+
+pipe.7
+ Michael Kerrisk
+ Since Linux 4.9, pipe-max-size is ceiling for the default pipe capacity
+ Michael Kerrisk
+ Clarify that default pipe capacity is 16 pages
+ The statement that the default pipe capacity is 65536 bytes
+ is accurate only on systems where the page size is 4096B.
+ See the use of PIPE_DEF_BUFFERS in the kernel source.
+
+random.7
+ Michael Kerrisk
+ Mention getentropy(3)
+ Michael Kerrisk
+ SEE ALSO: add getentropy(3)
+ Michael Kerrisk
+ SEE ALSO: add getauxval(3)
+ A small hint to the reader that some random bytes arrive
+ in the auxiliary vector.
+
+signal.7
+ Michael Kerrisk
+ SIGSYS: add reference to seccomp(2)
+ Michael Kerrisk
+ Change description of SIGSYS to "Bad system call"
+ This is the more typical definition.
+ Michael Kerrisk
+ SIGPIPE: add reference to pipe(7)
+ Michael Kerrisk
+ SIGXFSZ: add reference to setrlimit(2)
+ Michael Kerrisk
+ Add a name for SIGEMT
+ Michael Kerrisk
+ SIGXCPU: add reference to setrlimit(2)
+ Michael Kerrisk
+ Migrated signal-safety discussion to new signal-safety(7) page
+
+unix.7
+ Michael Kerrisk [Sergey Polovko]
+ Since Linux 3.4, UNIX domain sockets support MSG_TRUNC
+ This was correctly noted in recv(2), but the unix(7) page
+ was not correspondingly updated for the Linux 3.4 change.
+ Michael Kerrisk [Willy Tarreau]
+ Document ETOOMANYREFS for SCM_RIGHTS send exceeding RLIMIT_NOFILE limit
+
+user_namespaces.7
+ Michael Kerrisk
+ Change page cross reference: keyctl(2) ==> keyrings(7)
+
+ld.so.8
+ Michael Kerrisk
+ LD_BIND_NOT has effect only for function symbols
+ Michael Kerrisk
+ Describe use of LD_DEBUG with LD_BIND_NOT
+ Michael Kerrisk
+ In secure mode, LD_AUDIT restricts the libraries that it will load
+ Michael Kerrisk
+ LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM
+
+
+
+==================== Changes in man-pages-4.11 ====================
+
+Released: 2017-05-03, Baden, Switzerland
+
+
+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:
+
+Alexander Alemayhu <alexander@alemayhu.com>
+Alexander Miller <alex.miller@gmx.de>
+Andrea Arcangeli <aarcange@redhat.com>
+Andreas Dilger <adilger@dilger.ca>
+Andrew Clayton <andrew@digital-domain.net>
+Arnd Bergmann <arnd@arndb.de>
+Ben Dog <wsy2220@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Chema Gonzalez <chema@google.com>
+Christian Brauner <christian.brauner@ubuntu.com>
+Cyril Hrubis <chrubis@suse.cz>
+David Howells <dhowells@redhat.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Florian Weimer <fweimer@redhat.com>
+Francois Saint-Jacques <fsaintjacques@gmail.com>
+Frank Theile
+Georg Sauthoff <mail@georg.so>
+Ian Abbott <abbotti@mev.co.uk>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Heberer <jangc@t-online.de>
+Marcin Ślusarz <marcin.slusarz@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Matthew Wilcox <willy@infradead.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Rapoport <rppt@linux.vnet.ibm.com>
+Nicolas Biscos <nicolas.biscos+man7@gmail.com>
+Nicolas Iooss <Nicolas.Iooss@ssi.gouv.fr>
+Nikos Mavrogiannopoulos <nmav@redhat.com>
+Nominal Animal <question@nominal-animal.net>
+Silvan Jegen <s.jegen@gmail.com>
+Stephan Bergmann <sbergman@redhat.com>
+Walter Harms <wharms@bfs.de>
+Zack Weinberg <zackw@panix.com>
+丁贵强<dingguiqiang@foxmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+ioctl_userfaultfd.2
+ Michael Kerrisk, Mike Rapoport
+ New page describing ioctl(2) operations for userfaultfd
+
+statx.2
+ David Howells, Michael Kerrisk [Andreas Dilger]
+ New page describing statx(2) system call added in Linux 4.11
+
+userfaultfd.2
+ Mike Rapoport, Michael Kerrisk [Andrea Arcangeli]
+ New page describing userfaultfd(2) system call.
+
+pthread_atfork.3
+ Michael Kerrisk
+ New page describing pthread_atfork(3)
+
+slabinfo.5
+ Michael Kerrisk
+ Rewrite to try to bring the content close to current reality
+ There's still gaps to fill in, but the existing page
+ was in any case hugely out of date.
+
+inode.7
+ Michael Kerrisk
+ New page with information about inodes
+ David Howells provided a statx(2) page that duplicated much of
+ the information from stat(2). Avoid such duplication
+ by moving the common information in stat(2) and statx(2)
+ to a new page.
+
+
+Renamed pages
+--------------
+
+ioctl_console.2
+ Michael Kerrisk
+ Renamed from console_ioctl.4
+ Most ioctl() man pages are in section 2, so move this one there
+ for consistency.
+ Michael Kerrisk
+ Note type of 'argp' for a various operations
+ For some commands, there was no clear statement about the type
+ of the 'argp' argument.
+
+ioctl_tty.2
+ Michael Kerrisk
+ Renamed from tty_ioctl(4)
+ All other ioctl(2) pages are in section 2. Make this
+ page consistent.
+ Michael Kerrisk
+ Packet mode state change events give POLLPRI events for poll(2)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ioctl_ns.2
+ Michael Kerrisk
+ Document the NS_GET_NSTYPE operation added in Linux 4.11
+ Michael Kerrisk
+ Document the NS_GET_OWNER_UID operation added in Linux 4.11
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/kernel/sched_child_runs_first
+
+namespaces.7
+ Michael Kerrisk
+ Document the /proc/sys/user/* files added in Linux 4.9
+
+socket.7
+ Francois Saint-Jacques, Michael Kerrisk
+ Document SO_INCOMING_CPU
+
+
+New and changed links
+---------------------
+
+console_ioctl.4
+ Michael Kerrisk
+ Link for old name of ioctl_console(2) page
+
+tty_ioctl.4
+ Michael Kerrisk
+ Link for old name of ioctl_tty(2) page
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Change page cross-references from tty_ioctl(4) to ioctl_tty(2)
+ Michael Kerrisk
+ Change page cross-references for console_ioctl(4) to ioctl_console(2)
+
+
+Changes to individual pages
+---------------------------
+
+alarm.2
+ Michael Kerrisk
+ SEE ALSO: add timer_create(2) and timerfd_create(2)
+
+chmod.2
+fsync.2
+mkdir.2
+mknod.2
+open.2
+truncate.2
+umask.2
+utime.2
+utimensat.2
+ Michael Kerrisk
+ Add/replace references to inode(7)
+
+clone.2
+ Michael Kerrisk
+ CLONE_NEWCGROUP by an unprivileged process also causes an EPERM error
+
+clone.2
+unshare.2
+ Michael Kerrisk
+ Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC
+ Michael Kerrisk
+ CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached
+ Michael Kerrisk
+ Exceeding the maximum nested user namespace limit now gives ENOSPC
+ Formerly, if the limit of 32 nested user namespaces was exceeded,
+ the error EUSERS resulted. Starting with Linux 4.9, the error
+ is ENOSPC.
+
+epoll_ctl.2
+ Michael Kerrisk
+ Defer to poll(2) for an explanation of EPOLLIN
+ Michael Kerrisk [Nicolas Biscos]
+ EPOLLERR is also set on write end of a pipe when the read end is closed
+ Michael Kerrisk [Nicolas Biscos]
+ Give the reader a clue that the 'events' field can be zero
+ 'events' specified as zero still allows EPOLLHUP and
+ EPOLLERR to be reported.
+
+_exit.2
+ Michael Kerrisk
+ On exit, child processes may be inherited by a "subreaper"
+ It is no longer necessarily true that orphaned processes
+ are inherited by PID 1.
+ Michael Kerrisk
+ Only the least significant byte of exit status is passed to the parent
+
+fcntl.2
+ Michael Kerrisk
+ Mention memfd_create() in the discussion of file seals
+ Give the reader a clue about what kinds of objects can
+ be employed with file seals.
+ Michael Kerrisk
+ File seals are not generally applicable to tmpfs(5) files
+ As far as I can see, file seals can be applied only to
+ memfd_create(2) file descriptors. This was checked by experiment
+ and by reading mm/shmem.c::shmem_get_inode((), where one finds
+ the following line that applies to all new shmem files:
+
+ info->seals = F_SEAL_SEAL;
+
+ Only in the code of the memfd_create() system call is this
+ setting reversed (in mm/shmem.c::memfd_create):
+
+ if (flags & MFD_ALLOW_SEALING)
+ info->seals &= ~F_SEAL_SEAL;
+
+fork.2
+ Michael Kerrisk
+ SEE ALSO: add pthread_atfork(3)
+
+getdents.2
+open.2
+stat.2
+statx.2
+ Michael Kerrisk
+ SEE ALSO: add inode(7)
+
+getdtablesize.2
+attr.5
+ Alexander Miller
+ Move .so directive to first line
+ Improves compatibility with the man and other dumb tools
+ that process man page files.
+
+getpid.2
+ Michael Kerrisk
+ Mention init(1) and "subreapers" in discussion of parent PID
+
+ioctl_list.2
+ Cyril Hrubis [Arnd Bergmann]
+ BLKRASET/BLKRAGET take unsigned long
+
+ioctl_ns.2
+ Michael Kerrisk
+ ERRORS: document ENOTTY
+
+kexec_load.2
+sched_setaffinity.2
+bootparam.7
+ Michael Kerrisk
+ Documentation/kernel-parameters.txt is now in Documentation/admin-guide/
+
+lseek.2
+ Michael Kerrisk
+ SEE ALSO: add fallocate(2)
+ Both of these pages discuss file holes.
+
+mincore.2
+ Michael Kerrisk
+ SEE ALSO: add fincore(1)
+
+mmap.2
+ Michael Kerrisk
+ Remove ancient reference to flags that appear on some other systems
+ MAP_AUTOGROW, MAP_AUTORESRV, MAP_COPY, and MAP_LOCAL may have
+ appeared on some systems many years ago, but the discussion here
+ mentions no details and the systems and flags probably ceased to
+ be relevant long ago. So, remove this text.
+ Michael Kerrisk
+ SEE ALSO: add userfaultfd(2)
+
+open.2
+ Michael Kerrisk
+ Add statx() to list of "at" calls in rationale discussion
+
+poll.2
+ Michael Kerrisk
+ Expand discussion of POLLPRI
+ Michael Kerrisk [Nicolas Biscos]
+ POLLERR is also set on write end of a pipe when the read end is closed
+
+posix_fadvise.2
+ Michael Kerrisk
+ SEE ALSO: add fincore(1)
+
+prctl.2
+ Mike Frysinger
+ PR_SET_MM: Refine CONFIG_CHECKPOINT_RESTORE requirement
+ The Linux 3.10 release dropped the c/r requirement and opened it
+ up to all users.
+ Mike Frysinger
+ PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers
+ Mike Frysinger
+ PR_SET_MM: Document arg4/arg5 zero behavior
+ The kernel will immediately reject calls where arg4/arg5 are not
+ zero. See kernel/sys.c:prctl_set_mm().
+ Michael Kerrisk
+ Explain rationale for use of subreaper processes
+ Michael Kerrisk
+ Note semantics of child_subreaper setting on fork() and exec()
+ Michael Kerrisk
+ Improve description of PR_SET_CHILD_SUBREAPER
+
+rename.2
+ Michael Kerrisk [Georg Sauthoff]
+ Note that there is no glibc wrapper for renameat2()
+
+sched_setaffinity.2
+ Michael Kerrisk
+ SEE ALSO: add get_nprocs(3)
+
+select.2
+ Michael Kerrisk [Matthew Wilcox, Carlos O'Donell]
+ Linux select() is buggy wrt POSIX in its check for EBADF errors
+ Michael Kerrisk
+ Show correspondence between select() and poll() readiness notifications
+ Michael Kerrisk
+ Give a hint that sets must be reinitialized if using select() in a loop
+ Michael Kerrisk
+ Refer to POLLPRI in poll(2) for info on exceptional conditions
+ Michael Kerrisk
+ Move mislocated text describing the self-pipe text from BUGS to NOTES
+
+sigaction.2
+ Michael Kerrisk
+ Show the prototype of an SA_SIGINFO signal handler
+
+signalfd.2
+ Michael Kerrisk
+ SIGKILL and SIGSTOP are silently ignored in 'mask'
+
+sigprocmask.2
+ Dmitry V. Levin
+ Do not specify an exact value of rt_sigprocmask's 4th argument
+ As sizeof(kernel_sigset_t) is not the same for all architectures,
+ it would be better not to mention any numbers as its value.
+ Michael Kerrisk
+ 'set' and 'oldset' can both be NULL
+
+sigwaitinfo.2
+ Michael Kerrisk
+ sigwaitinfo() can't be used to accept synchronous signals
+
+socketcall.2
+ Mike Frysinger
+ Document call argument
+
+stat.2
+ Michael Kerrisk
+ Remove information migrated to inode(7) page
+ Michael Kerrisk
+ Restructure field descriptions as a hanging list
+ Michael Kerrisk
+ Remove "Other systems" subsection
+ These details about other systems were added in 1999,
+ and were probably of limited use then, and even less today.
+ However, they do clutter the page, so remove them.
+ Michael Kerrisk
+ DESCRIPTION: add list entries for 'st_uid' and 'st_gid'
+ Michael Kerrisk
+ Add some subsection headings to ease readability
+ David Howells
+ ERRORS: correct description of ENOENT
+ Michael Kerrisk
+ Give 'struct stat' argument a more meaningful name ('statbuf')
+ Marcin Ślusarz
+ Tweak description of AT_EMPTY_PATH
+ Currently it says when dirfd is AT_FDCWD it can be something
+ other than directory, which doesn't make much sense. Just swap
+ the order of sentences.
+ Michael Kerrisk
+ Add slightly expanded description of 'st_ino' field
+ Michael Kerrisk
+ DESCRIPTION: add a list entry for 'st_ino'
+ Michael Kerrisk
+ DESCRIPTION: add a list entry for 'st_nlinks' field
+
+syscalls.2
+ Michael Kerrisk
+ Add membarrier(2)
+ Michael Kerrisk
+ Fix kernel version for userfaultfd(2)
+ Michael Kerrisk
+ Linux 4.11 added statx()
+ Michael Kerrisk
+ Include deprecated getunwind(2) in list
+
+wait.2
+ Michael Kerrisk
+ Orphaned children may be adopted by a "subreaper", rather by than PD 1
+
+bzero.3
+ Michael Kerrisk [Zack Weinberg]
+ Add correct header file for explicit_bzero()
+
+cfree.3
+ Michael Kerrisk
+ cfree() is removed from glibc in version 2.26
+
+exit.3
+ Michael Kerrisk
+ Improve discussion of zombie processes
+
+getentropy.3
+ Nikos Mavrogiannopoulos [Michael Kerrisk, Florian Weimer]
+ Correct header file
+ Michael Kerrisk [Frank Theile]
+ SYNOPSIS: add missing return type for getentropy() declaration
+
+grantpt.3
+ Michael Kerrisk
+ Tell a more nuanced story about what grantpt() does or does not do
+
+insque.3
+ Michael Kerrisk
+ SEE ALSO: add queue(3)
+
+queue.3
+ Michael Kerrisk
+ SEE ALSO: add insque(3)
+
+shm_open.3
+ Michael Kerrisk
+ Clarify that POSIX shared memory uses tmpfs(5)
+
+syslog.3
+ Michael Kerrisk [Ian Abbott, Walter Harms]
+ Reorganize page text for easier parsing and better readability
+ Michael Kerrisk
+ Various rewordings and improvements
+ Michael Kerrisk
+ Note default value for 'facility' when calling openlog()
+ Michael Kerrisk
+ SEE ALSO: add journalctl(1)
+
+ttyname.3
+ Dmitry V. Levin
+ Document ENODEV error code
+ Christian Brauner
+ NOTES: warn about a confusing case that may occur with mount namespaces
+
+wcsdup.3
+ Jan Heberer
+ RETURN VALUE: fix error in return value description
+ Return value for failure was accidentally changed from NULL to
+ -1 in man-pages commit 572acb41c48b6b8e690d50edff367d8b8b01702a.
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add elfedit(1), nm(1), size(1), strings(1), and strip(1)
+
+nsswitch.conf.5
+ Florian Weimer
+ Mention sudoers
+ It turns out that sudo drops things into nsswitch.conf, too.
+
+proc.5
+ Michael Kerrisk
+ Refer to namespaces(7) for discussion of /proc/sys/user/* files
+ Michael Kerrisk
+ Simplify /proc/slabinfo entry
+ Don't repeat (out-of-date) info from slabinfo(5); just defer to
+ that page.
+
+tmpfs.5
+ Michael Kerrisk
+ tmpfs supports extended attributes, but not 'user' extended attributes
+
+environ.7
+ Jakub Wilk
+ Fix name of function that honors TMPDIR
+ tempnam() takes the TMPDIR environment variable into account, unlike
+ tmpnam(), which always creates pathnames within /tmp.
+
+hostname.7
+ Marko Myllynen
+ Use lower case for hostname example
+ Marko Myllynen
+ Use generic names in examples
+ Marko Myllynen
+ Describe accepted characters for hostname
+
+inotify.7
+ Michael Kerrisk [Nicolas Iooss]
+ Mounting a filesystem on top of a monitored directory causes no event
+
+man-pages.7
+ Michael Kerrisk
+ Note preferred approach for 'duplicate' errors
+
+pid_namespaces.7
+ Michael Kerrisk
+ The maximum nesting depth for PID namespaces is 32
+
+user_namespaces.7
+ Stephan Bergmann
+ Fixes to example
+ While toying around with the userns_child_exec example program on the
+ user_namespaces(7) man page, I noticed two things:
+
+ * In the EXAMPLE section, we need to mount the new /proc before
+ looking at /proc/$$/status, otherwise the latter will print
+ information about the outer namespace's PID 1 (i.e., the real
+ init). So the two paragraphs need to be swapped.
+
+ * In the program source, make sure to close pipe_fd[0] in the
+ child before exec'ing.
+
+pthreads.7
+ Michael Kerrisk
+ SEE ALSO: add pthread_rwlockattr_setkind_np(3)
+
+pty.7
+ Michael Kerrisk
+ Mention a couple of other applications of pseudoterminals
+
+sem_overview.7
+ Michael Kerrisk
+ SEE ALSO: add shm_overview(7)
+
+signal.7
+ Michael Kerrisk
+ SEE ALSO: add sigreturn(2)
+
+tcp.7
+ Michael Kerrisk
+ Note indications for OOB data given by select(2) and poll(2)
+ Chema Gonzalez
+ tcp_abc was removed in 3.9
+
+xattr.7
+ Michael Kerrisk
+ SEE ALSO: add ioctl_iflags(2)
+ People sometimes confuse xattrs and inode flags. Provide a link
+ to the page that describes inode flags to give them a tip.
+
+ld.so.8
+ Michael Kerrisk
+ Mention quoting when using "Rpath tokens" in LD_AUDIT and LD_PRELOAD
+ Michael Kerrisk
+ Expand description of /etc/ld.so.preload
+ Michael Kerrisk
+ Mention ldconfig(8) in discussion of /etc/ld.so.cache
+
+zdump.8
+ Jakub Wilk
+ Add OPTIONS section heading
+
+
+==================== Changes in man-pages-4.12 ====================
+
+Released: 2017-07-13, London
+
+
+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:
+
+Alex Henrie <alexhenrie24@gmail.com>
+Andi Kleen <andi-bz@firstfloor.org>
+Arjun Shankar <arjun.is@lostca.se>
+Brad Bendily <bendily@gmail.com>
+Cameron Wright <wright18@uw.edu>
+Carlos O'Donell <carlos@redhat.com>
+Darrick J. Wong <darrick.wong@oracle.com>
+David Lewis <davlewi3@cisco.com>
+DJ Delorie <dj@delorie.com>
+Douglas Caetano dos Santos <douglascs@taghos.com.br>
+Dr. Tobias Quathamer <toddy@debian.org>
+Eric Biggers <ebiggers@google.com>
+Ferdinand Thiessen <f.thiessen@gmx.de>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Henry Bent <henry.r.bent@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Janne Snabb <snabb@epipe.com>
+Joe Brown <joe.brown.89@outlook.com>
+Jorge Nerin <jnerin@gmail.com>
+Kirill Tkhai <ktkhai@virtuozzo.com>
+lilydjwg <lilydjwg@gmail.com>
+Long Wang <w@laoqinren.net>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@chromium.org>
+Nadav Har'El <nyh@math.technion.ac.il>
+NeilBrown <neilb@suse.com>
+Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
+Quentin Rameau <quinq@fifth.space>
+Ruben Kerkhof <ruben@rubenkerkhof.com>
+sulit <sulitsrc@foxmail.com>
+石井大貴 <hiroki.ishii@miraclelinux.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+ioctl_getfsmap.2
+ Darrick J. Wong
+ Document the GETFSMAP ioctl
+ Document the new GETFSMAP ioctl that returns the physical layout of a
+ (disk-based) filesystem.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+namespaces.7
+ Kirill Tkhai [Michael Kerrisk]
+ Document the /proc/[pid]/ns/pid_for_children file
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ 'objdump -p prog | grep NEEDED' doesn't give quite same info as 'ldd'
+
+chmod.2
+ Michael Kerrisk
+ Put fchmod() feature test macro requirements in a more readable format
+ Michael Kerrisk
+ Note glibc 2.24 feature test macro requirements changes for fchmod()
+
+chown.2
+ Michael Kerrisk
+ When file owner or group is changed, file capabilities are cleared
+ Michael Kerrisk
+ Changes to file owner by root also clear set-UID and set-GID bits
+
+clone.2
+ Michael Kerrisk
+ Update BUGS to reflect fact that PID caching was removed in glibc 2.25
+
+epoll_wait.2
+ Michael Kerrisk
+ Clarify semantics of returned 'data' field
+ The returned 'data' is the 'data' most recently set via
+ epoll_ctl().
+
+get_mempolicy.2
+ Michael Kerrisk [Nadav Har'El, Andi Kleen]
+ SYNOPSIS: fix return type of get_mempolicy()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=97051
+
+getpid.2
+ Carlos O'Donell, Michael Kerrisk
+ Note that PID caching is removed as of glibc 2.25
+ Since glibc 2.25 the PID cache is removed.
+
+ Rationale given in the release notes:
+ https://sourceware.org/glibc/wiki/Release/2.25#pid_cache_removal
+
+ioctl.2
+ Michael Kerrisk
+ SEE ALSO: add ioctl_getfsmap(2)
+
+ioctl_getfsmap.2
+ Michael Kerrisk
+ Fix ordering of sections
+ Michael Kerrisk
+ Add VERSIONS section
+ Michael Kerrisk
+ ERRORS: order alphabetically
+
+madvise.2
+ Michael Kerrisk
+ Remove bogus text re POSIX_MADV_NOREUSE
+ There is a POSIX_FADV_NOREUSE for posix_fadvise(),
+ but no POSIX_MADV_NOREUSE for any API in POSIX.
+
+membarrier.2
+ Michael Kerrisk
+ Add ENOSYS error for 'nohz_full' CPU setting
+
+mount.2
+ NeilBrown
+ Revise description of MS_REMOUNT | MS_BIND
+ MS_REMOUNT|MS_BIND affects all per-mount-point
+ flag. MS_RDONLY is only special because it,
+ uniquely, is both a per-mount-point flag *and* a
+ per-filesystem flag.
+
+ So the sections of per-mount-point flags and
+ MS_REMOUNT can usefully be clarified.
+
+open.2
+ Michael Kerrisk
+ Note some further advantages of the *at() APIs
+
+pipe.2
+ Michael Kerrisk
+ SEE ALSO: add tee(2) and vmsplice(2)
+
+readv.2
+ Michael Kerrisk
+ glibc 2.26 adds library support for preadv2() and pwritev2()
+
+sched_setaffinity.2
+ Michael Kerrisk
+ Mention cpuset cgroups as a cause of EINVAL error
+
+seccomp.2
+ Mike Frysinger
+ Expand SECCOMP_RET_KILL documentation
+
+sigaction.2
+ Michael Kerrisk
+ Note feature test macro requirements for 'si_code' constants
+ Michael Kerrisk
+ Add a subheading for the description of 'si_code'
+ Michael Kerrisk
+ TRAP_BRANCH and TRAP_HWBKPT are present only on IA64
+
+sigaltstack.2
+ Michael Kerrisk
+ Note that specifying SS_ONSTACK in ss.ss_flags decreases portability
+ In the Illumos source (which presumably mirrors its Solaris
+ ancestry), there is this check in the sigaltstack()
+ implementation:
+
+ if (ss.ss_flags & ~SS_DISABLE)
+ return (set_errno(EINVAL));
+
+ And in the FreeBSD source we find similar:
+
+ if ((ss->ss_flags & ~SS_DISABLE) != 0)
+ return (EINVAL);
+ Michael Kerrisk
+ Note buggy addition of ss.ss_flags==SS_ONSTACK
+ Note buggy addition of ss.ss_flags==SS_ONSTACK as a synonym
+ for ss_flags==0. No other implementation does this, AFAIK.
+ And it was not needed :-(.
+ Michael Kerrisk
+ Specifying 'ss' returns the current settings without changing them
+ Michael Kerrisk
+ Give 'oss' argument a more meaningful name: 'old_ss'
+ Michael Kerrisk
+ Some minor reworking of the text
+ Michael Kerrisk
+ ERRORS: update description of EINVAL error
+
+splice.2
+tee.2
+vmsplice.2
+ Michael Kerrisk
+ SEE ALSO: add pipe(7)
+
+splice.2
+ Michael Kerrisk
+ ERRORS: split EINVAL error cases
+ Michael Kerrisk
+ ERRORS: add EINVAL for case where both descriptors refer to same pipe
+
+timer_create.2
+ Michael Kerrisk
+ Document the CONFIG_POSIX_TIMERS option added in Linux 4.10
+
+wait.2
+ Michael Kerrisk
+ Note glibc 2.26 changes to feature test macro requirements for waitid()
+
+acosh.3
+asinh.3
+atanh.3
+ Alex Henrie
+ Remove C89 designation.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=196319
+
+bsd_signal.3
+ Michael Kerrisk
+ Note feature test macro requirements changes for glibc 2.26
+
+dl_iterate_phdr.3
+ Michael Kerrisk
+ dl_iterate_phdr() shows the order in which objects were loaded
+ dl_iterate_phdr() tells us not just which objects are
+ loaded, but also the order in which they are loaded
+ (the "link-map order"). Since the order is relevant for
+ understanding symbol resolution, give the reader this clue.
+ Michael Kerrisk
+ Expand the code example, and show sample output
+ Michael Kerrisk
+ List values for the 'p_type' field
+
+dlsym.3
+ Michael Kerrisk
+ _GNU_SOURCE is needed to get RTLD_DEFAULT and RTLD_NEXT definitions
+
+flockfile.3
+ Michael Kerrisk
+ Note glibc 2.24 feature test macro requirement changes
+
+fpathconf.3
+ Michael Kerrisk
+ Rework RETURN VALUE description to add more detail
+ Michael Kerrisk
+ Add an errors section
+ Michael Kerrisk
+ Largely rewrite the description of _PC_CHOWN_RESTRICTED
+ Michael Kerrisk
+ Rewrite description of _PC_PIPE_BUF
+ The existing description was not accurate, and lacked details.
+
+ftw.3
+ Michael Kerrisk
+ BUGS: document a probable glibc regression in FTW_SLN case
+ See https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+ and http://austingroupbugs.net/view.php?id=1121.
+
+getaddrinfo.3
+ Quentin Rameau
+ Fix _POSIX_C_SOURCE value for getaddrinfo()
+ The correct _POSIX_C_SOURCE value is 200112L, not 201112L in features.h.
+
+getcontext.3
+ Carlos O'Donell
+ Exemplar structure should use 'ucontext_t'.
+
+getgrent.3
+ Michael Kerrisk
+ Note glibc 2.22 changes for feature test macro requirements
+
+grantpt.3
+ptsname.3
+unlockpt.3
+ Ferdinand Thiessen [Michael Kerrisk]
+ Update feature test macro-requirements for glibc 2.24
+
+if_nametoindex.3
+ Douglas Caetano dos Santos
+ Add ENODEV error for if_nametoindex()
+
+malloc.3
+ Michael Kerrisk
+ Document the reallocarray() added in glibc 2.26
+
+nl_langinfo.3
+ Michael Kerrisk
+ Note feature test macro requirements for nl_langinfo_l()
+
+posix_madvise.3
+ Dr. Tobias Quathamer
+ Remove paragraph about POSIX_FADV_NOREUSE
+ POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
+ corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.
+ See https://bugs.debian.org/865699
+
+ptsname.3
+ Michael Kerrisk [Arjun Shankar]
+ Since glibc 2.26, ptsname_r() no longer gives EINVAL for buf==NULL
+
+rand.3
+ Michael Kerrisk
+ Note glibc 2.24 feature test macro requirement changes for rand_r()
+
+resolver.3
+ Michael Kerrisk
+ Add basic notes on 'op' argument of res_nmkquery() and res_mkquery()
+
+sigpause.3
+ Michael Kerrisk
+ Note glibc 2.26 changes to feature test macro requirements
+
+sigwait.3
+ Michael Kerrisk
+ Note glibc 2.26 feature test macro changes
+
+strtol.3
+ Heinrich Schuchardt
+ Mention 0X prefix
+ The prefix 0x may be capitalized as 0X.
+
+ See ISO/IEC 9899:1999.
+
+sysconf.3
+ Michael Kerrisk [Pavel Tikhomirov]
+ Rework RETURN VALUE description to add more detail
+ Make the discussion clearer, and add a few details.
+ Also, fix the problem report from Pavel Tikhomirov
+ who noted that the man page falsely said that errno
+ is not changed on a successful return.
+
+ Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955
+ Michael Kerrisk
+ Add ERRORS section
+
+ttyslot.3
+ Michael Kerrisk
+ Fix error in feature test macro requirements
+ Michael Kerrisk
+ Note feature test macro requirements changes in glibc 2.24
+ Michael Kerrisk
+ Clarify details of use of <stdlib.h> file
+
+unlocked_stdio.3
+ Michael Kerrisk
+ Note glibc 2.24 feature test macro requirement changes
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add dl_iterate_phdr(3)
+
+nsswitch.conf.5
+ DJ Delorie
+ Clarify group merge rules
+ This minor patch clarifies when merging is not done,
+ and how duplicate entries are merged.
+
+proc.5
+ Michael Kerrisk
+ Document that 'iowait' field of /proc/stat is unreliable
+ Text taken from Chao Fan's kernel commit 9c240d757658a3ae996.
+
+slabinfo.5
+ Michael Kerrisk [Jorge Nerin]
+ SEE ALSO: add some references to relevant kernel source files
+
+tmpfs.5
+ Michael Kerrisk
+ SEE ALSO: add memfd_create(2), mmap(2), shm_open(3)
+
+capabilities.7
+ Michael Kerrisk
+ Clarify the effect on process capabilities when UID 0 does execve(2)
+ Michael Kerrisk
+ Note effect on capabilities when a process with UID != 0 does execve(2)
+ Michael Kerrisk [David Lewis]
+ Fix reversed descriptions of CAP_MAC_OVERRIDE and CAP_MAC_ADMIN
+ Michael Kerrisk
+ SEE ALSO: add filecap(8), netcap(8), pscap(8)
+
+cgroup_namespaces.7
+ Michael Kerrisk
+ Add some further explanation of the example shell session
+ Michael Kerrisk
+ Fix a bug in shell session example
+
+inode.7
+ Michael Kerrisk
+ Note glibc 2.24 feature test macro changes for S_IFSOCK and S_ISSOCK()
+
+man.7
+ G. Branden Robinson
+ Undocument "URL" macro in man(7) in favor .UR+.UE
+
+pid_namespaces.7
+ Michael Kerrisk
+ Mention /proc/[pid]/ns/pid_for_children
+
+pipe.7
+ Michael Kerrisk
+ SEE ALSO: add tee(2) and vmsplice(2)
+
+sigevent.7
+ Michael Kerrisk
+ Mention signal.h header file
+
+signal.7
+ Michael Kerrisk [lilydjwg]
+ Since Linux 3.8, read(2) on an inotify FD is restartable with SA_RESTART
+ See https://bugzilla.kernel.org/show_bug.cgi?id=195711
+ Michael Kerrisk
+ read() from an inotify FD is no longer interrupted by a stop signal
+ (Change was in Linux 3.8.)
+
+tcp.7
+ Michael Kerrisk
+ Document value '2' for tcp_timestamps
+ Since Linux 4.10, the value '2' is meaningful for tcp_timestamps
+ Ruben Kerkhof
+ Change default value of tcp_frto
+ The default changed in c96fd3d461fa495400df24be3b3b66f0e0b152f9
+ (Linux 2.6.24).
+
+ld.so.8
+ Michael Kerrisk
+ Greatly expand the explanation of LD_DYNAMIC_WEAK
+ Carlos O'Donell
+ Expand DT_RUNPATH details.
+ ld.so.8: Expand DT_RUNPATH details.
+
+ Every 3 years we get asked why DT_RUNPATH doesn't work like DT_RPATH.
+ The most recent question was here:
+ https://www.sourceware.org/ml/libc-help/2017-06/msg00013.html
+
+ We need to expand the description of DT_RUNPATH to cover this
+ situation and explain that the DT_RUNPATH entries apply only to the
+ immediate DT_NEEDED, not that of another, say dlopen'd child object.
+ Michael Kerrisk
+ Since glibc 2.2.5, LD_PROFILE is ignored in secure-execution mode
+ Michael Kerrisk
+ Make notes on secure-execute mode more prominent
+ Place each note on secure-execution mode in a separate
+ paragraph, to make it more obvious.
+ Michael Kerrisk
+ Note that libraries in standard directories are not normally set-UID
+ In secure mode, LD_PRELOAD loads only libraries from standard
+ directories that are marked set-UID. Note that it is unusual for
+ a library to be marked in this way.
+ Michael Kerrisk
+ SEE ALSO: add elf(5)
+ Michael Kerrisk
+ Note version where secure-execution started ignoring LD_USE_LOAD_BIAS
+ Michael Kerrisk
+ Correct glibc version that ignores LD_SHOW_AUXV in secure-execution mode
+ Ignored since 2.3.4 (not 2.3.5).
+ Michael Kerrisk
+ Rewrite LD_DEBUG_OUTPUT description and note that .PID is appended
+
+
+==================== Changes in man-pages-4.13 ====================
+
+Released: 2017-09-15, 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:
+
+Aleksa Sarai <asarai@suse.de>
+Alex Henrie <alexhenrie24@gmail.com>
+Benjamin Peterson <bp@benjamin.pe>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Cyrill Gorcunov <gorcunov@openvz.org>
+Darrick J. Wong <darrick.wong@oracle.com>
+David Wilder <dwilder@us.ibm.com>
+Dennis Knorr <dennis.knorr@muenchen.de>
+Don Brace <don.brace@microsemi.com>
+Douglas Caetano dos Santos <douglascs@taghos.com.br>
+Elliott Hughes <enh@google.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabio Scotoni <fabio@esse.ch>
+Florian Weimer <fweimer@redhat.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jason Noakes <jjnoakes@gmail.com>
+Jens Axboe <axboe@kernel.dk>
+Jonas Grabber <jobegrabber@gmail.com>
+Kees Cook <keescook@chromium.org>
+Konstantin Shemyak <konstantin@shemyak.com>
+Li Zhijian <lizhijian@cn.fujitsu.com>
+Marko Myllynen <myllynen@redhat.com>
+Mark Wielaard <mark@klomp.org>
+Meelis Roos <mroos@linux.ee>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Rapoport <rppt@linux.vnet.ibm.com>
+NeilBrown <neilb@suse.com>
+Otto Ebeling <oebeling@github.mail.kapsi.fi>
+Paul Eggert <eggert@cs.ucla.edu>
+Rick Jones <rick.jones2@hpe.com>
+Sage Weil <sage@redhat.com>
+Sam Varshavchik <mrsam@courier-mta.com>
+Sergey Z. <zhurxx@gmail.com>
+Shrikant Giridhar <shrikantgiridhar@gmail.com>
+Stephan Müller <smueller@chronox.de>
+Sukadev Bhattiprolu <sukadev@linux.vnet.ibm.com>
+Tej Chajed <tchajed@mit.edu>
+Thiago Jung Bauermann <bauerman@linux.vnet.ibm.com>
+Vincent Bernat <vincent@bernat.im>
+Yubin Ruan <ablacktshirt@gmail.com>
+Ильдар Низамов <niya3@mail.ru>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pthread_mutex_consistent.3
+ Yubin Ruan, Michael Kerrisk
+ New page documenting pthread_mutex_consistent(3)
+
+pthread_mutexattr_getpshared.3
+ Michael Kerrisk
+ New page for pthread_mutexattr_getpshared(3) and pthread_mutexattr_setpshared(3)
+
+pthread_mutexattr_init.3
+ Michael Kerrisk
+ New page for pthread_mutexattr_init(3) and pthread_mutexattr_destroy(3)
+
+pthread_mutexattr_setrobust.3
+ Yubin Ruan, Michael Kerrisk
+ New page for pthread_mutexattr_setrobust(3) and pthread_mutexattr_getrobust(3)
+
+sysfs.5
+ Michael Kerrisk [Mark Wielaard]
+ New page documenting the sysfs filesystem
+ Just a skeleton page so far, but perhaps it will be filled out
+ over time.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fcntl.2
+ Jens Axboe, Michael Kerrisk
+ Describe the set/get write hints commands that are added in Linux 4.13
+ Document F_GET_RW_HINT, F_SET_RW_HINT, F_GET_FILE_RW_HINT, and
+ F_SET_FILE_RW_HINT.
+
+ioctl_tty.2
+ Aleksa Sarai, Michael Kerrisk
+ Add TIOCGPTPEER documentation
+
+kcmp.2
+ Cyrill Gorcunov
+ Add KCMP_EPOLL_TFD description
+
+keyctl.2
+ Eugene Syromyatnikov
+ Document the KEYCTL_RESTRICT_KEYRING operation
+ Eugene Syromyatnikov [Stephan Müller]
+ Document the ability to provide KDF parameters in KEYCTL_DH_COMPUTE
+
+
+New and changed links
+---------------------
+
+pthread_mutexattr_destroy.3
+ Michael Kerrisk
+ New link to new pthread_mutexattr_init.3 page
+
+pthread_mutexattr_getrobust.3
+pthread_mutexattr_getrobust_np.3
+pthread_mutexattr_setrobust_np.3
+ Michael Kerrisk
+ New links to new pthread_mutexattr_setrobust.3 page
+
+pthread_mutexattr_setpshared.3
+ Michael Kerrisk
+ New link to new pthread_mutexattr_getpshared.3 page
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Use .EX/.EE for EXAMPLE programs
+
+Various pages
+ Michael Kerrisk
+ Use consistent markup for code snippets
+ Change .nf/.fi to .EX/.EE
+
+Various pages
+ Michael Kerrisk
+ Use consistent markup for code snippets
+ The preferred form is
+
+ .PP/.IP
+ .in +4n
+ .EX
+ <code>
+ .EE
+ .in
+ .PP/.IP
+
+Various pages
+ Michael Kerrisk
+ Formatting fix: replace blank lines with .PP/.IP
+ Blank lines shouldn't generally appear in *roff source (other
+ than in code examples), since they create large vertical
+ spaces between text blocks.
+
+Various pages
+ Michael Kerrisk [Bjarni Ingi Gislason]
+ Add a non-breaking space between a number and a unit (prefix)
+ Based on a patch by Bjarni Ingi Gislason.
+
+Various pages
+ Michael Kerrisk [Bjarni Ingi Gislason]
+ Use en-dash for ranges
+ Based on a patch by Bjarni Ingi Gislason.
+
+A few pages
+ Michael Kerrisk
+ Fix misordering of sections
+ Michael Kerrisk
+ Fix order of SEE ALSO entries
+
+
+Changes to individual pages
+---------------------------
+
+ldd.1
+ Michael Kerrisk
+ Add more detail on ldd security implications, noting glibc 2.27 changes
+
+add_key.2
+backtrace.3
+syslog.3
+ Michael Kerrisk
+ Fix misordered SEE ALSO entries
+
+add_key.2
+request_key.2
+keyrings.7
+ Eugene Syromyatnikov
+ Update Linux documentation pointers
+
+chown.2
+ Michael Kerrisk
+ Update kernel version in note on support for grpid/nogrpid mount options
+ There has been no change since Linux 2.6.25, so update the
+ kernel version to 4.12.
+
+execve.2
+ Michael Kerrisk
+ SEE ALSO: add get_robust_list(2)
+
+getrandom.2
+ Michael Kerrisk [Fabio Scotoni]
+ SYNOPSIS: make return type of getrandom() 'ssize_t'
+ This accords with glibc headers and the Linux kernel source.
+
+getrlimit.2
+ Thiago Jung Bauermann
+ Mention unit used by RLIMIT_CORE and RLIMIT_FSIZE
+ Michael Kerrisk
+ Note that RLIMIT_AS and RLIMIT_DATA are rounded down to system page size
+ Michael Kerrisk
+ Mention unit for RLIMIT_DATA
+
+getrlimit.2
+mmap.2
+malloc.3
+ Jonas Grabber
+ RLIMIT_DATA affects mmap(2) since Linux 4.7
+
+get_robust_list.2
+ Michael Kerrisk
+ Detail the operation of robust futex lists
+ Michael Kerrisk
+ Since Linux 2.6.28, robust futex lists also have an effect for execve(2)
+ Michael Kerrisk
+ Clarify that "thread ID" means "kernel thread ID"
+ Michael Kerrisk
+ SEE ALSO: add pthread_mutexattr_setrobust(3)
+
+ioctl_getfsmap.2
+ Darrick J. Wong
+ Correct semantics of FMR_OF_LAST flag
+
+ioctl_userfaultfd.2
+ Mike Rapoport
+ Document replacement of ENOSPC with ESRCH
+ Mike Rapoport
+ Update uffdio_api.features description
+ There is no requirement that uffdio_api.features must be zero
+ for newer kernels. This field actually defines what features
+ space would like to enable.
+
+io_submit.2
+ Sage Weil
+ Acknowledge possibility of short return
+ Note that the return value may be a value less than 'nr'
+ if not all iocbs were queued at once.
+
+ipc.2
+ Michael Kerrisk
+ SEE ALSO: add svipc(7)
+
+keyctl.2
+ Eugene Syromyatnikov
+ mention keyctl_dh_compute(3) and keyctl_dh_compute_alloc (3)
+ These functions have been added in keyutils 1.5.10
+ Eugene Syromyatnikov
+ Mention ENOMEM in ERRORS
+ Eugene Syromyatnikov
+ Update kernel documentation path reference
+
+move_pages.2
+ Otto Ebeling [Michael Kerrisk]
+ Note permission changes that occurred in Linux 4.13
+
+mprotect.2
+ Michael Kerrisk [Shrikant Giridhar]
+ Add warning about the use of printf() in the example code
+
+open.2
+ NeilBrown
+ Improve O_PATH documentation
+ - fstatfs is now permitted.
+ - ioctl isn't, and is worth listing explicitly
+ - O_PATH allows an automount point to be opened with
+ triggering the mount.
+
+prctl.2
+seccomp.2
+ Eugene Syromyatnikov
+ Update pointer to in-kernel seccomp documentation
+
+prctl.2
+ptrace.2
+ Eugene Syromyatnikov
+ Update pointer to in-kernel Yama documentation
+
+prctl.2
+ Eugene Syromyatnikov
+ Update pointer to in-kernel no_new_privs flag documentation
+
+readlink.2
+ Michael Kerrisk [Jason Noakes]
+ Fix an off-by-one error in example code
+
+seccomp.2
+ Kees Cook
+ Clarify SECCOMP_RET_KILL kills tasks not processes
+
+select_tut.2
+ Michael Kerrisk [Sergey Z.]
+ Clarify an ambiguity with respect to select() and EAGAIN
+ See https://bugzilla.kernel.org/show_bug.cgi?id=196345
+
+set_tid_address.2
+ Elliott Hughes
+ Note that there's no glibc wrapper for set_tid_address()
+
+socket.2
+ Michael Kerrisk [Yubin Ruan]
+ socket() uses the lowest available file descriptor
+
+_syscall.2
+ Michael Kerrisk
+ Remove redundant comment from EXAMPLE
+ A discussion of the nroff source of the manual
+ page isn't very useful...
+
+sysfs.2
+ Michael Kerrisk
+ Add a pointer to sysfs(5) to help possibly confused readers
+ Michael Kerrisk
+ Make it clearer near the start of the page that sysfs(2) is obsolete
+
+timer_create.2
+ Michael Kerrisk
+ Strengthen the warning about use of printf() in the example program
+ Michael Kerrisk
+ Update cross reference: signal(7) should be signal-safety(7)
+
+umount.2
+ NeilBrown
+ Revise MNT_FORCE description
+ MNT_FORCE does not allow a busy filesystem to be unmounted. Only
+ MNT_DETACH allows that. MNT_FORCE only tries to abort pending
+ transactions, in the hope that might help umount not to block,
+
+ Also, other filesystems than NFS support MNT_FORCE.
+
+unshare.2
+ Eugene Syromyatnikov
+ Update pointer to in-kernel unshare documentation
+
+wait.2
+ Michael Kerrisk [Ильдар Низамов]
+ POSIX.1-2008 TC1 clarifies treatment of 'si_pid' for waitid() WNOHANG
+
+cmsg.3
+ Sukadev Bhattiprolu
+ Add a scatter/gather buffer to sample code
+ Michael Kerrisk
+ Reorganize the text somewhat (no content changes)
+
+crypt.3
+ Konstantin Shemyak [Michael Kerrisk]
+ Add description of previously undocumented 'rounds' parameter
+ Konstantin Shemyak
+ Encryption isn't done with SHA-xxx, but with a function based on SHA-xxx
+ Konstantin Shemyak
+ Clarify that ending of the salt string with '$' is optional
+
+exit.3
+ Michael Kerrisk
+ Mention the prctl(2) PR_SET_PDEATHSIG operation
+ Michael Kerrisk
+ SEE ALSO: add get_robust_list(2)
+ Michael Kerrisk
+ Add a heading to delimit discussion of signals sent to other processes
+
+exp2.3
+ Alex Henrie
+ Remove C89 designation
+
+log1p.3
+ Alex Henrie
+ Document fixes to give EDOM or ERANGE on error
+
+matherr.3
+ Michael Kerrisk
+ Note that glibc 2.27 removes the 'matherr' mechanism
+ Michael Kerrisk
+ Remove crufty feature test macro requirements
+
+pow10.3
+ Michael Kerrisk
+ Note that pow10() is now obsolete in favor of exp10()
+ Also, the pow10() functions are no longer supported by glibc,
+ starting with version 2.27.
+
+sincos.3
+ Michael Kerrisk
+ Note that sincos() is intended to be more efficient than sin() + cos()
+
+cciss.4
+hpsa.4
+ Eugene Syromyatnikov [Don Brace, Meelis Roos]
+ Mention cciss removal in Linux 4.14
+ During the Linux 4.13 development cycle, the cciss driver has been
+ removed in favor of the hpsa driver, which has been amended with
+ some legacy board support.
+
+initrd.4
+proc.5
+bootparam.7
+ Eugene Syromyatnikov
+ Update pointer to in-kernel initrd documentation
+
+initrd.4
+ Eugene Syromyatnikov
+ Update pointer to in-kernel root over NFS documentation
+
+intro.4
+ Michael Kerrisk
+ SEE ALSO: add mknod(1) and mknod(2)
+
+host.conf.5
+ Michael Kerrisk
+ Add cross-reference to hosts(5)
+
+locale.5
+ Marko Myllynen
+ Refer to existing locales for encoding details
+ Since I don't think it would make sense to try to have different
+ explanation for each glibc version on the locale(5) man page, I'm
+ proposing that we apply the below patch so that we refer to
+ existing locale definition files in general and not spell out the
+ exact format or any certain locale as a definitive guideline.
+
+nologin.5
+ Michael Kerrisk
+ Add a sentence explaining why nologin is useful
+
+proc.5
+ Eugene Syromyatnikov
+ Document removal of htab-reclaim sysctl file
+ This PPC-specific sysctl option has been removed in Linux 2.4.9.2,
+ according to historic Linux repository commit log.
+ Eugene Syromyatnikov
+ Add description for cpuN lines in /proc/stat
+ Eugene Syromyatnikov
+ Add description for softirq line in /proc/stat
+ Eugene Syromyatnikov
+ Document removal of timer_stats file
+ Michael Kerrisk
+ Note Linux 4.9 changes to privileges for /proc/[pid]/timerslack_ns
+ Michael Kerrisk
+ Show command used to mount /proc
+ Michael Kerrisk
+ Explicitly note in intro that some /proc files are writable
+ Eugene Syromyatnikov
+ Update pointer to in-kernel SysRq documentation
+ Michael Kerrisk
+ SEE ALSO: add sysfs(5)
+ Eugene Syromyatnikov
+ Update pointer to in-kernel security keys documentation
+ Benjamin Peterson
+ Fix path to binfmt_misc docs
+ Eugene Syromyatnikov
+ Update pointer to in-kernel MTRR documentation
+ Eugene Syromyatnikov
+ Update reference to kernel's crypto API documentation
+
+tzfile.5
+ Paul Eggert
+ Sync from tzdb upstream
+ This makes tzfile.5 a copy of the tzdb version, except that the
+ tzdb version's first line is replaced by man-pages boilerplate.
+ The new version documents version 3 format, among other things.
+ Also, it removes the "Summary of the timezone information file
+ format" section, which should no longer be needed due to
+ improvements in the part of the man page.
+
+capabilities.7
+ Michael Kerrisk
+ Note semantics for a program that is set-UID-root and has capabilities
+ Note semantics for a program that is both set-user-ID-root and has
+ file capabilities.
+ Michael Kerrisk [Dennis Knorr]
+ Note that a set-UID-root program may have an empty file capability set
+
+cgroups.7
+ Michael Kerrisk
+ SEE ALSO: systemd-cgls(1)
+
+cpuset.7
+ Eugene Syromyatnikov
+ Update pointer to in-kernel cpusets documentation
+
+keyrings.7
+ Eugene Syromyatnikov
+ Document description restriction for logon keys
+ "logon" type has additional check that enforces colon-separated
+ prefix in key descriptions.
+ Eugene Syromyatnikov
+ Add pointers to kernel's documentation
+ Mostly because of asymmetric-keys.txt, which is outside
+ security/keys for some reason.
+
+man-pages.7
+ Michael Kerrisk
+ Expand the guidance on formatting code snippets
+
+netlink.7
+ David Wilder
+ Change buffer size in example code about reading netlink message
+ Michael Kerrisk [Rick Jones]
+ Add a comment on 8192 buffer size in example code
+
+pthreads.7
+ Michael Kerrisk
+ SEE ALSO: add pthread_mutexattr_destroy(3) and pthread_mutexattr_init(3)
+
+signal.7
+ Michael Kerrisk
+ Since glibc 2.26, SIGUNUSED is no longer defined
+
+tcp.7
+ Vincent Bernat
+ tcp_tw_recycle is removed from Linux 4.12
+ And it is completely broken.
+
+unicode.7
+ Eugene Syromyatnikov
+ Update pointer to in-kernel Unicode terminal support documentation
+
+
+==================== Changes in man-pages-4.14 ====================
+
+Released: 2017-11-27, Paris
+
+
+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:
+
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Adrian Bunk <bunk@kernel.org>
+Ahmad Fatoum <ahmad@a3f.at>
+Andrea Arcangeli <aarcange@redhat.com>
+Bastien Roucaries <roucaries.bastien@gmail.com>
+Breno Leitao <leitao@debian.org>
+Carlos O'Donell <carlos@redhat.com>
+Christian Brauner <christian.brauner@ubuntu.com>
+Christoph Hellwig <hch@lst.de>
+Colm MacCárthaigh <colm@allcosts.net>
+Craig Ringer <craig.ringer@2ndquadrant.com>
+Cristian Rodríguez <crrodriguez@opensuse.org>
+David Eckardt <david.eckardt@sociomantic.com>
+Don Brace <don.brace@microsemi.com>
+Elliot Hughes <enh@google.com>
+Eric W. Biederman <ebiederm@xmission.com>
+Fabio Scotoni <fabio@esse.ch>
+Fangrui Song <i@maskray.me>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Goldwyn Rodrigues <rgoldwyn@suse.com>
+Grégory Vander Schueren <gregory.vanderschueren@tessares.net>
+Jakub Wilk <jwilk@jwilk.net>
+Jann Horn <jannh@google.com>
+Jeff Layton <jlayton@redhat.com>
+Jens Axboe <axboe@kernel.dk>
+Jonny Grant <jg@jguk.org>
+Julien Gomes <julien@arista.com>
+Kees Cook <keescook@chromium.org>
+Křištof Želechovski <giecrilj@stegny.2a.pl>
+Lennart Poettering <lennart@poettering.net>
+Lucas Werkmeister <mail@lucaswerkmeister.de>
+Marcus Folkesson <marcus.folkesson@gmail.com>
+Marin H. <mar-tSIEzQ@neutronstar.noip.me>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Matthew Wilcox <willy@infradead.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@kernel.org>
+Michał Zegan <webczat_200@poczta.onet.pl>
+Mihir Mehta <mihir@cs.utexas.edu>
+Mike Frysinger <vapier@chromium.org>
+Mike Kravetz <mike.kravetz@oracle.com>
+Mike Rapoport <rppt@linux.vnet.ibm.com>
+Miklos Szeredi <mszeredi@redhat.com>
+NeilBrown <neilb@suse.com>
+Oliver Ebert <oe@outputenable.net>
+Pedro Alves <palves@redhat.com>
+Per Böhlin <Per.Bohlin@zenterio.com>
+Peter Zijlstra <peterz@infradead.org>
+Petr Malat <oss@malat.biz>
+Petr Uzel <petr.uzel@suse.cz>
+Prakash Sangappa <prakash.sangappa@oracle.com>
+Raghavendra D Prabhu <me@rdprabhu.com>
+Rahul Bedarkar <rpal143@gmail.com>
+Ram Pai <linuxram@us.ibm.com>
+Richard Knutsson <richard.knutsson@abelko.se>
+Rik van Riel <riel@redhat.com>
+Scott Vokes <vokes.s@gmail.com>
+Seonghun Lim <wariua@gmail.com>
+Stas Sergeev <stsp@list.ru>
+Stefan Puiu <stefan.puiu@gmail.com>
+Thomas Gleixner <tglx@linutronix.de>
+Tobias Klausmann <klausman@schwarzvogel.de>
+Tomas Pospisek <tpo@sourcepole.ch>
+Tyler Hicks <tyhicks@canonical.com>
+Victor Porton <porton@narod.ru>
+Walter Harms <wharms@bfs.de>
+Wesley Aptekar-Cassels <w.aptekar@gmail.com>
+Yubin Ruan <ablacktshirt@gmail.com>
+Zack Weinberg <zackw@panix.com>
+Дилян Палаузов <dilyan.palauzov@aegee.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pthread_spin_init.3
+ Michael Kerrisk [Peter Zijlstra, Thomas Gleixner, Zack Weinberg,
+ Florian Weimer]
+ New page describing pthread_spin_init(3) and pthread_spin_destroy(3)
+
+pthread_spin_lock.3
+ Michael Kerrisk [Carlos O'Donell]
+ New page describing functions that lock and unlock spin locks
+ Add a page describing pthread_spin_lock(3), pthread_spin_unlock(3),
+ and pthread_spin_trylock(3).
+
+smartpqi.4
+ Don Brace [Michael Kerrisk, G. Branden Robinson]
+ Document the smartpqi SCSI driver
+
+veth.4
+ Tomáš Pospíšek, Eric Biederman, Michael Kerrisk
+ New page documenting veth virtual ethernet devices
+ Based on a page from Tomáš Pospíšek, with some clean-ups by mtk.
+
+
+Removed pages
+-------------
+
+infnan.3:
+ Michael Kerrisk
+ This function was in libc4 and libc5, but never part
+ of glibc. It ceased to be relevant nearly 20 years
+ ago. Time to remove the man page.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ioctl_userfaultfd.2
+userfaultfd.2
+ Prakash Sangappa [Andrea Arcangeli, Mike Rapoport]
+ Add description for UFFD_FEATURE_SIGBUS
+
+madvise.2
+ Rik van Riel [Colm MacCárthaigh, Michael Kerrisk]
+ Document MADV_WIPEONFORK and MADV_KEEPONFORK
+ Michael Kerrisk
+ Note fork() and execve() semantics for wipe-on-fork setting
+
+membarrier.2
+ Mathieu Desnoyers
+ Update membarrier manpage for 4.14
+ Add documentation for these new membarrier() commands:
+ MEMBARRIER_CMD_PRIVATE_EXPEDITED
+ MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED
+
+memfd_create.2
+ Mike Kravetz
+ Add description of MFD_HUGETLB (hugetlbfs) support
+ hugetlbfs support for memfd_create() was recently merged by Linus
+ and should be in the Linux 4.14 release. To request hugetlbfs
+ support a new memfd_create() flag (MFD_HUGETLB) was added.
+
+readv.2
+ Christoph Hellwig
+ Document RWF_NOWAIT added in Linux 4.14
+
+seccomp.2
+ Tyler Hicks
+ Document the SECCOMP_GET_ACTION_AVAIL operation added in Linux 4.14
+ Tyler Hicks
+ Document the SECCOMP_FILTER_FLAG_LOG flag added in Linux 4.14
+ Tyler Hicks
+ Document the SECCOMP_RET_LOG action added In Linux 4.14
+ Michael Kerrisk [Kees Cook]
+ Add description of SECCOMP_RET_KILL_PROCESS
+ Michael Kerrisk
+ Add SECCOMP_RET_KILL_THREAD description and rework SECCOMP_RET_KILL text
+ Michael Kerrisk
+ Document the seccomp audit logging feature added in Linux 4.14
+
+seccomp.2
+proc.5
+ Tyler Hicks
+ Document the seccomp /proc interfaces added in Linux 4.14
+ Document the seccomp /proc interfaces in Linux 4.14:
+ /proc/sys/kernel/seccomp/actions_avail and
+ /proc/sys/kernel/seccomp/actions_logged.
+
+sigaltstack.2
+ Michael Kerrisk [Stas Sergeev]
+ Document the SS_AUTODISARM flag added in Linux 4.7
+
+proc.5
+ Michael Kerrisk
+ Document /proc/locks
+ Oliver Ebert
+ Document /proc/kpagecgroup
+ Oliver Ebert
+ Add KPF_BALLOON, KPF_ZERO_PAGE, and KPF_IDLE for /proc/kpageflags
+
+pid_namespaces.7
+ Michael Kerrisk
+ Document /proc/sys/kernel/ns_last_pid
+
+
+New and changed links
+---------------------
+
+pthread_spin_destroy.3
+ Michael Kerrisk
+ New link to new pthread_spin_init.3 page
+
+pthread_spin_trylock.3
+pthread_spin_unlock.3
+ Michael Kerrisk
+ New links to new pthread_spin_lock.3 page
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Consistently use "x86-64", not "x86_64"
+ When referring to the architecture, consistently use "x86-64",
+ not "x86_64". Hitherto, there was a mixture of usages, with
+ "x86-64" predominant.
+
+Various pages
+ G. Branden Robinson
+ Replace incorrect uses of Latin abbreviation "cf.".
+ People seem to be using "cf." ("conferre"), which means "compare",
+ to mean "see" instead, for which the Latin abbreviation would be
+ "q.v." ("quod vide" -> "which see").
+
+ In some cases "cf." might actually be the correct term but it's
+ still not clear what specific aspects of a function/system call
+ one is supposed to be comparing.
+
+
+
+Changes to individual pages
+---------------------------
+
+capget.2
+ Michael Kerrisk
+ Clarify discussion of kernels that have no VFS capability support
+
+clock_getres.2
+ Michael Kerrisk
+ clock_gettime() may be implemented in the vDSO
+
+clone.2
+ Michael Kerrisk
+ Warn that the clone() wrapper modifies child_stack in the parent
+ Michael Kerrisk
+ Rework the discussion of the historical CLONE_PID for clarity
+ Michael Kerrisk
+ Add NOTES heading
+ Michael Kerrisk
+ Add a reference to new veth(4) page
+ Michael Kerrisk
+ Eliminate some redundant phrasing in discussion of "fn()"
+ Michael Kerrisk
+ Combine redundant paragraphs describing child_stack==NULL
+ Michael Kerrisk
+ Note that child_stack can be NULL when using the raw system call
+ Michael Kerrisk
+ Remove a redundant paragraph
+
+connect.2
+ Michael Kerrisk
+ Clarify that ECONNREFUSED is for stream sockets
+
+fcntl.2
+ Michael Kerrisk [Jens Axboe]
+ Inode read-write hints persist only until the filesystem is unmounted
+
+flock.2
+ Michael Kerrisk
+ Move NFS details to a headed subsection
+ Michael Kerrisk [Petr Uzel]
+ Placing an exclusive lock over NFS requires the file is open for writing
+
+fork.2
+ Rik van Riel [Colm MacCárthaigh, Michael Kerrisk]
+ Document effect of MADV_WIPEONFORK
+
+fork.2
+getsid.2
+setpgid.2
+setsid.2
+ Ahmad Fatoum
+ Include <sys/types.h> in SYNOPSIS to obtain declaration of pid_t
+
+fsync.2
+ Craig Ringer
+ ERRORS: add ENOSPC
+
+getcpu.2
+ Michael Kerrisk
+ getcpu() may have an implementation in the vDSO
+
+getpid.2
+ Michael Kerrisk
+ Mention that PID == TGID, and note contrast with TID
+ Michael Kerrisk
+ SEE ALSO: add gettid(2)
+
+getrandom.2
+ Michael Kerrisk [Fabio Scotoni]
+ ERRORS: add ENOSYS
+
+getrlimit.2
+ Michael Kerrisk [Scott Vokes]
+ Make it clear RLIMIT_NPROC is a limit on current number of processes
+ https://twitter.com/silentbicycle/status/893849097903505409
+
+gettid.2
+ Michael Kerrisk
+ SEE ALSO: add getpid(2)
+
+gettimeofday.2
+ Michael Kerrisk
+ Note that gettimeofday() may be implemented in the vDSO
+
+ioctl_userfaultfd.2
+ Michael Kerrisk
+ Rework version information for feature bits
+
+io_submit.2
+ Goldwyn Rodrigues
+ Add iocb details to io_submit
+ Add more information about the iocb structure. Explains the
+ fields of the I/O control block structure which is passed to the
+ io_submit() call.
+ Michael Kerrisk
+ Add cross-reference to io_getevents(2)
+ Michael Kerrisk
+ Cross reference pwritev(2) in discussion of RWF_SYNC and RWF_DSYNC
+
+membarrier.2
+ Mathieu Desnoyers
+ Update example to take TSO into account
+ The existing example given specifically states that it focus on
+ x86 (TSO memory model), but gives a read-read vs write-write
+ ordering example, even though this scenario does not require
+ explicit barriers on TSO.
+
+ So either we change the example architecture to a weakly-ordered
+ architecture, or we change the example to a scenario requiring
+ barriers on x86.
+
+ Let's stay on x86, but provide a Dekker as example instead.
+ Mathieu Desnoyers
+ Adapt the MEMBARRIER_CMD_SHARED return value documentation to
+ reflect that it now returns -EINVAL when issued on a system
+ configured for nohz_full.
+
+memfd_create.2
+ Michael Kerrisk
+ Note the limit for size of 'name'
+
+mkdir.2
+ Michael Kerrisk [Raghavendra D Prabhu]
+ ERRORS: document EINVAL error for invalid filename
+
+mmap.2
+ Michael Kerrisk
+ Add explicit text noting that 'length' must be greater than 0
+ Currently, this detail is hidden in ERRORS. Make it clear in
+ the main text.
+ Michael Kerrisk
+ SEE ALSO: add ftruncate(2)
+
+mremap.2
+ Mike Kravetz [Florian Weimer, Jann Horn]
+ Add description of old_size == 0 functionality
+ Since at least the 2.6 time frame, mremap() would create a new
+ mapping of the same pages if 'old_size == 0'. It would also leave
+ the original mapping. This was used to create a 'duplicate
+ mapping'.
+
+ A recent change was made to mremap() so that an attempt to create a
+ duplicate a private mapping will fail.
+ Michael Kerrisk [Michal Hocko, Mike Kravetz]
+ BUGS: describe older behavior for old_size==0 on private mappings
+ Explain the older behavior, and why it changed. This is a
+ follow-up to Mike Kravetz's patch documenting the behavior
+ for old_size==0 with shared mappings.
+ Michael Kerrisk
+ Reformat EINVAL errors as a list
+
+open.2
+ Michael Kerrisk
+ By contrast with O_RDONLY, no file permissions are required for O_PATH
+ Note one of the significant advantages of O_PATH: many of the
+ operations applied to O_PATH file descriptors don't require
+ read permission, so there's no reason why the open() itself
+ should require read permission.
+ Michael Kerrisk
+ Note use of O_PATH to provide O_EXEC functionality
+ Michael Kerrisk
+ Mention O_PATH file descriptor use with fexecve(3)
+ Michael Kerrisk
+ ERRORS: document EINVAL error for invalid filename
+ Michael Kerrisk
+ Clarify that O_TMPFILE creates a *regular* file
+ Michael Kerrisk
+ Make it explicit that O_CREAT creates a regular file
+ Michael Kerrisk
+ Since glibc 2.26, the open() wrapper always uses the openat() syscall
+ Michael Kerrisk
+ Change pathname used in discussion of rationale for openat()
+ /path/to/file is a little confusing as a pathname
+ Michael Kerrisk
+ Make the purpose of open() a little clearer at the start of the page
+
+open_by_handle_at.2
+ NeilBrown
+ Clarifications needed due to NFS reexport
+ NeilBrown [Lennart Poettering]
+ Clarify MAX_HANDLE_SZ
+ As hinted in the kernel source, MAX_HANDLE_SZ is a hint
+ rather than a promise.
+
+pipe.2
+ Michael Kerrisk [Marin H.]
+ Since Linux 4.5, fcntl() can be used to set O_DIRECT for a pipe
+ See https://bugzilla.kernel.org/show_bug.cgi?id=197917
+
+pivot_root.2
+ Michael Kerrisk
+ SEE ALSO: add switch_root(8)
+
+pkey_alloc.2
+ Breno Leitao
+ Fix argument order
+ Currently pkey_alloc() syscall has two arguments, and the very
+ first argument is still not supported and should be set to zero.
+ The second argument is the one that should specify the
+ page access rights.
+
+ptrace.2
+ Michael Kerrisk
+ SEE ALSO: add ltrace(1)
+
+reboot.2
+ Michael Kerrisk [Michał Zegan]
+ Fix bogus description of reboot() from non-initial PID namespace
+ The current text was confused (mea culpa). No signal is sent to
+ the init() process. Rather, depending on the 'cmd' given to
+ reboot(), the 'group_exit_code' value will set to either SIGHUP or
+ SIGINT, with the effect that one of those signals is reported to
+ wait() in the parent process.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=195899
+ Michael Kerrisk
+ SEE ALSO: remove reboot(8) (synonym for halt(8)); add shutdown(8)
+ Michael Kerrisk
+ SEE ALSO: add systemctl(1), systemd(1)
+
+recvmmsg.2
+sendmmsg.2
+ Elliot Hughes
+ Type fixes in SYNOPSIS
+ [mtk: The raw system calls use "unsigned int", but the glibc
+ wrappers have "int" for the 'flags' argument.]
+
+sched_setaffinity.2
+ Michael Kerrisk
+ SEE ALSO: add numactl(8)
+
+sched_yield.2
+ Michael Kerrisk [Peter Zijlstra]
+ sched_yield() is intended for use with real-time scheduling policies
+
+seccomp.2
+ Michael Kerrisk [Adhemerval Zanella, Florian Weimer, Kees Cook]
+ Add some Caveats regarding the use of seccomp filters
+ Michael Kerrisk
+ Document the "default" filter return action
+ The kernel defaults to either SECCOMP_RET_KILL_PROCESS
+ or SECCOMP_RET_KILL_THREAD for unrecognized filter
+ return action values.
+ Michael Kerrisk [Kees Cook]
+ Change SECCOMP_RET_ACTION to SECCOMP_RET_ACTION_FULL
+ In Linux 4.14, the action component of the return value
+ switched from being 15 bits to being 16 bits. A new macro,
+ SECCOMP_RET_ACTION_FULL, that masks the 16 bits was added,
+ to replace the older SECCOMP_RET_ACTION.
+ Michael Kerrisk
+ Explicitly note that other threads survive SECCOMP_RET_KILL_THREAD
+ Michael Kerrisk
+ SEE ALSO: add strace(1)
+
+send.2
+ Grégory Vander Schueren
+ Add EALREADY to ERRORS
+
+setns.2
+ Michael Kerrisk
+ SEE ALSO: add nsenter(1)
+
+shmop.2
+ Yubin Ruan
+ Note that return value of shmat() is page-aligned
+
+sigaction.2
+ Michael Kerrisk
+ Rework discussion of SA_SIGINFO handler arguments
+ Expand and rework the text a little, in particular adding
+ a reference to sigreturn(2) as a source of further
+ information about the ucontext argument.
+ Michael Kerrisk
+ Mention that libc sets the act.sa_restorer field
+
+sigaltstack.2
+ Michael Kerrisk [Walter Harms]
+ Reword BUGS text to be a little clearer
+ Michael Kerrisk
+ Add explicit error handling to example code
+ Michael Kerrisk
+ Add use of sigaction() to example code
+
+sigreturn.2
+ Michael Kerrisk
+ Make it a little clearer that a stack frame is created by the kernel
+ Michael Kerrisk
+ glibc has a simple wrapper for sigreturn() that returns ENOSYS
+
+splice.2
+ Michael Kerrisk
+ Since Linux 2.6.31,'fd_in' and 'fd_out' may both refer to pipes
+
+stat.2
+ Michael Kerrisk [Richard Knutsson]
+ Use lstat() instead of stat()
+ It's more logical to use lstat() in the example code,
+ since one can then experiment with symbolic links, and
+ also the S_IFLNK case can also occur.
+ NeilBrown
+ Correct AT_NO_AUTOMOUNT text and general revisions
+ Expand on the relationship between fstatat() and the other three
+ functions, and improve the description of AT_NO_AUTOMOUNT.
+ Specifically, both stat() and lstat() act the same way with
+ respect to automounts, and that behavior matches fstatat() with
+ the AT_NO_AUTOMOUNT flag.
+
+statfs.2
+ Michael Kerrisk
+ Add some comments noting filesystems that are no longer current
+ Michael Kerrisk
+ Add comments describing a few filesystem types
+
+time.2
+ Michael Kerrisk
+ Note that time() may be implemented in the vDSO
+ Michael Kerrisk [Victor Porton]
+ Language fix-up: clarify that "tasks" means "work"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=197183
+
+userfaultfd.2
+ Mike Rapoport
+ BUGS: document spurious UFFD_EVENT_FORK
+
+write.2
+fsync.2
+close.2
+ NeilBrown [Jeff Layton]
+ Update description of error codes
+ Since 4.13, errors from writeback are more reliably reported
+ to all file descriptors that might be relevant.
+
+ Add notes to this effect, and also add detail about ENOSPC and
+ EDQUOT which can be delayed in a similar many to EIO - for NFS
+ in particular.
+
+abort.3
+ Michael Kerrisk
+ Starting with glibc 2.27, abort() does not attempt to flush streams
+ Michael Kerrisk
+ SEE ALSO: add assert(3)
+
+backtrace_symbols_fd(3)
+ Stefan Puiu [Walter Harms]
+ backtrace_symbols_fd() can trigger a call to malloc()
+
+daemon.3
+ Michael Kerrisk
+ SEE ALSO: add daemon(7), logrotate(8)
+
+errno.3
+ Michael Kerrisk
+ Note use of errno(1) to look up error names and numbers
+ Michael Kerrisk
+ Update error list for POSIX.1-2008
+ POSIX.1-2008 specified a couple of new errors not present in
+ POSIX.1-2001.
+ Michael Kerrisk [Walter Harms]
+ Note the use of perror(3) and strerror(3)
+ Michael Kerrisk
+ Recast the advice against manually declaring 'errno'
+ Recast the advice against manually declaring 'errno' to
+ a more modern perspective. It's 13 years since the original
+ text was added, and even then it was describing old behavior.
+ Cast the description to be about behavior further away in
+ time, and note more clearly that manual declaration will
+ cause problems with modern C libraries.
+ Michael Kerrisk
+ Add some missing errors
+ Michael Kerrisk
+ Error numbers are positive values (rather than nonzero values)
+ POSIX.1-2008 noted the explicitly the change (to align with
+ the C standards) that error numbers are positive, rather
+ than nonzero.
+ Michael Kerrisk
+ Reorganize the text and add some subheadings
+ Restructure the text and add some subheadings for better
+ readability. No (intentional) content changes.
+ Michael Kerrisk [Wesley Aptekar-Cassels]
+ Note that error numbers vary somewhat across architectures
+ Added after a patch from Wesley Aptekar-Cassels that proposed
+ to add error numbers to the text.
+ Michael Kerrisk
+ Note the <errno.h> also provides the symbolic error names
+ Michael Kerrisk [Walter Harms]
+ Explicitly note that error numbers vary also across UNIX systems
+
+exec.3
+ Michael Kerrisk
+ glibc 2.24 dropped CWD from the default path
+ Document the glibc 2.24 change that dropped CWD from the default
+ search path employed by execlp(), execvp() and execvpe() when
+ PATH is not defined.
+
+fexecve.3
+ Michael Kerrisk
+ O_PATH file descriptors are also usable with fexecve()
+ Cristian Rodríguez
+ fexecve() is now implemented with execveat(2), where available
+ Michael Kerrisk
+ Add some detail on the glibc implementation of fexecve() via execveat(2)
+
+ffs.3
+ Michael Kerrisk
+ glibc 2.27 relaxes the FTM requirements for ffsl() and ffsll()
+
+get_nprocs_conf.3
+ Michael Kerrisk
+ SEE ALSO: add nproc(1)
+
+lround.3
+ Michael Kerrisk [David Eckardt]
+ Clarify that lround() rounds *halfway cases" away from zero
+ See https://bugzilla.kernel.org/show_bug.cgi?id=194601
+
+makedev.3
+ Adrian Bunk
+ glibc has deprecated exposing the definitions via <sys/types.h>
+
+mallinfo.3
+ Jakub Wilk
+ Fix the example
+ Remove reference to non-standard "tlpi_hdr.h" and replace calls to
+ functions that were declared in this header.
+
+malloc.3
+ Michael Kerrisk
+ SEE ALSO: add valgrind(1)
+
+popen.3
+ Michael Kerrisk
+ Add a cross reference to Caveats in system(3)
+ All of the same risks regarding system() also apply to popen().
+
+pthread_detach.3
+ Michael Kerrisk [Rahul Bedarkar]
+ Improve sentence describing freeing of resources on process termination
+ As reported by Rahul, the existing sentence could be read as
+ meaning that resources of joined and terminated detached
+ threads are freed only at process termination. Eliminate
+ that possible misreading.
+
+pthread_yield.3
+ Michael Kerrisk [Peter Zijlstra]
+ pthread_yield() is intended for use with real-time scheduling policies
+
+setlocale.3
+ Michael Kerrisk [Křištof Želechovski]
+ The standards do not specify all of the locale categories
+
+sockatmark.3
+ Seonghun Lim
+ Fix cruft in code example
+
+stdio.3
+ Michael Kerrisk
+ Use proper section cross references in function list
+ Michael Kerrisk
+ Remove crufty reference to pc(1)
+
+sysconf.3
+ Michael Kerrisk
+ Mention get_nprocs_conf(3)
+ Mention get_nprocs_conf(3) in discussion of _SC_NPROCESSORS_CONF
+ and _SC_NPROCESSORS_ONLN.
+
+system.3
+ Michael Kerrisk [Bastien Roucaries]
+ Create a "Caveats" subsection to hold warnings about the use of system()
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=882222
+ Michael Kerrisk [Bastien Roucaries]
+ Mention PATH explicitly in discussion of system() and set-UID programs
+ Michael Kerrisk [Bastien Roucaries]
+ Note that user input for system() should be carefully sanitized
+ Michael Kerrisk
+ Mention file capabilities in discussion of privileged programs
+ Michael Kerrisk
+ Correctly note which shell Debian uses as (noninteractive) /bin/sh
+
+core.5
+ Michael Kerrisk
+ Add some notes on systemd and core dumps
+ Michael Kerrisk
+ Dumps are not produced if core_pattern is empty and core_uses_pid is 0
+ Michael Kerrisk [Per Böhlin]
+ RLIMIT_CORE is not enforced when piping core dump to a program
+ Michael Kerrisk
+ SEE ALSO: add systemd-coredump(8)
+ Michael Kerrisk
+ SEE ALSO: add coredumpctl(1)
+
+filesystems.5
+ Michael Kerrisk [Jonny Grant]
+ Replace crufty URL reference for 'smb' with up-to-date URL
+ Michael Kerrisk [Jonny Grant]
+ Refer to VFAT as an extended FAT (not DOS) filesystem
+
+proc.5
+ Michael Kerrisk [Miklos Szered, Ram Pai]
+ Correct the description of the parent mount ID for /proc/PID/mountinfo
+ Oliver Ebert
+ Add mmap-exclusive bit for /proc/[pid]/pagemap
+ Marcus Folkesson
+ Update description of /proc/<pid>/oom_score
+ Lucas Werkmeister
+ Clarify permissions in /proc/[pid]/fd/
+ Michael Kerrisk
+ Add reference to pid_namespaces(7) for /proc/sys/kernel/ns_last_pid
+
+shells.5
+ Michael Kerrisk
+ SEE ALSO: add pam_shells(8)
+
+sysfs.5
+ Michael Kerrisk
+ Add a brief explanation of /sys/kernel
+ Michael Kerrisk
+ Add a brief description of /sys/class/net
+ Michael Kerrisk
+ Add a brief description of /sys/kernel/mm
+ Michael Kerrisk
+ Add brief description of /sys/kernel/debug/tracing
+ Michael Kerrisk
+ Add a description of /sys/kernel/mm/hugepages
+
+arp.7
+ Michael Kerrisk
+ SEE ALSO: add arpd(8)
+
+capabilities.7
+ Michael Kerrisk
+ Add a reference to xattr(7) in the discussion of extended attributes
+ Michael Kerrisk
+ SEE ALSO: add captest(8)
+
+epoll.7
+ Michael Kerrisk
+ Note existence of kcmp() KCMP_EPOLL_TFD operation
+
+fifo.7
+ Michael Kerrisk
+ Refer reader to pipe(7) for details of I/O semantics of FIFOs
+
+hier.7
+ Michael Kerrisk
+ SEE ALSO: add file-hierarchy(7)
+
+icmp.7
+ Michael Kerrisk
+ SEE ALSO: add rdisc(8)
+
+man-pages.7
+ Michael Kerrisk
+ Note that "x86-64" is generally preferred over "x86_64"
+ G. Branden Robinson
+ Add a use case for real minus character
+
+namespaces.7
+ Michael Kerrisk
+ Add a reference to new veth(4) page
+ Michael Kerrisk
+ EXAMPLE: refer also to example in clone(2)
+
+pid_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add reboot(2)
+ Add because reboot(2) has special semantics for non-initial
+ PID namespaces.
+
+pthreads.7
+ Michael Kerrisk
+ SEE ALSO: add pthread_spin_init(3) and pthread_spin_lock(3)
+
+socket.7
+ Michael Kerrisk [Petr Malat, Tobias Klausmann]
+ Correct the description of SO_RXQ_OVFL
+
+standards.7
+ Michael Kerrisk
+ SEE ALSO: add getconf(1), confstr(3), pathconf(3), sysconf(3)
+
+user_namespaces.7
+ Christian Brauner [Michael Kerrisk]
+ Document new 340 line idmap limit
+
+ld.so.8
+ Michael Kerrisk [Yubin Ruan]
+ Simplify language around conferring capabilities
+ The statement "conferring permitted or effective capabilities"
+ to the process is somewhat redundant. Binaries with capabilities
+ confer capabilities only to those process capability sets, so it's
+ simpler to just say "confers capabilities to the process".
+
+
+==================== Changes in man-pages-4.15 ====================
+
+Released: 2018-02-02, Palo Alto
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adam Liddell <ml+kernel.org@aliddell.com>
+Andrea Parri <parri.andrea@gmail.com>
+Andries E. Brouwer <Andries.Brouwer@cwi.nl>
+Elie Roudninski <xademax@gmail.com>
+Eric Benton <erbenton@comcast.net>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Joel Williamson <jwilliamson@carnegietechnologies.com>
+John Hubbard <jhubbard@nvidia.com>
+Jorgen Hansen <jhansen@vmware.com>
+Keno Fischer <keno@juliacomputing.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@kernel.org>
+NeilBrown <neilb@suse.com>
+Nikola Forró <nforro@redhat.com>
+Nikolay Borisov <nborisov@suse.com>
+Pradeep Kumar <pradeepsixer@gmail.com>
+QingFeng Hao <haoqf@linux.vnet.ibm.com>
+Ricardo Biehl Pasquali <pasqualirb@gmail.com>
+roblabla <man-pages@roblab.la>
+Roman Gushchin <guro@fb.com>
+Shawn Landden <slandden@gmail.com>
+Stefan Hajnoczi <stefanha@redhat.com>
+Stefan Raspl <raspl@linux.vnet.ibm.com>
+Tejun Heo <tj@kernel.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+s390_sthyi.2
+ QingFeng Hao [Michael Kerrisk]
+ New page for s390-specific s390_sthyi(2)
+
+network_namespaces.7
+ Michael Kerrisk
+ New page describing network namespaces
+ Based on content moved from namespaces(7)
+
+vsock.7
+ Stefan Hajnoczi [Jorgen Hansen, Michael Kerrisk]
+ Document the VSOCK socket address family
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+cgroups.7
+ Michael Kerrisk [Tejun Heo]
+ Document cgroups v2 "thread mode"
+ Michael Kerrisk [Tejun Heo]
+ Document cgroup v2 delegation via the 'nsdelegate' mount option
+ Michael Kerrisk
+ Document the cgroup.max.depth and cgroup.max.descendants files
+ Michael Kerrisk
+ Document 'release_agent' mount option
+ Michael Kerrisk [Roman Gushchin]
+ Document /sys/kernel/cgroup/delegate
+ Michael Kerrisk [Roman Gushchin]
+ Document /sys/kernel/cgroup/features
+ Michael Kerrisk [Roman Gushchin]
+ Document cgroups v2 cgroup.stat file
+
+
+Global changes
+--------------
+
+Various pages
+ G. Branden Robinson
+ Standardize on "nonzero"
+ Also add this term to the style guide in man-pages(7).
+
+
+Changes to individual pages
+---------------------------
+
+bpf.2
+ Nikolay Borisov
+ Sync list of supported map types with 4.14 kernel
+
+copy_file_range.2
+ Michael Kerrisk
+ Library support was added in glibc 2.27
+ Shawn Landden
+ glibc provides a user-space emulation where the system call is absent
+ Florian Weimer
+ EFBIG errors are possible, similar to write(2)
+ Michael Kerrisk
+ ERRORS: add EISDIR
+ Michael Kerrisk
+ Order ERRORS alphabetically
+ Michael Kerrisk
+ Add comment to code example explaining use of syscall(2)
+
+fcntl.2
+read.2
+write.2
+ NeilBrown
+ Document "Lost locks" as cause for EIO.
+ If an advisory lock is lost, then read/write requests on any
+ affected file descriptor can return EIO - for NFSv4 at least.
+
+memfd_create.2
+ Michael Kerrisk
+ glibc support for memfd_create() was added in version 2.27
+
+mlock.2
+ Michael Kerrisk
+ Make details for MLOCK_ONFAULT a little more explicit
+ Michael Kerrisk
+ glibc support for mlock2() is added in version 2.27
+
+mmap.2
+ John Hubbard [Michael Hocko]
+ MAP_FIXED is no longer discouraged
+ MAP_FIXED has been widely used for a very long time, yet the man
+ page still claims that "the use of this option is discouraged".
+ John Hubbard
+ MAP_FIXED updated documentation
+ -- Expand the documentation to discuss the hazards in
+ enough detail to allow avoiding them.
+
+ -- Mention the upcoming MAP_FIXED_SAFE flag.
+
+ -- Enhance the alignment requirement slightly.
+
+mount.2
+ Keno Fischer [Michael Kerrisk]
+ Add EINVAL error condition when MS_BINDing MNT_LOCKED submounts
+
+mprotect.2
+pkey_alloc.2
+ Michael Kerrisk
+ Glibc support for memory protection keys was added in version 2.27
+
+perf_event_open.2
+ Michael Kerrisk
+ SEE ALSO: add perf(1)
+
+pkey_alloc.2
+ Michael Kerrisk
+ Clarify description of pkey_alloc() 'flags' argument
+
+prctl.2
+ Michael Kerrisk
+ Defer to capabilities(7) for discussion of the "keep capabilities" flag
+
+recvmmsg.2
+sendmmsg.2
+ Nikola Forró
+ Point out that error handling is unreliable
+
+seccomp.2
+ Michael Kerrisk
+ Clarify that SECCOMP_RET_TRAP SIGSYS signal is thread-directed
+
+syscalls.2
+ Michael Kerrisk
+ Add s390-specific s390_sthyi(2) to syscall list
+
+unshare.2
+ Michael Kerrisk
+ Clarify that EUSERS occurred only until kernel 4.8
+
+errno.3
+ Michael Kerrisk
+ 'errno -s' can be used to search for errors by string in description
+ Michael Kerrisk
+ Add Linux error text corresponding to ENOMEM
+
+fgetpwent.3
+ Michael Kerrisk
+ Add missing ATTRIBUTES preamble
+
+fts.3
+ Michael Kerrisk [Pradeep Kumar]
+ fts_pathlen = strlen(fts_path) + strlen(fts_name)
+
+fuse.4
+ Michael Kerrisk
+ Places errors in alphabetical order (no content changes)
+
+veth.4
+ Michael Kerrisk
+ Add network_namespaces(7)
+
+sysfs.5
+ Michael Kerrisk
+ Refer to cgroups(7) for information about files in /sys/kernel/cgroup
+
+capabilities.7
+ Michael Kerrisk
+ Note which capability sets are affected by SECBIT_NO_SETUID_FIXUP
+ Note explicitly that SECBIT_NO_SETUID_FIXUP is relevant for
+ the permitted, effective, and ambient capability sets.
+ Michael Kerrisk
+ Deemphasize the ancient prctl(2) PR_SET_KEEPCAPS command
+ The modern approach is SECBITS_KEEP_CAPS.
+ Michael Kerrisk
+ Clarify effect of CAP_SETFCAP
+ Make it clear that CAP_SETFCAP allows setting arbitrary
+ capabilities on a file.
+ Michael Kerrisk
+ Clarify which capability sets are effected by SECBIT_KEEP_CAPS
+ This flag has relevance only for the process permitted and
+ effective sets.
+ Michael Kerrisk
+ Rephrase CAP_SETPCAP description
+ * Mention kernel versions.
+ * Place current kernel behavior first
+ Michael Kerrisk
+ SECBIT_KEEP_CAPS is ignored if SECBIT_NO_SETUID_FIXUP is set
+ Michael Kerrisk
+ Ambient set is also cleared when UIDs are set to nonzero value
+
+cgroups.7
+ Michael Kerrisk
+ Add a more complete description of cgroup v1 named hierarchies
+ Michael Kerrisk
+ Add a section on unmounting cgroup v1 filesystems
+ Michael Kerrisk
+ Add subsection describing cgroups v2 subtree delegation
+ Michael Kerrisk
+ Mention ENOENT error that can occur when writing to subtree_control file
+ Michael Kerrisk
+ Add list of currently available version 2 controllers
+ Nikolay Borisov
+ Add information about RDMA controller
+ Michael Kerrisk
+ Rewrite the description of cgroup v2 subtree control
+ Michael Kerrisk [Tejun Heo]
+ Note Linux 4.11 changes to cgroup v2 delegation containment rules
+ Michael Kerrisk
+ systemd(1) nowadays automatically mounts the cgroup2 filesystem
+ Michael Kerrisk
+ Clarify that cgroup.controllers is read-only
+ Michael Kerrisk
+ Elaborate a little on problems of splitting threads across cgroups in v1
+ Michael Kerrisk [Tejun Heo]
+ Tweak the description of delegation of cgroup.subtree_control
+
+ip.7
+ Ricardo Biehl Pasquali
+ INADDR_* values cannot be assigned directly to 's_addr'
+ Michael Kerrisk
+ s/INADDR_ANY/INADDR_LOOPBACK/ in discussion of htonl()
+ INADDR_LOOPBACK is a better example, since it is not
+ byte-order neutral.
+
+namespaces.7
+network_namespaces.7
+ Michael Kerrisk
+ Move content from namespaces(7) to network_namespaces(7)
+
+pid_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add mount_namespaces(7)
+
+sched.7
+ Michael Kerrisk [Andrea Parri]
+ Correctly describe effect of priority changes for RT threads
+ The placement of a thread in the run queue for its new
+ priority depends on the direction of movement in priority.
+ (This appears to contradict POSIX, except in the case of
+ pthread_setschedprio().)
+
+user_namespaces.7
+ Michael Kerrisk
+ Mention NS_GET_OWNER_UID ioctl() operation
+
+
+==================== Changes in man-pages-4.16 ====================
+
+Released: 2018-04-30, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adam Borowski <kilobyte@angband.pl>
+Andy Owen <andrew.owen@dolby.com>
+Carlos O'Donell <carlos@redhat.com>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Elvira Khabirova <lineprinter@altlinux.org>
+Enrique Garcia <cquike@arcor.de>
+Frederic Brault <fbrault@xyalis.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Howard Johnson <hwj@BridgeportContractor.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+John Hubbard <jhubbard@nvidia.com>
+Jürg Billeter <j@bitron.ch>
+Konstantin Grinemayer <cdlscpmv@gmail.com>
+Konstantin Khlebnikov <khlebnikov@yandex-team.ru>
+Martin Mares <mj@ucw.cz>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Mattias Andrée <maandree@kth.se>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mike Frysinger <vapier@gentoo.org>
+Nikos Mavrogiannopoulos <nmavrogi@redhat.com>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+Ross Zwisler <ross.zwisler@linux.intel.com>
+Rusty Russell <rusty@rustcorp.com.au>
+Serge E. Hallyn <serge@hallyn.com>
+Song Liu <songliubraving@fb.com>
+Tomi Salminen <tsalminen@forcepoint.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+membarrier.2
+ Mathieu Desnoyers [Michael Kerrisk]
+ Document new membarrier commands introduced in Linux 4.16
+ Document the following membarrier commands introduced in
+ Linux 4.16:
+
+ MEMBARRIER_CMD_GLOBAL_EXPEDITED
+ (the old enum label MEMBARRIER_CMD_SHARED is now an
+ alias to preserve header backward compatibility)
+ MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED
+ MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE
+ MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE
+
+mmap.2
+ Jan Kara [Ross Zwisler, Michael Kerrisk]
+ Add description of MAP_SHARED_VALIDATE and MAP_SYNC
+ Michal Hocko [John Hubbard, Michael Kerrisk, Jann Horn]
+ Document new MAP_FIXED_NOREPLACE flag
+ 4.17+ kernels offer a new MAP_FIXED_NOREPLACE flag which allows
+ the caller to atomically probe for a given address range.
+
+readv.2
+io_submit.2
+ Jürg Billeter
+ Document RWF_APPEND added in Linux 4.16
+
+capabilities.7
+ Michael Kerrisk
+ Describe file capability versioning
+ Michael Kerrisk [Serge E. Hallyn]
+ Document namespaced-file capabilities
+ [There's still more work to be done on this new text]
+
+
+Changes to individual pages
+---------------------------
+
+bpf.2
+ Michael Kerrisk
+ Update list of architectures that support JITed eBPF
+ And note kernel version numbers where support is added.
+ Michael Kerrisk
+ Kernel 4.15 added CONFIG_BPF_JIT_ALWAYS_ON
+ This causes the JIT compiler to be always on and
+ forces bpf_jit_enable to 1.
+
+execve.2
+ Michael Kerrisk
+ Note that describing execve as "executing a new process" is misleading
+ This misdescription is so common that it's worth calling it out
+ explicitly.
+ Michael Kerrisk
+ More explicitly describe effect of execve() in the opening paragraph
+
+fallocate.2
+ Michael Kerrisk
+ Since Linux 4.16, Btrfs supports FALLOC_FL_ZERO_RANGE
+
+getrlimit.2
+ Michael Kerrisk
+ CAP_SYS_RESOURCE capability is required in *initial user namespace*
+
+io_submit.2
+ Michael Kerrisk
+ Add kernel version numbers for various 'aio_rw_flags' flags
+ Michael Kerrisk
+ Place 'aio_rw_flags' in alphabetical order
+
+mmap.2
+ Jann Horn
+ MAP_FIXED is okay if the address range has been reserved
+ Clarify that MAP_FIXED is appropriate if the specified address
+ range has been reserved using an existing mapping, but shouldn't
+ be used otherwise.
+ Michael Kerrisk
+ Move the text on MAP_FIXED to NOTES
+ This text has become rather long, making it somewhat
+ unwieldy in the discussion of the mmap() flags. Therefore,
+ move it to NOTES, with a pointer in DESCRIPTION referring
+ the reader to NOTES.
+ Michael Kerrisk [Heinrich Schuchardt]
+ Clarify that when addr==NULL, address chosen by kernel is page-aligned
+ Michael Kerrisk
+ Add a little historical detail on the obsolete MAP_DENYWRITE
+
+mount.2
+ Michael Kerrisk
+ ERRORS: add EBUSY for the case of trying to stack same mount twice
+ Michael Kerrisk
+ Remove a couple of obsolete EBUSY errors
+ As far as I can tell, these EBUSY errors disappeared
+ with the addition of stackable mounts in Linux 2.4.
+
+msgget.2
+semget.2
+shmget.2
+ Michael Kerrisk
+ The purpose of "flags" == 0 is to obtain ID of an existing IPC object
+ This was implied in these pages, but the meaning of "flags" == 0
+ could be more explicit, as indicated by questions such as
+ https://stackoverflow.com/questions/49833569/flag-value-of-semget-function
+
+open.2
+ Jann Horn
+ Document more -ETXTBSY conditions
+ Jakub Wilk
+ Add missing argument for snprintf() in example code
+
+perf_event_open.2
+ Song Liu
+ Add type kprobe and uprobe
+ Two new types kprobe and uprobe are being added to
+ perf_event_open(), which allow creating kprobe or
+ uprobe with perf_event_open. This patch adds
+ information about these types.
+
+ptrace.2
+ Jann Horn
+ Copy retval info for SECCOMP_GET_FILTER to right section
+ The "RETURN VALUE" section made a claim that was incorrect for
+ PTRACE_SECCOMP_GET_FILTER. Explicitly describe the behavior of
+ PTRACE_SECCOMP_GET_FILTER in the "RETURN VALUE" section (as
+ usual), but leave the now duplicate description in the section
+ describing PTRACE_SECCOMP_GET_FILTER, since the
+ PTRACE_SECCOMP_GET_FILTER section would otherwise probably become
+ harder to understand.
+
+readv.2
+ Michael Kerrisk
+ Remove redundant sentence
+
+seccomp.2
+ Michael Kerrisk
+ Note that execve() may change syscall numbers during life of process
+ On a multiarch/multi-ABI platform such as modern x86, each
+ architecture/ABI (x86-64, x32, i386)has its own syscall numbers,
+ which means a seccomp() filter may see different syscall numbers
+ over the life of the process if that process uses execve() to
+ execute programs that has a different architectures/ABIs.
+ Michael Kerrisk
+ Note which architectures support seccomp BPF
+ Michael Kerrisk
+ In EXAMPLE, clearly note that x32 syscalls are >= X32_SYSCALL_BIT
+
+shutdown.2
+ Carsten Grohmann
+ SEE ALSO: add close(2)
+
+syscall.2
+ Adam Borowski
+ Add riscv
+
+wait.2
+ Michael Kerrisk [Robin Kuzmin]
+ wait() and waitpid() block the calling thread (not process)
+
+wait4.2
+ Michael Kerrisk [Martin Mares]
+ Soften the warning against the use of wait3()/wait4()
+ These functions are nonstandard, but there is no replacement.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=199215
+
+crypt.3
+encrypt.3
+ Carlos O'Donell [Michael Kerrisk]
+ Add notes about _XOPEN_CRYPT
+ The distribution may choose not to support _XOPEN_CRYPT in the
+ case that the distribution has transitioned from glibc crypt to
+ libxcrypt.
+
+fseek.3
+ Michael Kerrisk [Andy Owen]
+ ERRORS: EBADF should be ESPIPE
+ Michael Kerrisk
+ Improve EPIPE error text
+
+getcwd.3
+ Carlos O'Donell
+ Mention that "(unreachable)" is no longer returned for glibc >= 2.27.
+
+makedev.3
+ Michael Kerrisk
+ Since glibc 2.28, <sys/types.h> no longer defines these macros
+
+pthread_create.3
+ Frederic Brault
+ Note default thread stack size for several architectures
+
+tsearch.3
+ Jann Horn
+ Clarify items vs nodes
+ The manpage claimed that tsearch() returns a pointer to a data
+ item. This is incorrect; tsearch() returns a pointer to the
+ corresponding tree node, which can also be interpreted as a
+ pointer to a pointer to the data item.
+
+ Since this API is quite unintuitive, also add a clarifying
+ sentence.
+ Jann Horn
+ tdelete() can return dangling pointers
+ POSIX says that deleting the root node must cause tdelete() to
+ return some unspecified non-NULL pointer. Glibc implements it by
+ returning a dangling pointer to the (freed) root node.
+ Therefore, explicitly note that tdelete() may return bad pointers
+ that must not be accessed.
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add patchelf(1)
+
+filesystems.5
+ Michael Kerrisk
+ Add an entry for tmpfs(5)
+
+group.5
+ Michael Kerrisk
+ SEE ALSO: add vigr(8)
+
+passwd.5
+ Michael Kerrisk
+ SEE ALSO: add vipw(8)
+
+sysfs.5
+ Michael Kerrisk
+ Add brief note on /sys/fs/smackfs
+
+tmpfs.5
+ Mike Frysinger
+ Document current mount options
+ Some of this content is moved from the mount(8) man page.
+ Style was based on proc(5) sections.
+ Michael Kerrisk
+ Remove reference to mount(8) for discussion of mount options
+ The mount options are now described in this page.
+ Michael Kerrisk
+ SEE ALSO: add Documentation/vm/transhuge.txt
+ Michael Kerrisk
+ Reformat 'huge' and 'mpol' mount option values as lists
+ Michael Kerrisk
+ Describe 'mpol' mount options
+ Based on text from Documentation/filesystems/tmpfs.txt.
+ Michael Kerrisk
+ Document 'huge' mount options
+ Based on text from Documentation/vm/transhuge.txt.
+ Michael Kerrisk
+ SEE ALSO: add set_mempolicy(2)
+ Michael Kerrisk
+ Document mpol=local mount option
+
+capabilities.7
+ Michael Kerrisk
+ Remove redundant mention of PTRACE_SECCOMP_GET_FILTER
+
+cgroups.7
+ Michael Kerrisk
+ cgroup.events transitions generate POLLERR as well as POLLPRI
+
+mount_namespaces.7
+ Michael Kerrisk
+ Note another case where shared "peer groups" are formed
+
+namespaces.7
+ Michael Kerrisk [Konstantin Khlebnikov]
+ Mention that device ID should also be checked when comparing NS symlinks
+ When comparing two namespaces symlinks to see if they refer to
+ the same namespace, both the inode number and the device ID
+ should be compared. This point was already made clear in
+ ioctl_ns(2), but was missing from this page.
+ Michael Kerrisk
+ Note an idiosyncrasy of /proc/[pid]/ns/pid_for_children
+ /proc/[pid]/ns/pid_for_children has a value only after first
+ child is created in PID namespace. Verified by experiment.
+
+network_namespaces.7
+ Michael Kerrisk
+ Network namespaces isolate the UNIX domain abstract socket namespace
+ Michael Kerrisk
+ Add cross reference to unix(7)
+ For further information on UNIX domain abstract sockets.
+
+posixoptions.7
+ Carlos O'Donell
+ Expand XSI Options groups
+ We define in detail the X/Open System Interfaces i.e. _XOPEN_UNIX
+ and all of the X/Open System Interfaces (XSI) Options Groups.
+
+ The XSI options groups include encryption, realtime, advanced
+ realtime, realtime threads, advanced realtime threads, tracing,
+ streams, and legacy interfaces.
+ Michael Kerrisk
+ Use a more consistent, less cluttered layout for option lists
+ Michael Kerrisk
+ Make function lists more consistent and less cluttered
+ Use more consistent layout for lists of functions, and
+ remove punctuation from the lists to make them less cluttered.
+
+socket.7
+ Michael Kerrisk [Tomi Salminen]
+ Fix error in SO_INCOMING_CPU code snippet
+ The last argument is passed by value, not reference.
+
+time.7
+ Michael Kerrisk [Enrique Garcia]
+ Mention clock_gettime()/clock_settime() rather than [gs]ettimeofday()
+ gettimeofday() is declared obsolete by POSIX. Mention instead
+ the modern APIs for working with the realtime clock.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=199049
+
+unix.7
+ Michael Kerrisk [Rusty Russell]
+ ERRORS: add EBADF for sending closed file descriptor with SCM_RIGHTS
+
+vdso.7
+ Michael Kerrisk
+ VDSO symbols (system calls) are not visible to seccomp(2) filters
+
+xattr.7
+ Michael Kerrisk
+ SEE ALSO: add selinux(8)
+
+ld.so.8
+ Mike Frysinger
+ Make lack of separator escaping explicit
+ Make it clear that the delimiters in LD_PRELOAD, LD_LIBRARY_PATH,
+ and LD_AUDIT cannot be escaped so people don't try various methods
+ (such as \:) to workaround it.
+ Michael Kerrisk
+ Remove unneeded mention of PATH in discussion of LD_LIBRARY_PATH
+ This brief sentence doesn't add value to the text.
+
+
+==================== Changes in man-pages-5.00 ====================
+
+Released: 2019-03-06, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adam Manzanares <adam.manzanares@wdc.com>
+Alan Jenkins <alan.christopher.jenkins@gmail.com>
+Alec Leamas <leamas.alec@gmail.com>
+Alessandro Vesely <vesely@tana.it>
+Alexander E. Patrakov <patrakov@gmail.com>
+Allison Randal <allison@lohutok.net>
+Amir Goldstein <amir73il@gmail.com>
+Anatoly Borodin <anatoly.borodin@gmail.com>
+Andreas Gruenbacher <agruenba@redhat.com>
+Andreas Westfeld <andreas.westfeld@htw-dresden.de>
+Andrei Vagin <avagin@openvz.org>
+Andrew Price <andy@andrewprice.me.uk>
+Anthony Iliopoulos <ailiopoulos@suse.com>
+Antonio Chirizzi <antonio.chirizzi@gmail.com>
+Antonio Ospite <ao2@ao2.it>
+Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
+Balbir Singh <bsingharora@gmail.com>
+Benjamin Peterson <benjamin@python.org>
+Bernd Petrovitsch <bernd@petrovitsch.priv.at>
+bert hubert <bert.hubert@powerdns.com>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Burkhard Lück <lueck@hube-lueck.de>
+Carlos O'Donell <carlos@redhat.com>
+Claudio Scordino <claudio@evidence.eu.com>
+Daniel Borkmann <daniel@iogearbox.net>
+Daniel Kamil Kozar <dkk089@gmail.com>
+Davidlohr Bueso <dave@stgolabs.net>
+Davidlohr Bueso <dbueso@suse.de>
+David Newall <glibc@davidnewall.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Elliot Hughes <enh@google.com>
+Elvira Khabirova <lineprinter@altlinux.org>
+Emil Fihlman <emil.fihlman@gmail.com>
+Enrico Scholz <enrico.scholz@sigma-chemnitz.de>
+Eric Benton <erbenton@comcast.net>
+Eric Sanchis <eric.sanchis@iut-rodez.fr>
+Eugene Syromiatnikov <esyr@redhat.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Felipe Gasper <felipe@felipegasper.com>
+Florian Weimer <fweimer@redhat.com>
+Frank Theile <ftheile@grundfos.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Goldwyn Rodrigues <rgoldwyn@suse.com>
+Goldwyn Rodrigues <rgoldwyn@suse.de>
+Göran Häggsjö <goran.haggsjo@icloud.com>
+Harry Mallon <hjmallon@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Heiko Carstens <heiko.carstens@de.ibm.com>
+Helge Deller <deller@gmx.de>
+Henry Wilson <henry.wilson@acentic.com>
+Hiroya Ito <hiroyan@gmail.com>
+Howard Johnson <hj@HowardJohnson.name>
+Ian Turner <iturner@janestreet.com>
+Ignat Loskutov <ignat.loskutov@gmail.com>
+Ingo Schwarze <schwarze@usta.de>
+Jakub Wilk <jwilk@jwilk.net>
+James Weigle <jtweigle@uchicago.edu>
+Jann Horn <jannh@google.com>
+Jann Horn <jann@thejh.net>
+Jason A. Donenfeld <Jason@zx2c4.com>
+Jeff Moyer <jmoyer@redhat.com>
+Jens Thoms Toerring <jt@toerring.de>
+Joe Lawrence <joe.lawrence@redhat.com>
+Johannes Altmanninger <aclopte@gmail.com>
+Johannes Liebermann <johanan.liebermann@gmail.com>
+Jonny Grant <jg@jguk.org>
+Joseph C. Sible <josephcsible@gmail.com>
+Joseph Sible <josephcsible@gmail.com>
+Josh Gao <jmgao@google.com>
+Josh Triplett <josh@joshtriplett.org>
+Kees Cook <keescook@chromium.org>
+Keith Thompson <Keith.S.Thompson@gmail.com>
+Keno Fischer <keno@juliacomputing.com>
+Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
+Konst Mayer <cdlscpmv@gmail.com>
+Leah Hanson <lhanson@pivotal.io>
+Lucas De Marchi <lucas.demarchi@intel.com>
+Lucas Werkmeister <mail@lucaswerkmeister.de>
+Luka Macan <Luka.Macan@fer.hr>
+Marc-André Lureau <marcandre.lureau@redhat.com>
+Marcus Gelderie <marcus.gelderie@gmail.com>
+Marcus Gelderie <redmnic@gmail.com>
+Marko Myllynen <myllynen@redhat.com>
+Mark Schott <schottm@google.com>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Kilgore <mattkilgore12@gmail.com>
+Mattias Engdegård <mattiase@acm.org>
+Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
+Michael Becker <mjbecker@web.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Witten <mfwitten@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mihir Mehta <mihir@cs.utexas.edu>
+Mike Frysinger <vapier@chromium.org>
+Mike Frysinger <vapier@gentoo.org>
+Mike Rapoport <rppt@linux.ibm.com>
+Mike Weilgart <mike.weilgart@verticalsysadmin.com>
+Nadav Har'El <nyh@math.technion.ac.il>
+Nick Gregory <ghost@capsule8.com>
+Niklas Hambüchen <mail@nh2.me>
+Nikola Forró <nforro@redhat.com>
+nixiaoming <nixiaoming@huawei.com>
+Oded Elisha <oded123456@gmail.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Millar <paul.millar@desy.de>
+Philip Dumont <phil@solidstatescientific.com>
+Pierre Chifflier <pollux@debian.org>
+Quentin Monnet <quentin.monnet@netronome.com>
+Radostin Stoyanov <rstoyanov1@gmail.com>
+Robert O'Callahan <robert@ocallahan.org>
+Robert P. J. Day <rpjday@crashcourse.ca>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+ruschein <ruschein@protonmail.com>
+Sam Varshavchik <mrsam@courier-mta.com>
+Sean Young <sean@mess.org>
+Shawn Landden <shawn@git.icu>
+Simone Piccardi <piccardi@truelite.it>
+snyh <snyh@snyh.org>
+Solal Pirelli <solal.pirelli@gmail.com>
+Stan Schwertly <stan@schwertly.com>
+Stephan Knauss <linux@stephans-server.de>
+Szabolcs Nagy <szabolcs.nagy@arm.com>
+Thomas Posch <kernel.org@online.posch.name>
+Tobias Klauser <tklauser@distanz.ch>
+Troy Engel <troyengel@gmail.com>
+Tycho Andersen <tycho@tycho.ws>
+Tycho Kirchner <tychokirchner@mail.de>
+Vince Weaver <vincent.weaver@maine.edu>
+Wang Nan <wangnan0@huawei.com>
+William Kucharski <william.kucharski@oracle.com>
+Xiao Yang <yangx.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+s390_guarded_storage.2
+ Eugene Syromyatnikov
+ New page documenting s390_guarded_storage(2) s390-specific system call
+
+address_families.7
+ Michael Kerrisk [Eugene Syromyatnikov]
+ New page that contains details of socket address families
+ There is too much detail in socket(2). Move most of it into
+ a new page instead.
+
+bpf-helpers.7
+ Michael Kerrisk [Daniel Borkmann, Quentin Monnet]
+ Add new man page for eBPF helper functions
+ (autogenerated from kernel source files)
+
+
+Removed Pages
+-------------
+
+mdoc.7
+mdoc.samples.7
+ Michael Kerrisk [Ingo Schwarze]
+ Remove mdoc(7) and mdoc.samples(7)
+ groff_mdoc(7) from the groff project provides a better
+ equivalent of mdoc.samples(7) and the 'mandoc' project
+ provides a better mdoc(7). And nowadays, there are virtually
+ no pages in "man-pages" that use mdoc markup.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify_init.2
+fanotify.7
+ nixiaoming [Amir Goldstein, Michael Kerrisk]
+ Document FAN_REPORT_TID
+ fanotify_init.2: add new flag FAN_REPORT_TID
+ fanotify.7: update description of member pid in
+ struct fanotify_event_metadata
+ Amir Goldstein
+ Document FAN_MARK_FILESYSTEM
+ Monitor fanotify events on the entire filesystem.
+ Matthew Bobrowski [Amir Goldstein]
+ Document FAN_OPEN_EXEC and FAN_OPEN_EXEC_PERM
+
+io_submit.2
+ Adam Manzanares
+ Document IOCB_FLAG_IOPRIO
+
+msgctl.2
+semctl.2
+shmctl.2
+ Davidlohr Bueso [Joe Lawrence, Michael Kerrisk]
+ Document STAT_ANY commands
+
+prctl.2
+ Konrad Rzeszutek Wilk [Michael Kerrisk]
+ Document PR_SET_SPECULATION_CTRL and PR_GET_SPECULATION_CTRL
+
+sched_setattr.2
+ Claudio Scordino [Michael Kerrisk]
+ Document SCHED_FLAG_DL_OVERRUN and SCHED_FLAG_RECLAIM
+
+socket.2
+ Tobias Klauser
+ Document AF_XDP
+ Document AF_XDP added in Linux 4.18.
+
+inotify.7
+ Henry Wilson
+ Document IN_MASK_CREATE
+
+unix.7
+ Michael Kerrisk
+ Document SO_PASSSEC
+ Michael Kerrisk
+ Document SCM_SECURITY ancillary data
+
+
+New and changed links
+---------------------
+
+reallocarray.3
+ Michael Kerrisk
+ New link to malloc(3)
+
+precedence.7
+ Josh Triplett
+ Add as a redirect to operator.7
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk [G. Branden Robinson]
+ Use '\e' rather than '\\' to get a backslash
+
+Various pages
+ Michael Kerrisk [Bjarni Ingi Gislason, G. Branden Robinson]
+ Use zero‐width space in appropriate locations
+
+Various pages
+ Michael Kerrisk
+ Clarify the distinction between "file descriptor" and "file description"
+
+Various pages
+ Mike Rapoport
+ Update paths for in-kernel memory management documentation files
+
+A few pages
+ Michael Kerrisk
+ Change references to '2.6.0-test*' series kernels to just '2.6.0'
+
+
+Changes to individual pages
+---------------------------
+
+iconv.1
+ Marko Myllynen
+ SEE ALSO: add uconv(1)
+
+localedef.1
+ Howard Johnson
+ Note that -f and -c, are reversed from what you might expect
+
+time.1
+ Michael Kerrisk [Johannes Altmanninger]
+ Document the -q/--quiet option
+ Jakub Wilk
+ Update bug reporting address
+
+bpf.2
+ Tobias Klauser
+ Update JIT support list for Linux 4.18
+ JIT support for x86-32 was during the Linux 4.18 release cycle.
+ Also correct the entry for MIPS (only MIPS64 is supported).
+ Oded Elisha
+ Fix bug in example
+ Quentin Monnet
+ SEE ALSO: add bpf-helpers(7)
+
+capget.2
+ Michael Kerrisk
+ Remove crufty sentence suggesting use of deprecated functions
+ Remove crufty sentence suggesting use of deprecated capsetp(3) and
+ capgetp(3); the manual page for those functions has long (at least
+ as far back as 2007) noted that they are deprecated.
+ Michael Kerrisk
+ Remove first paragraph, which repeats details from capabilities(7)
+
+chroot.2
+ Michael Kerrisk
+ Mention /proc/[pid]/root
+
+clock_getres.2
+ Michael Kerrisk [Jens Thoms Toerring]
+ CLOCK_MONOTONIC_RAW does not count while the system is suspended
+ Michael Kerrisk [Jens Thoms Toerring]
+ On Linux CLOCK_MONOTONIC counts time that the system has run since boot
+ Michael Kerrisk [Jens Thoms Toerring]
+ CLOCK_MONOTONIC does not count while the system is suspended
+ Michael Kerrisk
+ ERRORS: add EINVAL error for noncanonical clock_settime() value
+
+clone.2
+ Michael Kerrisk
+ Rework discussion of threads and signals
+ The discussion is phrased in terms of signals sent using kill(2),
+ but applies equally to a signal sent by the kernel.
+ Jann Horn
+ Pending CLONE_NEWPID prevents thread creation
+ Michael Kerrisk
+ Clarify the discussion of threads and signals
+ And explicitly introduce the terms "process-directed" and
+ "thread-directed" signals.
+ Eugene Syromyatnikov
+ Add information about clone and clone2 on IA-64
+ Michael Kerrisk
+ ERRORS: EINVAL occurs with CLONE_NEWUSER if !CONFIG_USER_NS
+
+connect.2
+ Benjamin Peterson
+ Document error semantics of nonblocking UNIX domain sockets
+
+epoll_ctl.2
+ Michael Kerrisk
+ Use the term "interest list" consistently
+
+epoll_wait.2
+ Michael Kerrisk
+ Clarify the behavior when epoll_wait()-ing on an empty interest list
+ Michael Kerrisk
+ Note that epoll_wait() round robins through the set of ready descriptors
+
+eventfd.2
+ Michael Kerrisk
+ Move text noting that eventfd() creates a FD earlier in the page
+
+fcntl.2
+ Michael Kerrisk
+ Actual pipe capacity may in practice be less than nominal capacity
+ The number of bytes that can be written to the pipe may be less
+ (sometimes substantially less) than the nominal capacity.
+ Eugene Syromyatnikov
+ Mention that l_sysid is not used even if present
+ Michael Kerrisk
+ Briefly explain the meaning of the 'l_sysid' field in 'struct flock'
+
+futex.2
+ Benjamin Peterson
+ Make the example use C11 atomics rather than GCC builtins
+
+getcpu.2
+ Tobias Klauser [Michael Kerrisk]
+ getcpu() now has a glibc wrapper; remove mention of syscall(2)
+ The glibc wrapper was added in glibc 2.29, release on 1 Feb 2019.
+
+getgid.2
+getpid.2
+getuid.2
+pipe.2
+syscall.2
+ Eugene Syromiatnikov [Michael Kerrisk]
+ Describe 2nd return value peculiarity
+ Some architectures (ab)use second return value register for
+ additional return value in some system calls. Let's describe this.
+
+getgroups.2
+ Michael Kerrisk
+ Note that a process can drop all groups with: setgroups(0, NULL)
+
+getrlimit.2
+ Eugene Syromyatnikov
+ Note that setrlimit(RLIMIT_CPU) doesn't fail
+ Michael Kerrisk
+ Resource limits are process-wide attributes shared by all threads
+ This was already noted in pthreads(7), but bears repeating here.
+ Eugene Syromyatnikov
+ Correct information about large limits on 32-bit architectures
+
+gettid.2
+ Michael Kerrisk
+ Glibc provides a wrapper since version 2.30
+
+gettimeofday.2
+ Michael Kerrisk
+ ERRORS: add EINVAL for noncanonical 'tv' argument to settimeofday()
+
+gettimeofday.2
+clock_getres.2
+ Michael Kerrisk [Jens Thoms Toerring]
+ ERRORS: EINVAL can occur if new real time is less than monotonic clock
+
+getxattr.2
+removexattr.2
+setxattr.2
+ Michael Kerrisk [Andreas Gruenbacher, Enrico Scholz]
+ ERRORS: replace ENOATTR with ENODATA
+ See also https://bugzilla.kernel.org/show_bug.cgi?id=201995
+
+inotify_add_watch.2
+ Paul Millar
+ Add IN_ONLYDIR based error
+ Henry Wilson
+ Note errors that can occur for IN_MASK_CREATE
+
+io_submit.2
+ Jeff Moyer
+ Fix the description of aio_data
+ aio_data is not a kernel-internal field.
+
+madvise.2
+ Michal Hocko [Niklas Hambüchen]
+ MADV_FREE clarify swapless behavior
+
+memfd_create.2
+ Marc-André Lureau
+ Update hugetlb file-sealing support
+ Lucas De Marchi
+ Fix header for memfd_create()
+ Joseph C. Sible
+ _GNU_SOURCE is required
+
+mmap.2
+ Elliott Hughes
+ Explicitly state that the fd can be closed
+ Jann Horn [Michal Hocko, William Kucharski]
+ Fix description of treatment of the hint
+ The current manpage reads as if the kernel will always pick a free
+ space close to the requested address, but that's not the case.
+
+mount.2
+ Michael Kerrisk
+ Clearly distinguish per-mount-point vs per-superblock mount flags
+ Michael Kerrisk
+ MS_SILENT is ignored when changing propagation type
+ Michael Kerrisk
+ Attempts to change MS_SILENT setting during remount are silently ignored
+ Michael Kerrisk [Harry Mallon]
+ Document EROFS for read-only filesystems
+ See https://bugzilla.kernel.org/show_bug.cgi?id=200649
+ Michael Kerrisk
+ Clarify that per-superblock flags are shared during remount
+ Michael Kerrisk
+ Remove crufty sentence about MS_BIND + MS_REMOUNT
+ Michael Kerrisk
+ Mention /proc/PID/mountinfo
+ Many people are unaware of the /proc/PID/mountinfo file. Provide
+ a helpful clue here.
+ Michael Kerrisk
+ Mandatory locking also now requires CONFIG_MANDATORY_FILE_LOCKING
+ Michael Kerrisk [Simone Piccardi]
+ Add MS_STRICTATIME to list of flags that can be used in remount
+ Michael Kerrisk
+ EACCES: note some reasons why a filesystem may be read-only
+ Michael Kerrisk
+ SEE ALSO: add ioctl_iflags(2)
+
+msgop.2
+ Michael Kerrisk
+ Correct the capability description for msgsnd() EACCESS error
+
+nfsservctl.2
+ Michael Kerrisk
+ Add VERSIONS section noting that this system call no longer exists
+
+open.2
+ Lucas Werkmeister
+ Document ENXIO for sockets
+ Michael Kerrisk
+ Clarify a special use case of O_NONBLOCK for devices
+ Eugene Syromiatnikov
+ Mention presence of unused O_RSYNC definition
+ O_RSYNC is defined in <asm/fcntl.h> on HP PA-RISC, but is not
+ used anyway.
+ Eugene Syromiatnikov
+ Document FASYNC usage in Linux UAPI headers
+ Andrew Price
+ Remove O_DIRECT-related quotation
+ Remove a section that adds no benefit to the discussion of O_DIRECT.
+ Michael Kerrisk [Robin Kuzmin]
+ Clarify that O_NONBLOCK has no effect on poll/epoll/select
+
+perf_event_open.2
+ Vince Weaver [Wang Nan]
+ Document the PERF_EVENT_IOC_PAUSE_OUTPUT ioctl
+ The PERF_EVENT_IOC_PAUSE_OUTPUT ioctl was introduced in Linux 4.7.
+ Vince Weaver
+ Fix wording in multiplexing description
+ Vince Weaver
+ Clarify exclude_idle
+ Vince Weaver
+ Document the PERF_EVENT_IOC_QUERY_BPF ioctl
+ Vince Weaver
+ Document the PERF_EVENT_IOC_MODIFY_ATTRIBUTES ioctl
+ Vince Weaver
+ Fix prctl behavior description
+
+pivot_root.2
+ Elvira Khabirova
+ Explain the initramfs case and point to switch_root(8)
+ Joseph Sible [Joseph C. Sible]
+ Document EINVAL if root is rootfs
+
+pkey_alloc.2
+ Michael Kerrisk [Szabolcs Nagy]
+ Switch to glibc prototype in SYNOPSIS
+
+poll.2
+ Michael Kerrisk
+ Note that poll() and ppoll() are not affected by O_NONBLOCK
+
+posix_fadvise.2
+ Eugene Syromyatnikov
+ Describe the difference between fadvise64/fadvise64_64
+
+prctl.2
+ Benjamin Peterson
+ PR_SET_MM_EXE_FILE may now be used as many times as desired
+ Michael Kerrisk
+ Add some further historical details on PR_SET_MM_EXE_FILE
+ Michael Kerrisk [Jann Horn]
+ Explain the circumstances in which the parent-death signal is sent
+ Michael Kerrisk
+ Rework the PR_SET_PDEATHSIG description a little, for easier readability
+ Michael Kerrisk
+ Add additional info on PR_SET_PDEATHSIG
+ The signal is process directed and the siginfo_t->si_pid
+ filed contains the PID of the terminating parent.
+ Michael Kerrisk
+ Note libcap(3) APIs for operating on ambient capability set
+ (However, the libcap APIs do not yet seem to have
+ manual pages...)
+ Michael Kerrisk
+ Mention libcap APIs for operating on capability bounding set
+
+ptrace.2
+ Dmitry V. Levin
+ Do not say that PTRACE_O_TRACESYSGOOD may not work
+ Jann Horn
+ BUGS: ptrace() may set errno to zero
+
+readdir.2
+ Eugene Syromyatnikov
+ Fix struct old_linux_dirent in accordance with current definition
+
+readv.2
+ Xiao Yang [Florian Weimer]
+ Fix wrong errno for an unknown flag
+
+rename.2
+ Michael Kerrisk
+ glibc 2.28 adds library support for renameat2()
+ Tobias Klauser
+ Add feature test macro for renameat2()
+ The glibc wrapper for renameat2() was added in glibc 2.28 and
+ requires _GNU_SOURCE.
+ Eugene Syromiatnikov
+ Some additional notes regarding RENAME_WHITEOUT
+ Lucas Werkmeister [Michael Kerrisk]
+ Add kernel versions for RENAME_NOREPLACE support
+ Michael Kerrisk
+ Rework list of supported filesystems for RENAME_NOREPLACE
+ Tobias Klauser
+ renameat2() now has a glibc wrapper; remove mention of syscall(2)
+
+s390_runtime_instr.2
+ Eugene Syromyatnikov
+ Add a note about runtime_instr.h availability
+
+s390_sthyi.2
+ Eugene Syromyatnikov [Heiko Carstens]
+ Some minor additions
+
+sched_setattr.2
+ Michael Kerrisk
+ Add a bit more detail for SCHED_DEADLINE
+
+sched_setparam.2
+ Michael Kerrisk
+ Clarify that scheduling parameters are per-thread (not per-process)
+
+seccomp.2
+ Michael Kerrisk
+ (Briefly) document SECCOMP_FILTER_FLAG_SPEC_ALLOW
+ Michael Kerrisk
+ SEE ALSO: add bpfc(1)
+
+select.2
+ Michael Kerrisk
+ BUGS: the use of value-result arguments is a design bug
+ Michael Kerrisk [Robin Kuzmin]
+ Note that select() and pselect() are not affected by O_NONBLOCK
+
+select_tut.2
+ Michael Kerrisk [Antonio Chirizzi]
+ Diagnose inet_aton() errors with simple fprintf() (not perror())
+
+setgid.2
+ Michael Kerrisk
+ Clarify EPERM capability requirements with respect to user namespaces
+
+setns.2
+ Michael Kerrisk
+ When joining a user namespace, it must be a descendant user namespace
+ Michael Kerrisk
+ Note capability requirements for changing PID namespace
+ Note capability requirements for changing network, IPC, or UTS namespace
+ Note capability requirements for changing cgroup namespace
+ Michael Kerrisk
+ Some text restructuring and reordering
+
+set_thread_area.2
+ Eugene Syromyatnikov
+ Mention related prctl() requests in SEE ALSO
+ Eugene Syromyatnikov
+ Mention that get_thread_area() is also Linux-specific
+ Eugene Syromyatnikov
+ Describe set_thread_area()/get_thread_area() on m68k/MIPS
+
+setuid.2
+ Michael Kerrisk
+ Clarify EPERM capability requirements with respect to user namespaces
+
+sigaction.2
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Describe obsolete usage of struct sigcontext as signal handler argument
+
+sigsuspend.2
+ Michael Kerrisk
+ Clarify that sigsuspend() suspends the calling *thread*
+
+socket.2
+ Michael Kerrisk
+ Remove references to external docs
+ This information is all in the new address_families(7)
+ Michael Kerrisk
+ Add cross reference to address_families(7)
+ Eugene Syromyatnikov
+ Reinstate AF_VSOCK mention
+ Michael Kerrisk
+ Simplify list of address families
+ Remove many of the details that are in address_families(7)
+ Nikola Forró
+ Remove notes concerning AF_ALG and AF_XDP
+ All address families are now documented in address_families.7.
+ Michael Kerrisk
+ Remove some more obscure protocols from address family list
+ The list of address families in this page is still
+ overwhelmingly long. So let's shorten it.
+ The removed entries are all in address_families(7).
+ Michael Kerrisk
+ Remove a few obsolete protocols
+ Documentation for these remains in address_families(7)
+
+socketpair.2
+ Eugene Syromyatnikov
+ Note that AF_TIPC also supports socketpair(2)
+ Introduced by Linux commit v4.12-rc1~64^3~304^2~1.
+
+stat.2
+ Michael Kerrisk [Alessandro Vesely]
+ ERRORS: ENOENT can occur where a path component is a dangling symlink
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=909789
+ Benjamin Peterson
+ SEE ALSO: add statx(2)
+
+statx.2
+ Tobias Klauser [Michael Kerrisk]
+ statx() now has a glibc wrapper; remove mention of syscall(2)
+
+syscall.2
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Elaborate x32 ABI specifics
+ snyh
+ Fix wrong retval register number in alpha architecture
+ Helge Deller
+ parisc needs care with syscall parameters
+ Michael Kerrisk
+ Rework table to render within 80 columns
+
+syscalls.2
+ Eugene Syromyatnikov
+ Change example of a thin syscall wrapper to chdir()
+ As truncate(3) should dispatch between truncate/truncate64,
+ as noted later in the page.
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Update syscall table
+ Added: arc_gettls, arc_settls, arc_usr_cmpxchg, arch_prctl,
+ atomic_barrier, atomic_cmpxchg_32, bfin_spinlock, breakpoint,
+ clone2, cmpxchg, cmpxchg_badaddr, dma_memcpy, execv, get_tls,
+ getdomainname, getdtablesize, gethostname, getxgid, getxpid,
+ getxuid, metag_get_tls, metag_set_fpu_flags,metag_set_tls,
+ metag_set_global_bit, newfstatat, old_adjtimex, oldumount,
+ or1k_atomic, pread, pwrite, riscv_flush_icache,
+ sched_get_affinity, sched_set_affinity, set_tls, setaltroot,
+ sethae, setpgrp, spill, sram_alloc, sram_free, swapcontext,
+ switch_endian, sys_debug_setcontext, syscall, sysmips, timerfd,
+ usr26, usr32, xtensa.
+
+ Uncommented: memory_ordering
+
+ Renamed: ppc_rtas to rtas (__NR_rtas), ppc_swapcontext to
+ swapcontext (__NR_swapcontext).
+ Eugene Syromyatnikov
+ Note about s390x and old_mmap
+ Michael Kerrisk
+ Add s390_guarded_storage(2)
+ Michael Kerrisk
+ Update syscall list for Linux 4.18
+ Eugene Syromyatnikov
+ Note that not all architectures return errno negated
+ Helge Deller
+ parisc Linux does not any longer emulate HP-UX
+ Michael Kerrisk
+ Comment out details of a few system calls that only ever briefly existed
+
+unshare.2
+ Michael Kerrisk [Shawn Landden]
+ Same EINVAL errors as for clone(2) can also occur with unshare(2)
+ Tycho Andersen
+ Note EINVAL when unsharing pid ns twice
+ The kernel doesn't allow unsharing a pid NS if it has
+ previously been unshared.
+
+ustat.2
+ Michael Kerrisk
+ Starting with version 2.28, glibc no longer provides a wrapper function
+
+vmsplice.2
+ Andrei Vagin
+ Note that vmsplice can splice pages from pipe to memory
+
+wait.2
+ Michael Kerrisk
+ Add some cross references to core(5)
+
+write.2
+ Michael Kerrisk [Nadav Har'El]
+ RETURN VALUE: clarify details of partial write and
+ https://bugzilla.kernel.org/show_bug.cgi?id=197961
+ Goldwyn Rodrigues
+ Add details on partial direct I/O writes
+
+alloca.3
+ Michael Kerrisk [Robin Kuzmin]
+ Prevent any misunderstanding about when allocated memory is released
+
+bsd_signal.3
+ Xiao Yang
+ Fix the wrong version of _POSIX_C_SOURCE
+
+bstring.3
+ Michael Kerrisk [Emil Fihlman]
+ Correct argument list for memmem() prototype
+
+cmsg.3
+ Michael Kerrisk
+ Explain zero-initialization requirement for CMSG_NXTHDR()
+ Michael Kerrisk
+ Remove out of place mention of MSG_CTRUNC
+ This detail is covered in recvmsg(2), and now also in unix(7).
+ Michael Kerrisk
+ Note that CMSG_FIRSTHDR can return NULL
+ Michael Kerrisk
+ Remove unnecessary 'fdptr' intermediate variable in example code
+
+des_crypt.3
+encrypt.3
+ Michael Kerrisk
+ The functions described in these pages are removed in glibc 2.28
+
+dlsym.3
+ Michael Kerrisk
+ Describe a case where a symbol value may be NULL
+
+errno.3
+ Michael Kerrisk [Robert P. J. Day]
+ Mention that errno(1) is part of the 'moreutils' package
+
+exec.3
+ Michael Kerrisk [Eugene Syromyatnikov]
+ Note that SPARC provides an execv() system call
+
+exit.3
+ Mike Frysinger
+ Note wider sysexits.h availability
+
+ferror.3
+ Elliot Hughes
+ Warn about closing the result of fileno()
+
+fnmatch.3
+ Elliott Hughes
+ Clarify "shell wildcard pattern"
+
+getaddrinfo.3
+ Michael Kerrisk [Eric Sanchis]
+ Fix off-by-one error in example client program
+
+getcwd.3
+ Michael Kerrisk
+ Rework text on use of getcwd() system call
+ Make it clear that all of the library functions described on this
+ page will use the getcwd() system call if it is present.
+ Michael Kerrisk
+ Add details on the getcwd() syscall and how it used by libc functions
+ Michael Kerrisk
+ Reorder the text describing "(unreachable)" being returned by getcwd()
+
+getmntent.3
+ Elliot Hughes
+ Clarify that endmntent() should be used rather than fclose()
+
+isatty.3
+ Michael Kerrisk [Jakub Wilk]
+ Most non-tty files nowadays result in the error ENOTTY
+ Historically, at least FIFOs and pipes yielded the error EINVAL.
+
+lockf.3
+ Ian Turner
+ ERRORS: add EINTR
+
+malloc.3
+ Michael Kerrisk
+ Add reference to glibc MallocInternals wiki
+ Michael Kerrisk
+ Note that calloc() detects overflow when multiplying its arguments
+ Michael Kerrisk
+ Since glibc 2.29, reallocarray() is exposed by defining _DEFAULT_SOURCE
+ Info gleaned from glibc NEWS file.
+
+pthread_attr_init.3
+ Michael Kerrisk [Göran Häggsjö, Jakub Wilk]
+ Use correct printf() specifier for "size_t" in example program
+
+pthread_rwlockattr_setkind_np.3
+ Carlos O'Donell
+ Remove bug notes
+
+pthread_setname_np.3
+ Jakub Wilk
+ Explain _np suffix
+ Add text to CONFORMING TO explaining that the "_np"
+ suffix is because these functions are non-portable.
+
+putenv.3
+ Michael Kerrisk
+ Note a glibc extension: putenv("NAME") removes an environment variable
+
+resolver.3
+ Michael Becker
+ Add documentation of res_nclose()
+
+strcmp.3
+ Heinrich Schuchardt
+ Clarify that strcmp() is not locale aware
+
+strcpy.3
+ Matthew Kilgore
+ Fix example code for strncpy, which could pass an incorrect length
+ Michael Kerrisk [Frank Theile]
+ Use "destination" consistently (instead of "target" sometimes)
+
+strfry.3
+ Keith Thompson
+ Remove incorrect reference to rand(3)
+
+string.3
+strlen.3
+strnlen.3
+ Michael Kerrisk [Jakub Wilk]
+ Use 'bytes' not 'characters'
+ This is in line with POSIX terminology.
+
+system.3
+ Michael Kerrisk [Jonny Grant]
+ Use '(char *) NULL' rather than '(char *) 0'
+ Michael Kerrisk
+ Note that system() can fail for the same reasons as fork(2)
+ Arkadiusz Drabczyk
+ Mention that 'errno' is set on error
+
+termios.3
+ Eugene Syromyatnikov
+ Note an XTABS alpha issue
+
+trunc.3
+ Michael Kerrisk [Eric Benton, G. Branden Robinson]
+ Make the description a little clearer
+ Michael Kerrisk
+ Emphasize that the return value is a floating-point number
+
+xcrypt.3
+ Jason A. Donenfeld
+ Warn folks not to use these functions
+
+lirc.4
+ Sean Young
+ Fix broken link
+ Sean Young
+ Document error returns more explicitly
+ Sean Young
+ lirc.h include file is in /usr/include/linux/lirc.h
+ Sean Young [Alec Leamas, Mauro Carvalho Chehab]
+ Remove ioctls and feature bits which were never implemented
+ Sean Young
+ Unsupported ioctl() operations always return ENOTTY
+ Sean Young
+ LIRC_MODE_LIRCCODE has been replaced by LIRC_MODE_SCANCODE
+ Sean Young
+ Document remaining ioctl (LIRC_GET_REC_TIMEOUT)
+ Now all ioctls are documented.
+ Sean Young
+ Timeout reports are enabled by default
+ Sean Young
+ Some devices are send only
+ Sean Young
+ Update SEE ALSO
+ Sean Young
+ LIRC_CAN_SET_REC_DUTY_CYCLE_RANGE was never supported
+ No driver ever supported such a thing.
+ Michael Kerrisk
+ Clarify the description LIRC_SET_REC_TIMEOUT
+
+tty.4
+ Michael Witten
+ Add `vcs(4)' and `pty(7)' to the `SEE ALSO' section
+
+vcs.4
+ Mattias Engdegård [Michael Witten]
+ Fix broken example code
+
+core.5
+ Michael Kerrisk
+ Add cross reference to vdso(7) where "virtual DSO" is mentioned
+
+filesystems.5
+ Eugene Syromyatnikov
+ Mention sysfs(2)
+
+host.conf.5
+ Nikola Forró
+ Clarify glibc versions in which spoof options were removed
+
+proc.5
+ Michael Kerrisk [Philip Dumont]
+ Document /proc/[tid]
+ See also https://bugzilla.kernel.org/show_bug.cgi?id=201441
+ Michael Kerrisk
+ Add an overview section describing the groups of files under /proc
+ Keno Fischer [Robert O'Callahan]
+ Correct description of NStgid
+ Lucas Werkmeister
+ Document fdinfo format for timerfd
+ Stephan Knauss
+ Mention /proc/uptime includes time spent in suspend
+ Michael Kerrisk
+ Reword /proc/PID/fdinfo timerfd field descriptions as a hanging list
+ Michael Kerrisk
+ SEE ALSO: add htop(1) and pstree(1)
+ fs/proc/uptime.c:uptime_proc_show() fetches time using
+ ktime_get_boottime which includes the time spent in suspend.
+ Michael Kerrisk
+ Document /proc/PID/status CoreDumping field
+ Michael Kerrisk
+ Mention choom(1) in discussion of /proc/[pid]/oom_score_adj
+ Michael Kerrisk
+ Add a few details on /proc/PID/fdinfo timerfd
+ Michael Kerrisk
+ Document /proc/meminfo KReclaimable field
+ Michael Kerrisk
+ Explain how to determine top-most mount in /proc/PID/mountinfo
+ Explain how to determine the top-most mount at a particular
+ location by inspecting /proc/PID/mountinfo.
+ Michael Kerrisk [Jakub Wilk]
+ Remove bogus suggestion to use cat(1) to read files containing '\0'
+ Michael Kerrisk
+ Refer to mount(2) for explanation of mount vs superblock options
+ Michael Kerrisk
+ Fix description of /proc/PID/* ownership to account for user namespaces
+ Elvira Khabirova
+ Describe ambiguities in /proc/<pid>/maps
+ Michael Kerrisk [Nick Gregory]
+ Since Linux 4.5, "stack:" is no longer shown in /proc/PID/maps
+ Nikola Forró
+ Document /proc/[pid]/status Speculation_Store_Bypass field
+ Alan Jenkins
+ Vmalloc information is no longer calculated (Linux 4.4)
+ Michael Kerrisk [Alexander E. Patrakov, Jakub Wilk, Michael Kerrisk]
+ Use 'tr '\000' '\n' to display contents of /proc/PID/environ
+ Michael Kerrisk
+ Setting dumpable to 1 reverts ownership of /proc/PID/* to effective IDs
+ Michael Kerrisk
+ Document /proc/meminfo LazyFree field
+ Michael Kerrisk
+ Fix kernel source pathname for soft-dirty documentation
+ Michael Kerrisk
+ /proc/[pid]/status VmPMD field was removed in Linux 4.15
+
+resolv.conf.5
+ Nikola Forró
+ Document no-reload (RES_NPRELOAD) option
+
+tzfile.5
+ Paul Eggert
+ Sync from tzdb upstream
+
+capabilities.7
+ Michael Kerrisk
+ Fix some imprecisions in discussion of namespaced file capabilities
+ The file UID does not come into play when creating a v3
+ security.capability extended attribute.
+ Michael Kerrisk
+ Note that v3 security.attributes are transparently created/retrieved
+ Michael Kerrisk
+ Improve the discussion of when file capabilities are ignored
+ The text stated that the execve() capability transitions are not
+ performed for the same reasons that setuid and setgid mode bits
+ may be ignored (as described in execve(2)). But, that's not quite
+ correct: rather, the file capability sets are treated as empty
+ for the purpose of the capability transition calculations.
+ Michael Kerrisk
+ Rework bounding set as per-thread set in transformation rules
+ Michael Kerrisk
+ Substantially rework "Capabilities and execution of programs by root"
+ Rework for improved clarity, and also to include missing details
+ on the case where (1) the binary that is being executed has
+ capabilities attached and (2) the real user ID of the process is
+ not 0 (root) and (3) the effective user ID of the process is 0
+ (root).
+ Marcus Gelderie
+ Add details about SECBIT_KEEP_CAPS
+ The description of SECBIT_KEEP_CAPS is misleading about the
+ effects on the effective capabilities of a process during a
+ switch to nonzero UIDs. The effective set is cleared based on
+ the effective UID switching to a nonzero value, even if
+ SECBIT_KEEP_CAPS is set. However, with this bit set, the
+ effective and permitted sets are not cleared if the real and
+ saved set-user-ID are set to nonzero values.
+ Marcus Gelderie
+ Mention header for SECBIT constants
+ Mention that the named constants (SECBIT_KEEP_CAPS and others)
+ are available only if the linux/securebits.h user-space header
+ is included.
+ Michael Kerrisk
+ Add text introducing bounding set along with other capability sets
+ Michael Kerrisk [Allison Randal]
+ Update URL for location of POSIX.1e draft standard
+ Michael Kerrisk
+ CAP_SYS_CHROOT allows use of setns() to change the mount namespace
+ Michael Kerrisk [Pierre Chifflier]
+ Ambient capabilities do not trigger secure-execution mode
+ Michael Kerrisk
+ Add a subsection on per-user-namespace "set-user-ID-root" programs
+ Michael Kerrisk
+ Rework discussion of exec and UID 0, correcting a couple of details
+ Clarify the "Capabilities and execution of programs by root"
+ section, and correct a couple of details:
+ * If a process with rUID == 0 && eUID != 0 does an exec,
+ the process will nevertheless gain effective capabilities
+ if the file effective bit is set.
+ * Set-UID-root programs only confer a full set of capabilities
+ if the binary does not also have attached capabilities.
+ Michael Kerrisk
+ Update URL for libcap tarballs
+ The previous location does not seem to be getting updated.
+ (For example, at the time of this commit, libcap-2.26
+ had been out for two months, but was not present at
+ http://www.kernel.org/pub/linux/libs/security/linux-privs.
+ Michael Kerrisk
+ Clarify which capability sets capset(2) and capget(2) apply to
+ capset(2) and capget(2) apply operate only on the permitted,
+ effective, and inheritable process capability sets.
+ Michael Kerrisk
+ Correct the description of SECBIT_KEEP_CAPS
+ Michael Kerrisk
+ Add background details on capability transformations during execve(2)
+ Add background details on ambient and bounding set when
+ discussing capability transformations during execve(2).
+ Michael Kerrisk
+ Document the 'no_file_caps' kernel command-line option
+
+cgroup_namespaces.7
+ Michael Kerrisk [Troy Engel]
+ Clarify the example by making an implied detail more explicit.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=201047
+
+cgroups.7
+ Michael Kerrisk
+ Add more detail on v2 'cpu' controller and realtime threads
+ Explicitly note the scheduling policies that are relevant for the
+ v2 'cpu' controller.
+ Michael Kerrisk
+ Document the use of 'cgroup_no_v1=named' to disable v1 named hierarchies
+ This feature was added in Linux 5.0.
+ Michael Kerrisk [Mike Weilgart]
+ Complete partial sentence re kernel boot options and 'nsdelegate'
+ https://bugzilla.kernel.org/show_bug.cgi?id=201029
+ Michael Kerrisk
+ Reframe the text on delegation to include more details about cgroups v1
+ Michael Kerrisk [Leah Hanson]
+ Rework discussion of writing to cgroup.type file
+ In particular, it is possible to write "threaded" to a
+ cgroup.type file if the current type is "domain threaded".
+ Previously, the text had implied that this was not possible.
+ Michael Kerrisk [Balbir Singh, Marcus Gelderie]
+ Soften the discussion about delegation in cgroups v1
+ Balbir pointed out that v1 delegation was not an accidental
+ feature.
+
+epoll.7
+ Michael Kerrisk
+ Introduce the terms "interest list" and "ready list"
+ Michael Kerrisk
+ Consistently use the term "interest list" rather than "epoll set"
+ Michael Kerrisk
+ Reformat Q&A list
+ Michael Kerrisk
+ Note that edge-triggered notification wakes up only one waiter
+ Note a useful performance benefit of EPOLLET: ensuring that
+ only one of multiple waiters (in epoll_wait()) is woken
+ up when a file descriptor becomes ready.
+ Michael Kerrisk
+ Expand the discussion of the implications of file descriptor duplication
+ In particular, note that it may be difficult for an application
+ to know about the existence of duplicate file descriptors.
+
+feature_test_macros.7
+ Michael Kerrisk [Andreas Westfeld]
+ Add more detail on why FTMs must be defined before including any header
+
+inotify.7
+ Michael Kerrisk [Paul Millar]
+ Note ENOTDIR error that can occur for IN_ONLYDIR
+ Note ENOTDIR error that occurs when requesting a watch on a
+ nondirectory with IN_ONLYDIR.
+
+ip.7
+ Bert Hubert
+ IP_RECVTTL error fixed
+ I need to get the TTL of UDP datagrams from userspace, so I set
+ the IP_RECVTTL socket option. And as promised by ip.7, I then get
+ IP_TTL messages from recvfrom. However, unlike what the manpage
+ promises, the TTL field gets passed as a 32 bit integer.
+
+man.7
+ Michael Kerrisk
+ SEE ALSO: remove mdoc.samples(7)
+
+mount_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add findmnt(8)
+
+namespaces.7
+ Michael Kerrisk
+ List factors that may pin a namespace into existence
+ Various factors may pin a namespace into existence, even when it
+ has no member processes.
+ Michael Kerrisk [Tycho Kirchner]
+ Briefly explain why CAP_SYS_ADMIN is needed to create nonuser namespaces
+ Michael Kerrisk
+ Mention ioctl(2) in discussion of namespaces APIs
+ Michael Kerrisk
+ SEE ALSO: add pam_namespace(8)
+
+pid_namespaces.7
+ Michael Kerrisk
+ Clarify the semantics for the adoption of orphaned processes
+ Because of setns() semantics, the parent of a process may reside
+ in the outer PID namespace. If that parent terminates, then the
+ child is adopted by the "init" in the outer PID namespace (rather
+ than the "init" of the PID namespace of the child).
+ Michael Kerrisk
+ Note a detail of /proc/PID/ns/pid_for_children behavior
+ After clone(CLONE_NEWPID), /proc/PID/ns/pid_for_children is empty
+ until the first child is created. Verified by experiment.
+ Michael Kerrisk
+ Note that a process can do unshare(CLONE_NEWPID) only once
+
+sched.7
+ Michael Kerrisk [Eugene Syromyatnikov]
+ In the kernel source SCHED_OTHER is actually called SCHED_NORMAL
+ Michael Kerrisk
+ SEE ALSO: add ps(1) and top(1)
+ Michael Kerrisk
+ SEE ALSO: add chcpu(1), lscpu(1)
+
+signal.7
+ Michael Kerrisk [Robin Kuzmin]
+ Clarify that sigsuspend() and pause() suspend the calling *thread*
+ Helge Deller
+ Add signal numbers for parisc
+ Michael Kerrisk
+ Unify signal lists into a signal table that embeds standards info
+ Having the signals listed in three different tables reduces
+ readability, and would require more table splits if future
+ standards specify other signals.
+ Michael Kerrisk
+ Reorder the architectures in the signal number lists
+ x86 and ARM are the most common architectures, but currently
+ are in the second subfield in the signal number lists.
+ Instead, swap that info with subfield 1, so the most
+ common architectures are first in the list.
+ Michael Kerrisk
+ Place signal numbers in a separate table
+ The current tables of signal information are unwieldy,
+ as they try to cram in too much information.
+ Michael Kerrisk
+ Insert standards info into tables
+ Michael Kerrisk
+ SEE ALSO: add clone(2)
+
+socket.7
+ Michael Kerrisk
+ Refer reader to unix(7) for information on SO_PASSSEC
+ Michael Kerrisk
+ SEE ALSO: add address_families(7)
+
+socket.7
+unix.7
+ Michael Kerrisk
+ Move text describing SO_PEERCRED from socket(7) to unix(7)
+ This is, AFAIK, an option specific to UNIX domain sockets, so
+ place it in unix(7).
+
+tcp.7
+udp.7
+ Michael Kerrisk
+ Add a reference to socket(7) noting existence of further socket options
+
+unix.7
+ Michael Kerrisk
+ Enhance the description of SCM_RIGHTS
+ The existing description is rather thin. More can be said.
+ Michael Kerrisk
+ There is a limit on the size of the file descriptor array for SCM_RIGHTS
+ The limit is defined in the kernel as SCM_MAX_FD (253).
+ Michael Kerrisk
+ Rework SO_PEERCRED text for greater clarity
+ Michael Kerrisk [Felipe Gasper]
+ Clarify SO_PASSCRED behavior
+ Michael Kerrisk
+ Explicitly note that SO_PASSCRED provides SCM_CREDENTIALS messages
+ Michael Kerrisk
+ If the buffer to receive SCM_RIGHTS FDs is too small, FDs are closed
+ Michael Kerrisk
+ One must send at least one byte of real data with ancillary data
+ Michael Kerrisk
+ Ancillary data forms a barrier when receiving on a stream socket
+ Michael Kerrisk
+ When sending ancillary data, only one item of each type may be sent
+ Michael Kerrisk
+ Improve wording describing socket option argument/return values
+ Michael Kerrisk
+ Clarify treatment of incoming ancillary data if 'msg_control' is NULL
+ Michael Kerrisk
+ Note behavior if buffer to receive ancillary data is too small
+ Michael Kerrisk
+ Fix a minor imprecision in description of SCM_CREDENTIALS
+ Michael Kerrisk
+ Refer reader to socket(7) for information about SO_PEEK_OFF
+
+user_namespaces.7
+ Michael Kerrisk
+ Rework terminology describing ownership of nonuser namespaces
+ Prefer the word "owns" rather than "associated with" when
+ describing the relationship between user namespaces and non-user
+ namespaces. The existing text used a mix of the two terms, with
+ "associated with" being predominant, but to my ear, describing the
+ relationship as "ownership" is more comprehensible.
+
+vdso.7
+ Helge Deller
+ Fix parisc gateway page description
+
+ld.so.8
+ Michael Kerrisk [Florian Weimer, David Newall]
+ Document the --preload command-line option added in glibc 2.30
+ Michael Kerrisk
+ Note delimiters for 'list' in --audit and --inhibit-rpath
+ Michael Kerrisk
+ Place OPTIONS in alphabetical order
+ Michael Kerrisk
+ LD_PRELOAD-ed objects are added to link map in left-to-right order
+
+zdump.8
+ Paul Eggert
+ Sync from tzdb upstream
+
+zic.8
+ Paul Eggert
+ Sync from tzdb upstream
+
+
+==================== Changes in man-pages-5.01 ====================
+
+Released: 2019-05-09, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Abhinav Upadhyay <er.abhinav.upadhyay@gmail.com>
+Andreas Korb <andreas.d.korb@gmail.com>
+Anisse Astier <anisse@astier.eu>
+Brice Goglin <Brice.Goglin@inria.fr>
+Carlos O'Donell <carlos@redhat.com>
+Dr. Jürgen Sauermann <mail@xn--jrgen-sauermann-zvb.de>
+Egmont Koblinger <egmont@gmail.com>
+Elias Benali <stackptr@users.sourceforge.net>
+Elliot Hughes <enh@google.com>
+Florian Weimer <fweimer@redhat.com>
+Hugues Evrard <hevrard@google.com>
+Jakub Nowak <jakub.jakub.nowak@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Keegan Saunders <keeganwsaunders@gmail.com>
+Lucas Werkmeister <mail@lucaswerkmeister.de>
+Marcus Huewe <suse-tux@gmx.de>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Witten <mfwitten@gmail.com>
+Seth Troisi <sethtroisi@google.com>
+Slavomir Kaslev <kaslevs@vmware.com>
+Vincent Lefevre <vincent@vinc17.net>
+Wladimir Mutel <muwlgr@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+tsearch.3
+ Florian Weimer [Michael Kerrisk]
+ Document the twalk_r() function added in glibc 2.30
+
+
+New and changed links
+---------------------
+
+twalk_r.3
+ Michael Kerrisk
+ New link to twalk(3) page
+
+
+Changes to individual pages
+---------------------------
+
+accept.2
+ Michael Kerrisk
+ Note that 'addrlen' is left unchanged in the event of an error
+ See http://austingroupbugs.net/view.php?id=836.
+
+bpf.2
+ Michael Kerrisk
+ Update kernel version info for JIT compiler
+
+clone.2
+ Michael Kerrisk [Jakub Nowak]
+ CLONE_CHILD_SETTID has effect before clone() returns *in the child*
+ CLONE_CHILD_SETTID may not have had effect by the time clone()
+ returns in the parent, which could be relevant if the
+ CLONE_VM flag is employed. The relevant kernel code is in
+ schedule_tail(), which is called in ret_from_fork()
+ in the child.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=203105
+
+execve.2
+exec.3
+ Michael Kerrisk [Dr. Jürgen Sauermann]
+ Consistently use the term 'pathname' (not 'path')
+
+execve.2
+ Michael Kerrisk
+ Note that stack+environ size is also limited to 3/4 of _STK_LIM
+ In fs/exec.c::prepare_arg_pages(), we have:
+
+ limit = _STK_LIM / 4 * 3;
+ limit = min(limit, bprm->rlim_stack.rlim_cur / 4);
+ Michael Kerrisk [Dr. Jürgen Sauermann]
+ SEE ALSO: refer to exec(3) (rather than execl(3))
+
+pipe.2
+ Michael Kerrisk
+ Note that 'pipefd' is left unchanged in the event of an error
+ See http://austingroupbugs.net/view.php?id=467.
+
+sched_setaffinity.2
+ Michael Kerrisk [Brice Goglin]
+ Correct details of return value of sched_getaffinity() syscall
+
+setfsgid.2
+ Michael Kerrisk
+ Rewrite for improved clarity and defer to setfsuid() for details
+ Rewrite for improved clarity and defer to setfsuid(2) for the
+ rationale of the fsGID rather than repeating the same details
+ in this page.
+
+setfsuid.2
+ Michael Kerrisk
+ Rewrite for improved clarity and to hint history more explicitly
+ The current text reads somewhat clumsily. Rewrite it to introduce
+ the eUID and fsUID in parallel, and more clearly hint at the
+ historical rationale for the fsUID, which is detailed lower in
+ the page.
+
+socketpair.2
+ Michael Kerrisk
+ Clarify that 'sv' is left unchanged in the event of an error
+ See also http://austingroupbugs.net/view.php?id=483.
+
+splice.2
+ Slavomir Kaslev
+ EAGAIN can occur when called on nonblocking file descriptors
+
+syscalls.2
+ Michael Kerrisk [Andreas Korb]
+ Remove crufty text about i386 syscall dispatch table
+ The removed text long ago ceased to be accurate. Nowadays, the
+ dispatch table is autogenerated when building the kernel (via
+ the kernel makefile, arch/x86/entry/syscalls/Makefile).
+
+tee.2
+ Slavomir Kaslev
+ EAGAIN can occur when called on nonblocking file descriptors
+
+fopen.3
+ Elliot Hughes
+ Explain BSD vs glibc "a+" difference
+ Where is the initial read position for an "a+" stream?
+
+ POSIX leaves this unspecified. Most BSD man pages are silent, and
+ MacOS has the ambiguous "The stream is positioned at the end of
+ the file", not differentiating between reads and writes other than
+ to say that fseek(3) does not affect writes. glibc's documentation
+ explicitly specifies that the initial read position is the
+ beginning of the file.
+
+mallinfo.3
+ Elliott Hughes
+ Further discourage use of mallinfo()
+ The BUGS section already explains why you need to be cautious
+ about using mallinfo, but given the number of bug reports we see
+ on Android, it seems not many people are reading that far. Call it
+ out up front.
+
+malloc_trim.3
+ Carlos O'Donell
+ Update trimming information
+ Since glibc 2.8, commit 68631c8eb92, the malloc_trim function has
+ iterated over all arenas and free'd back to the OS all page runs
+ that were free. This allows an application to call malloc_trim to
+ consolidate fragmented chunks and free back any pages it can to
+ potentially reduce RSS usage.
+
+posix_memalign.3
+ Elliot Hughes
+ Some functions set errno
+ True of bionic, glibc, and musl. (I didn't check elsewhere.)
+
+resolver.3
+ Michael Kerrisk [Wladimir Mutel]
+ Mention that some functions set 'h_errno'
+
+stdarg.3
+ Michael Kerrisk [Vincent Lefevre]
+ Remove the NOTES section describing the ancient varargs macros
+ stdarg.h is now 30 years old, and gcc long ago (2004) ceased to
+ implement <varargs.h>. There seems little value in keeping this
+ text.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=202907
+ Michael Kerrisk [Egmont Koblinger]
+ Add a note that "..." in function signature means a variadic function
+ Egmont suggested adding this, because the string "..." appears
+ at several other points in the page, but just to indicate that
+ some text is omitted from example code.
+
+strerror.3
+ Jakub Wilk
+ Don't discuss buffer size for strerror_l()
+ Unlike strerror_r(), strerror_l() doesn't take buffer length as an
+ argument.
+
+strtol.3
+strtoul.3
+ Jakub Wilk
+ SEE ALSO: add strtoimax(3), strtoumax(3)
+
+sysconf.3
+ Michael Kerrisk [Hugues Evrard]
+ Clearly note that _SC_PAGESIZE and _SC_PAGE_SIZE are synonyms
+
+tsearch.3
+ Florian Weimer
+ Do not use const arguments in twalk() callback
+ The const specifier is not part of the prototype (it only applies
+ to the implementation), so showing it here confuses the reader.
+ Michael Kerrisk
+ SYNOPSIS: add missing definition of 'VISIT' type
+ Michael Kerrisk
+ Reformat twalk() and twalk_r() prototypes for easier readability
+
+console_codes.4
+ Jakub Wilk
+ Document that \e[1;n] and \e[2;n] support 16 colors
+ Source: setterm_command() in drivers/tty/vt/vt.c
+
+elf.5
+ Michael Kerrisk [Keegan Saunders]
+ A data segment does not have PF_X
+
+proc.5
+ Michael Witten [Anisse Astier]
+ Add missing Inode field to /proc/net/unix
+
+hostname.7
+ Florian Weimer
+ HOSTALIASES/search path processing is DNS-specific
+ Other NSS modules do not necessarily honor these settings.
+
+inode.7
+ Michael Kerrisk
+ Note that timestamp fields measure time starting at the Epoch
+ Michael Kerrisk
+ Timestamp fields are structures that include a nanosecond component
+ Michael Kerrisk
+ Add references to execve(2) to describe set-UID/set-GID behaviors
+
+
+==================== Changes in man-pages-5.02 ====================
+
+Released: 2019-08-02, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alan Stern <stern@rowland.harvard.edu>
+Alexey Izbyshev <izbyshev@ispras.ru>
+Amir Goldstein <amir73il@gmail.com>
+Cyrill Gorcunov <gorcunov@gmail.com>
+Eric Sanchis <eric.sanchis@iut-rodez.fr>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Finn O'Leary <finnoleary@inventati.org>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Guillaume Laporte <guillaume.laporte.adm@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Kumar Chaudhary, Naveen <naveen.kumar.chaudhary@intel.com>
+Mark Wielaard <mark@klomp.org>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Kenigsberg <matthewkenigsberg@gmail.com>
+Matthias Hertel <Matthias.Hertel@rohde-schwarz.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Sekletar <msekleta@redhat.com>
+Oleg Nesterov <oleg@redhat.com>
+Palmer Dabbelt <palmer@sifive.com>
+Petr Vaněk <arkamar@atlas.cz>
+Sami Kerola <kerolasa@iki.fi>
+Shawn Landden <shawn@git.icu>
+Thorsten Glaser <tg@mirbsd.de>
+Tobias Klauser <tklauser@distanz.ch>
+Tomas Skäre <tomas.skare@gmail.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify.7
+fanotify_init.2
+fanotify_mark.2
+ Matthew Bobrowski [Amir Goldstein, Jan Kara]
+ Document FAN_REPORT_FID and directory modification events
+
+vdso.7
+ Tobias Klauser [Palmer Dabbelt]
+ Document vDSO for RISCV
+
+Renamed pages
+-------------
+
+sysvipc.7
+ svipc(7) is renamed to sysvipc(7).
+ The name sysvipc is a bit more natural, and is the name used in
+ /proc/sysvipc.
+
+New and changed links
+---------------------
+
+svipc.7
+ Michael Kerrisk
+ Add old name of sysvipc(7) page as a link
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Change reference to svipc(7) to sysvipc(7)
+
+
+Changes to individual pages
+---------------------------
+
+pldd.1
+ G. Branden Robinson [Michael Kerrisk]
+ Document glibc's unbreakage of tool
+ After a longstanding breakage, pldd now works again (glibc 2.30).
+
+bpf.2
+ Michael Kerrisk
+ Correct kernel version for JIT support on s390
+
+chdir.2
+ Michael Kerrisk
+ Add ENOTDIR error for fchdir()
+
+execve.2
+ Michael Kerrisk [Eugene Syromyatnikov]
+ Since Linux 5.1, the limit on the #! line is 255 chars (rather than 127)
+ Shawn Landden [Michael Kerrisk]
+ Add more detail about Shebangs
+ Michael Kerrisk
+ Linux is not alone in ignoring the set-UID and set-GID bits for scripts
+
+mount.2
+ Michael Kerrisk
+ ERRORS: Add a couple of EINVAL errors for MS_MOVE
+ Michael Kerrisk
+ SEE ALSO: add chroot(2) and pivot_root(2)
+
+mprotect.2
+ Mark Wielaard
+ pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0
+
+mprotect.2
+pkey_alloc.2
+ Mark Wielaard [Florian Weimer]
+ _GNU_SOURCE is required for the pkey functions.
+
+pivot_root.2
+ Michael Kerrisk
+ ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation
+ Michael Kerrisk
+ 'new_root' must be a mount point
+ It appears that 'new_root' may not have needed to be a mount
+ point on ancient kernels, but already in Linux 2.4.5 this changed.
+ Michael Kerrisk
+ 'put_old' can't be a mount point with MS_SHARED propagation
+ Michael Kerrisk
+ SEE ALSO: add mount(2)
+
+poll.2
+ Michael Kerrisk [Alan Stern]
+ Note that poll() equivalent code for ppoll() is not quite equivalent
+
+prctl.2
+ Yang Xu [Cyrill Gorcunov]
+ Correct some details for PR_SET_TIMERSLACK
+
+setxattr.2
+ Finn O'Leary [Michael Kerrisk]
+ Add ERANGE to 'ERRORS' section
+
+tkill.2
+ Michael Kerrisk
+ glibc 2.30 provides a wrapper for tgkill()
+
+dlopen.3
+ Michael Kerrisk
+ Clarify the rules for symbol resolution in a dlopen'ed object
+ The existing text wrongly implied that symbol look up first
+ occurred in the object and then in main, and did not mention
+ whether dependencies of main where used for symbol resolution.
+ Michael Kerrisk
+ Clarify when an executable's symbols can be used for symbol resolution
+ The --export-dynamic linker option is not the only way that main's
+ global symbols may end up in the dynamic symbol table and thus be
+ used to satisfy symbol reference in a shared object. A symbol
+ may also be placed into the dynamic symbol table if ld(1)
+ notices a dependency in another object during the static link.
+ Michael Kerrisk
+ An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL
+ Michael Kerrisk
+ Note that symbol use might keep a dlclose'd object in memory
+ Michael Kerrisk
+ On dlclose(), destructors are called when reference count falls to 0
+ Michael Kerrisk
+ Make it clear that RTLD_NODELETE also affects global variables
+ Michael Kerrisk
+ Clarify that constructors are called only when library is first loaded
+
+exec.3
+ Matthew Kenigsberg
+ Explain function groupings
+ I've found the exec man page quite difficult to read when trying
+ to find the behavior for a specific function. Since the names of
+ the functions are inline and the order of the descriptions isn't
+ clear, it's hard to find which paragraphs apply to each function.
+ I thought it would be much easier to read if the grouping based on
+ letters is stated.
+
+getutent.3
+ Michael Kerrisk [Thorsten Glaser]
+ Fix missing include file in EXAMPLE
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=932382
+
+on_exit.3
+ Michael Kerrisk [Sami Kerola]
+ Stack variables may be out of scope when exit handler is invoked
+
+strcat.3
+ Michael Kerrisk [Eric Sanchis]
+ Fix off-by-one error in example code
+
+cpuid.4
+ Michael Kerrisk
+ SEE ALSO: add cpuid(1)
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add ld.so(8)
+
+proc.5
+ Michael Kerrisk
+ Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields
+ These fields are signal masks, not counters.
+ Michael Kerrisk
+ Clarify that various mask fields in /proc/PID/status are in hexadecimal
+
+capabilities.7
+ Michael Kerrisk
+ Add a note about using strace on binaries that have capabilities
+ Michael Kerrisk
+ Add pivot_root(2) to CAP_SYS_ADMIN list
+ Michael Kerrisk
+ CAP_FOWNER also allows modifying user xattrs on sticky directories
+
+cgroup_namespaces.7
+ Michael Kerrisk
+ Some wording fixes to improve clarity
+ Michael Kerrisk
+ In the example shell session, give second shell a different prompt
+
+credentials.7
+ Michael Kerrisk
+ Note that /proc/PID/status shows a process's credentials
+ Michael Kerrisk
+ SEE ALSO: add tcgetsid(3)
+
+fanotify.7
+ Matthew Bobrowski
+ Reword FAN_REPORT_FID data structure inclusion semantics
+ Michael Kerrisk
+ Clarify logic in ESTALE check
+ Michael Kerrisk
+ Reorder text in EXAMPLE
+ Michael Kerrisk
+ Reformat program output to fit in 80 columns
+
+mount_namespaces.7
+ Michael Kerrisk
+ Clarify implications for other NS if mount point is removed in one NS
+ If a mount point is deleted or renamed or removed in one mount
+ namespace, this will cause an object that is mounted at that
+ location in another mount namespace to be unmounted (as verified
+ by experiment). This was implied by the existing text, but it is
+ better to make this detail explicit.
+ Michael Kerrisk
+ SEE ALSO: add pivot_root(2), pivot_root(8)
+
+namespaces.7
+ Michael Kerrisk
+ Note initial values of hostname and domainname in a new UTS namespace
+
+sched.7
+ Michael Kerrisk
+ SEE ALSO: add pthread_getschedparam(3)
+
+signal.7
+ Michal Sekletar [Oleg Nesterov, Michael Kerrisk]
+ Clarify that siginfo_t isn't changed on coalescing
+ Michael Kerrisk
+ Various fields in /proc/PID/status show signal-related information
+ Michael Kerrisk
+ Add subsection on queuing and delivery semantics for standard signals
+
+socket.7
+ Michael Kerrisk
+ select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28
+
+unix.7
+ Michael Kerrisk
+ Note SCM_RIGHTS interaction with RLIMIT_NOFILE
+ If the file descriptors received in SCM_RIGHTS would cause
+ the process to its exceed RLIMIT_NOFILE limit, the excess
+ FDs are discarded.
+
+user_namespaces.7
+ Michael Kerrisk
+ Describe the effect of file-related capabilities inside user namespaces
+ Michael Kerrisk
+ Describe how kernel treats UIDs/GIDs when a process accesses files
+
+vdso.7
+ Tobias Klauser
+ Mention removal of Blackfin port in Linux 4.17
+
+ld.so.8
+ Michael Kerrisk [Matthias Hertel]
+ Note some further details of secure-execution mode
+ Note some further details of the treatment of environment
+ variables in secure execution mode. In particular (as noted by
+ Matthias Hertel), note that ignored environment variables are also
+ stripped from the environment. Furthermore, there are some other
+ variables, not used by the dynamic linker itself, that are also
+ treated in this way (see the glibc source file
+ sysdeps/generic/unsecvars.h).
+
+
+==================== Changes in man-pages-5.03 ====================
+
+Released: 2019-10-11, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adam Borowski <kilobyte@angband.pl>
+Aleksa Sarai <asarai@suse.de>
+Alexey Budankov <alexey.budankov@linux.intel.com>
+Amir Goldstein <amir73il@gmail.com>
+Andrew Clayton <andrew@digital-domain.net>
+Carlos O'Donell <carlos@redhat.com>
+Christian Brauner <christian@brauner.io>
+Christopher M. Riedl <cmr@informatik.wtf>
+Daniel Colascione <dancol@google.com>
+Dave Carroll <david.carroll@microsemi.com>
+Dave Chinner <dchinner@redhat.com>
+Дилян Палаузов <dilyan.palauzov@aegee.org>
+Dmitry V. Levin <ldv@altlinux.org>
+Don Brace <don.brace@microsemi.com>
+eponymous alias <eponymousalias@yahoo.com>
+Eric Biggers <ebiggers@google.com>
+Eric W. Biederman <ebiederm@xmission.com>
+Florian Weimer <fw@deneb.enyo.de>
+Florin Blanaru <florin.blanaru96@gmail.com>
+Gilbert Wu <gilbert.wu@microsemi.com>
+Ingo Schwarze <schwarze@usta.de>
+Jakub Wilk <jwilk@jwilk.net>
+Kevin Barnett <kevin.barnett@microsemi.com>
+Marko Myllynen <myllynen@redhat.com>
+Matti Moell <Matti.Moell@opensynergy.com>
+Matti Möll <Matti.Moell@opensynergy.com>
+Matt Perricone <matt.perricone@microsemi.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Murthy Bhat <Murthy.Bhat@microsemi.com>
+Nikola Forró <nforro@redhat.com>
+nilsocket <nilsocket@gmail.com>
+Paul Wise <pabs3@bonedaddy.net>
+Philipp Wendler <ml@philippwendler.de>
+Raphael Moreira Zinsly <rzinsly@linux.vnet.ibm.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Reid Priedhorsky <reidpr@lanl.gov>
+Rick Stanley <rstanley@rsiny.com>
+Rob Landley <rob@landley.net>
+Scott Benesh <scott.benesh@microsemi.com>
+Scott Teel <scott.teel@microsemi.com>
+Shawn Anastasio <shawn@anastas.io>
+Simone Piccardi <piccardi@truelite.it>
+Vincent Lefevre <vincent@vinc17.net>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pidfd_open.2
+ Michael Kerrisk [Christian Brauner, Florian Weimer, Daniel Colascione]
+ New page documenting pidfd_open(2)
+
+pidfd_send_signal.2
+ Michael Kerrisk [Florian Weimer, Christian Brauner]
+ New page documenting pidfd_send_signal(2)
+
+pivot_root.2
+ Michael Kerrisk [Eric W. Biederman, Reid Priedhorsky, Philipp Wendler]
+ This page has been completely rewritten, adding a lot of missing
+ details (including the use of pivot_root(".", ".")) and an example
+ program. In addition, the text prevaricating on whether or not
+ pivot_root() might change the root and current working directories has
+ been eliminated, and replaced with a simple description of the behavior
+ of the system call, which has not changed for 19 years, and will not
+ change in the future. Many longstanding errors in the old version of
+ the page have also been corrected.
+
+ipc_namespaces.7
+ Michael Kerrisk
+ New page with content migrated from namespaces(7)
+
+uts_namespaces.7
+ Michael Kerrisk
+ New page with content migrated from namespaces(7)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Christian Brauner, Michael Kerrisk
+ Document CLONE_PIDFD
+ Add an entry for CLONE_PIDFD. This flag is available starting
+ with kernel 5.2. If specified, a process file descriptor
+ ("pidfd") referring to the child process will be returned in
+ the ptid argument.
+
+fanotify_mark.2
+ Jakub Wilk
+ Document FAN_MOVE_SELF
+
+ptrace.2
+ Dmitry V. Levin [Michael Kerrisk]
+ Document PTRACE_GET_SYSCALL_INFO
+
+regex.3
+ Rob Landley
+ Document REG_STARTEND
+
+
+New and changed links
+---------------------
+
+res_nclose.3
+ Michael Kerrisk
+ Add NEW link to resolver.3
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ SEE ALSO: correct list order
+
+Various pages
+ Michael Kerrisk
+ Remove section number from references to function in its own page
+
+Various pages
+ Michael Kerrisk
+ ERRORS: correct alphabetical order
+
+
+Changes to individual pages
+---------------------------
+
+localedef.1
+ Marko Myllynen
+ Describe recently added options
+ Describe few recently added options (present in glibc-2.29).
+
+clone.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_open(2)
+
+copy_file_range.2
+ Amir Goldstein [Dave Chinner]
+ Kernel v5.3 updates
+
+fanotify_mark.2
+ Jakub Wilk
+ Add kernel version numbers for some FAN_* constants
+
+getdomainname.2
+ Michael Kerrisk
+ Add mention of UTS namespaces
+
+gethostname.2
+ Michael Kerrisk [Jakub Wilk]
+ Mention UTS namespaces
+
+io_submit.2
+ Matti Moell [Matti Möll]
+ Fix kernel version numbers for 'aio_rw_flags' flags
+
+kill.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+mmap.2
+ Nikola Forró
+ Fix EINVAL conditions
+ Since introduction of MAP_SHARED_VALIDATE, in case flags contain
+ both MAP_PRIVATE and MAP_SHARED, mmap() doesn't fail with EINVAL,
+ it succeeds.
+
+ The reason for that is that MAP_SHARED_VALIDATE is in fact equal
+ to MAP_PRIVATE | MAP_SHARED.
+
+mount.2
+ Michael Kerrisk [Reid Priedhorsky]
+ Describe the concept of "parent mounts"
+ Michael Kerrisk
+ NOTES: add subsection heading for /proc/[pid]/{mounts,mountinfo}
+ Michael Kerrisk
+ Rework the text on mount namespaces a little
+ Eliminate the term "Per-process namespaces" and add a reference
+ to mount_namespaces(7).
+
+move_pages.2
+ Yang Xu [Michael Kerrisk]
+ Mark E2BIG as deprecated
+ E2BIG was removed in 2.6.29, we should mark it as deprecated.
+
+perf_event_open.2
+ Michael Kerrisk [Alexey Budankov]
+ SEE ALSO: add Documentation/admin-guide/perf-security.rst
+
+prctl.2
+ Michael Kerrisk
+ Clarify that PR_GET_SPECULATION_CTRL returns value as function result
+ Michael Kerrisk
+ Clarify that PR_MCE_KILL_GET returns value via function result
+ Michael Kerrisk
+ Clarify that PR_GET_FP_MODE returns value as function result
+ Michael Kerrisk
+ RETURN VALUE: add some missing entries
+ Note success return for PR_GET_SPECULATION_CTRL and PR_GET_FP_MODE.
+
+rt_sigqueueinfo.2
+ Michael Kerrisk
+ Note that 'si_code' can't be specified as SI_KERNEL
+ Michael Kerrisk
+ The rules for 'si_code' don't apply when sending a signal to oneself
+ The restriction on what values may be specified in 'si_code'
+ apply only when sending a signal to a process other than the
+ caller itself.
+ Michael Kerrisk
+ Rename 'uinfo' argument to 'info'
+ This is more consistent with the naming in other pages
+ that refer to a 'siginfo_t' structure.
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+sched_setaffinity.2
+ Michael Kerrisk
+ RETURN VALUE: sched_getaffinity() syscall differs from the wrapper
+
+setns.2
+ Mike Frysinger
+ Fix CLONE_NEWNS restriction info
+
+sigaction.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+signalfd.2
+ Andrew Clayton, Michael Kerrisk
+ Note about interactions with epoll & fork
+
+statx.2
+ Michael Kerrisk [Simone Piccardi]
+ Clarify details of a case where an invalid 'mask' value may be rejected
+
+syscall.2
+ Shawn Anastasio
+ Add information for powerpc64
+ Michael Kerrisk [Adam Borowski, Florin Blanaru]
+ Update name of syscall instruction for riscv
+
+syscalls.2
+ Michael Kerrisk
+ Add fsconfig(), fsmount(), fsopen(), fspick(), move_mount(), open_tree()
+ Michael Kerrisk [(), Michael(), Kerrisk(),]
+ Add new syscalls in 5.1
+ Add io_uring_enter(), io_uring_register(), io_uring_setup(), and
+ pidfd_send_signal().
+ Michael Kerrisk
+ Add clone3() and pidfd_open()
+
+uname.2
+ Michael Kerrisk
+ Replace reference to namespaces(7) with reference to uts_namespaces(7)
+
+errno.3
+ Rasmus Villemoes
+ Add some comments on EAGAIN/EWOULDBLOCK and EDEADLK/EDEADLOCK
+
+fexecve.3
+ Michael Kerrisk [Simone Piccardi]
+ ENOSYS occurs only if the kernel provides no execveat() syscall
+ Michael Kerrisk [Simone Piccardi]
+ ERRORS: add ENOENT
+
+getauxval.3
+ Raphael Moreira Zinsly
+ Add new cache geometry entries
+
+printf.3
+ Vincent Lefevre
+ Add detail on the first digit with the %e format
+
+pthread_setcancelstate.3
+pthreads.7
+signal-safety.7
+ Carlos O'Donell
+ Describe issues with cancellation points in signal handlers
+
+strtok.3
+ Michael Kerrisk [eponymous alias]
+ Correct description of use of 'saveptr' argument in strtok_r()
+ Michael Kerrisk [eponymous alias]
+ The caller should not modify 'saveptr' between strtok_r() calls
+ Michael Kerrisk
+ Add portability note for strtok_r() '*saveptr' value
+ On some implementations, '*saveptr' must be NULL on first call
+ to strtok_r().
+
+smartpqi.4
+ Murthy Bhat [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
+ Add sysfs entries
+ Gilbert Wu [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
+ Add module param expose ld first
+ Dave Carroll [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
+ Add module param to hide vsep
+
+core.5
+ Paul Wise
+ Explain the new situation with argument splitting
+ Things changed in Linux v5.3-rc3 commit 315c69261dd3 from
+ splitting after template expansion to splitting beforehand.
+
+resolv.conf.5
+ Nikola Forró
+ Update information about search list
+ Since glibc 2.26, the number of domains in the search list is
+ no longer limited.
+
+man-pages.7
+ Michael Kerrisk
+ Relocate and enhance the text on semantic newlines
+ Michael Kerrisk [Paul Wise]
+ Paragraphs should not be separated by blank lines
+
+mount_namespaces.7
+ Michael Kerrisk
+ Explain how a namespace's mount point list is initialized
+ Provide a more detailed explanation of the initialization of
+ the mount point list in a new mount namespace.
+ Michael Kerrisk [Eric W. Biederman]
+ Clarify description of "less privileged" mount namespaces
+ Michael Kerrisk
+ SEE ALSO: refer to example in pivot_root(2)
+ Michael Kerrisk [Eric W. Biederman]
+ It may be desirable to disable propagation after creating a namespace
+ After creating a new mount namespace, it may be desirable to
+ disable mount propagation. Give the reader a more explicit
+ hint about this.
+
+mq_overview.7
+sysvipc.7
+ Michael Kerrisk
+ Adjust references to namespaces(7) to ipc_namespaces(7)
+
+namespaces.7
+ Michael Kerrisk
+ Remove content migrated to new ipc_namespaces(7) page
+ Michael Kerrisk
+ Remove content migrated to uts_namespaces(7)
+ Michael Kerrisk
+ Include manual page references in the summary table of namespace types
+ Make the page more compact by removing the stub subsections that
+ list the manual pages for the namespace types. And while we're
+ here, add an explanation of the table columns.
+
+operator.7
+ Michael Kerrisk [Rick Stanley]
+ Prefix and postfix ++/-- have different precedences
+ Harbison and Steele also agree on this.
+
+signal.7
+ Michael Kerrisk
+ Enhance the text on process-directed and thread-directed signals
+ clone(2) has a good description of these concepts; borrow
+ from it liberally.
+ Michael Kerrisk
+ SEE ALSO: add pidfd_send_signal(2)
+
+user_namespaces.7
+ Michael Kerrisk
+ Improve explanation of meaning of ownership of nonuser namespaces
+
+
+==================== Changes in man-pages-5.04 ====================
+
+Released: 2019-11-19, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Andrew Price <anprice@redhat.com>
+Christian Brauner <christian.brauner@ubuntu.com>
+Florian Weimer <fweimer@redhat.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Kenigbolo Meya Stephen <kenigbol@ut.ee>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mikael Magnusson <mikachu@gmail.com>
+Robert Edmonds <edmonds@debian.org>
+Silviu Popescu <silviupopescu1990@gmail.com>
+Torin Carey <torin@tcarey.uk>
+Witold Baryluk <witold.baryluk@gmail.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Michael Kerrisk [Christian Brauner, Jakub Wilk]
+ Document clone3()
+
+wait.2
+ Michael Kerrisk
+ Add P_PIDFD for waiting on a child referred to by a PID file descriptor
+
+bpf-helpers.7
+ Michael Kerrisk
+ Refresh against kernel v5.4-rc7
+
+
+New and changed links
+---------------------
+
+clone3.2
+ Michael Kerrisk
+ New link to clone(2)
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Rename arguments for consistency with clone3()
+ Make the names of the clone() arguments the same as the fields
+ in the clone3() 'args' struct:
+
+ ctid ==> child_pid
+ ptid ==> parent_tid
+ newtls ==> tld
+ child_stack ==> stack
+ Michael Kerrisk
+ Consistently order paragraphs for CLONE_NEW* flags
+ Sometimes the descriptions of these flags mentioned the
+ corresponding section 7 namespace manual page and then the
+ required capabilities, and sometimes the order was the was
+ the reverse. Make it consistent.
+ Michael Kerrisk [Christian Brauner, Jann Horn]
+ EXAMPLE: Allocate child's stack using mmap(2) rather than malloc(3)
+ Christian Brauner suggested mmap(MAP_STACK), rather than
+ malloc(), as the canonical way of allocating a stack for the
+ child of clone(), and Jann Horn noted some reasons why
+ (MAP_STACK exists elsewhere, and mmap() returns a page-aligned
+ block of memory, which is useful if we want to set up a guard
+ page at the end of the stack).
+ Michael Kerrisk [Christian Brauner]
+ Tidy up the description of CLONE_DETACHED
+ The obsolete CLONE_DETACHED flag has never been properly
+ documented, but now the discussion CLONE_PIDFD also requires
+ mention of CLONE_DETACHED. So, properly document CLONE_DETACHED,
+ and mention its interactions with CLONE_PIDFD.
+ Michael Kerrisk [Christian Brauner]
+ Give the introductory paragraph a new coat of paint
+ Change the text in the introductory paragraph (which was written
+ 20 years ago) to reflect the fact that clone*() does more things
+ nowadays.
+ Michael Kerrisk
+ Remove wording that suggests CLONE_NEW* flags are for containers
+ These flags are used for implementing many other interesting
+ things by now.
+ Michael Kerrisk
+ Remove various details that are already covered in namespaces pages
+ Remove details of UTS, IPC, and network namespaces that are
+ already covered in the corresponding namespaces pages in section 7.
+
+clone.2
+proc.5
+ Michael Kerrisk
+ Adjust references to namespaces(7)
+ Adjust references to namespaces(7) to be references to pages
+ describing specific namespace types.
+
+fallocate.2
+ Andrew Price
+ Add gfs2 to the list of punch hole-capable filesystems
+
+ioctl_iflags.2
+ Michael Kerrisk [Robert Edmonds]
+ Emphasize that FS_IOC_GETFLAGS and FS_IOC_SETFLAGS argument is 'int *'
+
+ioctl_list.2
+ Michael Kerrisk
+ Add reference to ioctl(2) SEE ALSO section
+ The referenced section lists various pages that document ioctls.
+
+mmap.2
+ Michael Kerrisk
+ Note that MAP_STACK exists on some other systems
+ Michael Kerrisk
+ Some rewording of the description of MAP_STACK
+ Reword a little to allow for the fact that there are now
+ *two* reasons to consider using this flag.
+
+pidfd_open.2
+ Michael Kerrisk
+ Note the waitid() use case for PID file descriptors
+ Michael Kerrisk
+ Add a subsection header "Use cases for PID file descriptors"
+ Michael Kerrisk
+ Make it a little more explicit the CLONE_PIDFD returns a PID FD
+
+pivot_root.2
+ Michael Kerrisk
+ EXAMPLE: allocate stack using mmap() MAP_STACK rather than malloc()
+
+quotactl.2
+ Yang Xu [Jan Kara]
+ Add some details about Q_QUOTAON
+
+seccomp.2
+cgroups.7
+ Michael Kerrisk
+ Switch to "considerate language"
+
+select.2
+ Michael Kerrisk
+ POLLIN_SET/POLLOUT_SET/POLLEX_SET are now defined in terms of EPOLL*
+ Since kernel commit a9a08845e9acbd224e4ee466f5c1275ed50054e8, the
+ equivalence between select() and poll()/epoll is defined in terms
+ of the EPOLL* constants, rather than the POLL* constants.
+
+wait.2
+ Michael Kerrisk
+ waitid() can be used to wait on children in same process group as caller
+ Since Linux 5.4, idtype == P_PGID && id == 0 can be used to wait
+ on children in same process group as caller.
+ Michael Kerrisk
+ Clarify semantics of waitpid(0, ...)
+ As noted in kernel commit 821cc7b0b205c0df64cce59aacc330af251fa8f7,
+ threads create an ambiguity: what if the calling process's PGID
+ is changed by another thread while waitpid(0, ...) is blocked?
+ So, clarify that waitpid(0, ...) means wait for children whose
+ PGID matches the caller's PGID at the time of the call to
+ waitpid().
+
+getauxval.3
+ Michael Kerrisk [Witold Baryluk]
+ Clarify that AT_BASE_PLATFORM and AT_EXECFN return pointers to strings
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=942207
+
+resolv.conf.5
+ Florian Weimer
+ Attempt clarify domain/search interaction
+ The domain directive is historic at this point; it should not
+ be used.
+
+netdevice.7
+ Michael Kerrisk [Silviu Popescu]
+ Small wording fix in description of SIOCGIFCONF
+ SIOCGIFCONF returns "network layer" addresses (not "transport
+ layer").
+
+uts_namespaces.7
+ Michael Kerrisk
+ Add a little more detail on scope of UTS namespaces
+
+
+==================== Changes in man-pages-5.05 ====================
+
+Released: 2020-02-09, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Adam Borowski <kilobyte@angband.pl>
+Adrian Reber <areber@redhat.com>
+Andy Lutomirski <luto@kernel.org>
+Antonin Décimo <antonin.decimo@gmail.com>
+Benjamin Peterson <benjamin@python.org>
+Brennan Vincent <brennan@materialize.io>
+Christian Brauner <christian.brauner@ubuntu.com>
+Colin Ian King <colin.king@canonical.com>
+Cyril Hrubis <chrubis@suse.cz>
+Daniel Colascione <dancol@google.com>
+Denys Vlasenko <dvlasenk@redhat.com>
+DJ Delorie <dj@redhat.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Jakub Wilk <jwilk@jwilk.net>
+Jashank Jeremy <jashank@rulingia.com.au>
+Joel Fernandes <joel@joelfernandes.org>
+John Hubbard <jhubbard@nvidia.com>
+John Jones <jmjatlanta@gmail.com>
+Joseph C. Sible <josephcsible@gmail.com>
+kevin sztern <kevin.sztern@epita.fr>
+Marko Myllynen <myllynen@redhat.com>
+markus T Metzger <markus.t.metzger@intel.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Salvatore <mike.salvatore@canonical.com>
+Mikhail Golubev <Mikhail.Golubev@opensynergy.com>
+Nick Shipp <ns@segbrk.com>
+Nikola Forró <nforro@redhat.com>
+Peter Gajdos <pgajdos@suse.cz>
+Petr Vorel <pvorel@suse.cz>
+Ponnuvel Palaniyappan <pponnuvel@gmail.com>
+Rich Felker <dalias@libc.org>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+Samuel Thibault <samuel.thibault@ens-lyon.org>
+Sam Varshavchik <mrsam@courier-mta.com>
+Vegard Nossum <vegard.nossum@gmail.com>
+Weitian LI <liweitianux@live.com>
+Will <cassis@tricolore.lu>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+Yu Jian Wu <yujian.wu1@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Adrian Reber [Christian Brauner, Michael Kerrisk]
+ Add clone3() set_tid information
+ Michael Kerrisk
+ Document CLONE_CLEAR_SIGHAND
+
+fcntl.2
+ Joel Fernandes [Michael Kerrisk]
+ Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
+
+memfd_create.2
+ Joel Fernandes
+ Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
+
+loop.4
+ Yang Xu
+ Document LOOP_SET_BLOCK_SIZE
+ Yang Xu
+ Document LOOP_SET_DIRECT_IO
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/vm/unprivileged_userfaultfd
+
+
+Changes to individual pages
+---------------------------
+
+capget.2
+ Michael Kerrisk [Yang Xu]
+ Add missing details in EPERM error for setting inheritable capabilities
+
+clone.2
+ Michael Kerrisk
+ Note that CLONE_THREAD causes similar behavior to CLONE_PARENT
+ The introductory paragraphs note that "the calling process" is
+ normally synonymous with the "the parent process", except in the
+ case of CLONE_PARENT. The same is also true of CLONE_THREAD.
+ Christian Brauner [Michael Kerrisk]
+ Mention that CLONE_PARENT is off-limits for inits
+ Michael Kerrisk [Colin Ian King]
+ Add old EINVAL error for AArch64
+ Michael Kerrisk
+ ERRORS: add EINVAL for use of CLONE_PARENT by an init process
+
+futex.2
+ Ponnuvel Palaniyappan
+ Fix a bug in the example
+
+listen.2
+ Michael Kerrisk [Peter Gajdos]
+ The 'somaxconn' default value has increased to 4096
+
+modify_ldt.2
+set_thread_area.2
+ Andy Lutomirski [Markus T Metzger]
+ Fix type of base_addr
+
+move_pages.2
+ John Hubbard [Michal Hocko]
+ Remove ENOENT from the list of possible return values
+
+open.2
+ Adam Borowski
+ No need for /proc to make an O_TMPFILE file permanent
+ In the example snippet, we already have the fd, thus there's no
+ need to refer to the file by name. And, /proc/ might be not
+ mounted or not accessible.
+ Michael Kerrisk [Joseph C. Sible]
+ In O_TMPFILE example, describe alternative linkat() call
+ This was already shown in an earlier version of the page,
+ but Adam Borowski's patch replaced it with an alternative.
+ Probably, it is better to show both possibilities.
+
+perf_event_open.2
+ Daniel Colascione
+ Mention EINTR for perf_event_open
+
+ptrace.2
+ Denys Vlasenko
+ PTRACE_EVENT_STOP does not always report SIGTRAP
+
+quotactl.2
+ Michael Kerrisk
+ Don't show numeric values of Q_XQUOTAON XFS_QUOTA_?DQ_* flags
+ The programmer should not need to care about the numeric values,
+ and their inclusion is verbosity.
+ Yang Xu [Michael Kerrisk]
+ Add EINVAL error of Q_XQUOTARM operation
+
+stime.2
+ Michael Kerrisk
+ Note that stime() is deprecated
+
+syscall.2
+ Petr Vorel [Cyril Hrubis]
+ Update feature test macro requirements
+
+sysctl.2
+ Michael Kerrisk
+ This system call was removed in Linux 5.5; adjust the page accordingly
+
+userfaultfd.2
+ Yang Xu [Michael Kerrisk]
+ Add EPERM error
+
+cmsg.3
+ Rich Felker
+ Clarify alignment issues and correct method of accessing CMSG_DATA()
+ From an email by Rich Felker:
+
+ It came to my attention while reviewing possible breakage with
+ move to 64-bit time_t that some applications are dereferencing
+ data in socket control messages (particularly SCM_TIMESTAMP*)
+ in-place as the message type, rather than memcpy'ing it to
+ appropriate storage. This necessarily does not work and is not
+ supportable if the message contains data with greater alignment
+ requirement than the header. In particular, on 32-bit archs,
+ cmsghdr has size 12 and alignment 4, but struct timeval and
+ timespec may have alignment requirement 8.
+ Michael Kerrisk [Rich Felker]
+ Modify CMSG_DATA() example to use memcpy()
+ See previous patch to this page for rationale
+
+exit.3
+ Benjamin Peterson [Mike Frysinger]
+ Use hex for the status mask
+
+ftime.3
+ Michael Kerrisk
+ Note that this function is deprecated
+
+getpt.3
+ Samuel Thibault
+ Remove mention of O_NOCTTY
+ The glibc implementation of getpt has actually never been setting
+
+malloc.3
+ Vegard Nossum
+ Clarify realloc() return value
+ Petr Vorel
+ Remove duplicate _GNU_SOURCE
+
+console_codes.4
+ Adam Borowski
+ Document \e[90m to 97, 100 to 107
+ Adam Borowski
+ \e[21m is now underline
+ Since 65d9982d7e523a1a8e7c9af012da0d166f72fc56 (4.17), it follows
+ xterm rather than common sense and consistency, being the only
+ command 1..9 where N+20 doesn't undo what N did. As libvte
+ 0.51.90 got changed the same way, this behaviour will probably
+ stay.
+ Adam Borowski
+ Update \e[38m and \e[48m
+ Supported since cec5b2a97a11ade56a701e83044d0a2a984c67b4 (3.16).
+
+cgroups.7
+ Michael Kerrisk
+ The v2 freezer controller was added in Linux 5.2
+ Michael Kerrisk
+ Split discussion of cgroups.events file and v2 release notification
+ In preparation for adding a description of the "frozen" key.
+ Michael Kerrisk
+ Describe the cgroup.events "frozen" key
+ Michael Kerrisk
+ Improve the discussion of the advantages of v2 release notification
+
+inotify.7
+ Nick Shipp
+ Merge late perror() into fprintf() in example code
+
+netlink.7
+ Antonin Décimo
+ Fix alignment issue in example
+
+packet.7
+ kevin sztern [Michael Kerrisk]
+ Add missing tpacket_auxdata field (tp_vlan_tpid)
+
+rtnetlink.7
+ Antonin Décimo
+ ifa_index is an unsigned int
+
+tcp.7
+ Michael Kerrisk
+ tcp_low_latency is ignored since Linux 4.14
+
+unix.7
+ Michael Kerrisk
+ The PID sent with SCM_CREDENTIALS must match an existing process
+
+vsock.7
+ Mikhail Golubev [Michael Kerrisk]
+ Add missing structure element
+ The structure 'struct sockaddr_vm' has additional element
+ 'unsigned char svm_zero[]' since version v3.9-rc1.
+
+ldconfig.8
+ DJ Delorie
+ Document file filter and symlink pattern expectations
+
+
+==================== Changes in man-pages-5.06 ====================
+
+Released: 2020-04-11, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alejandro Colomar <alx@kernel.org>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexander Miller <alex.miller@gmx.de>
+Andrea Arcangeli <aarcange@redhat.com>
+André Almeida <andrealmeid@collabora.com>
+Andrei Vagin <avagin@gmail.com>
+Andrew Micallef <andrew.micallef@live.com.au>
+Bart Van Assche <bvanassche@acm.org>
+Benjamin Peterson <benjamin@python.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Christian Brauner <christian@brauner.io>
+devi R.K <devi.feb27@gmail.com>
+Dmitry Safonov <dima@arista.com>
+Eric Biggers <ebiggers@google.com>
+Eric Dumazet <eric.dumazet@gmail.com>
+Eric Rannaud <e@nanocritical.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helge Deller <deller@gmx.de>
+Jakub Wilk <jwilk@jwilk.net>
+Jorgen Hansen <jhansen@vmware.com>
+Julia Suvorova <jusual@mail.ru>
+Keno Fischer <keno@juliacomputing.com>
+Krzysztof Małysa <varqox@gmail.com>
+Marc Lehmann <debian-reportbug@plan9.de>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Wilcox <willy@infradead.org>
+Michael Galassi <michael@galassi.us>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@kernel.org>
+Mike Christie <mchristi@redhat.com>
+Mike Frysinger <vapier@gentoo.org>
+Pablo M. Ronchi <pmronchi@yahoo.com.ar>
+Ricardo Biehl Pasquali <pasqualirb@gmail.com>
+Stefan Hajnoczi <stefanha@redhat.com>
+Stefano Garzarella <sgarzare@redhat.com>
+Thomas Gleixner <tglx@linutronix.de>
+Walter Harms <wharms@bfs.de>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+openat2.2
+ Aleksa Sarai [Michael Kerrisk]
+ Document new openat2(2) syscall
+
+pidfd_getfd.2
+ Michael Kerrisk [Christian Brauner]
+ New manual page documenting the pidfd_getfd() system call
+
+select.2
+ Michael Kerrisk
+ Rewrite DESCRIPTION
+ Improve structure and readability, at the same time incorporating
+ text and details that were formerly in select_tut(2). Also
+ move a few details in other parts of the page into DESCRIPTION.
+ Michael Kerrisk
+ Consolidate the discussion of pselect into a headed subsection
+ Michael Kerrisk
+ Consolidate historical glibc pselect() details under one subhead
+ Michael Kerrisk
+ Consolidate info on usleep() emulation in one place
+ Michael Kerrisk
+ Place the discussion of the self-pipe technique in a headed subsection
+ Michael Kerrisk
+ Note that FD_SET() and FD_CLR() do not return errors
+ Michael Kerrisk
+ Remove details of historical #include requirements
+ The POSIX situation has been the norm for a long time now,
+ and including ancient details overcomplicates the page.
+ Michael Kerrisk
+ Remove some ancient information about pre-POSIX types for 'timeout'
+
+select_tut.2
+ Michael Kerrisk
+ Eliminate duplication of info across select_tut.2 and select2
+ There was a lot of a duplication of info in SYNOPSIS, DESCRIPTION
+ RETURN VALUE, and SEE ALSO. Move all of the info to one place:
+ the select(2) page.
+
+sysvipc.7
+ Michael Kerrisk
+ Rewrite this page as just a summary of the System V IPC APIs
+ All of the other details in this page have by now been moved into
+ the relevant *ctl(2) pages.
+
+time_namespaces.7
+ Michael Kerrisk [Andrei Vagin, Dmitry Safonov, Thomas Gleixner]
+ New page documenting time namespaces
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+arch_prctl.2
+ Keno Fischer
+ Add ARCH_SET_CPUID subcommand
+
+clock_getres.2
+ Benjamin Peterson
+ Document CLOCK_TAI
+ Michael Kerrisk
+ Add CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM
+
+prctl.2
+ Mike Christie [Michal Hocko, Michael Kerrisk, Bart Van Assche]
+ Document PR_SETIO_FLUSHER/GET_IO_FLUSHER
+
+setns.2
+ Michael Kerrisk
+ Document CLONE_NEWTIME
+
+statx.2
+ Eric Biggers
+ Document STATX_ATTR_VERITY
+
+unshare.2
+ Michael Kerrisk
+ Document CLONE_NEWTIME
+
+socket.7
+ Ricardo Biehl Pasquali, Michael Kerrisk
+ Add description of SO_SELECT_ERR_QUEUE
+ Alejandro Colomar [Michael Kerrisk]
+ Document SO_TIMESTAMPNS
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Remove a few mentions of the ancient "Linux libc"
+
+Various pages
+ Michael Kerrisk
+ Global formatting fix: disfavor nonstandard .TP indents
+ In many cases, these don't improve readability, and (when stacked)
+ they sometimes have the side effect of sometimes forcing text
+ to be justified within a narrow column range.
+
+Various pages
+ Michael Kerrisk [Christian Brauner]
+ Fix clumsy wording around "nonnegative file descriptors"
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Helge Deller [Michael Kerrisk]
+ Consecutive calls for CLOCK_MONOTONIC may return same value
+ Consecutive calls to clock_gettime(CLOCK_MONOTONIC) are guaranteed
+ to return MONOTONIC values, which means that they either return
+ the *SAME* time value like the last call, or a later (higher) time
+ value.
+ Eric Rannaud
+ Dynamic POSIX clock devices can return other errors
+ Michael Kerrisk
+ Improve description of CPU-time clocks
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ CLOCK_REALTIME_COARSE is not settable
+ Michael Kerrisk
+ Note that CPU-time clocks are not settable.
+ Explicitly note that CLOCK_PROCESS_CPUTIME_ID and
+ CLOCK_PROCESS_CPUTIME_ID are not settable.
+ Michael Kerrisk
+ Clarify that CLOCK_TAI is nonsettable
+ Michael Kerrisk
+ Clarify that CLOCK_MONOTONIC is system-wide
+ Michael Kerrisk
+ ERRORS: add EINVAL for attempt to set a nonsettable clock
+ Michael Kerrisk
+ Move text in BUGS to NOTES
+ The fact that CLOCK_PROCESS_CPUTIME_ID and
+ CLOCK_PROCESS_CPUTIME_ID are not settable isn't a bug,
+ since POSIX does allow the possibility that these clocks
+ are not settable.
+ Michael Kerrisk
+ SEE ALSO: add time_namespaces(7)
+
+clock_nanosleep.2
+ Michael Kerrisk
+ clock_nanosleep() can also sleep against CLOCK_TAI
+ Michael Kerrisk
+ clock_nanosleep() also supports CLOCK_BOOTTIME
+ Presumably (and from a quick glance at the source code)
+ since Linux 2.6.39, when CLOCK_BOOTTIME was introduced.
+
+clock_nanosleep.2
+timer_create.2
+timerfd_create.2
+ Michael Kerrisk
+ Add various missing errors
+ Mostly verified by testing and reading the code.
+
+ There is unfortunately quite a bit of inconsistency across API~s:
+
+ clock_gettime clock_settime clock_nanosleep timer_create timerfd_create
+
+ CLOCK_BOOTTIME y n (EINVAL) y y y
+ CLOCK_BOOTTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
+ CLOCK_MONOTONIC y n (EINVAL) y y y
+ CLOCK_MONOTONIC_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_MONOTONIC_RAW y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_REALTIME y y y y y
+ CLOCK_REALTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
+ CLOCK_REALTIME_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_TAI y n (EINVAL) y y n (EINVAL)
+ CLOCK_PROCESS_CPUTIME_ID y n (EINVAL) y y n (EINVAL)
+ CLOCK_THREAD_CPUTIME_ID y n (EINVAL) n (EINVAL [2]) y n (EINVAL)
+ pthread_getcpuclockid() y n (EINVAL) y y n (EINVAL)
+
+ [1] The caller must have CAP_WAKE_ALARM, or the error EPERM results.
+
+ [2] This error is generated in the glibc wrapper.
+
+connect.2
+ Michael Kerrisk [Eric Dumazet]
+ Update the details on AF_UNSPEC
+ Update the details on AF_UNSPEC and circumstances in which
+ socket can be reconnected.
+
+dup.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_getfd(2)
+
+epoll_ctl.2
+ Michael Kerrisk
+ Various minor additions and clarifications
+
+epoll_wait.2
+ Michael Kerrisk
+ A few minor additions and rewrites
+
+execve.2
+ Michael Kerrisk
+ Add a subhead for the discussion of effect on process attributes
+ Michael Kerrisk
+ Explicitly note that argv[argc] == NULL in the new program
+ Michael Kerrisk
+ ERRORS: ENOENT does not occur for missing shared libraries
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=12241.
+
+_exit.2
+ Michael Kerrisk
+ Clarify that raw _exit() system call terminates only the calling thread
+
+inotify_add_watch.2
+ Michael Kerrisk
+ EXAMPLE: add reference to example in inotify(7)
+
+io_submit.2
+ Julia Suvorova
+ Add IOCB_CMD_POLL opcode
+
+lseek.2
+ Michael Kerrisk [Matthew Wilcox]
+ ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file
+
+madvise.2
+ Michael Kerrisk [Andrea Arcangeli]
+ Incorporate some (ancient) comments about MADV_HUGEPAGE
+ Back in 2011, a mail from Andrea Arcangeli noted some details
+ that I never got round to incorporating into the manual page.
+
+mmap.2
+ Michael Kerrisk
+ Add a subhead for the 'flags' argument
+ Michael Kerrisk
+ Move some text hidden at the end of DESCRIPTION to NOTES
+
+msgctl.2
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+ Michael Kerrisk
+ Copy information on 'msqid_ds' fields from sysvipc(7)
+
+open.2
+ Michael Kerrisk
+ Clarify that O_NOFOLLOW is relevant (only) for basename of 'pathname'
+ Aleksa Sarai
+ Add references to new openat2(2) page
+ Michael Kerrisk
+ Note EINVAL error for invalid character in basename of 'pathname'
+
+pidfd_open.2
+ Michael Kerrisk
+ Mention pidfd_getfd(2)
+
+poll.2
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ Mention epoll(7) in the introductory paragraph
+ Michael Kerrisk
+ Improve description of EFAULT error
+ Michael Kerrisk
+ Fix description of ENOMEM error
+
+select_tut.2
+ Michael Kerrisk
+ Adjust header file includes in example
+ Employ <sys/select.h>, rather than the historical header files.
+
+semctl.2
+ Michael Kerrisk
+ Copy information on 'semid_ds' fields from sysvipc(7)
+ Michael Kerrisk
+ Add a reference to the example in shmop(2)
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+
+semget.2
+ Michael Kerrisk
+ EXAMPLE: add an example program
+
+semop.2
+ Michael Kerrisk
+ Add a reference to the semop(2) example in shmop(2)
+
+shmctl.2
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+ Michael Kerrisk
+ Note that execute permission is not needed for shmat() SHM_EXEC
+ Michael Kerrisk
+ Copy information on 'shmid_ds' fields from sysvipc(7)
+ Michael Kerrisk
+ Some small improvements to the description of the 'shmid_ds' structure
+
+shmget.2
+ Michael Kerrisk
+ Add a reference to the example in shmop(2)
+
+shmop.2
+ Michael Kerrisk
+ EXAMPLE: add a pair of example programs
+ Add example programs demonstrating usage of shmget(2), shmat(2),
+ semget(2), semctl(2), and semop(2).
+
+sigaction.2
+signal.7
+ Zack Weinberg
+ Document kernel bugs in delivery of signals from CPU exceptions
+
+stat.2
+ Michael Kerrisk
+ Clarify definitions of timestamp fields
+ In particular, make it clear that atime and mtime relate to the
+ file *data*.
+
+syscalls.2
+ Michael Kerrisk
+ Add new Linux 5.6 system calls
+ Michael Kerrisk
+ Note that the 5.x series followed 4.20
+
+timer_create.2
+ Michael Kerrisk
+ timer_create(2) also supports CLOCK_TAI
+ Michael Kerrisk
+ Mention clock_getres(2) for further details on the various clocks
+
+timerfd_create.2
+ Michael Kerrisk [Thomas Gleixner]
+ Note a case where timerfd_settime() can fail with ECANCELED
+ Michael Kerrisk [devi R.K, Thomas Gleixner]
+ Negative changes to CLOCK_REALTIME may cause read() to return 0
+ Michael Kerrisk
+ Rework text for EINVAL for invalid clock ID
+ Michael Kerrisk
+ Refer reader to clock_getres(2) for further details on the clocks
+
+unshare.2
+ Michael Kerrisk
+ Add CLONE_NEWCGROUP and CLONE_NEWTIME to example program
+
+exit.3
+ Michael Kerrisk [Walter Harms]
+ Small improvement to the discussion of 'status' argument
+
+ftok.3
+ Michael Kerrisk
+ EXAMPLE: add a reference to the example in semget(2)
+
+getifaddrs.3
+ Michael Kerrisk [Michael Galassi]
+ EXAMPLE: remove unneeded loop variable
+
+nl_langinfo.3
+ Eugene Syromyatnikov
+ Document era-related locale elements
+ Eugene Syromyatnikov
+ Add information about AM/PM time format locale elements
+ Eugene Syromyatnikov
+ Mention the respective strftime(3) conversion specifications
+
+sem_init.3
+ Michael Kerrisk
+ Add references to example code in shm_open(3) and sem_wait(3)
+
+sem_post.3
+ Michael Kerrisk
+ Add a reference to code example code in shm_open(3)
+
+shm_open.3
+ Michael Kerrisk
+ EXAMPLE: add some example programs
+
+strcmp.3
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk [Andrew Micallef, Walter Harms]
+ Rework text describing return value to be clearer
+ Michael Kerrisk
+ Note that the comparison is done using unsigned char
+ Michael Kerrisk
+ SEE ALSO: add ascii(7)
+
+strftime.3
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Refer to the relevant nl_langinfo(3) items
+ Eugene Syromyatnikov
+ Expand %E and %O description
+ Eugene Syromyatnikov
+ Consistently document fall-back format string
+
+proc.5
+ Mike Frysinger
+ Clarify /proc/[pid]/cmdline mutability
+
+cgroups.7
+ Michael Kerrisk
+ Update list of cgroups v2 controllers
+ Update the list of cgroups v2 controllers (several controllers
+ were missing).
+ Michael Kerrisk
+ Add a subsection on cgroup v2 mount options and include 'nsdelegate'
+ Michael Kerrisk
+ Document the cgroups v2 'memory_localevents' mount option
+ Michael Kerrisk
+ SEE ALSO: add Documentation/admin-guide/cgroup-v2.rst
+
+namespaces.7
+ Michael Kerrisk
+ Add time namespaces information
+ Michael Kerrisk
+ Eliminate some superfluous info from display of /proc/PID/ns links
+
+path_resolution.7
+ Aleksa Sarai
+ Update to mention openat2(2) features
+
+socket.7
+ Michael Kerrisk
+ Note SCM message types for SO_TIMESTAMP and SO_TIMESTAMPNS
+
+tcp.7
+ Michael Kerrisk
+ SEE ALSO: mention Documentation/networking/ip-sysctl.txt
+
+time.7
+ Michael Kerrisk
+ Add small subsection on clocks and time namespaces
+
+unix.7
+ Heinrich Schuchardt
+ Correct example
+
+vsock.7
+ Stefano Garzarella [Jorgen Hansen, Stefan Hajnoczi]
+ Add VMADDR_CID_LOCAL description
+
+
+==================== Changes in man-pages-5.07 ====================
+
+Released: 2020-06-09, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Achilles Gaikwad <agaikwad@redhat.com>
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexander Monakov <amonakov@ispras.ru>
+Alexander Morozov <alexandermv@gmail.com>
+Alexopo Seid <alexopo.ceid@gmail.com>
+Amir Goldstein <amir73il@gmail.com>
+Andi Kleen <andi@firstfloor.org>
+Andrea Galbusera <gizero@gmail.com>
+Arnd Bergmann <arnd@arndb.de>
+Branden Robinson <g.branden.robinson@gmail.com>
+Brian Geffon <bgeffon@google.com>
+Bruno Haible <bruno@clisp.org>
+Chris Lamb <lamby@debian.org>
+Christian Brauner <christian.brauner@ubuntu.com>
+Dave Hansen <dave.hansen@linux.intel.com>
+Dave Martin <Dave.Martin@arm.com>
+David Adam <zanchey@ucc.gu.uwa.edu.au>
+Devin J. Pohly <djpohly@gmail.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Eric Hopper <hopper@omnifarious.org>
+Eric Sandeen <sandeen@redhat.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabien Siron <fabien.siron@epita.fr>
+Florian Weimer <fweimer@redhat.com>
+Gary Perkins <glperkins@lit.edu>
+Geoff Clare <gwc@opengroup.org>
+Goldwyn Rodrigues <rgoldwyn@suse.com>
+Heiko Carstens <heiko.carstens@de.ibm.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helge Kreutzmann <debian@helgefjell.de>
+Ian Rogers <irogers@google.com>
+Idan Katz <idanski1@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jan Moskyto Matejka <mq@ucw.cz>
+Jason Etherton <jason@ethertonltd.co.uk>
+Jeff Moyer <jmoyer@redhat.com>
+John Marshall <John.W.Marshall@glasgow.ac.uk>
+Jonny Grant <jg@jguk.org>
+Joseph C. Sible <josephcsible@gmail.com>
+Jürgen Sauermann <mail@juergen-sauermann.de>
+Kai Mäkisara <kai.makisara@kolumbus.fi>
+Keno Fischer <keno@juliacomputing.com>
+Kirill A. Shutemov <kirill@shutemov.name>
+Kirill Smelkov <kirr@nexedi.com>
+Kir Kolyshkin <kolyshkin@gmail.com>
+Léo Stefanesco <leo.lveb@gmail.com>
+Li Xinhai <lixinhai.lxh@gmail.com>
+Lokesh Gidra <lokeshgidra@google.com>
+Lukas Czerner <lczerner@redhat.com>
+Manfred Spraul <manfred@colorfullife.com>
+Marco Curreli <marcocurreli@tiscali.it>
+Marcus Gelderie <redmnic@gmail.com>
+Martin Doucha <mdoucha@suse.cz>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Nikola Forró <nforro@redhat.com>
+Olivier Gayot <olivier.gayot@sigexec.com>
+Ondrej Slamecka <ondrej@slamecka.cz>
+Paul Eggert <eggert@cs.ucla.edu>
+Peter Schiffer <pschiffe@redhat.com>
+Peter Wu <peter@lekensteyn.nl>
+Petr Vorel <pvorel@suse.cz>
+Piotr Caban <piotr@codeweavers.com>
+Ricardo Castano <ricardo.castano.salinas@gmail.com>
+Richard Cochran <richardcochran@gmail.com>
+Richard Palethorpe <rpalethorpe@suse.com>
+Russell King <rmk+kernel@armlinux.org.uk>
+Stefan Puiu <stefan.puiu@gmail.com>
+Thierry Lelegard <thierry.lelegard@canal-plus.fr>
+Thomas Piekarski <t.piekarski@deloquencia.de>
+Tobias Stoeckmann <tobias@stoeckmann.org>
+Urs Thuermann <urs@isnogud.escape.de>
+Vincent Lefèvre <vincent-srcware@vinc17.net>
+Vlad <cvazir@gmail.com>
+vrafaeli@msn.com
+walter harms <wharms@bfs.de>
+Will Deacon <will@kernel.org>
+Yang Shi <yang.shi@linux.alibaba.com>
+YunQiang Su <syq@debian.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+ioctl_fslabel.2
+ Eric Sandeen
+ New page documenting filesystem get/set label ioctl(2) operations
+
+
+Removed pages
+-------------
+
+ioctl_list.2
+ Michael Kerrisk [Heinrich Schuchardt, Eugene Syromyatnikov]
+ This page was first added more than 20 years ago. Since
+ that time it has seen hardly any update, and is by now
+ very much out of date, as reported by Heinrich Schuchardt
+ and confirmed by Eugene Syromyatnikov.
+
+ As Heinrich says:
+
+ Man-pages like netdevices.7 or ioctl_fat.2 are what is
+ needed to help a user who does not want to read through the
+ kernel code.
+
+ If ioctl_list.2 has not been reasonably maintained since
+ Linux 1.3.27 and hence is not a reliable source of
+ information, shouldn't it be dropped?
+
+ My answer is, yes (but let's move a little info into ioctl(2)).
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+adjtimex.2
+ Arnd Bergmann [Richard Cochran, Michael Kerrisk]
+ Document clock_adjtime(2)
+
+clock_getres.2
+ Richard Cochran [Michael Kerrisk]
+ Explain dynamic clocks
+
+clone.2
+ Christian Brauner, Michael Kerrisk
+ Document the clone3() CLONE_INTO_CGROUP flag
+
+mremap.2
+ Brian Geffon, Michael Kerrisk [Lokesh Gidra]
+ Document MREMAP_DONTUNMAP
+
+open.2
+ Joseph C. Sible [Michael Kerrisk]
+ Document fs.protected_fifos and fs.protected_regular
+
+prctl.2
+ Dave Martin
+ Add PR_SPEC_INDIRECT_BRANCH for SPECULATION_CTRL prctls
+ Dave Martin
+ Add PR_SPEC_DISABLE_NOEXEC for SPECULATION_CTRL prctls
+ Dave Martin
+ Add PR_PAC_RESET_KEYS (arm64)
+
+ptrace.2
+ Joseph C. Sible
+ Document PTRACE_SET_SYSCALL
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/fs/protected_regular
+ Michael Kerrisk
+ Document /proc/sys/fs/protected_fifos
+ Michael Kerrisk
+ Document /proc/sys/fs/aio-max-nr and /proc/sys/fs/aio-nr
+
+New and changed links
+---------------------
+
+clock_adjtime.2
+ Arnd Bergmann
+ New link to adjtimex(2)
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Retitle EXAMPLE section heading to EXAMPLES
+ EXAMPLES appears to be the wider majority usage across various
+ projects' manual pages, and is also what is used in the POSIX
+ manual pages.
+
+Various pages
+ Michael Kerrisk
+ Correct bogus POSIX.1 standards names
+ POSIX.1-2003 ==> POSIX.1-2001 TC1
+ POSIX.1-2004 ==> POSIX.1-2001 TC2
+ POSIX.1-2013 ==> POSIX.1-2008 TC1
+ POSIX.1-2016 ==> POSIX.1-2008 TC2
+
+Various pages
+ Michael Kerrisk
+ Add section number in page cross-reference.
+
+Various pages
+ Kir Kolyshkin
+ Add missing commas in SEE ALSO
+
+Various pages
+ Michael Kerrisk
+ Remove AVAILABILITY section heading
+ In the few pages where this heading (which is "nonstandard" within
+ man-pages) is used, it always immediately follows CONFORMING TO
+ and generally contains information related to standards. Remove
+ the section heading, thus incorporating AVAILABILITY into
+ CONFORMING TO.
+
+Various pages
+ Michael Kerrisk
+ Remove section number in page self-references
+
+Various pages
+ Michael Kerrisk
+ Put SEE ALSO entries in alphabetical order
+
+Various pages
+ Michael Kerrisk
+ Place SH sections in standard order
+ Fix various pages that deviated from the norm described in
+ man-pages(7).
+
+Various "aio" pages
+ Michael Kerrisk [Andi Kleen, Jeff Moyer]
+ Change uses of aio_context_t to io_context_t
+
+
+Changes to individual pages
+---------------------------
+
+bpf.2
+ Peter Wu
+ Update enum bpf_map_type and enum bpf_prog_type
+ Richard Palethorpe
+ Change note on unprivileged access
+ The kernel now allows calls to bpf() without CAP_SYS_ADMIN
+ under some circumstances.
+
+clone.2
+ Michael Kerrisk
+ Add kernel version numbers for clone_args fields
+ Michael Kerrisk
+ Combine separate NOTES sections
+
+close.2
+ Michael Kerrisk [Lukas Czerner, Peter Schiffer, Thierry Lelegard]
+ Note behavior when close() happens in a parallel thread
+ If one thread is blocked in an I/O system call on a file descriptor
+ that is closed in another thread, then the blocking system call
+ does not return immediately, but rather when the I/O operation
+ completes. This surprises some people, but is longstanding
+ behavior.
+
+connect.2
+ Stefan Puiu
+ Can return EACCES because of SELinux
+
+execve.2
+ Michael Kerrisk [Eric Hopper]
+ Changes to the "dumpable" flag may change ownership of /proc/PID files
+ Michael Kerrisk
+ Improve/correct discussion of changes to dumpable flag during execve(2)
+ The details were not quite accurate. Defer to prctl(2)
+ for the more complete picture.
+ Nikola Forró
+ Clarify signal sent to the process on late failure
+ Michael Kerrisk
+ SEE ALSO: add capabilities(7)
+
+fanotify_init.2
+ Amir Goldstein [Matthew Bobrowski]
+ Move out of place entry FAN_REPORT_FID
+ It was inserted in the middle of the FAN_CLASS_ multi flags bit
+ and broke the multi flag documentation.
+ Michael Kerrisk [Alexander Morozov, Amir Goldstein, Jan Kara]
+ Remove mention of FAN_Q_OVERFLOW as an input value in 'mask'
+ See https://bugzilla.kernel.org/show_bug.cgi?id=198569.
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Clarification about FAN_EVENT_ON_CHILD and new events
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Clarification about FAN_MARK_MOUNT and FAN_REPORT_FID
+
+getdents.2
+ Petr Vorel [Michael Kerrisk]
+ Mention glibc support for getdents64()
+ Support was added in glibc 2.30.
+ Chris Lamb
+ Correct linux_dirent definition in example code
+ It is "unsigned long" earlier up in the file
+
+gettid.2
+ Michael Kerrisk [Joseph C. Sible]
+ Document header file and feature test macro requirements for gettid()
+
+ioctl.2
+ Michael Kerrisk
+ SEE ALSO: add ioctl_fslabel(2)
+ Michael Kerrisk
+ Remove mentions of ioctl_list(2)
+ Michael Kerrisk
+ Move subsection on "ioctl structure" from ioctl_list(2) to ioctl(2)
+
+io_setup.2
+ Michael Kerrisk
+ Tweak description of /proc/sys/fs/aio-max-nr
+
+mbind.2
+ Li Xinhai [Michael Kerrisk]
+ Remove note about MPOL_MF_STRICT been ignored
+
+mmap.2
+ Michael Kerrisk [Heinrich Schuchardt]
+ Don't mark MAP_ANON as deprecated
+
+move_pages.2
+ Yang Shi [Michal Hocko]
+ Returning positive value is a new error case
+
+mremap.2
+ Michael Kerrisk
+ Remove mention of "Segmentation fault" in EFAULT text
+ "Segmentation fault" (SIGSEGV) is not exactly the same thing as
+ EFAULT.
+ Michael Kerrisk
+ Reorder some paragraphs in NOTES
+ Michael Kerrisk
+ Move a paragraph from DESCRIPTION to NOTES
+
+msgctl.2
+ Michael Kerrisk
+ Correct description of 'msg_ctime' field
+ Verified by inspecting kernel source.
+
+nfsservctl.2
+ Michael Kerrisk
+ SEE ALSO: add nfsd(7)
+
+open.2
+ Michael Kerrisk
+ Some '*at' APIs have functionality that isn't in conventional APIs
+ Note that another reason to use the *at() APIs is to access
+ 'flags' functionality that is not available in the corresponding
+ conventional APIs.
+ Michael Kerrisk
+ Add a few more APIs to list in "Rationale for openat()..."
+ There have been a few more dirfd APIs added in recent times.
+ Michael Kerrisk
+ Explain ways in which a 'directory file descriptor' can be obtained
+ Michael Kerrisk
+ Add openat2() to list of APIs that take a 'dirfd' argument
+
+openat2.2
+ Michael Kerrisk [Aleksa Sarai]
+ Various changes after feedback from Aleksa Sarai
+
+poll.2
+ Michael Kerrisk
+ Add license to example program
+
+prctl.2
+ Dave Martin
+ Sort prctls into alphabetical order
+ Dave Martin
+ Clarify that prctl can apply to threads
+ The current synopsis for prctl(2) misleadingly claims that prctl
+ operates on a process. Rather, some (in fact, most) prctls operate
+ Dave Martin [Dave Hansen]
+ Document removal of Intel MPX prctls
+ Dave Martin
+ Fix mis-description of thread ID values in procfs
+ Dave Martin
+ Work around bogus constant "maxsig" in PR_SET_PDEATHSIG
+ Michael Kerrisk
+ Add reference to proc(5) for /proc/self/task/[tid]/comm
+ Dave Martin [Michael Kerrisk]
+ Add health warning
+ Dave Martin
+ Clarify the unsupported hardware case of EINVAL
+
+rename.2
+ Michael Kerrisk
+ SEE ALSO: add rename(1)
+
+s390_runtime_instr.2
+ Heiko Carstens [Eugene Syromyatnikov, Michael Kerrisk]
+ Document signum argument behavior change
+ Document that the signum argument is ignored in newer kernels, but
+ that user space should pass a valid real-time signal number for
+ backwards compatibility.
+
+semctl.2
+ Michael Kerrisk [Manfred Spraul]
+ Correct description of sem_ctime field
+
+semget.2
+ Michael Kerrisk
+ Add license to example program
+
+shmctl.2
+ Michael Kerrisk
+ Correct 'shm_ctime' description
+
+shmop.2
+ Michael Kerrisk
+ Add license to example programs
+
+statfs.2
+ Michael Kerrisk [David Adam]
+ Add SMB2 constant to filesystem types list
+
+syscall.2
+ Dave Martin [Will Deacon]
+ arm64: Fix syscall number register size
+ Dave Martin [Russell King]
+ arm: Use real register names for arm/OABI
+
+sysfs.2
+ Michael Kerrisk
+ SEE ALSO: add proc(5) and sysfs(5)
+
+utimensat.2
+ Goldwyn Rodrigues
+ Immutable flag returns EPERM
+ Linux kernel commit 337684a1746f "fs: return EPERM on immutable
+ inode" changed the return value of the utimensat(2) from -EACCES
+ to -EPERM in case of an immutable flag.
+
+wait4.2
+ Michael Kerrisk
+ Update wait3() feature test macro requirements for changes in glibc 2.26
+
+cexp2.3
+ Michael Kerrisk
+ Still not present in glibc 2.31
+
+cmsg.3
+ Michael Kerrisk
+ CONFORMING TO: note which CMSG_* APIs are in current and upcoming POSIX
+
+dirfd.3
+ Michael Kerrisk
+ SEE ALSO: add openat(2)
+
+dlsym.3
+ Alexander Monakov
+ Extend discussion of NULL symbol values
+ Avoid implying that use of IFUNC is the only way to produce a
+ symbol with NULL value. Give more scenarios how a symbol may get
+ NULL value, but explain that in those scenarios dlsym() will fail
+ with Glibc's ld.so due to an implementation inconsistency.
+
+err.3
+ Michael Kerrisk
+ EXAMPLES: use EXIT_FAILURE rather than 1 as exit status
+
+expm1.3
+ Michael Kerrisk
+ The expm1() bogus underflow floating-point exception has been fixed
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6778
+ Michael Kerrisk
+ The bogus invalid floating-point exception bug has been fixed
+ https://www.sourceware.org/bugzilla/show_bug.cgi?id=6814.
+
+fdim.3
+ Michael Kerrisk
+ BUGS: these functions did not set errno on some architectures
+ https://www.sourceware.org/bugzilla/show_bug.cgi?id=6796
+
+ftw.3
+ Michael Kerrisk
+ glibc eventually fixed a regression in FTW_SLN behavior
+ For details, see:
+ https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+ http://austingroupbugs.net/view.php?id=1121
+ https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+
+getauxval.3
+ YunQiang Su
+ MIPS, AT_BASE_PLATFORM passes ISA level
+
+getdtablesize.3
+ Michael Kerrisk
+ Remove redundant statement that getdtablesize() is a library function
+
+malloc.3
+ Michael Kerrisk
+ Add 'reallocarray' in NAME
+ Michael Kerrisk
+ Add VERSIONS section noting when reallocarray() was added to glibc
+
+newlocale.3
+ Michael Kerrisk [Piotr Caban]
+ Fix a valgrind issue in example program
+ See https://bugzilla.kernel.org/show_bug.cgi?id=202977.
+
+nextafter.3
+ Michael Kerrisk
+ Since glibc 2.23, these functions do set errno
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799.
+
+posix_spawn.3
+ Olivier Gayot [Adhemerval Zanella]
+ Clarify by using name of steps rather than syscalls
+ Olivier Gayot [Adhemerval Zanella]
+ Document implementation using clone() since glibc 2.24
+ Olivier Gayot [Adhemerval Zanella]
+ Document POSIX_SPAWN_USEVFORK
+ Added a few lines about POSIX_SPAWN_USEVFORK so that it appears
+ clearly that since glibc 2.24, the flag has no effect.
+ Olivier Gayot [Adhemerval Zanella]
+ Document the POSIX_SPAWN_SETSID attribute
+
+pow.3
+ Michael Kerrisk
+ BUGS: pow() performance problem for some (rare) inputs has been fixed
+ See https://sourceware.org/bugzilla/show_bug.cgi?id=13932
+ Michael Kerrisk
+ Several bugs in glibc's pow() implementation were fixed in glibc 2.16
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=3866.
+ Michael Kerrisk
+ Add a subheading to mark off historical bugs that are now fixed
+
+printf.3
+ Tobias Stoeckmann
+ Prevent signed integer overflow in example
+
+ptsname.3
+ Bruno Haible
+ Fix description of failure behaviour of ptsname_r()
+
+random.3
+ John Marshall
+ Change "RAND_MAX" tp "2^31-1"
+
+scalb.3
+ Michael Kerrisk
+ These functions now correctly set errno for the EDOM and ERANGE cases
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803
+ and https://www.sourceware.org/bugzilla/show_bug.cgi?id=6804
+
+scalbln.3
+ Michael Kerrisk
+ These functions now correctly set errno for the ERANGE case
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803
+
+scanf.3
+ Michael Kerrisk [Jürgen Sauermann]
+ Clarify that 'x' specifier allows a 0x/0X prefix in input string
+
+sem_getvalue.3
+ Michael Kerrisk [Andrea Galbusera]
+ Note that glibc's sem_getvalue() doesn't return EINVAL errors
+ See https://bugzilla.kernel.org/show_bug.cgi?id=204273
+
+setlogmask.3
+ Michael Kerrisk
+ Note that LOG_UPTO() is included in the next POSIX release
+
+shm_open.3
+ Michael Kerrisk
+ Add license to example programs
+
+sincos.3
+ Michael Kerrisk
+ The glibc implementation does now give EDOM for a domain error
+ See https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467
+
+stdarg.3
+ Michael Kerrisk
+ SEE ALSO: add vprintf(3), vscanf(3), vsyslog(3)
+
+strcmp.3
+ Michael Kerrisk
+ Add license to example programs
+
+strftime.3
+ Urs Thuermann
+ ISO week number can be 52, add example
+
+y0.3
+ Michael Kerrisk
+ These functions now correctly diagnose a pole error
+ https://sourceware.org/bugzilla/show_bug.cgi?id=6807
+ Michael Kerrisk
+ errno is now correctly set to ERANGE on underflow
+ https://www.sourceware.org/bugzilla/show_bug.cgi?id=6808
+
+loop.4
+ Michael Kerrisk [Vlad]
+ 'lo_flags' is nowadays "r/w"
+ See https://bugzilla.kernel.org/show_bug.cgi?id=203417
+
+veth.4
+ Devin J. Pohly
+ Add a more direct example
+ iproute2 allows you to specify the netns for either side of a veth
+ interface at creation time. Add an example of this to veth(4) so
+ it doesn't sound like you have to move the interfaces in a
+ separate step.
+
+core.5
+ Michael Kerrisk [Jonny Grant]
+ Mention 'sysctl -w' as a way of changing core_pattern setting
+ Michael Kerrisk [Jonny Grant]
+ Note that not dumping core of an unreadable binary is a security measure
+ Michael Kerrisk [Jonny Grant]
+ Explain that core_pattern %e is process/thread 'comm' value
+ The 'comm' value is typically the same as the (possibly
+ truncated) executable name, but may be something different.
+
+filesystems.5
+ Michael Kerrisk
+ SEE ALSO: add sysfs(5) and xfs(5)
+
+locale.5
+ Michael Kerrisk [Helge Kreutzmann]
+ Improve description of 'first_weekday'
+
+proc.5
+ Michael Kerrisk
+ Note kernel version for /proc/PID/smaps VmFlags "wf" flag
+ Michael Kerrisk
+ Add "um" and "uw" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk
+ Add "mp" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk
+ Note kernel version that removed /proc/PID/smaps VmFlags "nl" flag
+ Ian Rogers
+ Add "wf" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk
+ Note kernel version for /proc/PID/smaps VmFlags "dd" flag
+ Michael Kerrisk
+ Add "sf" to VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk [Kirill A. Shutemov]
+ Remove "mp" under VmFlags in /proc/[pid]/smaps
+ Michael Kerrisk [Eric Hopper]
+ Alert the reader that UID/GID changes can reset the "dumpable" attribute
+ Keno Fischer
+ Fix an outdated note about map_files
+ The restriction to CAP_SYS_ADMIN was removed from map_files in 2015.
+ Michael Kerrisk [Helge Kreutzmann]
+ Better explanation of some /proc/ide fields
+ Michael Kerrisk
+ TASK_COMM_LEN limit includes the terminating '\0'
+ Clarify this detail in the discussion of /proc/[pid]/comm.
+ Michael Kerrisk
+ Add a detail to /proc/[pid]/comm
+ Note the connection to the "%e" specifier in
+ /proc/sys/kernel/core_pattern.
+
+securetty.5
+ Michael Kerrisk [Helge Kreutzmann]
+ Improve wording of .SH one-line description
+
+tzfile.5
+ Michael Kerrisk
+ Sync to 2020a tzdb release
+ From https://www.iana.org/time-zones, version 2020a.
+ Michael Kerrisk
+ Explain UT abbreviation
+
+ascii.7
+ Michael Kerrisk [Helge Kreutzmann]
+ SEE ALSO: fix sort order in entries
+
+bpf-helpers.7
+ Michael Kerrisk
+ Resync against kernel 5.7
+
+cgroups.7
+ Marcus Gelderie
+ Mention cgroup.sane_behavior file
+ The cgroup.sane_behavior file returns the hard-coded value "0" and
+ is kept for legacy purposes. Mention this in the man-page.
+ Michael Kerrisk
+ Note the existence of the clone3() CLONE_INTO_CGROUP flag
+
+credentials.7
+ Michael Kerrisk
+ Alert reader that UID/GID changes can affect process capabilities
+ Michael Kerrisk
+ Changes to process UIDs/GIDs can effect the "dumpable" attribute
+ Michael Kerrisk
+ Add a list of the APIs that change a process's credentials
+
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Fix fanotify_fid.c example
+ Michael Kerrisk
+ Wrap some long lines in example program
+
+fanotify.7
+fanotify_mark.2
+ Amir Goldstein [Matthew Bobrowski]
+ Clarify FAN_ONDIR in output mask
+ FAN_ONDIR was an input only flag before introducing
+ FAN_REPORT_FID. Since the introduction of FAN_REPORT_FID, it can
+ also be in output mask.
+
+hier.7
+ Thomas Piekarski [Gary Perkins]
+ Updating from FHS 2.3 to 3.0
+ See https://bugzilla.kernel.org/show_bug.cgi?id=206693
+
+inotify.7
+ Michael Kerrisk [Jason Etherton]
+ Add missing #include in example program
+
+ip.7
+ Michael Kerrisk [Martin Doucha]
+ Note a few more valid 'protocol' values
+ See https://bugzilla.kernel.org/show_bug.cgi?id=204981
+ Michael Kerrisk
+ SEE ALSO: add netdevice(7)
+
+man-pages.7
+ Michael Kerrisk
+ Rename EXAMPLE to EXAMPLES
+ Michael Kerrisk
+ Describe COPYRIGHT section
+ man-pages doesn't use COPYRIGHT sections in manual pages, but
+ various projects do. Make some recommendations about placement
+ of the section.
+ Michael Kerrisk
+ Add REPORTING BUGS section
+ man-pages doesn't have a REPORTING BUGS section in manual pages,
+ but many other projects do. Make some recommendations about
+ placement of that section.
+ Michael Kerrisk
+ Mention AUTHORS in summary section list
+ Although man-pages doesn't use AUTHORS sections, many projects do
+ use an AUTHORS section in their manual pages, so mention it in
+ man-pages to suggest some guidance on the position at which
+ to place that section.
+
+mount_namespaces.7
+ Michael Kerrisk
+ SEE ALSO: add mount(8), umount(8)
+
+namespaces.7
+ Michael Kerrisk
+ Document /proc/sys/user/max_time_namespaces
+
+netlink.7
+ Michael Kerrisk [Idan Katz]
+ Update path for NETLINK_CONNECTOR docs in kernel source tree
+ Michael Kerrisk [Fabien Siron]
+ Note that NETLINK_SOCK_DIAG is preferred over NETLINK_INET_DIAG
+
+pid_namespaces.7
+ Michael Kerrisk
+ Note that /proc/sys/kernel/ns_last_pid is virtualized per PID NS
+ Michael Kerrisk
+ Correct capability requirements for write to /proc/sys/kernel/ns_last_pid
+ CAP_SYS_ADMIN is needed in the user NS that owns the PID NS.
+
+rtnetlink.7
+ Jan Moskyto Matejka [Michael Kerrisk]
+ Add missing RTA_* attributes
+
+standards.7
+ Michael Kerrisk [Geoff Clare]
+ Add some more standards
+ Add: SUSv4 2016 edition, POSIX.1-2017, and SUSv4 2018 edition
+ Michael Kerrisk
+ Remove mention of bogus "POSIX" names
+ The terms POSIX.1-{2003,2004,2013,2016} were inventions of
+ my imagination, as confirmed by consulting Geoff Clare of
+ The Open Group. Remove these names.
+
+symlink.7
+ Michael Kerrisk
+ Describe differences in the treatment of symlinks in the dirname
+ Describe differences in the treatment of symlinks in the dirname
+ part of pathname.
+
+tcp.7
+ Michael Kerrisk [vrafaeli@msn.com]
+ Update info on tcp_syn_retries default value
+ See https://bugzilla.kernel.org/show_bug.cgi?id=202885.
+
+user_namespaces.7
+ Michael Kerrisk [Léo Stefanesco]
+ Clarify that "system time" means "calendar time"
+
+xattr.7
+ Achilles Gaikwad
+ Add attr(1) as relevant page to SEE ALSO
+
+ldconfig.8
+ Florian Weimer
+ Mention new default for --format in glibc 2.32
+
+zdump.8
+ Michael Kerrisk [Marco Curreli, Paul Eggert]
+ Update to latest upstream tz release
+ Look under "Latest version", which is 2020a.
+
+
+==================== Changes in man-pages-5.08 ====================
+
+Released: 2020-08-13, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alejandro Colomar <alx@kernel.org>
+Aleksa Sarai <cyphar@cyphar.com>
+Alyssa Ross <hi@alyssa.is>
+Andrew Price <anprice@redhat.com>
+Andy Lutomirski <luto@kernel.org>
+Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
+Benjamin Peterson <benjamin@python.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Bruno Haible <bruno@clisp.org>
+Carlos O'Donell <carlos@redhat.com>
+Catalin Marinas <catalin.marinas@arm.com>
+Dan Kenigsberg <danken@redhat.com>
+Dave Martin <Dave.Martin@arm.com>
+Diogo Miguel Ferreira Rodrigues <dmfrodrigues2000@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Geoff Clare <gwc@opengroup.org>
+Helge Kreutzmann <debian@helgefjell.de>
+Jakub Wilk <jwilk@jwilk.net>
+Jeff Layton <jlayton@kernel.org>
+John Scott <jscott@posteo.net>
+Kumar Kartikeya Dwivedi <memxor@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Oleksandr Kravchuk <open.source@oleksandr-kravchuk.com>
+Philip Adams <mail@philipadams.org>
+Rich Felker <dalias@libc.org>
+Saikiran Madugula <hummerbliss@gmail.com>
+Stephen Hemminger <stephen@networkplumber.org>
+Sven Hoexter <sven@stormbind.net>
+Thomas Bartelsmeier <t.bartelsmeier@gmail.com>
+Thomas Piekarski <t.piekarski@deloquencia.de>
+victorm007@yahoo.com
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+prctl.2
+ Dave Martin
+ Add SVE prctls (arm64)
+ Add documentation for the PR_SVE_SET_VL and PR_SVE_GET_VL
+ prctls added in Linux 4.15 for arm64.
+ Dave Martin [Catalin Marinas]
+ Add tagged address ABI control prctls (arm64)
+ Add documentation for the PR_SET_TAGGED_ADDR_CTRL and
+ PR_GET_TAGGED_ADDR_CTRL prctls added in Linux 5.4 for arm64.
+
+setns.2
+ Michael Kerrisk
+ Document the use of PID file descriptors with setns()
+ Starting with Linux 5.8, setns() can take a PID file descriptor as
+ an argument, and move the caller into or more of the namespaces of
+ the thread referred to by that descriptor.
+
+capabilities.7
+ Michael Kerrisk
+ Document CAP_BPF
+ Michael Kerrisk
+ Add CAP_PERFMON
+
+symlink.7
+ Aleksa Sarai
+ Document magic links more completely
+
+
+Global changes
+--------------
+
+A few pages
+ Michael Kerrisk
+ Use \` rather than `
+ \` produces better rendering in PDF.
+
+Various pages
+ Michael Kerrisk [Geoff Clare]
+ Use "\(ti" instead of "~"
+ A naked tilde ("~") renders poorly in PDF. Instead use "\(ti",
+ which renders better in a PDF, and produces the same glyph
+ when rendering on a terminal.
+
+Various pages
+ Michael Kerrisk [Geoff Clare]
+ Use "\(ha" rather than "^" in code
+ This renders better in PDF.
+
+Various pages
+ Mike Frysinger
+ Drop "coding: UTF-8" header
+ This header is used inconsistently -- man pages are UTF-8 encoded
+ but not setting this marker. It's only respected by the man-db
+ package, and seems a bit anachronistic at this point when UTF-8
+ is the standard default nowadays.
+
+Various pages
+ Mike Frysinger
+ Trim leading blank comment line
+ Very few pages do this, so trim them.
+
+Various pages
+ Mike Frysinger
+ Use standard .\" comment style
+ The \" comment produces blank lines. Use the .\" that the vast
+ majority of the codebase uses instead.
+
+Various pages
+ Mike Frysinger [G. Branden Robinson]
+ Various pages: Drop t comment header
+ Historically, a comment of the following form at the top of a
+ manual page was used to indicate too man(1) that the use of tbl(1)
+ was required in order to process tables:
+
+ '\" t
+
+ However, at least as far back as 2001 (according to Branden),
+ man-db's man(1) automatically uses tbl(1) as needed, rendering
+ this comment unnecessary. And indeed many existing pages in
+ man-pages that have tables don't have this comment at the top of
+ the file. So, drop the comment from those files where it is
+ present.
+
+
+Changes to individual pages
+---------------------------
+
+ioctl_tty.2
+ Michael Kerrisk
+ Fix a confusing wording error in description of TIOCSPTLCK
+
+iopl.2
+ Thomas Piekarski [victorm007@yahoo.com]
+ Updating description of permissions and disabling interrupts
+ Update description of permissions for port-mapped I/O set
+ per-thread and not per-process. Mention that iopl() can not
+ disable interrupts since Linux 5.5 anymore and is in general
+ deprecated and only provided for legacy X servers.
+
+ See https://bugzilla.kernel.org/show_bug.cgi?id=205317
+
+keyctl.2
+ Oleksandr Kravchuk
+ Declare auth_key to fix a compilation error in example code
+
+lseek.2
+ Andrew Price
+ List gfs2 support for SEEK_HOLE/SEEK_DATA
+
+mount.2
+ Michael Kerrisk
+ ERRORS: add EINVAL for bind mount of mount namespace inode
+
+open.2
+ Michael Kerrisk
+ Say a bit more about what happens when 'mode' is wrongly omitted
+
+pidfd_open.2
+ Michael Kerrisk
+ Add the setns(2) use case for PID file descriptors
+ Michael Kerrisk
+ Close the pidfd in EXAMPLE
+ Close the PID file descriptor in the example program, to hint to
+ the reader that like every other kind of file descriptor, a PID FD
+ should be closed.
+
+prctl.2
+ Michael Kerrisk
+ The parent death signal is cleared on some credential changes
+ See kernel/cred.c::commit_creds() in the Linux 5.6 source code.
+
+seccomp.2
+ Andy Lutomirski
+ Improve x32 and nr truncation notes
+
+send.2
+recv.2
+ Alyssa Ross
+ Add msg_iovlen POSIX note
+ msg_iovlen is incorrectly typed (according to POSIX) in addition
+ to msg_controllen, but unlike msg_controllen, this wasn't
+ mentioned for msg_iovlen.
+
+setns.2
+ Michael Kerrisk
+ EXAMPLE: use O_CLOEXEC when opening namespace file descriptor
+ Michael Kerrisk
+ It is possible to setns() to the caller's current PID namespace
+ The page currently incorrectly says that 'fd' must refer to
+ a descendant PID namespace. However, 'fd' can also refer to
+ the caller's current PID namespace. Verified by experiment,
+ and also comments in kernel/pid_namespace.c (Linux 5.8-rc1).
+
+sync.2
+ Jeff Layton
+ syncfs() now returns errors if writeback fails
+ A patch has been merged for v5.8 that changes how syncfs() reports
+ errors. Change the sync() manpage accordingly.
+
+syscalls.2
+ Michael Kerrisk
+ Add faccessat2(), added in Linux 5.8
+
+sysctl.2
+ Michael Kerrisk
+ glibc removed support for sysctl() starting in version 2.32
+
+atoi.3
+ Arkadiusz Drabczyk
+ Explain disadvantages of atoi()
+ Michael Kerrisk
+ Relocate BUGS section
+ Michael Kerrisk
+ Add NOTES section explaining 0 return value on error
+ And note that this is not specified by POSIX.
+
+fread.3
+ Arkadiusz Drabczyk
+ Add example
+ Arkadiusz Drabczyk
+ Explain that file position is moved after calling fread()/fwrite()
+ Corresponding manpage on FreeBSD already contains that
+ information.
+
+getpt.3
+posix_openpt.3
+pts.4
+ Michael Kerrisk
+ Use the term "pseudoterminal multiplexor device" for /dev/ptmx
+ Let's use some consistent terminology for this device.
+
+posix_memalign.3
+ Bruno Haible
+ Clarify how to free the result of posix_memalign
+
+pthread_rwlockattr_setkind_np.3
+ Carlos O'Donell [Kumar Kartikeya Dwivedi]
+ Clarify a PTHREAD_RWLOCK_PREFER_WRITER_NP detail
+
+queue.3
+ Alejandro Colomar
+ Remove wrong code from example
+ Alejandro Colomar
+ Comment out text for functions not in glibc (related: 6559169cac)
+
+pts.4
+ Michael Kerrisk
+ Remove NOTES on BSD pseudoterminals
+ This information is already covered better in pty(7). No need to
+ mention it again here.
+
+hosts.5
+ Thomas Bartelsmeier
+ Clarify capability for IPv6 outside of examples
+ Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279
+
+proc.5
+ Jakub Wilk
+ Use "pwd -P" for printing cwd
+ "/bin/pwd" happens to work with the GNU coreutils implementation,
+ which has -P as the default, contrary to POSIX requirements.
+
+ Use "pwd -P" instead, which is shorter, easier to type, and should
+ work everywhere.
+ Arkadiusz Drabczyk
+ Inform that comm in /proc/pid/{stat,status} might also be truncated
+ pgrep for example searches for a process name in /proc/pid/status
+
+resolv.conf.5
+ Michael Kerrisk [Helge Kreutzmann]
+ Clarify that ip6-bytestring was removed in 2.25
+
+capabilities.7
+ Dan Kenigsberg
+ Clarify that CAP_SYS_NICE relates to *lowering* the nice value
+ Saikiran Madugula
+ CAP_SYS_RESOURCE: add two more items for POSIX message queues
+ CAP_SYS_RESOURCE also allows overriding /proc/sys/fs/mqueue/msg_max
+ and /proc/sys/fs/mqueue/msgsize_max.
+ Michael Kerrisk [Dan Kenigsberg]
+ Clarify wording around increasing process nice value
+ Michael Kerrisk
+ SEE ALSO: add getpcaps(8)
+
+cgroups.7
+cpuset.7
+ Sven Hoexter
+ Update kernel cgroup documentation references
+ cgroups-v1/v2 documentation got moved to the "admin-guide" subfolder
+ and converted from .txt files to .rst
+
+ip.7
+ Michael Kerrisk [Stephen Hemminger]
+ Remove mention of ipfw(4) which was in long obsolete ipchains project
+
+man-pages.7
+ Michael Kerrisk
+ Add some notes on generating optimal glyphs
+ Getting nice renderings of ^ ` and ~ requires special
+ steps in the page source.
+
+pty.7
+ Michael Kerrisk
+ Explicitly mention CONFIG_LEGACY_PTYS
+ Explicitly mention CONFIG_LEGACY_PTYS, and note that it is disabled
+ by default since Linux 2.6.30.
+ Michael Kerrisk
+ Relocate a paragraph to NOTES
+
+standards.7
+ Michael Kerrisk
+ Add an entry for POSIX.1-1988
+ Michael Kerrisk [Geoff Clare]
+ Correct various details in the explanation of XPG/POSIX/SUS
+
+ld.so.8
+ Florian Weimer [Michael Kerrisk]
+ List more places in which dynamic string tokens are expanded
+ This happens for more than just DT_RPATH/DT_RUNPATH.
+ Arkadiusz Drabczyk
+ Explain that empty entry in LD_LIBRARY_PATH means cwd
+
+zic.8
+ Michael Kerrisk
+ Sync to 2020a tzdb release
+ From https://www.iana.org/time-zones, version 2020a.
+
+
+==================== Changes in man-pages-5.09 ====================
+
+Released: 2020-11-01, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alejandro Colomar <alx@kernel.org>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexey Budankov <alexey.budankov@linux.intel.com>
+Amir Goldstein <amir73il@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Dave Martin <Dave.Martin@arm.com>
+David Howells <dhowells@redhat.com>
+David Laight <David.Laight@ACULAB.COM>
+Dmitry V. Levin <ldv@altlinux.org>
+Érico Rolim <erico.erc@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Hauke Fath <hf@spg.tu-darmstadt.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+henrik@optoscale.no
+Ira Weiny <ira.weiny@intel.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Jing Peng <pj.hades@gmail.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Konstantin Bukin <kbukin@gmail.com>
+Mark Mossberg <mark.mossberg@gmail.com>
+Marko Hrastovec <marko.hrastovec@gmail.com>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Moore <paul@paul-moore.com>
+Rich Felker <dalias@libc.org>
+Samanta Navarro <ferivoz@riseup.net>
+Serge Hallyn <serge@hallyn.com>
+Simon McVittie <smcv@collabora.com>
+Sridhar Samudrala <sridhar.samudrala@intel.com>
+Stephen Smalley <stephen.smalley.work@gmail.com>
+Steve Hilder <stevehilder@yahoo.co.uk>
+Thomas Piekarski <t.piekarski@deloquencia.de>
+Tony May <tony.may@mediakind.com>
+Tycho Andersen <tycho@tycho.ws>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+circleq.3
+ Alejandro Colomar
+ New page with 'circleq' content extracted from queue(3)
+
+list.3
+ Alejandro Colomar
+ New page with 'list' content extracted from queue(3)
+
+
+pthread_attr_setsigmask_np.3
+ Michael Kerrisk
+ New page for pthread_attr_setsigmask_np() + pthread_attr_getsigmask_np()
+ Add a page documenting the pthread_attr_setsigmask_np(3) and
+ pthread_attr_getsigmask_np(3) functions added in glibc 2.32.
+
+slist.3
+ Alejandro Colomar
+ New page with 'slist' content extracted from queue(3)
+
+stailq.3
+ Alejandro Colomar
+ New page with 'stailq' content extracted from queue(3)
+
+tailq.3
+ Alejandro Colomar
+ New page with 'tailq' content extracted from queue(3)
+
+system_data_types.7
+ Alejandro Colomar, Michael Kerrisk
+ A new page documenting a wide range of system data types.
+
+kernel_lockdown.7
+ David Howells, Heinrich Schuchardt [Michael Kerrisk]
+ New page documenting the Kernel Lockdown feature
+
+queue.7
+ Alejandro Colomar
+ Create summary page for 'queue' APIs
+ The former queue(3) page was rather unwieldy, as it attempted to
+ describe too many APIs. After splitting that content out into a
+ number of smaller pages ( circleq.3, list.3, slist.3, stailq.3,
+ and tailq.3) move the much-reduced queue(3) page, which is now
+ essentially a summary of those APIs, from Section 3 to Section 7.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify_init.2
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Document FAN_REPORT_DIR_FID
+
+fanotify_init.2
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Document FAN_REPORT_NAME
+
+statx.2
+ Ira Weiny
+ Add STATX_ATTR_DAX
+
+strerror.3
+ Michael Kerrisk
+ Document strerrorname_np() and strerrordesc_np()
+ strerrorname_np() and strerrordesc_np() were added in glibc 2.32.
+
+strsignal.3
+ Michael Kerrisk
+ Document sigabbrev_np() and sigdescr_np().
+ sigabbrev_np() and sigdescr_np() were added in glibc 2.32.
+
+loop.4
+ Yang Xu
+ Document LOOP_CONFIGURE ioctl
+ Yang Xu
+ Document LO_FLAGS_DIRECT_IO flag
+
+capabilities.7
+ Michael Kerrisk
+ Document the CAP_CHECKPOINT_RESTORE capability added in Linux 5.9
+
+ip.7
+ Stephen Smalley [Paul Moore]
+ Document IP_PASSSEC for UDP sockets
+
+ip.7
+socket.7
+ Stephen Smalley
+ Document SO_PEERSEC for AF_INET sockets
+ Sridhar Samudrala
+ Document SO_INCOMING_NAPI_ID
+
+socket.7
+unix.7
+ Stephen Smalley [Serge Hallyn, Simon McVittie]
+ Add initial description for SO_PEERSEC
+
+
+New and changed links
+---------------------
+
+aiocb.3
+clock_t.3
+clockid_t.3
+dev_t.3
+div_t.3
+double_t.3
+fenv_t.3
+fexcept_t.3
+FILE.3
+float_t.3
+gid_t.3
+id_t.3
+imaxdiv_t.3
+int8_t.3
+int16_t.3
+int32_t.3
+int64_t.3
+intN_t.3
+intmax_t.3
+intptr_t.3
+lconv.3
+ldiv_t.3
+lldiv_t.3
+off_t.3
+pid_t.3
+ptrdiff_t.3
+regex_t.3
+regmatch_t.3
+regoff_t.3
+siginfo_t.3
+sigset_t.3
+sigval.3
+size_t.3
+ssize_t.3
+suseconds_t.3
+time_t.3
+timer_t.3
+timespec.3
+timeval.3
+uid_t.3
+uint8_t.3
+uint16_t.3
+uint32_t.3
+uint64_t.3
+uintN_t.3
+uintptr_t.3
+va_list.3
+void.3
+ Alejandro Colomar, Michael Kerrisk
+ New links to system_data_types(7)
+
+CIRCLEQ_ENTRY.3
+CIRCLEQ_HEAD.3
+CIRCLEQ_INIT.3
+CIRCLEQ_INSERT_AFTER.3
+CIRCLEQ_INSERT_BEFORE.3
+CIRCLEQ_INSERT_HEAD.3
+CIRCLEQ_INSERT_TAIL.3
+CIRCLEQ_REMOVE.3
+ Alejandro Colomar
+ Link to the new circleq(3) page instead of queue(3)
+
+LIST_EMPTY.3
+LIST_ENTRY.3
+LIST_FIRST.3
+LIST_FOREACH.3
+LIST_HEAD.3
+LIST_HEAD_INITIALIZER.3
+LIST_INIT.3
+LIST_INSERT_AFTER.3
+LIST_INSERT_BEFORE.3
+LIST_INSERT_HEAD.3
+LIST_NEXT.3
+LIST_REMOVE.3
+ Alejandro Colomar
+ Link to the new list.3 page instead of queue.3
+
+SLIST_EMPTY.3
+SLIST_ENTRY.3
+SLIST_FIRST.3
+SLIST_FOREACH.3
+SLIST_HEAD.3
+SLIST_HEAD_INITIALIZER.3
+SLIST_INIT.3
+SLIST_INSERT_AFTER.3
+SLIST_INSERT_HEAD.3
+SLIST_NEXT.3
+SLIST_REMOVE.3
+SLIST_REMOVE_HEAD.3
+ Alejandro Colomar
+ Link to the new slist(3) page instead of queue(3)
+
+STAILQ_CONCAT.3
+STAILQ_EMPTY.3
+STAILQ_ENTRY.3
+STAILQ_FIRST.3
+STAILQ_FOREACH.3
+STAILQ_HEAD.3
+STAILQ_HEAD_INITIALIZER.3
+STAILQ_INIT.3
+STAILQ_INSERT_AFTER.3
+STAILQ_INSERT_HEAD.3
+STAILQ_INSERT_TAIL.3
+STAILQ_NEXT.3
+STAILQ_REMOVE.3
+STAILQ_REMOVE_HEAD.3
+ Alejandro Colomar
+ Link to the new stailq(3) page instead of queue(3)
+
+TAILQ_CONCAT.3
+TAILQ_EMPTY.3
+TAILQ_ENTRY.3
+TAILQ_FIRST.3
+TAILQ_FOREACH.3
+TAILQ_FOREACH_REVERSE.3
+TAILQ_HEAD.3
+TAILQ_HEAD_INITIALIZER.3
+TAILQ_INIT.3
+TAILQ_INSERT_AFTER.3
+TAILQ_INSERT_BEFORE.3
+TAILQ_INSERT_HEAD.3
+TAILQ_INSERT_TAIL.3
+TAILQ_LAST.3
+TAILQ_NEXT.3
+TAILQ_PREV.3
+TAILQ_REMOVE.3
+TAILQ_SWAP.3
+ Alejandro Colomar
+ Link to the new tailq(3) page instead of queue(3)
+
+getcwd.2
+mq_notify.2
+mq_open.2
+mq_timedreceive.2
+mq_timedsend.2
+mq_unlink.2
+ Michael Kerrisk
+ Reinstate links to section 3 pages that document system calls
+ Some of the links removed in commit 247c654385128fd0748 should
+ have been kept, because in some cases there are real system
+ calls whose wrapper functions are documented in Section 3.
+
+queue.3
+ Alejandro Colomar
+ Link to queue(7)
+
+sigabbrev_np.3
+ Michael Kerrisk
+ New link to strsignal.3
+
+sigdescr_np.3
+ Michael Kerrisk
+ New link to strsignal.3
+
+strerrordesc_np.3
+ Michael Kerrisk
+ New link to strerror(3)
+
+strerrorname_np.3
+ Michael Kerrisk
+ New link to strerror(3)
+
+sys_siglist.3
+ Michael Kerrisk
+ New link to strsignal(3)
+
+
+Global changes
+--------------
+
+Various pages
+ Alejandro Colomar
+ Use ``sizeof`` consistently through all the examples in the
+ following way:
+
+ - Use the name of the variable instead of its type as argument for
+ ``sizeof``.
+
+Various pages
+ Alejandro Colomar
+ Use sizeof() to get buffer size (instead of hardcoding macro name)
+
+Various pages
+ Michael Kerrisk
+ Use \(aq instead of ' inside monospace fonts
+ Use \(aq to get an unslanted single quote inside monospace code
+ blocks. Using a simple ' results in a slanted quote inside PDFs.
+
+Various pages
+ Michael Kerrisk, Alejandro Colomar
+ Use C99 style to declare loop counter variables
+ Rather than:
+
+ sometype x;
+
+ for (x = ....; ...)
+
+ use
+
+ for (sometype x = ...; ...)
+
+ This brings the declaration and use closer together (thus aiding
+ readability) and also clearly indicates the scope of the loop
+ counter variable.
+
+Various pages
+ Alejandro Colomar
+ Switch printf() casts to use [u]intmax_t + %ju / %jd
+ Let's move to the 21st century. Instead of casting system data
+ types to long/long long/etc. in printf() calls, instead cast to
+ intmax_t or uintmax_t, the largest available signed/unsigned
+ integer types.
+
+Various pages
+ Alejandro Colomar
+ Omit 'int' keyword for 'short', 'long' and 'long long' types
+
+Various pages
+ Alejandro Colomar
+ Remove unneeded casts
+
+Various pages
+ Alejandro Colomar
+ In printf(): s/0x%/%#/ except when followed by X instead of x
+ Use printf()'s '#' flag character to prepend the string "0x".
+
+ However, when the number is printed in uppercase, and the prefix
+ is in lowercase, the string "0x" needs to be manually written.
+
+Various pages
+ Michael Kerrisk
+ Use C99-style declarations for readability
+ Rather than writing things such as:
+
+ struct sometype *x;
+ ...
+ x = malloc(sizeof(*x));
+
+ let's use C99 style so that the type info is in the same line as
+ the allocation:
+
+ struct sometype *x = malloc(sizeof(*x));
+
+Various pages
+ Alejandro Colomar
+ Cast to 'unsigned long' rather than 'long' when printing with "%lx"
+
+stdarg.3
+ Alejandro Colomar
+ Declare variables with different types in different lines
+ In particular, don's mix a variable and a pointer declaration
+ on the same line: TYPE x, *p;
+
+
+Changes to individual pages
+---------------------------
+
+memusage.1
+ Michael Kerrisk
+ EXAMPLES: remove doubled calculations
+ The same calculations are repeated in malloc() and printf() calls.
+ For better readability, do the calculations once.
+ Michael Kerrisk
+ Use %zu rather than %zd when printing 'size_t' values
+
+clock_getres.2
+ Alejandro Colomar
+ EXAMPLES: use 'const' when appropriate
+ Alejandro Colomar [Jakub Wilk]
+ Cast 'time_t' to 'int' for printf() and fix the length modifiers
+ Michael Kerrisk [Tony May]
+ Fix type and variable name in dynamic clock code example
+
+clone.2
+ Michael Kerrisk
+ CAP_CHECKPOINT_RESTORE can now be used to employ 'set_tid'
+
+epoll_ctl.2
+ Michael Kerrisk
+ epoll instances can be nested to a maximum depth of 5
+ This limit appears to be an off-by-one count against
+ EP_MAX_NESTS (4).
+ Michael Kerrisk
+ Move some version info from CONFORMING TO to VERSIONS
+
+eventfd.2
+ Alejandro Colomar
+ Use 'PRIxN' macros when printing C99 fixed-width integer types
+
+futex.2
+ Alejandro Colomar
+ Use appropriate types
+
+getdents.2
+ Alejandro Colomar
+ SYNOPSIS: add missing header and feature test macro
+
+intro.2
+intro.3
+credentials.7
+feature_test_macros.7
+standards.7
+ Michael Kerrisk
+ SEE ALSO: add system_data_types(7)
+
+ioctl_ns.2
+stat.2
+ Alejandro Colomar [Konstantin Bukin]
+ Fix signedness of printf specifiers
+
+membarrier.2
+ Alejandro Colomar
+ Note that glibc does not provide a wrapper
+
+mprotect.2
+ Alejandro Colomar
+ Use "%p" rather than casting to 'long' when printing pointer values
+
+mq_getsetattr.2
+ Alejandro Colomar
+ Use 'const' when appropriate
+
+msgop.2
+ Yang Xu
+ Add restriction on ENOSYS error
+
+open.2
+ Michael Kerrisk [henrik@optoscale.no]
+ ERRORS: add EBUSY
+
+openat.2
+ Alejandro Colomar
+ SYNOPSIS: return long
+ The Linux kernel uses long as the return type for this syscall.
+ As glibc provides no wrapper, use the same type the kernel uses.
+
+open_by_handle_at.2
+ Alejandro Colomar
+ Use "%u" rather than "%d" when printing 'unsigned int' values
+
+perf_event_open.2
+ Alexey Budankov
+ Update the man page with CAP_PERFMON related information
+
+recv.2
+send.2
+ Michael Kerrisk
+ Add cross references to pages with further info about ancillary data
+
+sched_getattr.2
+ Aleksa Sarai
+ Update to include changed size semantics
+
+seccomp.2
+ Michael Kerrisk [Jann Horn]
+ Warn reader that SECCOMP_RET_TRACE can be overridden
+ Highlight to the reader that if another filter returns a
+ higher-precedence action value, then the ptracer will not
+ be notified.
+ Michael Kerrisk [Rich Felker]
+ Warn against the use of SECCOMP_RET_KILL_THREAD
+ Killing a thread with SECCOMP_RET_KILL_THREAD is very likely
+ to leave the rest of the process in a broken state.
+ Michael Kerrisk [Rich Felker]
+ EXAMPLES: use SECCOMP_RET_KILL_PROCESS rather than SECCOMP_RET_KILL
+ Alejandro Colomar
+ Use ARRAY_SIZE() macro instead of raw sizeof division
+
+setns.2
+ Michael Kerrisk
+ Correct the version for time namespace support
+
+sigaction.2
+ Michael Kerrisk [Alejandro Colomar]
+ Use correct POSIX type for siginfo_t.si_value
+
+syscalls.2
+ Michael Kerrisk
+ Move system calls from discontinued ports out of main syscall list
+ Various ports that had their own indigenous system calls have
+ been discontinued. Remove those system calls (none of which had
+ manual pages!) to a separate part of the page, to avoid
+ cluttering the main list of system calls.
+ Michael Kerrisk
+ Add close_range (Linux 5.9)
+
+timerfd_create.2
+ Alejandro Colomar
+ Use 'PRIxN' macros when printing C99 fixed-width integer types
+
+userfaultfd.2
+ Michael Kerrisk
+ Use a better type (uint64_t) for 'len' in EXAMPLES
+ Alejandro Colomar
+ Use 'PRIx64' rather than "%llx" when printing 64-bit fixed-width types
+
+argz_add.3
+envz_add.3
+ Michael Kerrisk [Jonny Grant]
+ Point out that 'error_t' is an integer type
+
+bsearch.3
+ Alejandro Colomar
+ Fix intermediate type and remove unneeded casts
+
+bswap.3
+ Jakub Wilk
+ Use strtoull() for parsing 64-bit numbers
+
+dlopen.3
+ Michael Kerrisk
+ Clarify DT_RUNPATH/DT_RPATH details
+ It is the DT_RUNPATH/DT_RPATH of the calling object (not the
+ executable) that is relevant for the library search. Verified
+ by experiment.
+
+errno.3
+ Michael Kerrisk [Alejandro Colomar]
+ Note that the pthreads APIs do not set errno
+
+fopencookie.3
+ Alejandro Colomar
+ printf()'s .* expects an int; cast accordingly
+ Alejandro Colomar
+ Fix bugs in example
+
+fread.3
+ Alejandro Colomar
+ Move ARRAY_SIZE logic into macro
+
+freeaddrinfo.3
+ Marko Hrastovec
+ Fix memory leaks in freeaddrinfo() examples
+
+getline.3
+ Alejandro Colomar
+ Use %zd rather than %zu when printing 'ssize_t' values
+
+lseek64.3
+ Michael Kerrisk
+ Since glibc 2.28. the 'llseek' symbol is no longer available
+
+mallinfo.3
+ Michael Kerrisk
+ The 'usmblks' field is nowadays always 0
+
+offsetof.3
+ Alejandro Colomar
+ Use "%zu" rather than "%zd" when printing 'size_t' values
+
+perror.3
+ Michael Kerrisk
+ sys_errlist and sys_nerr are no longer exposed by <stdio.h>
+ The change came with the release of glibc 2.32.
+
+posix_fallocate.3
+ Érico Rolim
+ Add EOPNOTSUPP error code.
+
+psignal.3
+strsignal.3
+ Michael Kerrisk
+ Consolidate information on 'sys_siglist' in one page (strsignal(3))
+
+pthread_attr_init.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_attr_init(3)
+
+pthread_attr_init.3
+pthread_create.3
+pthread_getattr_np.3
+ Michael Kerrisk
+ Use correct type (size_t) for some variables
+
+pthread_getattr_np.3
+ Alejandro Colomar
+ Use "%zu" and "%zx" when printing 'size_t' values
+
+pthread_sigmask.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_attr_setsigmask_np(3)
+
+qsort.3
+ Alejandro Colomar
+ Fix casts
+ Alejandro Colomar
+ SYNOPSIS: move code from queue.3 to stailq.3
+
+regex.3
+ Alejandro Colomar
+ Add example program
+ Alejandro Colomar
+ Remove unnecessary include
+
+strsignal.3
+ Michael Kerrisk [Hauke Fath]
+ Note that starting with v2.32, glibc no longer exports 'sys_siglist'
+ Michael Kerrisk
+ Further addition on version range for sys_siglist
+ Michael Kerrisk
+ Note that 'sys_siglist' is nonstandard
+
+strtod.3
+ Jonathan Wakely
+ Fix return value for underflow
+
+strtol.3
+ Alejandro Colomar
+ EXAMPLES: simplify errno checking
+ Alejandro Colomar
+ EXAMPLES: as the default base, use special value 0
+ Alejandro Colomar
+ EXAMPLES: delimit output string using ""
+
+tsearch.3
+ Alejandro Colomar
+ Simplify type usage and remove unneeded casts
+ Alejandro Colomar
+ Use size_t for malloc() argument
+
+loop.4
+ Yang Xu
+ Add some details about lo_flags
+
+core.5
+ Alejandro Colomar
+ Use adequate type
+
+locale.5
+ Florian Weimer
+ Decimal points, thousands separators must be one character
+
+proc.5
+ Michael Kerrisk
+ Update capability requirements for accessing /proc/[pid]/map_files
+ Jann Horn [Mark Mossberg]
+ Document inaccurate RSS due to SPLIT_RSS_COUNTING
+ Michael Kerrisk
+ Note "open file description" as (better) synonym for "file handle"
+
+resolv.5
+ Florian Weimer
+ Document the trust-ad option
+
+aio.7
+ Alejandro Colomar
+ Use perror() directly
+
+bpf-helpers.7
+ Michael Kerrisk [Jakub Wilk]
+ Resync with current kernel source
+
+capabilities.7
+ Michael Kerrisk
+ Under CAP_SYS_ADMIN, group "sub-capabilities" together
+ CAP_BPF, CAP_PERFMON, and CAP_CHECKPOINT_RESTORE have all been
+ added to split out the power of CAP_SYS_ADMIN into weaker pieces.
+ Group all of these capabilities together in the list under
+ CAP_SYS_ADMIN, to make it clear that there is a pattern to these
+ capabilities.
+ Michael Kerrisk
+ CAP_SYS_ADMIN implies CAP_CHECKPOINT_RESTORE
+ But the latter, weaker capability is preferred.
+ Michael Kerrisk
+ Add kernel doc reference for CAP_PERFMON
+
+fanotify.7
+ Alejandro Colomar
+ Pass array to read(2) directly instead of a pointer to it
+
+fanotify.7
+fanotify_mark.2
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Generalize documentation of FAN_REPORT_FID
+
+feature_test_macros.7
+ Jakub Wilk
+ Update list of macros that inhibit default definitions
+
+man.7
+ Michael Kerrisk [G. Branden Robinson]
+ Clarify that alternating typeface macros print arguments without spaces
+
+man-pages.7
+ Michael Kerrisk
+ Add some more requests re code examples
+ Michael Kerrisk
+ Soften the statement that ideal programs should be short
+
+namespaces.7
+ Michael Kerrisk
+ A 'time_for_children' symlink can also pin a namespace
+
+pid_namespaces.7
+ Michael Kerrisk
+ Update capability requirements for /proc/sys/kernel/ns_last_pid
+
+pthreads.7
+ Michael Kerrisk
+ Explicitly note that pthreads APIs return an errno-style value on error
+
+rtld-audit.7
+ Florian Weimer [Carlos O'Donell]
+ Clarify la_version handshake
+ Returning its argument without further checks is almost always
+ wrong for la_version.
+ Alejandro Colomar
+ Use "%u" rather than "%d" when printing 'unsigned int' values
+
+sigevent.7
+ Michael Kerrisk
+ Note that 'sigev_notify_thread_id' is Linux-specific
+
+socket.7
+ Michael Kerrisk
+ SEE ALSO: add ipv6(7)
+
+
+==================== Changes in man-pages-5.10 ====================
+
+Released: 2020-12-21, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Amir Goldstein <amir73il@gmail.com>
+Arusekk <arek_koz@o2.pl>
+Baruch Siach <baruch@tkos.co.il>
+Bill Allombert <ballombe@debian.org>
+Colin Ian King <colin.king@canonical.com>
+Dave Martin <Dave.Martin@arm.com>
+Davide Giorgio <davide@giorgiodavide.it>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jan Kara <jack@suse.cz>
+Jing Peng <pj.hades@gmail.com>
+John A. Leuenhagen <john@zlima12.com>
+Mathias Rav <m@git.strova.dk>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Crowe <mac@mcrowe.com>
+Namhyung Kim <namhyung@gmail.com>
+Peter Oskolkov <posk@google.com>
+Philip Rowlands <linux-kernel@dimebar.com>
+Rob Landley <rob@landley.net>
+Ross Zwisler <zwisler@chromium.org>
+Sebastian Kirmayer <sebastian@kirmayer.de>
+наб <nabijaczleweli@nabijaczleweli.xyz>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+access.2
+ Michael Kerrisk
+ Document faccessat2()
+ faccessat2() was added in Linux 5.8 and enables a fix to
+ longstanding bugs in the faccessat() wrapper function.
+
+membarrier.2
+ Peter Oskolkov [Alejandro Colomar]
+ Update for Linux 5.10
+ Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840
+ (part of 5.10 release) changed sys_membarrier prototype/parameters
+ and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ
+ and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ].
+
+mount.2
+statfs.2
+ Ross Zwisler
+ Add NOSYMFOLLOW flags to mount(2) and statfs(2)
+
+
+New and changed links
+---------------------
+
+faccessat2.2
+ Michael Kerrisk
+ New link to access.2
+
+CIRCLEQ_EMPTY.3
+CIRCLEQ_FIRST.3
+CIRCLEQ_FOREACH.3
+CIRCLEQ_FOREACH_REVERSE.3
+CIRCLEQ_HEAD_INITIALIZER.3
+CIRCLEQ_LAST.3
+CIRCLEQ_LOOP_NEXT.3
+CIRCLEQ_LOOP_PREV.3
+CIRCLEQ_NEXT.3
+CIRCLEQ_PREV.3
+ Michael Kerrisk
+ Add missing links to circleq.3
+
+pthread_attr_getsigmask_np.3
+ Michael Kerrisk
+ New link to pthread_attr_setsigmask_np.3
+
+
+Global changes
+--------------
+
+Various pages
+ Alejandro Colomar
+ Use Oxford comma
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ Michael Kerrisk
+ BUGS: note that faccessat() wrapper function emulation ignores ACLs
+
+bpf.2
+ Michael Kerrisk
+ Place EXAMPLES section in correct location
+
+cacheflush.2
+ Alejandro Colomar
+ Document Architecture-specific variants
+ Alejandro Colomar [Heinrich Schuchardt]
+ Document __builtin___clear_cache() as a more portable alternative
+
+chroot.2
+memfd_create.2
+tailq.3
+ Michael Kerrisk [Alejandro Colomar]
+ Fix unbalanced .nf/.fi
+
+clock_getres.2
+ Michael Kerrisk
+ Place ERRORS in alphabetical order
+
+clone.2
+sigaltstack.2
+ Michael Kerrisk
+ clone(CLONE_VM) disables the alternate signal stack
+
+getrlimit.2
+ Michael Kerrisk
+ State more precisely the range of kernel versions that had RLIMIT_LOCKS
+
+getrusage.2
+ Michael Kerrisk
+ Note that the 'vtimes' symbol exists only up to glibc 2.32
+
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+ Alejandro Colomar
+ SYNOPSIS: s/io_context_t/aio_context_t/
+ Linux uses aio_context_t for these syscalls,
+ and it's the type provided by <linux/aio_abi.h>.
+ Use it in the SYNOPSIS.
+
+ libaio uses 'io_context_t', but that difference is already noted
+ in NOTES.
+
+io_setup.2
+ Alejandro Colomar
+ SYNOPSIS: return long
+
+link.2
+ Mathias Rav
+ ERRORS: add ENOENT when target is deleted
+ Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part
+ of kernel release v2.6.39) added a check to disallow creating a
+ hard link to an unlinked file.
+
+llseek.2
+ Michael Kerrisk
+ Note size of 'loff_t' type
+ Michael Kerrisk
+ Point the reader to lseek64(3) for info about llseek(3)
+ Michael Kerrisk
+ Some mild rewriting to ease reading of the info in this page
+
+mmap.2
+ Michael Kerrisk
+ Clarify SIGBUS text and treatment of partial page at end of a mapping
+
+msgctl.2
+ Michael Kerrisk
+ Make comments in 'msqid_ds' definition more compact
+ Michael Kerrisk
+ Place list of field descriptions in same order as structure definition
+ Michael Kerrisk
+ Use field name "msg_cbytes" rather than "__msg_cbytes"
+ Michael Kerrisk
+ Add description of 'msg_cbytes' field
+
+openat.2
+ Colin Ian King
+ Fix include path, should be linux/openat2.h
+
+perf_event_open.2
+ Namhyung Kim [Alejandro Colomar]
+ Update man page with recent kernel changes
+ Alejandro Colomar
+ Assign calculated value explicitly to 'config'
+
+restart_syscall.2
+ Alejandro Colomar
+ SYNOPSIS: Fix restart_syscall() return type
+
+set_tid_address.2
+ Alejandro Colomar
+ SYNOPSIS: Fix set_tid_address() return type
+
+shmctl.2
+ Michael Kerrisk
+ Place list of field descriptions in same order as structure definition
+
+sigaction.2
+ Michael Kerrisk
+ Clarify description of SA_NODEFER
+ Clarify description of SA_NODEFER, and note interaction with
+ act.sa_mask.
+ Michael Kerrisk
+ Add a cross-reference to signal(7) for further info on 'ucontext_t'
+
+sigaltstack.2
+ Michael Kerrisk
+ Clarify that the alternate signal stack is per-thread
+ Clarify that the alternate signal stack is per-thread (rather
+ than process-wide).
+
+spu_create.2
+ Michael Kerrisk
+ Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM
+ Michael Kerrisk
+ Relocate paragraph on 'mode' argument
+ Michael Kerrisk [Alejandro Colomar]
+ Clarify that spu_create() now has 4 arguments but once had only 3
+
+subpage_prot.2
+ Alejandro Colomar
+ SYNOPSIS: Fix return type: s/long/int/
+
+syscalls.2
+ Michael Kerrisk
+ Add process_madvise()
+ Michael Kerrisk
+ Note that sysctl() was removed in Linux 5.5
+
+timer_getoverrun.2
+ Michael Kerrisk
+ timer_getoverrun() now clamps the overrun count to DELAYTIMER_MAX
+ See https://bugzilla.kernel.org/show_bug.cgi?id=12665.
+
+uselib.2
+posix_memalign.3
+profil.3
+rtime.3
+ Michael Kerrisk
+ Remove some text about libc/libc5
+ With this change, there remain almost no vestiges of information
+ about the long defunct Linux libc.
+
+errno.3
+ Michael Kerrisk
+ Note another possible cause of the EMFILE error
+
+getcontext.3
+ Michael Kerrisk
+ Mention SA_SIGINFO flag when talking about 3-argument signal handler
+ Michael Kerrisk
+ SEE ALSO: add signal(7)
+
+list.3
+ Michael Kerrisk
+ NAME: remove LIST_PREV, which is not documented in this page
+
+lseek64.3
+ Michael Kerrisk
+ Remove section numbers from interface list
+ Michael Kerrisk
+ Remove sentence saying lseek64() is an alias for llseek()
+ Michael Kerrisk
+ NOTES: describe the origin of lseek64() in LFS
+
+nextafter.3
+ Michael Kerrisk
+ Remove duplicate "BUGS" section heading
+
+pthread_tryjoin_np.3
+ Michael Kerrisk [Mike Crowe]
+ Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug
+
+rcmd.3
+ Michael Kerrisk
+ SEE ALSO: remove intro(2)
+
+strnlen.3
+ Michael Kerrisk [Heinrich Schuchardt]
+ Fix a small inconsistency in the text
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add objcopy(1)
+
+filesystems.5
+ Ahelenia Ziemiańska [Alejandro Colomar]
+ Fix link to user space tooling for ncpfs
+ Ahelenia Ziemiańska [Alejandro Colomar]
+ Note ncpfs removal from kernel
+
+attributes.7
+ Michael Kerrisk
+ SEE ALSO: add signal-safety(7)
+
+fanotify.7
+ Amir Goldstein [Jan Kara]
+ Fix outdated description
+
+kernel_lockdown.7
+ Michael Kerrisk
+ Remove unneeded quotes
+
+packet.7
+ Baruch Siach [Alejandro Colomar]
+ Update references to kernel documentation
+
+pthreads.7
+ Michael Kerrisk
+ Rephrase function list in terms of POSIX rather than SUS
+ The list was using an inconsistent mixture of "POSIX" and "SUS".
+
+signal.7
+ Michael Kerrisk [Heinrich Schuchardt, Dave Martin]
+ Add some details on the execution of signal handlers
+ Add a "big picture" of what happens when a signal handler
+ is invoked.
+ Michael Kerrisk
+ Add pidfd_send_signal() to list of APIs for sending signals
+ Michael Kerrisk
+ Mention 'ucontext_t' in the discussion of signal handler execution
+ Michael Kerrisk
+ SEE ALSO: add swapcontext(3)
+
+signal-safety.7
+ Michael Kerrisk
+ Note async-signal-safety details for errno
+
+standards.7
+ Michael Kerrisk
+ Add URL for POSIX.1-2008/SUSv4
+ Michael Kerrisk
+ Add LFS (Large File Summit)
+ Michael Kerrisk [Rob Landley]
+ Fix some URLs for locations of the standards
+ Michael Kerrisk
+ Relocate the discussion on POSIX manual pages
+
+tcp.7
+ Alejandro Colomar [Philip Rowlands]
+ tcp_syncookies: It is now an integer [0, 2]
+ Since Linux kernel 3.12, tcp_syncookies can have the value 2,
+ which sends out cookies unconditionally.
+
+
+==================== Changes in man-pages-5.11 ====================
+
+Released: 2021-03-21, Munich
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Alejandro Colomar <alx@kernel.org>
+Alessandro Bono <alessandro.bono369@gmail.com>
+Alyssa Ross <hi@alyssa.is>
+Bastien Roucariès <rouca@debian.org>
+Bruno Haible <bruno@clisp.org>
+Christian Brauner <christian.brauner@ubuntu.com>
+Ciprian Dorin Craciun <ciprian.craciun@gmail.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Dmitry Vorobev <dvorobev@cloudflare.com>
+edef <edef@edef.eu>
+Enke Chen <enkechen2020@gmail.com>
+Gabriel Krisman Bertazi <krisman@collabora.com>
+Ganimedes Colomar <gacoan.linux@gmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jens Axboe <axboe@kernel.dk>
+Johannes Pfister <johannes.pfister@josttech.ch>
+Johannes Wellhöfer <johannes.wellhofer@gmail.com>
+John Morris <john@zultron.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Manfred Spraul <manfred@colorfullife.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Minchan Kim <minchan@kernel.org>
+Pádraig Brady <P@draigBrady.com>
+Pali Rohár <pali@kernel.org>
+Palmer Dabbelt <palmerdabbelt@google.com>
+Paran Lee <p4ranlee@gmail.com>
+Peter H. Froehlich <peter.hans.froehlich@gmail.com>
+Philipp Schuster <phip1611@gmail.com>
+Stephen Kitt <steve@sk2.org>
+Steve Grubb <sgrubb@redhat.com>
+Suren Baghdasaryan <surenb@google.com>
+Szunti <szunti@gmail.com>
+Valentin Kettner <vakevk@gmail.com>
+Vincent Lefevre <vincent@vinc17.net>
+Walter Franzini <walter.franzini@gmail.com>
+Walter Harms <wharms@bfs.de>
+Willem de Bruijn <willemb@google.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+close_range.2
+ Stephen Kitt, Michael Kerrisk [Christian Brauner]
+ New page documenting close_range(2)
+
+process_madvise.2
+ Suren Baghdasaryan, Minchan Kim [Michal Hocko, Alejandro Colomar,
+ Michael Kerrisk]
+ Document process_madvise(2)
+
+fileno.3
+ Michael Kerrisk
+ Split fileno(3) content out of ferror(3) into new page
+ fileno(3) differs from the other functions in various ways.
+ For example, it is governed by different standards,
+ and can set 'errno'. Conversely, the other functions
+ are about examining the status of a stream, while
+ fileno(3) simply obtains the underlying file descriptor.
+ Furthermore, splitting this function out allows
+ for some cleaner upcoming changes in ferror(3).
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+epoll_wait.2
+ Willem de Bruijn [Dmitry V. Levin]
+ Add documentation of epoll_pwait2()
+ Expand the epoll_wait() page with epoll_pwait2(), an epoll_wait()
+ variant that takes a struct timespec to enable nanosecond
+ resolution timeout.
+
+fanotify_init.2
+fanotify.7
+ Jan Kara [Steve Grubb]
+ Document FAN_AUDIT flag and FAN_ENABLE_AUDIT
+
+madvise.2
+ Michael Kerrisk
+ Add descriptions of MADV_COLD and MADV_PAGEOUT
+ Taken from process_madvise(2).
+
+openat2.2
+ Jens Axboe
+ Add RESOLVE_CACHED
+
+prctl.2
+ Gabriel Krisman Bertazi
+ Document Syscall User Dispatch
+
+mallinfo.3
+ Michael Kerrisk
+ Document mallinfo2() and note that mallinfo() is deprecated
+ Document the mallinfo2() function added in glibc 2.33.
+ Update example program to use mallinfo2()
+
+system_data_types.7
+ Alejandro Colomar
+ Add off64_t to system_data_types(7)
+
+ld.so.8
+ Michael Kerrisk
+ Document the --argv0 option added in glibc 2.33
+
+
+New and changed links
+---------------------
+
+epoll_pwait2.2
+ Dmitry V. Levin
+ New link to epoll_wait(2)
+
+mallinfo2.3
+ Michael Kerrisk
+ New link to mallinfo(3)
+
+off64_t.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+
+Global changes
+--------------
+
+Various pages
+ Alejandro Colomar
+ SYNOPSIS: Use 'restrict' in prototypes
+ This change has been completed for *all* relevant pages
+ (around 135 pages in total).
+
+Various pages
+ Alejandro Colomar [Zack Weinberg]
+ Remove unused <sys/types.h>
+ The manual pages are already inconsistent in which headers need
+ to be included. Right now, not all of the types used by a
+ function have their required header included in the SYNOPSIS.
+
+ If we were to add the headers required by all of the types used by
+ functions, the SYNOPSIS would grow too much. Not only it would
+ grow too much, but the information there would be less precise.
+
+ Having system_data_types(7) document each type with all the
+ information about required includes is much more precise, and the
+ info is centralized so that it's much easier to maintain.
+
+ So let's document only the include required for the function
+ prototype, and also the ones required for the macros needed to
+ call the function.
+
+ <sys/types.h> only defines types, not functions or constants, so
+ it doesn't belong to man[23] (function) pages at all.
+
+ I ignore if some old systems had headers that required you to
+ include <sys/types.h> *before* them (incomplete headers), but if
+ so, those implementations would be broken, and those headers
+ should probably provide some kind of warning. I hope this is not
+ the case.
+
+ [mtk: Already in 2001, POSIX.1 removed the requirement to
+ include <sys/types.h> for many APIs, so this patch seems
+ well past due.]
+
+A few pages
+ Alejandro Colomar
+ Add notes about missing glibc wrappers
+
+_exit.2
+abort.3
+err.3
+exit.3
+pthread_exit.3
+setjmp.3
+ Alejandro Colomar
+ SYNOPSIS: Use 'noreturn' in prototypes
+ Use standard C11 'noreturn' in these manual page for
+ functions that do not return.
+
+Various pages
+ Ganimedes Colomar [Alejandro Colomar]
+ Normalize SYNOPSIS notes about nonexistent glibc wrappers
+ To easily distinguish documentation about glibc wrappers from
+ documentation about kernel syscalls, let's have a normalized
+ 'Note' in the SYNOPSIS, and a further explanation in the page body
+ (NOTES in most of them), as already happened in many (but not all)
+ of the manual pages for syscalls without a wrapper. Furthermore,
+ let's normalize the messages, following membarrier.2 (because it's
+ already quite extended), so that it's easy to use grep to find
+ those pages.
+ Normalize NOTES about nonexistent glibc wrappers
+ This commit normalizes texts under sections other than SYNOPSIS
+ (most of them in NOTES).
+
+
+Global changes (formatting fixes and minor edits)
+-------------------------------------------------
+
+Various pages
+ Michael Kerrisk
+ ERRORS: remove redundant statement that 'errno' is set
+ This is implied in every other manual page. There is no need to
+ state it explicitly in these pages.
+
+Various pages
+ Michael Kerrisk
+ Use periods more consistently inside code comments
+ In general, complete sentences in free-standing comments
+ should be terminated by periods.
+
+A few pages
+ Michael Kerrisk
+ Better table formatting
+ In particular, allow for rendering in widths different from
+ (especially less than) 80 columns.
+
+Various pages
+ Michael Kerrisk
+ Consistency fix-up in FTMs
+ Generally, place '||' at start of a line, rather than the end of
+ the previous line.
+
+ Rationale: this placement clearly indicates that each piece
+ is an alternative.
+
+Various pages
+ Michael Kerrisk [Alejandro Colomar]
+ Bring more whitespace consistency in SYNOPSIS
+ The use of vertical white space in the SYNOPSIS sections
+ is rather inconsistent. Make it more consistent, subject to the
+ following heuristics:
+
+ * Prefer no blank lines between function signatures by default.
+ * Where many functions are defined in the SYNOPSIS, add blank
+ lines where needed to improve readability, possibly by using
+ blank lines to separate logical groups of functions.
+
+Various pages
+ Alejandro Colomar
+ Consistently use 'unsigned int'
+ Most pages use 'unsigned int' (and the kernel too).
+ Make them all do so.
+
+Various pages
+ Michael Kerrisk
+ Various improvements in wording in RETURN VALUE
+
+Various pages
+ Michael Kerrisk
+ s/Glibc versions </Glibc </ in Feature Test Macro discussions
+ Use a more compact notation that will render less wide
+ on the terminal.
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, "to indicate the cause of the error"
+ is changed to "to indicate the error".
+
+Various pages
+ Michael Kerrisk
+ Add missing .nf/.fi in FTM info
+
+Various pages
+ Michael Kerrisk
+ Simplify mark-up for Feature Test Macro requirements
+ Different source styles are used in different pages to achieve the
+ same formatted output, and in some cases the source mark-up is a
+ rather convoluted combination of .RS/.RE/.TP/.PD macros. Simplify
+ this greatly, and unify all of the pages to use more or less the
+ same source code style. This makes the source code rather easier
+ to read, and may simplify future scripted global changes.
+
+ The feature test macro info is currently bracketed by .nf/.fi
+ pairs. This is not strictly necessary (i.e., it makes no
+ difference to the rendered output), but for the moment we keep
+ these "brackets" in case they may be replaced with something else.
+
+Various pages
+ Michael Kerrisk
+ Use real minus signs in pathnames
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, reword various cases saying that 'errno' is set
+ "appropriately" to "is set to indicate the error".
+
+Various pages
+ Michael Kerrisk
+ Improve formatting in ATTRIBUTES
+ Make the formatting more consistent inside the tables in the
+ ATTRIBUTES sections. Make the source code more uniform; in
+ particular, eliminate the use of custom tweaks using
+ 'lbwNN'/'lwNN' and .br macros. In addition, ensure that
+ hyphenation and text justification do not occur inside the tables.
+
+Various pages
+ Michael Kerrisk
+ Use .nf/.fi in SYNOPSIS
+ The majority of pages use .nf/.fi in SYNOPSIS, but there are
+ still many that don't and use .br to achieve newlines. Fix many
+ of those. This brings greater consistency to the pages, which
+ eases editing and may ease future scripted edits to the pages.
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, miscellaneous descriptions of the setting
+ of 'errno' are reworded to the norm of "is set to indicate
+ the error".
+
+Various pages
+ Michael Kerrisk
+ Use "\-" to generate real minus in circumstances where appropriate
+ Use \- for math formulas, pathnames, manual page cross references,
+ etc.
+
+Various pages
+ Michael Kerrisk
+ Inside code blocks (.EX/.EE) use \- to get real minus signs
+ A real minus can be cut and pasted...
+
+Various pages
+ Alejandro Colomar
+ Remove explicit blank lines, replacing them with .PP when appropriate
+
+Various pages
+ Michael Kerrisk
+ Use internally consistent continuation indents in SYNOPSIS
+ In the SYNOPSIS, a long function prototype may need to be
+ continued over to the next line. The continuation line is
+ indented according to the following rules:
+
+ 1. If there is a single such prototype that needs to be continued,
+ then align the continuation line so that when the page is
+ rendered on a fixed-width font device (e.g., on an xterm) the
+ continuation line starts just below the start of the argument
+ list in the line above. (Exception: the indentation may be
+ adjusted if necessary to prevent a very long continuation line
+ or a further continuation line where the function prototype is
+ very long.)
+
+ Thus:
+
+ int tcsetattr(int fd, int optional_actions,
+ const struct termios *termios_p);
+
+ 2. But, where multiple functions in the SYNOPSIS require
+ continuation lines, and the function names have different
+ lengths, then align all continuation lines to start in the
+ same column. This provides a nicer rendering in PDF output
+ (because the SYNOPSIS uses a variable width font where
+ spaces render narrower than most characters).
+
+ Thus:
+
+ int getopt(int argc, char * const argv[],
+ const char *optstring);
+ int getopt_long(int argc, char * const argv[],
+ const char *optstring,
+ const struct option *longopts, int *longindex);
+
+Various pages
+ Michael Kerrisk
+ Standardize wording around setting of 'errno' on error
+ In the RETURN VALUE sections, a number of different wordings
+ are used in to describe the fact that 'errno' is set on error.
+ There's no reason for the difference in wordings, since the same
+ thing is being described in each case. Switch to a standard
+ wording that is the same as FreeBSD and similar to the wording
+ used in POSIX.1.
+
+ In this change, fix some instances stating that 'errno' is set
+ "appropriately" to instead say "to indicate the error".
+
+Various System V IPC pages
+ Michael Kerrisk
+ Improve wording describing RETURN VALUE and setting of 'errno'
+
+
+Changes to individual pages
+---------------------------
+
+alloc_hugepages.2
+ Michael Kerrisk
+ CONFORMING TO: reword to reflect that these system calls are long gone
+
+cacheflush.2
+ Alejandro Colomar
+ Update SYNOPSIS for glibc wrapper
+ Glibc uses 'void *' instead of 'char *'.
+ And the prototype is declared in <sys/cachectl.h>.
+
+clone.2
+ Valentin Kettner
+ Fix types in clone_args
+ A file descriptor is an int so it should be stored through an int
+ pointer while parent_tid should have the same type as child_tid
+ which is pid_t pointer.
+
+close.2
+ Michael Kerrisk
+ SEE ALSO: add close_range(2)
+
+copy_file_range.2
+ Alejandro Colomar
+ Document glibc wrapper instead of kernel syscall
+ Glibc uses 'off64_t' instead of 'loff_t'.
+
+delete_module.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ The Linux kernel uses 'unsigned int' instead of 'int' for the
+ 'flags' parameter. As glibc provides no wrapper, use the same
+ type the kernel uses.
+
+epoll_create.2
+ Michael Kerrisk
+ CONFORMING TO: mention that epoll_create1() is Linux-specific
+
+epoll_wait.2
+ Michael Kerrisk
+ CONFORMING TO: mention that epoll_pwait() is Linux-specific
+
+execve.2
+ Palmer Dabbelt
+ Correct the versions of Linux that don't have ARG_MAX argv/envp size
+
+execveat.2
+ Alejandro Colomar
+ Fix prototype
+ It's been 6 years since execveat(2) was added to the kernel,
+ and there's still no glibc wrapper. Let's document the kernel
+ syscall prototype.
+
+getcpu.2
+ Michael Kerrisk [Alejandro Colomar]
+ Rewrite page to describe glibc wrapper function
+ Since glibc 2.29, there is a wrapper for getcpu(2).
+ The wrapper has only 2 arguments, omitting the unused
+ third system call argument. Rework the manual page
+ to reflect this.
+
+getgid.2
+getuid.2
+ Michael Kerrisk
+ Note that these interfaces never modify 'errno'
+ See https://www.austingroupbugs.net/view.php?id=511
+ and the POSIX.1-2008 specifications of the interfaces.
+
+gethostname.2
+ Michael Kerrisk
+ Update FTM requirements for gethostname()
+
+getpagesize.2
+getdtablesize.3
+ Michael Kerrisk
+ Update/correct FTM requirements
+
+getrusage.2
+ Michael Kerrisk
+ Starting in 2.33, glibc no longer provides vtimes()
+
+ioctl_tty.2
+ Michael Kerrisk
+ Reformat argument type information
+ The current mark-up renders poorly. To resolve this, move
+ the type information into a separate line.
+
+ipc.2
+ Alejandro Colomar
+ Fix prototype parameter types
+
+kcmp.2
+ Michael Kerrisk
+ Since Linux 5.12, kcmp() availability is unconditional
+ kcmp() is no longer dependent on CONFIG_CHECKPOINT_RESTORE.
+
+keyctl.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ The Linux kernel uses 'unsigned long'.
+ There's no reason to use the typedef '__kernel_ulong_t'.
+
+lookup_dcookie.2
+ Alejandro Colomar
+ Use standard types: u64 -> uint64_t
+
+madvise.2
+ Michael Kerrisk
+ SEE ALSO: add process_madvise(2)
+
+mlock.2
+ Alejandro Colomar
+ mlock2(): Fix prototype parameter types
+ The documented prototype for mlock2() was a mix of the
+ glibc wrapper prototype and the kernel syscall prototype.
+ Let's document the glibc wrapper prototype, which is shown below.
+ Michael Kerrisk
+ CONFORMING TO: note more explicitly which APIs are in the standards
+
+mmap2.2
+ Alejandro Colomar
+ Fix prototype parameter types
+ There are many slightly different prototypes for this syscall,
+ but none of them is like the documented one.
+ Of all the different prototypes,
+ let's document the asm-generic one.
+
+mount.2
+ Michael Kerrisk
+ Note that the 'data' argument can be NULL
+
+move_pages.2
+ Alejandro Colomar
+ Add notes about missing glibc wrappers
+
+open.2
+rename.2
+ Alyssa Ross
+ Refer to tmpfs rather than shmem
+ If I'm understanding correctly, tmpfs is a filesystem built on
+ shmem, so I think it's more correct (and probably much more
+ widely understandable) to refer to tmpfs here.
+
+pciconfig_read.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ Use the glibc prototypes instead of the kernel ones.
+ Exception: use 'int' instead of 'enum'.
+
+pidfd_open.2
+ Michael Kerrisk
+ Note the process_madvise(2) use case for PID file descriptors
+
+readlink.2
+ Michael Kerrisk [Jonny Grant]
+ Emphasize that the returned buffer is not null-terminated
+
+s390_pci_mmio_write.2
+ Alejandro Colomar
+ SYNOPSIS: Add 'const' qualifier
+ s390_pci_mmio_write() uses 'const void *' instead of 'void *'.
+
+sched_setattr.2
+ Alejandro Colomar
+ Add note about missing glibc wrappers
+
+semctl.2
+ Yang Xu [Alejandro Colomar, Manfred Spraul]
+ Correct SEM_STAT_ANY description
+
+socketcall.2
+ Alejandro Colomar
+ Add note about missing glibc wrapper
+
+splice.2
+ Alejandro Colomar
+ Use 'off64_t' instead of 'loff_t'
+ The kernel syscall uses 'loff_t', but the glibc wrapper uses 'off64_t'.
+ Let's document the wrapper prototype, as in other pages.
+
+spu_create.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter type
+ The 'flags' parameter of spu_create() uses 'unsigned int'.
+
+spu_run.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ The 2nd and 3rd parameters of spu_run() use 'uint32_t *'.
+
+stat.2
+ Jonathan Wakely [Alejandro Colomar]
+ Remove <unistd.h> from SYNOPSIS
+ There seems to be no reason <unistd.h> is shown here, so remove it.
+ Michael Kerrisk
+ Move the obsolete _BSD_SOURCE FTM to the end of the FTM info
+
+syscall.2
+ Peter H. Froehlich
+ Update superh syscall convention
+
+syscalls.2
+ Michael Kerrisk
+ Add epoll_pwait2()
+
+tkill.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter types
+ All but the last parameters of t[g]kill() use 'pid_t',
+ both in the kernel and glibc.
+
+vmsplice.2
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype parameter type
+ The 3rd parameter of vmsplice() uses 'size_t' in glibc.
+
+bstring.3
+ Michael Kerrisk
+ SEE ALSO: add string(3)
+
+circleq.3
+list.3
+slist.3
+stailq.3
+tailq.3
+ Alejandro Colomar
+ Improve readability, especially in SYNOPSIS
+
+circleq.3
+ Alejandro Colomar
+ Fix CIRCLEQ_LOOP_*() return type
+
+crypt.3
+ Michael Kerrisk
+ Reformat FTM info (in preparation for next patch)
+ Michael Kerrisk
+ Update crypt() FTM requirements to note glibc 2.28 changes
+
+ecvt.3
+gcvt.3
+ Michael Kerrisk
+ Update FTM requirements
+
+error.3
+ Michael Kerrisk [Alejandro Colomar, Walter Harms]
+ Clarify the meaning of 'status==0' for error(3)
+
+ferror.3
+ Michael Kerrisk
+ Remove fileno(3) content that was migrated to new fileno(3) page
+ Michael Kerrisk
+ Add a RETURN VALUE section
+ Michael Kerrisk
+ POSIX.1-2008: these functions won't change 'errno' if 'stream' is valid
+ See https://www.austingroupbugs.net/view.php?id=401.
+
+fread.3
+ Alessandro Bono
+ EXAMPLES: swap size and nmemb params
+ It works both ways, but this one feels more right. We are reading
+ four elements sizeof(*buffer) bytes each.
+
+fseeko.3
+ Michael Kerrisk
+ Move info about obsolete FTM from SYNOPSIS to NOTES
+ This makes the SYNOPSIS more consistent with other pages.
+
+ftime.3
+ Michael Kerrisk
+ glibc 2.33 has removed ftime()
+
+ftw.3
+ Alejandro Colomar
+ SYNOPSIS: Remove duplicate header
+
+gethostbyname.3
+ Michael Kerrisk
+ Move mention of <sys/socket.h> from SYNOPSIS to DESCRIPTION
+ The functions are all declared in <netdb.h>. <sys/socket.h> is only
+ needed for the AF_* constants.
+
+gethostid.3
+ Michael Kerrisk
+ Update FTM requirements for gethostid()
+
+get_phys_pages.3
+ Alejandro Colomar [Jakub Wilk]
+ glibc gets the info from sysinfo(2) since 2.23
+
+grantpt.3
+ptsname.3
+unlockpt.3
+ Michael Kerrisk
+ Remove mention of _XOPEN_SOURCE_EXTENDED FTM
+ This rather ancient FTM is not mentioned in other pages for
+ reasons discussed in feature_test_macros(7). Remove this FTM
+ from the three pages where it does appear.
+
+malloc.3
+ Alejandro Colomar [Johannes Pfister]
+ Document that realloc(p, 0) is specific to glibc and nonportable
+
+malloc_hook.3
+ Alejandro Colomar
+ SYNOPSIS: Use 'volatile' in prototypes
+
+malloc_trim.3
+ Dmitry Vorobev
+ Remove mention of free() call
+ 'malloc_trim' was and is never called from the 'free' function.
+
+pthread_create.3
+ Michael Kerrisk [Paran Lee]
+ Fix undeclared variable error in example program
+ Michael Kerrisk
+ Fix a signedness error in the example code
+
+puts.3
+ Michael Kerrisk
+ Reorder functions more logically (group related functions together)
+
+qecvt.3
+ Michael Kerrisk
+ Update feature test macro requirements
+
+setbuf.3
+ Michael Kerrisk
+ POSIX doesn't require errno to be unchanged after successful setbuf()
+ See https://www.austingroupbugs.net/view.php?id=397#c799
+
+setlocale.3
+ Michael Kerrisk [Alejandro Colomar, Bruno Haible]
+ Restructure a particularly difficult sentence
+
+simpleq.3
+stailq.3
+queue.7
+SIMPLEQ_*.3
+ Alejandro Colomar
+ Document SIMPLEQ_*() as an alias to STAILQ_*() macros
+
+strerror.3
+ Alejandro Colomar
+ strerrorname_np() and strerrordesc_np() first appeared on glibc 2.32
+
+string.3
+ Michael Kerrisk
+ SEE ALSO: add bstring(3)
+
+system.3
+ Alejandro Colomar [Ciprian Dorin Craciun]
+ Document bug and workaround when the command name starts with a hyphen
+
+environ.7
+ Bastien Roucariès
+ Reorder the text
+ Move the text describing how to set environment variable before
+ the list(s) of variables in order to improve readability.
+ Bastien Roucariès
+ Document convention of string in environ
+ Document the name=value system and that nul byte is forbidden.
+ Bastien Roucariès
+ Document that HOME, LOGNAME, SHELL, USER are set at login time
+ and point to the su(1) manual page.
+ Bastien Roucariès
+ Add see also ld.so(8) for LD_ variables
+ Michael Kerrisk [Bastien Roucariès]
+ Improve the description of PATH
+ Add more details of how PATH is used, and mention the legacy
+ use of an empty prefix.
+ Bastien Roucariès [Alejandro Colomar, Bastien Roucaries, Vincent Lefevre]
+ Document valid values of pathnames for SHELL, PAGER and EDITOR/VISUAL
+ Michael Kerrisk [Bastien Roucariès]
+ Note the default if PAGER is not defined
+ Michael Kerrisk
+ Be a little more precise when discussing 'exec'
+ Say "execve(2)" instead of "exec(3)", and note that this step
+ starts a new program (not a new process!).
+ Michael Kerrisk [Bastien Roucariès]
+ Relocate and reword the mention of _GNU_SOURCE
+
+man-pages.7
+ Michael Kerrisk
+ Document "acknowledgement" as the preferred spelling
+ Michael Kerrisk
+ Add some notes on comments in example code
+ Michael Kerrisk
+ Add a FORMATTING AND WORDING CONVENTIONS section
+ In man-pages-5.11, a large number of pages were edited to achieve
+ greater consistency in the SYNOPSIS, RETURN VALUE and ATTRIBUTES
+ sections. To avoid future inconsistencies, try to capture some of
+ the preferred conventions in text in man-pages(7).
+ Michael Kerrisk
+ Note some rationale for the use of real minus signs
+
+netdevice.7
+ Pali Rohár [Alejandro Colomar]
+ Update documentation for SIOCGIFADDR SIOCSIFADDR SIOCDIFADDR
+
+netlink.7
+ Pali Rohár [Alejandro Colomar]
+ Fix minimal Linux version for NETLINK_CAP_ACK
+ NETLINK_CAP_ACK option was introduced in commit 0a6a3a23ea6e which first
+ appeared in Linux version 4.3 and not 4.2.
+ Pali Rohár [Alejandro Colomar]
+ Remove IPv4 from description
+ rtnetlink is not only used for IPv4
+ Philipp Schuster
+ Clarify details of netlink error responses
+ Make it clear that netlink error responses (i.e., messages with
+ type NLMSG_ERROR (0x2)), can be longer than sizeof(struct
+ nlmsgerr). In certain circumstances, the payload can be longer.
+
+shm_overview.7
+ Michael Kerrisk
+ SEE ALSO: add memfd_create(2)
+
+sock_diag.7
+ Pali Rohár [Alejandro Colomar]
+ Fix recvmsg() usage in the example
+
+tcp.7
+ Enke Chen
+ Documentation revision for TCP_USER_TIMEOUT
+
+uri.7
+ Michael Kerrisk
+ Note that 'logical' quoting is the norm in Europe
+
+
+==================== Changes in man-pages-5.12 ====================
+
+Released: 2021-06-20, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Akihiro Motoki <amotoki@gmail.com>
+Alejandro Colomar <alx@kernel.org>
+Alyssa Ross <hi@alyssa.is>
+Aurelien Aptel <aaptel@suse.com>
+Borislav Petkov <bp@suse.de>
+Bruce Merry <bmerry@ska.ac.za>
+Chris Keilbart <keilbartchris@gmail.com>
+Christian Brauner <christian@brauner.io>
+Christoph Anton Mitterer <calestyo@scientia.net>
+dann frazier <dann.frazier@canonical.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Florian Weimer <fw@deneb.enyo.de>
+Huang Ying <ying.huang@intel.com>
+Jakub Wilk <jwilk@jwilk.net>
+James O. D. Hunt <jamesodhunt@gmail.com>
+Jann Horn <jannh@google.com>
+Johannes Berg <johannes@sipsolutions.net>
+Jon Murphy <jonmurphy1618@gmail.com>
+Josh Triplett <josh@joshtriplett.org>
+Katsuhiro Numata <byakkomon@gmail.com>
+Kees Cook <keescook@chromium.org>
+Mark Kettenis <kettenis@openbsd.org>
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Rapoport <rppt@linux.vnet.ibm.com>
+Peter Xu <peterx@redhat.com>
+Sargun Dhillon <sargun@sargun.me>
+Stefan Puiu <stefan.puiu@gmail.com>
+Štěpán Němec <stepnem@gmail.com>
+thomasavoss <thomasavoss@protonmail.com>
+Topi Miettinen <toiwoton@gmail.com>
+Tycho Andersen <tycho@tycho.pizza>
+Utkarsh Singh <utkarsh190601@gmail.com>
+Vishwajith K <vishuvikas1996@gmail.com>
+Walter Harms <wharms@bfs.de>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Zhiheng Li <phoenix_lzh@sina.com>
+наб <nabijaczleweli@nabijaczleweli.xyz>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+seccomp_unotify.2
+ Michael Kerrisk [Tycho Andersen, Jann Horn, Kees Cook, Christian Brauner
+ Sargun Dhillon]
+ New page documenting the seccomp user-space notification mechanism
+
+MAX.3
+ Alejandro Colomar
+ New page to document MAX() and MIN()
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+seccomp.2
+ Tycho Andersen [MichaelKerrisk]
+ Document SECCOMP_GET_NOTIF_SIZES
+ Tycho Andersen
+ Document SECCOMP_FILTER_FLAG_NEW_LISTENER [Michael Kerrisk]
+ Tycho Andersen
+ Document SECCOMP_RET_USER_NOTIF [Michael Kerrisk]
+
+set_mempolicy.2
+ Huang Ying [Alejandro Colomar, "Huang, Ying"]
+ Add mode flag MPOL_F_NUMA_BALANCING
+
+userfaultfd.2
+ Peter Xu [Alejandro Colomar, Mike Rapoport]
+ Add UFFD_FEATURE_THREAD_ID docs
+ Peter Xu [Alejandro Colomar, Mike Rapoport]
+ Add write-protect mode docs
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/vm/sysctl_hugetlb_shm_group
+
+system_data_types.7
+ Alejandro Colomar
+ Add 'blksize_t'
+ Alejandro Colomar
+ Add 'blkcnt_t'
+ Alejandro Colomar
+ Add 'mode_t'
+ Alejandro Colomar
+ Add 'struct sockaddr'
+ Alejandro Colomar
+ Add 'cc_t'
+ Alejandro Colomar
+ Add 'socklen_t'
+
+
+New and changed links
+---------------------
+
+blkcnt_t.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+blksize_t.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+cc_t.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+MIN.3
+ Michael Kerrisk
+ New link to MIN.3
+
+mode_t.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+sockaddr.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+socklen_t.3
+ Alejandro Colomar
+ New link to system_data_types(7)
+
+
+Global changes
+--------------
+
+Many pages
+ Alejandro Colomar
+ SYNOPSIS: Use syscall(SYS_...); for system calls without a wrapper
+
+Many pages
+ Alejandro Colomar
+ SYNOPSIS: Document why each header is required
+
+Many pages
+ Alejandro Colomar
+ SYNOPSIS: Remove unused includes
+
+Various pages
+ Alejandro Colomar
+ Add note about the use of syscall(2)
+
+Various pages
+ Alejandro Colomar
+ SYNOPSIS: Miscellaneous fixes to includes
+
+A few pages
+ Alejandro Colomar
+ SYNOPSIS: Add missing 'const'
+
+
+Changes to individual pages
+---------------------------
+
+dup.2
+ Michael Kerrisk
+ Rewrite the description of dup() somewhat
+ As can be seen by any number of StackOverflow questions, people
+ persistently misunderstand what dup() does, and the existing manual
+ page text, which talks of "copying" a file descriptor doesn't help.
+ Rewrite the text a little to try to prevent some of these
+ misunderstandings, in particular noting at the start that dup()
+ allocates a new file descriptor.
+ Michael Kerrisk
+ Clarify what silent closing means
+ Alejandro Colomar
+ SYNOPSIS: Use consistent comments through pages
+
+epoll_wait.2
+ Alejandro Colomar
+ Move misplaced subsection to NOTES from BUGS
+
+execveat.2
+ Michael Kerrisk
+ Library support has been added in glibc 2.34
+
+_exit.2
+ Michael Kerrisk
+ Add a little more detail on the raw _exit() system cal
+
+exit_group.2
+ Alejandro Colomar
+ Use 'noreturn' in prototypes
+
+flock.2
+ Aurelien Aptel [Alejandro Colomar]
+ Add CIFS details
+ CIFS flock() locks behave differently than the standard.
+ Give an overview of those differences.
+
+ioperm.2
+ Alejandro Colomar
+ Remove obvious comment
+
+memfd_create.2
+mmap.2
+shmget.2
+ Michael Kerrisk [Yang Xu]
+ Document the EPERM error for huge page allocations
+ This error can occur if the caller is does not have CAP_IPC_LOCK
+ and is not a member of the sysctl_hugetlb_shm_group.
+
+mmap.2
+ Bruce Merry
+ Clarify that MAP_POPULATE is best-effort
+
+mount.2
+ Topi Miettinen
+ Document SELinux use of MS_NOSUID mount flag
+
+open.2
+ Alejandro Colomar [Walter Harms]
+ Fix bug in linkat(2) call example
+ AT_EMPTY_PATH works with empty strings (""), but not with NULL
+ (or at least it's not obvious).
+ Michael Kerrisk
+ Make it clearer that an FD is an index into the process's FD table
+ Sometimes people are confused, thinking a file descriptor is just a
+ number....
+
+perfmonctl.2
+ Michael Kerrisk
+ This system call was removed in Linux 5.10
+
+pipe.2
+ Alejandro Colomar
+ SYNOPSIS: Fix incorrect prototype
+ Michael Kerrisk
+ Rearrange SYNOPSIS so that minority version pipe() is at end
+
+ptrace.2
+ Dmitry V. Levin [Alejandro Colomar, Mathieu Desnoyers]
+ Mention PTRACE_GET_SYSCALL_INFO in RETURN VALUE section
+
+seccomp.2
+ Michael Kerrisk
+ Reorder list of SECCOMP_SET_MODE_FILTER flags alphabetically
+ (No content changes.)
+ Michael Kerrisk
+ SEE ALSO: add seccomp_unotify(2)
+
+select.2
+ Michael Kerrisk
+ Strengthen the warning regarding the low value of FD_SETSIZE
+ All modern code should avoid select(2) in favor of poll(2)
+ or epoll(7).
+ Michael Kerrisk
+ Relocate sentence about the fd_set value-result arguments to BUGS
+
+syscalls.2
+ Michael Kerrisk
+ perfmonctl(2) was removed in Linux 5.10
+
+bswap.3
+ Alejandro Colomar
+ bswap_*() are implemented using functions
+ Even though it's true that they are macros,
+ it's transparent to the user.
+
+ The user will see their results casted to unsigned types
+ after the conversion due to the underlying functions,
+ so it's better to document these as the underlying functions,
+ specifying the types.
+
+cmsg.3
+unix.7
+ Michael Kerrisk
+ Refer to seccomp_unotify(2) for an example of SCM_RIGHTS usage
+
+cpow.3
+ Alejandro Colomar
+ Use 'complex' after the type consistently
+
+ctime.3
+ Michael Kerrisk [Katsuhiro Numata]
+ Restore documentation of 'tm_gmtoff' field
+
+errno.3
+ Alejandro Colomar [Florian Weimer, Mark Kettenis]
+ Fix ENODATA text
+ ENODATA is an XSI STREAMS extension (not base POSIX).
+
+exec.3
+ Josh Triplett [Alejandro Colomar]
+ Clarify that execvpe() uses PATH from the caller, not envp
+ Josh Triplett [Alejandro Colomar]
+ Fix description of 'e' variants
+ The envp argument specifies the environment of the new process
+ image, not "the environment of the caller".
+
+fflush.3
+ Alejandro Colomar
+ SEE ALSO: Add fpurge(3)
+
+getline.3
+ наб [Ahelenia Ziemiańska, Alejandro Colomar]
+ !*lineptr is sufficient
+ No implementation or spec requires *n to be 0 to allocate
+ a new buffer.
+
+getopt.3
+ James O. D. Hunt [Alejandro Colomar]
+ Clarify behaviour
+
+printf.3
+ Utkarsh Singh [Alejandro Colomar]
+ Add overall structure of format string
+
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+ Alejandro Colomar
+ SYNOPSIS: Use 'restrict' in prototypes
+
+pthread_mutexattr_setrobust.3
+ Michael Kerrisk
+ Note that the *_np() APIs are deprecated since glibc 2.34
+ Alejandro Colomar
+ SYNOPSIS: Remove incorrect 'const'
+
+pthread_mutex_consistent.3
+ Michael Kerrisk
+ Note that pthread_mutexattr_setrobust() is now deprecated
+
+pthread_yield.3
+ Michael Kerrisk
+ Note that this function is deprecated since glibc 2.34
+
+rpc.3
+ Alejandro Colomar
+ SYNOPSIS: Fix prototypes (misc.)
+
+scanf.3
+ Alyssa Ross [Alejandro Colomar]
+ Clarify that %n supports type modifiers
+
+xdr.3
+ Alejandro Colomar
+ SYNOPSIS: Fix prototype types
+ Use the same types glibc uses, and add a missing 'const'.
+
+capabilities.7
+ Michael Kerrisk
+ CAP_IPC_LOCK also governs memory allocation using huge pages
+
+environ.7
+ Josh Triplett [Alejandro Colomar]
+ Remove obsolete admonishment of the GZIP environment variable
+
+kernel_lockdown.7
+ dann frazier [Alejandro Colomar]
+ Remove description of lifting via SysRq (not upstream)
+ The patch that implemented lockdown lifting via SysRq ended up
+ getting dropped[*] before the feature was merged upstream. Having
+ the feature documented but unsupported has caused some confusion
+ for our users.
+
+mount_namespaces.7
+namespaces.7
+ Michael Kerrisk
+ Relocate reference to pam_namespace(8) from namespaces.7 to
+ mount_namespaces.7.
+
+signal.7
+ Michael Kerrisk
+ Add reference to seccomp_unotify(2)
+ The seccomp user-space notification feature can cause changes in
+ the semantics of SA_RESTART with respect to system calls that
+ would never normally be restarted. Point the reader to the page
+ that provide further details.
+
+vsock.7
+ Alyssa Ross
+ ioctls are on /dev/vsock, not sockets
+
+
+==================== Changes in man-pages-5.13 ====================
+
+Released: 2021-08-27, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes or (noted in brackets
+in the changelog below) reports, notes, and ideas that have been
+incorporated in changes in this release:
+
+Ahelenia Ziemiańska (наб) <nabijaczleweli@nabijaczleweli.xyz>
+Alan Peakall <Alan.Peakall@helpsystems.com>
+Alejandro Colomar <alx@kernel.org>
+Alexis Wilke <alexis@m2osw.com>
+Askar Safin <safinaskar@mail.ru>
+Christian Brauner <christian.brauner@ubuntu.com>
+Christophe Leroy <christophe.leroy@csgroup.eu>
+Christopher Yeleighton <giecrilj@stegny.2a.pl>
+Cristian Morales Vega <christian.morales.vega@gmail.com>
+Dan Robertson <dan@dlrobertson.com>
+Darrick J. Wong <djwong@kernel.org>
+Dominique Brazziel <dbrazziel@snet.net>
+EmanueleTorre <torreemanuele6@gmail.com>
+Eric W. Biederman <ebiederm@xmission.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Jakub Wilk <jwilk@jwilk.net>
+James O. D. Hunt <jamesodhunt@gmail.com>
+Jonny Grant <jg@jguk.org>
+Kees Cook <keescook@chromium.org>
+Kir Kolyshkin <kolyshkin@gmail.com>
+Kurt Kanzenbach <kurt@linutronix.de>
+kXuan <kxuanobj@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Weiß <michael.weiss@aisec.fraunhofer.de>
+NeilBrown <neilb@suse.de>
+Nora Platiel <nplatiel@gmx.us>
+Pali Rohár <pali@kernel.org>
+Peter Collingbourne <pcc@google.com>
+Richard Palethorpe <rpalethorpe@suse.com>
+Rodrigo Campos <rodrigo@kinvolk.io>
+Sagar Patel <sagarmp@cs.unc.edu>
+Serge E. Hallyn <serge@hallyn.com>
+Sergey Petrakov <kr@spmail.info>
+Stefan Kanthak <stefan.kanthak@nexgo.de>
+Štěpán Němec <stepnem@gmail.com>
+Thomas Gleixner <tglx@linutronix.de>
+Thomas Voss <thomasavoss@protonmail.com>
+Viet Than <thanhoangviet@gmail.com>
+Will Manley <will@williammanley.net>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+mount_setattr.2
+ Christian Brauner [Alejandro Colomar, Michael Kerrisk]
+ New manual page documenting the mount_setattr() system call
+
+
+Removed Pages
+-------------
+
+getumask.3
+ Michael Kerrisk
+ This function was never implemented on Linux. It seems pointless to
+ retain such a page 20 years after it was written.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+futex.2
+ Kurt Kanzenbach [Alejandro Colomar, Thomas Gleixner, Michael Kerrisk]
+ Document FUTEX_LOCK_PI2
+
+ioctl_tty.2
+ Pali Rohár [Alejandro Colomar, Michael Kerrisk]
+ Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2
+
+pidfd_open.2
+ Michael Kerrisk
+ Document PIDFD_NONBLOCK
+
+seccomp_unotify.2
+ Rodrigo Campos [Alejandro Colomar]
+ Document SECCOMP_ADDFD_FLAG_SEND
+
+sigaction.2
+ Peter Collingbourne [Alejandro Colomar, Michael Kerrisk]
+ Document SA_EXPOSE_TAGBITS and the flag support detection protocol
+
+statx.2
+ NeilBrown
+ Document STATX_MNT_ID
+
+capabilities.7
+user_namespaces.7
+ Michael Kerrisk, Kir Kolyshkin [Alejandro Colomar]
+ Describe CAP_SETFCAP for mapping UID 0
+
+mount_namespaces.7
+ Michael Kerrisk [Christian Brauner, Eric W. Biederman]
+ More clearly explain the notion of locked mounts
+ For a long time, this manual page has had a brief discussion of
+ "locked" mounts, without clearly saying what this concept is, or
+ why it exists. Expand the discussion with an explanation of what
+ locked mounts are, why mounts are locked, and some examples of the
+ effect of locking.
+
+user_namespaces.7
+ Michael Kerrisk
+ Document /proc/PID/projid_map
+
+ld.so.8
+ Michael Kerrisk
+ Document --list-tunables option added in glibc 2.33
+
+
+Global changes
+--------------
+
+A few pages
+ Michael Kerrisk
+ ERRORS: correct alphabetic order
+
+A few pages
+ Michael Kerrisk
+ Place SEE ALSO entries in correct order
+
+A few pages
+ Michael Kerrisk
+ Arrange .SH sections in correct order
+
+Various pages
+ Michael Kerrisk
+ Fix EBADF error description
+ Make the description of the EBADF error for invalid 'dirfd' more
+ uniform. In particular, note that the error only occurs when the
+ pathname is relative, and that it occurs when the 'dirfd' is
+ neither valid *nor* has the value AT_FDCWD.
+
+Various pages
+ Michael Kerrisk
+ ERRORS: combine errors into a single alphabetic list
+ These pages split out extra errors for some APIs into a separate
+ list. Probably, the pages are easier to ready if all errors are
+ combined into a single list.
+
+ Note that there still remain a few pages where the errors are
+ listed separately for different APIs. For the moment, it seems
+ best to leave those pages as is, since the error lists are
+ largely distinct in those pages.
+
+Various pages
+ Michael Kerrisk
+ Terminology clean-up: "mount point" ==> "mount"
+ Many times, these pages use the terminology "mount point", where
+ "mount" would be better. A "mount point" is the location at which
+ a mount is attached. A "mount" is an association between a
+ filesystem and a mount point.
+
+accept.2
+access.2
+getpriority.2
+mlock.2
+ Michael Kerrisk
+ ERRORS: combine errors into a single list
+ These pages split out errors into separate lists (perhaps per API,
+ perhaps "may" vs "shall", perhaps "Linux-specific" vs
+ standard(??)), but there's no good reason to do this. It makes
+ the error list harder to read, and is inconsistent with other
+ pages. So, combine the errors into a single list.
+
+fanotify_mark.2
+futimesat.2
+mount_setattr.2
+statx.2
+symlink.2
+mkfifo.3
+ Michael Kerrisk
+ Refer the reader to openat(2) for explanation of why 'dirfd' is useful
+
+Various pages
+ Thomas Voss [Alejandro Colomar]
+ Consistently use '*argv[]'
+
+
+Changes to individual pages
+---------------------------
+
+iconv.1
+iconvconfig.8
+ Michael Kerrisk [Christopher Yeleighton]
+ FILES: note that files may be under /usr/lib64 rather than /usr/lib
+ See https://bugzilla.kernel.org/show_bug.cgi?id=214163
+
+ldd.1
+ Alejandro Colomar [EmanueleTorre]
+ Fix example command
+
+add_key.2
+keyctl.2
+request_key.2
+ Michael Kerrisk [Dominique Brazziel]
+ Note that the "libkeyutils" package provides <keyutils.h>
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992377
+
+close_range.2
+ Michael Kerrisk, Alejandro Colomar
+ Glibc 2.34 has added a close_range() wrapper
+
+execve.2
+ Michael Kerrisk [Nora Platiel]
+ The pathname given to interpreter is not necessarily absolute
+ Michael Kerrisk
+ SEE ALSO: getauxval(3)
+ getauxval(3) is useful background regarding execve(2).
+
+fanotify_mark.2
+ Michael Kerrisk
+ ERRORS: add missing EBADF error for invalid 'dirfd'
+
+ioctl_tty.2
+ Pali Rohár [Alejandro Colomar]
+ Update DTR example
+ Do not include unused (and incompatible) header file termios.h and
+ include required header files for puts() and close() functions.
+
+mount.2
+ Michael Kerrisk
+ ERRORS: add EPERM error for case where a mount is locked
+ Refer the reader to mount_namespaces(7) for details.
+ Michael Kerrisk
+ SEE ALSO: add mount_setattr(2)
+
+open.2
+ Michael Kerrisk
+ Explicitly describe the EBADF error that can occur with openat()
+ In particular, specifying an invalid file descriptor number
+ in 'dirfd' can be used as a check that 'pathname' is absolute.
+ Michael Kerrisk
+ Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH
+ Michael Kerrisk
+ Add mount_setattr(2) to list of 'dirfd' APIs
+
+open_by_handle_at.2
+ Michael Kerrisk
+ ERRORS: add missing EBADF error for invalid 'dirfd'
+
+readv2.2
+ Will Manley [Alejandro Colomar]
+ Note preadv2(..., RWF_NOWAIT) bug in BUGS section
+
+readv.2
+pipe.7
+ Michael Kerrisk [наб]
+ Make text on pipe writes more general to avoid a confusion in writev(2)
+
+seccomp.2
+ Eric W. Biederman [Kees Cook]
+ Clarify that bad system calls kill the thread (not the process)
+
+syscalls.2
+ Michael Kerrisk
+ Add quotactl_fd(); remove quotactl_path()
+ quotactl_path() was never wired up in Linux 5.13.
+ It was replaced instead by quotactl_fd(),
+ Michael Kerrisk
+ Add system calls that are new in 5.13
+
+umount.2
+ Michael Kerrisk
+ ERRORS: add EINVAL for case where mount is locked
+
+wait.2
+ Richard Palethorpe [Alejandro Colomar]
+ Add ESRCH for when pid == INT_MIN
+ Michael Kerrisk
+ ERRORS: document EAGAIN for waitid() on a PID file descriptor
+
+getaddrinfo.3
+ Alejandro Colomar [Cristian Morales Vega]
+ Note that 'errno' is set in parallel with EAI_SYSTEM
+
+getauxval.3
+ Michael Kerrisk
+ SEE ALSO: add execve(2)
+
+getopt.3
+ James O. D. Hunt [Alejandro Colomar]
+ Further clarification of 'optstring'
+
+pthread_setname_np.3
+ Michael Kerrisk [Alexis Wilke]
+ EXAMPLES: remove a bug by simplifying the code
+
+strlen.3
+wcslen.3
+ Michael Kerrisk [Alejandro Colomar, Jonny Grant]
+ Recommend alternatives where input buffer might not be null-terminated
+
+strstr.3
+ Alejandro Colomar [Stefan Kanthak]
+ Document special case for empty needle
+
+termios.3
+ Pali Rohár [Alejandro Colomar]
+ SPARC architecture has 4 different Bnnn constants
+ Pali Rohár [Alejandro Colomar]
+ Add information how to set baud rate to any other value
+ Pali Rohár [Alejandro Colomar]
+ Use bold style for Bnn and EXTn macro constants
+ Pali Rohár [Alejandro Colomar]
+ Document missing baud-rate constants
+
+tsearch.3
+ Michael Kerrisk
+ NAME: add twalk_r
+
+wcstok.3
+ Jakub Wilk
+ Fix type mismatch in the example
+
+proc.5
+ Michael Kerrisk
+ Add /proc/PID/projid_map, referring reader to user_namespaces(7)
+ Michael Kerrisk
+ Remove duplicated /proc/[pid]/gid_map entry
+
+mount_namespaces.7
+ Michael Kerrisk
+ Terminology clean-up: "mount point" ==> "mount"
+ Many times, this page uses the terminology "mount point", where
+ "mount" would be better. A "mount point" is the location at which
+ a mount is attached. A "mount" is an association between a
+ filesystem and a mount point.
+ Michael Kerrisk
+ SEE ALSO: add mount_setattr(2)
+
+namespaces.7
+ Štěpán Němec [Alejandro Colomar]
+ Fix confusion caused by text reorganization
+
+path_resolution.7
+ Michael Kerrisk [Askar Safin]
+ Improve description of trailing slashes
+ See https://bugzilla.kernel.org/show_bug.cgi?id=212385
+
+posixoptions.7
+ Alejandro Colomar [Alan Peakall]
+ Fix legacy functions list (s/getcwd/getwd/)
+
+user_namespaces.7
+ Kir Kolyshkin [Alejandro Colomar]
+ Fix a reference to a kernel document
+ Michael Kerrisk [Eric W. Biederman]
+ Add a definition of "global root"
+
+vdso.7
+ Michael Kerrisk [Christophe Leroy]
+ Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc
+ Alejandro Colomar [Christophe Leroy]
+ Add y2038 compliant gettime for ppc/32
+
+
+==================== Changes in man-pages-6.00 ====================
+
+Released: 2022-10-09, València
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+
+"Darrick J. Wong" <darrick.wong@oracle.com>
+"Dr. Jürgen Sauermann" <mail@xn--jrgen-sauermann-zvb.de>
+"Dr. Wolfgang Armbruster" <dr.w.e.armbruster@gmail.com>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+"M. Welinder" <mwelinder@gmail.com>
+"Theodore Ts'o" <tytso@mit.edu>
+"Todd C. Miller" <Todd.Miller@sudo.ws>
+"Valentin V. Bartenev" <vbart@nginx.com>
+<pellucida@tutanota.com>
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Ahelenia Ziemiańska (наб) <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Aleksander Baranowski <alex@euro-linux.com>
+Alexander Viro <viro@zeniv.linux.org.uk>
+Alexei Starovoitov <ast@kernel.org>
+Amir Goldstein <amir73il@gmail.com>
+Andrea Cervesato <andrea.cervesato@suse.com>
+Andreas Dilger <adilger@dilger.ca>
+Andrew Morton <akpm@linux-foundation.org>
+Andrew Morton <akpm@osdl.org>
+Andrew Persons <andrewscottpersons@gmail.com>
+Andrew Wock <ajwock@gmail.com>
+Anna Schumaker <anna.schumaker@netapp.com>
+Arnd Bergmann <arnd@arndb.de>
+Avinash Sonawane <rootkea@gmail.com>
+Axel Rasmussen <axelrasmussen@google.com>
+Benjamin Peterson <benjamin@python.org>
+Benoit Lecocq <benoit@openbsd.org>
+Bjarni Ingi Gislason <bjarniig@vortex.is>
+Brett Holman <bholman.devel@gmail.com>
+CIFS <linux-cifs@vger.kernel.org>
+Carlos O'Donell <carlos@redhat.com>
+Charan Teja Reddy <quic_charante@quicinc.com>
+Christian Aistleitner <christian@quelltextlich.at>
+Christian Brauner <brauner@kernel.org>
+Christoph Hellwig <hch@infradead.org>
+Cyril Hrubis <chrubis@suse.cz>
+Daniel Borkmann <daniel@iogearbox.net>
+Dave Chinner <dchinner@redhat.com>
+Dave Kemper <saint.snit@gmail.com>
+David Hildenbrand <david@redhat.com>
+David Howells <dhowells@redhat.com>
+David Laight <David.Laight@ACULAB.COM>
+David Sletten <david.paul.sletten@gmail.com>
+David Ward <david.ward@gatech.edu>
+Davide Benini <davide.benini@gmail.com>
+Donald Buczek <buczek@molgen.mpg.de>
+Elliott Hughes <enh@google.com>
+Eric Biggers <ebiggers@kernel.org>
+Eric Dumazet <edumazet@google.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Fabian <fabian@ritter-vogt.de>
+Florian Weimer <fweimer@redhat.com>
+GUO Zihua <guozihua@huawei.com>
+Gabriel Krisman Bertazi <krisman@collabora.com>
+Greg Banks <gbanks@linkedin.com>
+Greg Kroah-Hartman <gregkh@linuxfoundation.org>
+Grzegorz Szpetkowski <gszpetkowski@gmail.com>
+Günther Noack <guenther@unix-ag.uni-kl.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Huang Pei <huangpei@loongson.cn>
+Ian Abbott <abbotti@mev.co.uk>
+Ian Lance Taylor <iant@google.com>
+Ingo Schwarze <schwarze@openbsd.org>
+Jakub Sitnicki <jakub@cloudflare.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Jayprakash Ray <r.jay3283@gmail.com>
+JeanHeyd Meneide <wg14@soasis.org>
+Jeff Layton <jlayton@kernel.org>
+Jens Gustedt <jens.gustedt@inria.fr>
+Jeremy Kerr <jk@codeconstruct.com.au>
+Jesse Rosenstock <jmr@google.com>
+Joseph Myers <joseph@codesourcery.com>
+Kir Kolyshkin <kolyshkin@gmail.com>
+Klemens Nanni <kn@openbsd.org>
+Kuniyuki Iwashima <kuniyu@amazon.co.jp>
+Linus Torvalds <torvalds@linuxfoundation.org>
+Lucien Gentis <lucien.gentis@waika9.com>
+Luis Henriques <lhenriques@suse.de>
+Luis Lozano <llozano@chromium.org>
+Marco Bonelli <marco@mebeim.net>
+Masatake YAMATO <yamato@redhat.com>
+Matheus Tavares <matheus.bernardino@usp.br>
+Mathnerd314 <mathnerd314.gph@gmail.com>
+Matthew Bobrowski <repnop@google.com>
+Matthew Wilcox <willy@infradead.org>
+Melker Narikka <meklu@meklu.org>
+Michael Kearney <mikekearney85@hotmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mickaël Salaün <mic@linux.microsoft.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Kravetz <mike.kravetz@oracle.com>
+Mike Rapoport <rppt@linux.ibm.com>
+Miklos Szeredi <miklos@szeredi.hu>
+Nadav Amit <nadav.amit@gmail.com>
+NeilBrown <neilb@suse.de>
+Nicolas Boichat <drinkcat@chromium.org>
+Nikola Forró <nforro@redhat.com>
+Olga Kornievskaia <aglo@umich.edu>
+Oscar Salvador <osalvador@suse.de>
+Pali Rohár <pali@kernel.org>
+Pankaj Gupta <pankaj.gupta@ionos.com>
+Patrick Reader <_@pxeger.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Peter Xu <peterx@redhat.com>
+Petr Vorel <pvorel@suse.cz>
+Pádraig Brady <P@draigBrady.com>
+Quentin Monnet <quentin.monnet@netronome.com>
+Ralf Baechle <ralf@linux-mips.org>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Randall <rsbecker@nexbridge.com>
+Rich Felker <dalias@libc.org>
+Robert Schneider <robert.schneider03@sap.com>
+Rumen Telbizov <rumen.telbizov@menlosecurity.com>
+Sam James <sam@gentoo.org>
+Samanta Navarro <ferivoz@riseup.net>
+Sean Young <sean@mess.org>
+Simon Branch <simonmbranch@gmail.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Stephen Kitt <steve@sk2.org>
+Steve French <sfrench@samba.org>
+Suren Baghdasaryan <surenb@google.com>
+Theo de Raadt <deraadt@openbsd.org>
+Theodore Dubois <tbodt@google.com>
+Tilman Schmidt <tilman@imap.cc>
+Tobias Stoeckmann <tobias@stoeckmann.org>
+Topi Miettinen <toiwoton@gmail.com>
+Trevor Woerner <twoerner@gmail.com>
+Trond Myklebust <trond.myklebust@hammerspace.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vito Caputo <vcaputo@pengaru.com>
+Walter Harms <wharms@bfs.de>
+Wei Wang <weiwan@google.com>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Yuchung Cheng <ycheng@google.com>
+Zack Weinberg <zack@owlfolio.org>
+enh <enh@google.com>
+glibg10b <pugonfireyt@gmail.com>
+nick black <nickblack@linux.com>
+zhangkui <zhangkui@oppo.com>
+Ævar Arnfjörð Bjarmason <avarab@gmail.com>
+Štěpán Němec <stepnem@smrk.net>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man2/
+ landlock_add_rule.2
+ landlock_create_ruleset.2
+ landlock_restrict_self.2
+ memfd_secret.2
+
+man2type/
+ open_how.2type
+
+man3/
+ _Generic.3
+
+man3const/
+ NULL.3const
+
+man3head/
+ sysexits.h.3head
+
+man3type/
+ aiocb.3type
+ blkcnt_t.3type
+ blksize_t.3type
+ cc_t.3type
+ clock_t.3type
+ clockid_t.3type
+ dev_t.3type
+ div_t.3type
+ double_t.3type
+ epoll_event.3type
+ fenv_t.3type
+ id_t.3type
+ intN_t.3type
+ intmax_t.3type
+ intptr_t.3type
+ iovec.3type
+ itimerspec.3type
+ lconv.3type
+ mode_t.3type
+ off_t.3type
+ ptrdiff_t.3type
+ regex_t.3type
+ size_t.3type
+ sockaddr.3type
+ stat.3type
+ time_t.3type
+ timer_t.3type
+ timespec.3type
+ timeval.3type
+ tm.3type
+ va_list.3type
+ void.3type
+
+man7/
+ landlock.7
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+epoll_wait.2
+ epoll_pwait2(2)
+
+fanotify_init.2
+ FAN_REPORT_PIDFD
+
+fanotify_mark.2
+ FAN_FS_ERROR
+ FAN_MARK_EVICTABLE
+ FAN_RENAME
+ FAN_REPORT_TARGET_FID
+
+madvise.2
+ MADV_POPULATE_READ
+ MADV_POPULATE_WRITE
+
+pipe.2
+ O_NOTIFICATION_PIPE
+
+process_madvise.2
+ MADV_WILLNEED
+
+send.2
+ MSG_FASTOPEN
+
+userfaultfd.2
+ UFFD_USER_MODE_ONLY
+
+proc.5
+ /proc/[pid]/pagemap bit 57
+
+fanotify.7
+ /proc/sys/fs/fanotify/max_queued_events
+ /proc/sys/fs/fanotify/max_user_group
+ /proc/sys/fs/fanotify/max_user_marks
+
+tcp.7
+ TCP_FASTOPEN
+ TCP_FASTOPEN_CONNECT
+
+
+New and changed links
+---------------------
+
+man3/
+ strftime_l.3
+
+man3type/
+ epoll_data.3type
+ epoll_data_t.3type
+ fexcept_t.3type
+ float_t.3type
+ gid_t.3type
+ imaxdiv_t.3type
+ in6_addr.3type
+ in_addr.3type
+ in_addr_t.3type
+ in_port_t.3type
+ int16_t.3type
+ int32_t.3type
+ int64_t.3type
+ int8_t.3type
+ ldiv_t.3type
+ lldiv_t.3type
+ loff_t.3type
+ off64_t.3type
+ pid_t.3type
+ regmatch_t.3type
+ regoff_t.3type
+ sa_family_t.3type
+ sockaddr_in.3type
+ sockaddr_in6.3type
+ sockaddr_storage.3type
+ sockaddr_un.3type
+ socklen_t.3type
+ speed_t.3type
+ ssize_t.3type
+ suseconds_t.3type
+ tcflag_t.3type
+ uid_t.3type
+ uint16_t.3type
+ uint32_t.3type
+ uint64_t.3type
+ uint8_t.3type
+ uintN_t.3type
+ uintmax_t.3type
+ uintptr_t.3type
+ useconds_t.3type
+
+
+Global changes
+--------------
+
+- Man dirs:
+
+ - Move definitions of types to separate pages in man2type/ and
+ man3type/. Previously, they were spread (and duplicated) in other
+ pages, or in system_data_types.7 (with links in man3/).
+
+ - Add man3head/ for pages that document header files.
+
+ - Add man3const/ for pages that document constants.
+
+- Licenses:
+
+ - Use SPDX-License-Indentiffier for licenses specified by SPDX
+ (including the newly-added Linux-man-pages-copyleft). This reduces
+ the overhead text at the top of most manual page source files.
+ License texts have been moved to LICENSES/.
+
+- Build system:
+
+ - Add several make(1) targets to lint the manual pages, and also lint
+ and build the C programs contained in them. Use of these targets
+ requires unreleased versions of software, such as groff-1.23.0, so
+ it's not yet intended to be used by the public.
+
+ - Add targets to build tarballs of the repository.
+
+- man(7) source:
+
+ - Improve consistency of man(7) source. Also, reduce the number of
+ warnings that groff(1) and mandoc(7) emit when parsing the pages
+ with the highest warning level. Most of these fixes were found
+ thanks to the new `make lint-man` target.
+
+- Manual pages sections:
+
+ - Title (.TH):
+
+ - Remove 5th argument to TH (middle-header).
+
+ - Specify "Linux man-pages" and the version in the 4th argument
+ (left-footer).
+
+ - Add the LIBRARY section. This section standardizes a way to
+ document the library that provides a given interface.
+
+ - Add the CAVEATS section. BUGS and NOTES were serving that purpose
+ before, but CAVEATS is more appropriate.
+
+ - Rename the CONFORMING TO section to STANDARDS for consistency with
+ other projects, such as the BSDs.
+
+ - SYNOPSIS: Add the ISO C2X [[deprecated]] attribute for functions
+ that have been deprecated or removed.
+
+ - EXAMPLES: Improve consistency of C source code. Also, reduce the
+ number of warnings that several linting tools emit.
+
+ - COLOPHON: Remove section (its purpose is now served by the title).
+
+- Repository:
+
+ - CONTRIBUTING, README, INSTALL: Document important changes in the
+ project organization.
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.01 ====================
+
+Released: 2022-10-18, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+Agostino Sarubbo <ago@gentoo.org>
+Alejandro Colomar <alx@kernel.org>
+Amir Goldstein <amir73il@gmail.com>
+Darrick J. Wong <djwong@kernel.org>
+Eric Biggers <ebiggers@google.com>
+Grigoriy <grigoriyremvar@protonmail.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Matthew Bobrowski <repnop@google.com>
+Michael Tokarev <mjt@tls.msk.ru>
+Mike Gilbert <floppym@gentoo.org>
+Nicolás A. Ortega Froysa <nicolas@ortegas.org>
+Pierre Labastie <pierre.labastie@neuf.fr>
+Sam James <sam@gentoo.org>
+Steve Izma <sizma@golden.net>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+EOF.3const
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify_mark.2
+ FAN_MARK_IGNORE
+
+open.2, statx.2
+ STATX_DIOALIGN
+
+feature_test_macros.7
+ _FORTIFY_SOURCE=3
+ _TIME_BITS
+
+
+Global changes
+--------------
+
+- Build system:
+
+ - Update manual page dates (TH 3rd argument) when creating the tarball
+ with 'make dist'. This removes the need for a tstamp commit before
+ each release.
+
+ - Don't print spurious errors from the Makefile that are not relevant.
+
+- Manual pages' sections:
+
+ - Title (.TH):
+
+ - Remove the hardcoded date (TH 3rd argument), and replace it by a
+ placeholder that should be changed when creating the tarball.
+ This removes the need for a tstamp commit before each release.
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.02 ====================
+
+Released: 2022-12-22, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+1092615079 <1092615079@qq.com>
+Aaron Schrab <aaron@schrab.com>
+Agostino Sarubbo <ago@gentoo.org>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Alex Colomar <alx.manpages@gmail.com>
+Amir Goldstein <amir73il@gmail.com>
+Andrew Clayton <andrew@digital-domain.net>
+Andrew Pinski <pinskia@gmail.com>
+Andries E. Brouwer <aeb@cwi.nl>
+Darrick J. Wong <djwong@kernel.org>
+Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
+Eric Biggers <ebiggers@google.com>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Grigoriy <grigoriyremvar@protonmail.com>
+Grzegorz Szymaszek <gszymaszek@short.pl>
+Helge Kreutzmann <debian@helgefjell.de>
+Ian Abbott <abbotti@mev.co.uk>
+Iker Pedrosa <ipedrosa@redhat.com>
+Ingo Schwarze <schwarze@openbsd.org>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+JeanHeyd Meneide <wg14@soasis.org>
+Jun Ishiguro <algon.0320@gmail.com>
+Luca Versari <veluca93@gmail.com>
+Luis Javier Merino <ninjalj@gmail.com>
+Mario Blättermann <mario.blaettermann@gmail.com>
+Martin Sebor <msebor@redhat.com>
+Martin Uecker <uecker@tugraz.at>
+Matthew Bobrowski <repnop@google.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Tokarev <mjt@tls.msk.ru>
+Mike Frysinger <vapier@gentoo.org>
+Mike Gilbert <floppym@gentoo.org>
+Minchan Kim <minchan@kernel.org>
+Nicolás A. Ortega Froysa <nicolas@ortegas.org>
+Pali Rohár <pali@kernel.org>
+Pierre Labastie <pierre.labastie@neuf.fr>
+Sam James <sam@gentoo.org>
+Serge Hallyn <serge@hallyn.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Steve Izma <sizma@golden.net>
+Suren Baghdasaryan <surenb@google.com>
+Thomas Voss <mail@thomasvoss.com>
+Tycho Andersen <tycho@tycho.pizza>
+Xi Ruoyao <xry111@xry111.site>
+Zach O'Keefe <zokeefe@google.com>
+Zack Weinberg <zack@owlfolio.org>
+
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man3/
+ static_assert.3
+ strcpy.3
+ stpncpy.3
+ strncat.3
+
+man3const/
+ EOF.3const
+ EXIT_SUCCESS.3const
+
+man7/
+ string_copying.7
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ioctl_tty.2
+ TIOCSERGETLSR
+ TIOCSER_TEMT
+
+madvise.2
+ MADV_COLLAPSE
+
+syscall.2
+ loongarch
+
+
+New and changed links
+---------------------
+
+man3/
+ _Static_assert.3 (static_assert(3))
+ stpcpy.3 (strcpy(3))
+ strcat.3 (strcpy(3))
+ strncpy.3 (stpncpy(3))
+ stpecpy.3 (string_copying(7))
+ stpecpyx.3 (string_copying(7))
+ ustpcpy.3 (string_copying(7))
+ ustr2stp.3 (string_copying(7))
+ zustr2stp.3 (string_copying(7))
+ zustr2ustp.3 (string_copying(7))
+
+man3const/
+ EXIT_FAILURE.3const (EXIT_SUCCESS(3const))
+
+
+Global changes
+--------------
+
+- Use correct letter case in manual page titles, instead of uppercase.
+
+- Use \" t comments when appropriate (Lintian needs this).
+
+- SYNOPSIS:
+
+ - Add _Nullable for functions that receive NULL as a meaningful
+ input.
+
+ - Use VLA syntax to clarify the meaning of size parameters, rather
+ than hiding it in possibly-confusing text. This syntax is not
+ accepted by any compilers, though.
+
+ - Use [[noreturn]] instead of noreturn, which will be deprecated
+ soon.
+
+- Repository documentation:
+
+ - Added significant documentation about the repository and the
+ project in the root of the repository in different files.
+ Starting from the README, anyone passing by should be able to
+ understand how the project works and be directed to other
+ documentation files. These files also document the release
+ process.
+
+ - Michael has been busy lately, and he is no longer maintaining
+ the project. The in-repository documentation mentioned above has
+ been updated to reflect that.
+
+
+Changes to individual pages
+---------------------------
+
+copy_file_range.2
+ Fix wrong kernel version information
+
+process_madvise.2
+ Fix capability and ptrace requirements
+
+madvise.2
+ Update Transparent Huge Pages file/shmem documentation for
+ Linux 5.4+.
+
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.03 ====================
+
+Released: 2023-02-12, Xulilla
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+Aaron Peter Bachmann <aaron_ng@inode.at>
+Adhemerval Zanella <adhemerval.zanella@linaro.org>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Alex Colomar <alx.manpages@gmail.com>
+Arsen Arsenović <arsen@aarsen.me>
+Bernd Petrovitsch <bernd@petrovitsch.priv.at>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+Colin Cross <ccross@google.com>
+Cristian Rodríguez <crrodriguez@opensuse.org>
+Deri James <deri@chuzzlewit.myzen.co.uk>
+Elliott Hughes <enh@google.com>
+Eric Biggers <ebiggers@kernel.org>
+Florian Weimer <fweimer@redhat.com>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+Günther Noack <gnoack3000@gmail.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Ian Abbott <abbotti@mev.co.uk>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Engelhardt <jengelh@inai.de>
+"Jason A. Donenfeld" <Jason@zx2c4.com>
+Jonny Grant <jg@jguk.org>
+Joseph Myers <joseph@codesourcery.com>
+Kees Cook <keescook@chromium.org>
+Lennart Jablonka <humm@ljabl.com>
+Mario Blaettermann <mario.blaettermann@gmail.com>
+Mark Galeck <markgaleck@gmail.com>
+Namhyung Kim <namhyung@kernel.org>
+Nick Gregory <nick@nickgregory.me>
+Pasha Tatashin <tatashin@google.com>
+Paul Eggert <eggert@cs.ucla.edu>
+<Radisson97@gmx.de>
+Sam James <sam@gentoo.org>
+Samanta Navarro <ferivoz@riseup.net>
+"Serge E. Hallyn" <serge@hallyn.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Suren Baghdasaryan <surenb@google.com>
+Thomas Weißschuh <linux@weissschuh.net>
+Walter Harms <wharms@bfs.de>
+Wilco Dijkstra <Wilco.Dijkstra@arm.com>
+Zack Weinberg <zack@owlfolio.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man3/
+ arc4random.3
+ powerof2.3
+ roundup.3
+
+man3head/
+ printf.h.3head
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+perf_event_open.2
+ PERF_COUNT_SW_BPF_OUTPUT
+ PERF_COUNT_SW_CGROUP_SWITCHES
+ PERF_FORMAT_LOST
+ PERF_RECORD_MISC_MMAP_BUILD_ID
+ PERF_RECORD_MISC_SWITCH_OUT_PREEMPT
+ PERF_SAMPLE_CODE_PAGE_SIZE
+ PERF_SAMPLE_DATA_PAGE_SIZE
+ PERF_SAMPLE_WEIGHT_STRUCT
+
+ struct perf_event_attr::build_id
+ struct perf_event_attr::inherit_thread
+ struct perf_event_attr::remove_on_exec
+ struct perf_event_attr::sigtrap
+ struct perf_event_attr::aux_sample_size
+ struct perf_event_attr::sig_data
+
+ union perf_sample_weight
+
+ struct read_format::values[]::lost
+
+ struct::weight
+ struct::data_page_size
+ struct::code_page_size
+ struct::size
+ struct::data
+
+ struct:: ::build_id_size
+ struct:: ::build_id
+
+prctl.2
+ PR_SET_VMA
+ PR_SET_VMA_ANON_NAME
+
+
+New and changed links
+---------------------
+
+man3/
+ arc4random_buf.3 (arc4random(3))
+ arc4random_uniform.3 (arc4random(3))
+ register_printf_modifier.3 (printf.h(3head))
+ register_printf_specifier.3 (printf.h(3head))
+ register_printf_type.3 (printf.h(3head))
+
+man3const/
+ PA_CHAR.3const (printf.h(3head))
+ PA_DOUBLE.3const (printf.h(3head))
+ PA_FLAG_LONG.3const (printf.h(3head))
+ PA_FLAG_LONG_DOUBLE.3const (printf.h(3head))
+ PA_FLAG_LONG_LONG.3const (printf.h(3head))
+ PA_FLAG_PTR.3const (printf.h(3head))
+ PA_FLAG_SHORT.3const (printf.h(3head))
+ PA_FLOAT.3const (printf.h(3head))
+ PA_INT.3const (printf.h(3head))
+ PA_LAST.3const (printf.h(3head))
+ PA_POINTER.3const (printf.h(3head))
+ PA_STRING.3const (printf.h(3head))
+ PA_WCHAR.3const (printf.h(3head))
+ PA_WSTRING.3const (printf.h(3head))
+
+man3type/
+ printf_arginfo_size_function.3type (printf.h(3head))
+ printf_function.3type (printf.h(3head))
+ printf_info.3type (printf.h(3head))
+ printf_va_arg_function.3type (printf.h(3head))
+
+
+Global changes
+--------------
+
+- Build system:
+ - Add scripts to produce a book of the Linux man-pages.
+ - Add lint-c-cppcheck to the make(1) targets to run the cppcheck(1)
+ linter.
+
+- TH:
+ - Use correct letter case in page titles. This started in 6.02, but
+ there were still many cases left.
+
+- SYNOPSIS:
+ - Mark some functions as deprecated.
+
+- STANDARDS:
+ - Remove most references to ISO C89. We still document it in
+ standards(7), but it's an ancient language version that this
+ project
+ regards as obsolescent, so in the STANDARDS sections for APIs we
+ only take into account C99 and later and POSIX.1-2001 and later
+ (with few exceptions where older standards are relevant).
+
+- ffix:
+ - Change \- to - where appropriate
+ - Improve readability of numbers:
+ - Show BCD magic numbers that are meaningful in hex as hex,
+ rather than weird decimal numbers.
+ - Use IEC multipliers.
+ - Format ranges consistently using interval notation: [min, max].
+
+- srcfix:
+ - Use \[] escapes.
+
+
+Changes to individual pages
+---------------------------
+
+timespec.3type
+ Update tv_nsec according to C2x.
+
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.04 ====================
+
+Released: 2023-04-03, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Andrew Clayton <andrew@digital-domain.net>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+"Carlos O'Donell" <carlos@redhat.com>
+Christian Brauner <brauner@kernel.org>
+Christoph Lameter <cl@linux.com>
+Dmitry Goncharov <dgoncharov@users.sf.net>
+"Dmitry V. Levin" <ldv@strace.io>
+Elliott Hughes <enh@google.com>
+Elvira Khabirova <lineprinter0@gmail.com>
+Fotios Valasiadis <fvalasiad@gmail.com>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+Guy Shefy <guyshefyb@gmail.com>
+Günther Noack <gnoack3000@gmail.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Iker Pedrosa <ipedrosa@redhat.com>
+Jack Pearson <jack@pearson.onl>
+Jakub Wilk <jwilk@jwilk.net>
+Marco Bonelli <marco@mebeim.net>
+Matt Jolly <Matt.Jolly@footclan.ninja>
+Mickaël Salaün <mic@digikod.net>
+Nate Eldredge <nate@thatsmathematics.com>
+Oskari Pirhonen <xxc3ncoredxx@gmail.com>
+Patrick Reader <_@pxeger.com>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Smith <psmith@gnu.org>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Rodrigo Campos <rodrigo@sdfg.com.ar>
+Samanta Navarro <ferivoz@riseup.net>
+Serge Hallyn <serge@hallyn.com>
+Simon Horman <simon.horman@corigine.com>
+Timo Stark <t.stark@nginx.com>
+Tom Schwindl <schwindl@posteo.de>
+"Valentin V. Bartenev" <vbartenev@gmail.com>
+Vincent Lefevre <vincent@vinc17.net>
+Vladislav Ivanishin <vlad@ispras.ru>
+Willem de Bruijn <willemb@google.com>
+Wu Zhenyu <wuzhenyu@ustc.edu>
+Yedidyah Bar David <didi@redhat.com>
+Younes Manton <younes.m@gmail.com>
+<imachug@yandex.ru>
+<pabeni@redhat.com>
+
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+proc.5
+ KPF_PGTABLE (Linux 4.18)
+
+landlock.7
+ LANDLOCK_ACCESS_FS_REFER (Linux 5.19)
+ LANDLOCK_ACCESS_FS_TRUNCATE (Linux 6.02)
+
+udp.7
+ UDP_GRO (Linux 5.0)
+ UDP_SEGMENT (Linux 4.18)
+
+
+Global changes
+--------------
+
+- Sections:
+ - Add HISTORY.
+ - HISTORY: Restore C89 references.
+ - Repurpose VERSIONS.
+ - Simplify STANDARDS.
+ - SYNOPSIS: Mark several functions as deprecated.
+
+- Build system:
+ - Support installing in different mandirs
+ (e.g., man3typedir='/usr/share/man/man3').
+ - Support installing compressed pages (Z='.gz').
+ - Support installing link pages as symlinks (LINK_PAGES='symlink').
+ - Add make(1) 'check' target. This has been split from 'lint'.
+ 'lint' will check the source code, and 'check' will check the
+ rendered pages (as a user will read them). There are currently
+ several pages that fail this `make check`, and distributors that
+ depend on this can workaround it by touching a few files:
+
+ $ make check -k -j >/dev/null 2>/dev/null;
+ $ make check -k 2>/dev/null;
+ GREP .tmp/man/man1/memusage.1.check-catman.touch
+ TROFF .tmp/man/man2/fanotify_init.2.cat.set
+ TROFF .tmp/man/man2/gettimeofday.2.cat.set
+ TROFF .tmp/man/man2/s390_sthyi.2.cat.set
+ GREP .tmp/man/man3/mallopt.3.check-catman.touch
+ TROFF .tmp/man/man3/unlocked_stdio.3.cat.set
+ TROFF .tmp/man/man4/console_codes.4.cat.set
+ TROFF .tmp/man/man4/lirc.4.cat.set
+ GREP .tmp/man/man4/smartpqi.4.check-catman.touch
+ GREP .tmp/man/man4/veth.4.check-catman.touch
+ TROFF .tmp/man/man5/proc.5.cat.set
+ GREP .tmp/man/man5/slabinfo.5.check-catman.touch
+ TROFF .tmp/man/man5/tzfile.5.cat.set
+ TROFF .tmp/man/man7/address_families.7.cat.set
+ TROFF .tmp/man/man7/ascii.7.cat.set
+ TROFF .tmp/man/man7/bpf-helpers.7.cat.set
+ GREP .tmp/man/man7/keyrings.7.check-catman.touch
+ GREP .tmp/man/man7/uri.7.check-catman.touch
+ TROFF .tmp/man/man8/tzselect.8.cat.set
+ TROFF .tmp/man/man8/zdump.8.cat.set
+ TROFF .tmp/man/man8/zic.8.cat.set
+
+ After touching the previous files, `make check` will succeed:
+
+ $ make check -k 2>/dev/null | awk '{print $2}' | xargs touch;
+ $ make check -j >/dev/null;
+ $ echo $?
+ 0
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.05 ====================
+
+Released: 2023-08-01, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+"David S. Miller" <davem@davemloft.net>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+A. Wilcox <AWilcox@wilcox-tech.com>
+Adam Dobes <adobes@redhat.com>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alan Cox <alan@llwyncelyn.cymru>
+Alejandro Colomar <alx@kernel.org>
+Alexei Starovoitov <ast@kernel.org>
+Andreas Schwab <schwab@suse.de>
+Andrew Clayton <andrew@digital-domain.net>
+Andrew Morton <akpm@linux-foundation.org>
+Avinesh Kumar <akumar@suse.de>
+Bastien Roucariès <rouca@debian.org>
+Bjarni Ingi Gislason <bjarniig@simnet.is>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+Bruno Haible <bruno@clisp.org>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Colin Watson <cjwatson@debian.org>
+Cyril Hrubis <chrubis@suse.cz>
+DJ Delorie <dj@redhat.com>
+Daniel Verkamp <daniel@drv.nu>
+David Howells <dhowells@redhat.com>
+Dirk Gouders <dirk@gouders.net>
+Dmitry Goncharov <dgoncharov@users.sf.net>
+Eli Zaretskii <eliz@gnu.org>
+Elliott Hughes <enh@google.com>
+Eric Biggers <ebiggers@google.com>
+Eric Blake <eblake@redhat.com>
+Eric Wong <e@80x24.org>
+Fangrui Song <maskray@google.com>
+Florian Weimer <fweimer@redhat.com>
+Gavin Smith <gavinsmith0123@gmail.com>
+Guillem Jover <guillem@hadrons.org>
+Günther Noack <gnoack@google.com>
+Helge Kreutzmann <debian@helgefjell.de>
+Igor Sysoev <igor@sysoev.ru>
+Ingo Schwarze <schwarze@openbsd.org>
+Jakub Jelinek <jakub@redhat.com>
+Jakub Sitnicki <jakub@cloudflare.com>
+Jakub Wilk <jwilk@jwilk.net>
+Johannes Weiner <hannes@cmpxchg.org>
+John Gilmore <gnu@toad.com>
+John Hubbard <jhubbard@nvidia.com>
+John Scott <jscott@posteo.net>
+Jonathan Corbet <corbet@lwn.net>
+Jonathan Wakely <jwakely@redhat.com>
+Joseph Myers <joseph@codesourcery.com>
+Josh Triplett <josh@joshtriplett.org>
+Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
+Larry McVoy <lm@mcvoy.com>
+Lennart Jablonka <humm@ljabl.com>
+Linus Heckemann <git@sphalerite.org>
+Lukas Javorsky <ljavorsk@redhat.com>
+Marcos Fouces <marcos@debian.org>
+Mario Blaettermann <mario.blaettermann@gmail.com>
+Martin (Joey) Schulze <joey@infodrom.org>
+Masami Hiramatsu <mhiramat@kernel.org>
+Masatake YAMATO <yamato@redhat.com>
+Matthew House <mattlloydhouse@gmail.com>
+Matthew Wilcox (Oracle) <willy@infradead.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michael Weiß <michael.weiss@aisec.fraunhofer.de>
+Mickaël Salaün <mic@digikod.net>
+Mike Frysinger <vapier@gentoo.org>
+Mike Kravetz <mike.kravetz@oracle.com>
+Mingye Wang <arthur200126@gmail.com>
+Nadav Amit <namit@vmware.com>
+Nick Desaulniers <ndesaulniers@google.com>
+Oskari Pirhonen <xxc3ncoredxx@gmail.com>
+Paul E. McKenney <paulmck@kernel.org>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Floyd <pjfloyd@wanadoo.fr>
+Paul Smith <psmith@gnu.org>
+Philip Guenther <guenther@gmail.com>
+Ralph Corderoy <ralph@inputplus.co.uk>
+Reuben Thomas <rrt@sc3d.org>
+Rich Felker <dalias@libc.org>
+Richard Biener <richard.guenther@gmail.com>
+Sam James <sam@gentoo.org>
+Serge Hallyn <serge@hallyn.com>
+Seth David Schoen <schoen@loyalty.org>
+Siddhesh Poyarekar <siddhesh@gotplt.org>
+Simon Horman <simon.horman@corigine.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Steffen Nurpmeso <steffen@sdaoden.eu>
+Szabolcs Nagy <nsz@port70.net>
+Thomas Weißschuh <thomas@t-8ch.de>
+Tom Schwindl <schwindl@posteo.de>
+Tomáš Golembiovský <tgolembi@redhat.com>
+Torbjorn SVENSSON <torbjorn.svensson@foss.st.com>
+Ulrich Drepper <drepper@redhat.com>
+Vahid Noormofidi <vnoormof@nvidia.com>
+Vlastimil Babka <vbabka@suse.cz>
+Wilco Dijkstra <Wilco.Dijkstra@arm.com>
+Xi Ruoyao <xry111@xry111.site>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Yedidyah Bar David <didi@redhat.com>
+Zack Weinberg <zack@owlfolio.org>
+Zijun Zhao <zijunzhao@google.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man2/
+ ioctl_pipe.2
+
+man3/
+ regex.3
+
+man5/
+ erofs.5
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+bpf.2
+ EAGAIN
+
+ioctl_userfaultfd.2
+ UFFD_FEATURE_EXACT_ADDRESS
+
+prctl.2
+ PR_GET_AUXV
+
+recv.2
+ MSG_CMSG_CLOEXEC
+
+statx.2
+ STAT_ATTR_MOUNT_ROOT
+
+syscall.2
+ ENOSYS
+
+resolv.conf.5
+ no-aaaa
+ RES_NOAAAA
+
+tmpfs.5
+ CONFIG_TRANSPARENT_HUGEPAGE
+
+ip.7
+ IP_LOCAL_PORT_RANGE
+
+rtnetlink.7
+ IFLA_PERM_ADDRESS
+
+
+New and changed links
+---------------------
+
+man3type/
+ regex_t.3type (regex(3))
+ regmatch_t.3type (regex(3))
+ regoff_t.3type (regex(3))
+
+
+Global changes
+--------------
+
+- Types:
+ - Document functions using off64_t as if they used off_t (except
+ for lseek64()).
+
+- Build system:
+ - Keep file modes in the release tarball.
+ - Fix symlink installation (`make install LINK_PAGES=symlink`).
+ - Add support for using bzip2(1), lzip(1), and xz(1) when installing
+ pages and creating release tarballs.
+ - Create reproducible release tarballs.
+ - Move makefiles from lib/ to share/mk/.
+ - Support mdoc(7) pages.
+ - Relicense Makefiles as GPL-3.0-or-later.
+ - Build PostScript and PDF manual pages.
+ - Add support for running our build system on arbitrary source
+ trees; this makes it possible to easily run our linters on another
+ project's manual pages as easily as `make lint MANDIR=~/src/groff`
+
+- Licenses:
+ - Relicense ddp.7 from VERBATIM_ONE_PARA to Linux-man-pages-copyleft.
+ - Relicense dir_colors.5 from LDPv1 to GPL-2.0-or-later.
+ - Use new SPDX license identifiers:
+ - Linux-man-pages-1-para (was VERBATIM_ONE_PARA)
+ - Linux-man-pages-copyleft-2-para (was VERBATIM_TWO_PARA)
+ - Linux-man-pages-copyleft-var (was VERBATIM_PROF)
+
+- ffix:
+ - use `\%`
+ - un-bracket tbl(1) tables
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.06 ====================
+
+Released: 2024-02-12, Aldaya
+
+
+Contributors
+------------
+
+The following people contributed patches/fixes, reports, notes,
+ideas, and discussions that have been incorporated in changes in
+this release:
+
+"G. Branden Robinson" <branden@debian.org>
+"G. Branden Robinson" <g.branden.robinson@gmail.com>
+"Huang, Ying" <ying.huang@intel.com>
+"Serge E. Hallyn" <serge@hallyn.com>
+Adhemerval Zanella Netto <adhemerval.zanella@linaro.org>
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx@kernel.org>
+Alexander Kozhevnikov <mentalisttraceur@gmail.com>
+Alexey Tikhonov <atikhono@redhat.com>
+Amir Goldstein <amir73il@gmail.com>
+Andreas Schwab <schwab@issan.informatik.uni-dortmund.de>
+Andreas Schwab <schwab@linux-m68k.org>
+Andreas Schwab <schwab@suse.de>
+Andriy Utkin <andriy_utkin@fastmail.com>
+Arnav Rawat <rawat.arnav@gmail.com>
+Arnd Bergmann <arnd@arndb.de>
+Aurelien Jarno <aurel32@debian.org>
+Avinesh Kumar <akumar@suse.de>
+Axel Rasmussen <axelrasmussen@google.com>
+Brian Inglis <Brian.Inglis@Shaw.ca>
+Bruno Haible <bruno@clisp.org>
+Carlos O'Donell <carlos@redhat.com>
+Catalin Marinas <catalin.marinas@arm.com>
+Christian Brauner <brauner@kernel.org>
+Christopher Lameter <cl@os.amperecomputing.com>
+Colin Watson <cjwatson@debian.org>
+DJ Delorie <dj@redhat.com>
+David Mosberger <davidm@hpl.hp.com>
+Deri James <deri@chuzzlewit.myzen.co.uk>
+Don Brace <don.brace@microchip.com>
+Elliott Hughes <enh@google.com>
+Florent Revest <revest@chromium.org>
+Florian Lehner <dev@der-flo.net>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Geoff Keating <geoffk@ozemail.com.au>
+Gobinda Das <godas@redhat.com>
+Greg Kroah-Hartman <gregkh@linuxfoundation.org>
+Guillem Jover <guillem@hadrons.org>
+Guo Ren <guoren@kernel.org>
+Guo Ren <guoren@linux.alibaba.com>
+Günther Noack <gnoack@google.com>
+Hanno Böck <hanno@hboeck.de>
+Helge Kreutzmann <debian@helgefjell.de>
+Iker Pedrosa <ipedrosa@redhat.com>
+Ingo Schwarze <schwarze@openbsd.org>
+Ingo Schwarze <schwarze@usta.de>
+Jakub Jelinek <jakub@redhat.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Engelhardt <jengelh@inai.de>
+Jan Kara <jack@suse.cz>
+John Watts <contact@jookia.org>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Kees Cook <keescook@chromium.org>
+Kevin Barnett <kevin.barnett@microchip.com>
+Kuniyuki Iwashima <kuniyu@amazon.com>
+Lee Griffiths <poddster@gmail.com>
+Luis Chamberlain <mcgrof@kernel.org>
+Maciej Żenczykowski <maze@google.com>
+Mario Blaettermann <mario.blaettermann@gmail.com>
+Matthew House <mattlloydhouse@gmail.com>
+Matthias Gerstner <matthias.gerstner@suse.com>
+Max Kellermann <max.kellermann@ionos.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Miguel de Icaza <miguel@nuclecu.unam.mx>
+Mike McGowen <mike.mcgowen@microchip.com>
+Mike Rapoport (IBM) <rppt@kernel.org>
+Morten Welinder <mwelinder@gmail.com>
+Muhammad Usama Anjum <usama.anjum@collabora.com>
+Oskari Pirhonen <xxc3ncoredxx@gmail.com>
+Patch by Xavier Leroy <Xavier.Leroy@inria.fr>.
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Smith <psmith@gnu.org>
+Peter Xu <peterx@redhat.com>
+Petr Vorel <pvorel@suse.cz>
+Philip Blundell <pb@nexus.co.uk>
+Renzo Davoli <renzo@cs.unibo.it>
+Reported by Ralf Corsepius <corsepiu@faw.uni-ulm.de>.
+Reported by Sam Roberts <sroberts@uniserve.com>.
+Richard Henderson <richard@gnu.ai.mit.edu>
+Richard Henderson <rth@cygnus.com>
+Richard Henderson <rth@tamu.edu>
+Rik van Riel <riel@surriel.com>
+Roland McGrath <roland@gnu.org>
+Sam James <sam@gentoo.org>
+Sambit Nayak <sambitnayak@gmail.com>
+Samuel Thibault <samuel.thibault@ens-lyon.org>
+Sargun Dhillon <sargun@sargun.me>
+Sascha Grunert <saschagrunert@gmail.com>
+Sascha Grunert <sgrunert@redhat.com>
+Scott Benesh <scott.benesh@microchip.com>
+Scott Teel <scott.teel@microchip.com>
+Serge Hallyn <serge@hallyn.com>
+Sergei Gromeniuk <sgromeni@redhat.com>
+Shahab Ouraie <shahabouraie@gmail.com>
+Shani Leviim <sleviim@redhat.com>
+Stefan Puiu <stefan.puiu@gmail.com>
+Thorsten Kukuk <kukuk@suse.com>
+Tom Schwindl <schwindl@posteo.de>
+Tomáš Golembiovský <tgolembi@redhat.com>
+Ulrich Drepper <drepper@cygnus.com>
+Ulrich Drepper <drepper@redhat.com>
+Wolfram Gloger <wg@wolfram.dent.med.uni-muenchen.de>
+Wolfram Gloger <wmglo@dent.med.uni-muenchen.de>
+Xavier Leroy <Xavier.Leroy@inria.fr>
+Xi Ruoyao <xry111@xry111.site>
+Yafang Shao <laoar.shao@gmail.com>
+Yang Xu <xuyang2018.jy@fujitsu.com>
+Zack Weinberg <zack@owlfolio.org>
+Štěpán Němec <stepnem@smrk.net>
+Дилян Палаузов <dilyan.palauzov@aegee.org>
+наб <nabijaczleweli@nabijaczleweli.xyz>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+man2/
+ ioctl_pagemap_scan.2
+
+man3/ (taken from glibc's linuxthreads)
+ pthread_cond_init.3
+ pthread_condattr_init.3
+ pthread_key_create.3
+ pthread_mutex_init.3
+ pthread_mutexattr_setkind_np.3
+ pthread_once.3
+
+man5/
+ proc.5 (split into many small pages)
+ proc_apm.5
+ proc_buddyinfo.5
+ proc_bus.5
+ proc_cgroups.5
+ proc_cmdline.5
+ proc_config.gz.5
+ proc_cpuinfo.5
+ proc_crypto.5
+ proc_devices.5
+ proc_diskstats.5
+ proc_dma.5
+ proc_driver.5
+ proc_execdomains.5
+ proc_fb.5
+ proc_filesystems.5
+ proc_fs.5
+ proc_ide.5
+ proc_interrupts.5
+ proc_iomem.5
+ proc_ioports.5
+ proc_kallsyms.5
+ proc_kcore.5
+ proc_key-users.5
+ proc_keys.5
+ proc_kmsg.5
+ proc_kpagecgroup.5
+ proc_kpagecount.5
+ proc_kpageflags.5
+ proc_ksyms.5
+ proc_loadavg.5
+ proc_locks.5
+ proc_malloc.5
+ proc_meminfo.5
+ proc_modules.5
+ proc_mtrr.5
+ proc_partitions.5
+ proc_pci.5
+ proc_pid.5
+ proc_pid_attr.5
+ proc_pid_autogroup.5
+ proc_pid_auxv.5
+ proc_pid_cgroup.5
+ proc_pid_clear_refs.5
+ proc_pid_cmdline.5
+ proc_pid_comm.5
+ proc_pid_coredump_filter.5
+ proc_pid_cpuset.5
+ proc_pid_cwd.5
+ proc_pid_environ.5
+ proc_pid_exe.5
+ proc_pid_fd.5
+ proc_pid_fdinfo.5
+ proc_pid_io.5
+ proc_pid_limits.5
+ proc_pid_map_files.5
+ proc_pid_maps.5
+ proc_pid_mem.5
+ proc_pid_mountinfo.5
+ proc_pid_mounts.5
+ proc_pid_mountstats.5
+ proc_pid_net.5
+ proc_pid_ns.5
+ proc_pid_numa_maps.5
+ proc_pid_oom_score.5
+ proc_pid_oom_score_adj.5
+ proc_pid_pagemap.5
+ proc_pid_personality.5
+ proc_pid_projid_map.5
+ proc_pid_root.5
+ proc_pid_seccomp.5
+ proc_pid_setgroups.5
+ proc_pid_smaps.5
+ proc_pid_stack.5
+ proc_pid_stat.5
+ proc_pid_statm.5
+ proc_pid_status.5
+ proc_pid_syscall.5
+ proc_pid_task.5
+ proc_pid_timers.5
+ proc_pid_timerslack_ns.5
+ proc_pid_uid_map.5
+ proc_pid_wchan.5
+ proc_profile.5
+ proc_scsi.5
+ proc_slabinfo.5
+ proc_stat.5
+ proc_swaps.5
+ proc_sys.5
+ proc_sys_abi.5
+ proc_sys_debug.5
+ proc_sys_dev.5
+ proc_sys_fs.5
+ proc_sys_kernel.5
+ proc_sys_net.5
+ proc_sys_proc.5
+ proc_sys_sunrpc.5
+ proc_sys_user.5
+ proc_sys_vm.5
+ proc_sysrq-trigger.5
+ proc_sysvipc.5
+ proc_tid_children.5
+ proc_timer_list.5
+ proc_timer_stats.5
+ proc_tty.5
+ proc_uptime.5
+ proc_version.5
+ proc_vmstat.5
+ proc_zoneinfo.5
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+man2/
+ access.2
+ AT_EMPTY_PATH
+
+ execve.2
+ E2BIG
+
+ ioctl_userfaultfd.2
+ UFFDIO_API handshake
+ UFFDIO_POISON
+ UFFD_FEATURE_WP_ASYNC
+
+ mbind.2
+ MPOL_F_NUMA_BALANCING
+
+ prctl.2
+ PR_SET_MDWE
+ PR_GET_MDWE
+
+ set_thread_area.2
+ C-SKY
+
+ utimensat.2
+ AT_EMPTY_PATH
+
+man3/
+ stdio.3
+ fmemopen(3)
+ fopencookie(3)
+ open_memstream(3)
+ open_wmemstream(3)
+
+man4/
+ smartpqi.4
+ ctrl_ready_timeout
+ enable_stream_detection
+ ssd_smart_path_enabled
+ enable_r5_writes
+ enable_r6_writes
+ lunid
+ unique_id
+ path_info
+ raid_bypass_cnt
+ sas_ncq_prio_enable
+
+man5/
+ proc_pid_status.5 (previously, proc.5)
+ Seccomp_filters
+
+ tmpfs.5
+ size/blocks=0
+ nr_inodes=0
+
+man8/
+ ld.so.8
+ --list-diagnostics
+ --glibc-hwcaps-mask
+ --glibc-hwcaps-prepend
+
+
+New and changed links
+---------------------
+
+man5/
+ proc_mounts.5 (proc_pid_mounts(5))
+ proc_net.5 (proc_pid_net(5))
+ proc_pid_gid_map.5 (proc_pid_uid_map(5))
+ proc_pid_oom_adj.5 (proc_pid_oom_score_adj(5))
+ proc_self.5 (proc_pid(5))
+ proc_thread-self.5 (proc_pid_task(5))
+ proc_tid.5 (proc_pid_task(5))
+
+
+Removed links
+-------------
+
+man3/
+ stpecpy.3
+ stpecpyx.3
+ ustpcpy.3
+ ustr2stp.3
+ zustr2stp.3
+ zustr2ustp.3
+
+
+Global changes
+--------------
+
+- Build system
+ - Update PDF book for groff-1.23.0.
+ - Add targets to [un]install intro(*) pages separately.
+ - Support manual pages in other projects, so that our build system
+ can be used to for example lint them.
+ - Reject non-GNU make(1).
+ - Add target to build the PDF book.
+
+- man*/
+ - Add some consistency in the use of man(7).
+ - Split proc(5) into many small pages.
+ - Import pages from old linuxthreads (glibc), with their git
+ history (from both glibc and Debian).
+ - Rewrite a large part of the documentation for string-copying
+ functions.
+ - Say ISO/IEC instead of ISO where appropriate, and be consistent in
+ the formatting of names of ISO or ISO/IEC standards.
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, use git(1).
+
+
+==================== Changes in man-pages-6.7 =====================
+
+Released: 2024-03-19, València
+
+
+New and rewritten pages
+-----------------------
+
+man3/
+ TIMEVAL_TO_TIMESPEC.3
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+man2/
+ process_madvise.2
+ process_madvise() glibc wrapper
+
+
+New and changed links
+---------------------
+
+man3/
+ TIMESPEC_TO_TIMEVAL.3 (TIMEVAL_TO_TIMESPEC(3))
+
+
+Global changes
+--------------
+
+- Build system
+ - Reorganize build system
+ - Clarify dependencies
+ - Clarify configurable variables
+ - Add 'distcheck' target
+ - Ignore known warnings
+ - Replace uses of man2html(1) by grohtml(1)
+
+
+Changes to individual pages
+---------------------------
+
+The manual pages (and other files in the repository) have been improved
+beyond what this changelog covers. To learn more about changes applied
+to individual pages, or the authors of changes, use git(1).
projects / thirdparty / man-pages.git / blobdiff