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
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 the
+ the eUID and fsUID in parallel, and more clearly hint at the
historical rationale for the fsUID, which is detailed lower in
the page.
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 <colomar.6.4.3@gmail.com>
+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