diff --git a/Changes b/Changes index 762939a68..f6e97accb 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-4.14 ==================== +==================== Changes in man-pages-4.15 ==================== -Released: 2017-11-27, Paris +Released: ????-??-??, Munich Contributors @@ -10,77 +10,6 @@ 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 -Adrian Bunk -Ahmad Fatoum -Andrea Arcangeli -Bastien Roucaries -Breno Leitao -Carlos O'Donell -Christian Brauner -Christoph Hellwig -Colm MacCárthaigh -Craig Ringer -Cristian Rodríguez -David Eckardt -Don Brace -Elliot Hughes -Eric W. Biederman -Fabio Scotoni -Fangrui Song -Florian Weimer -G. Branden Robinson -Goldwyn Rodrigues -Grégory Vander Schueren -Jakub Wilk -Jann Horn -Jeff Layton -Jens Axboe -Jonny Grant -Julien Gomes -Kees Cook -Křištof Želechovski -Lennart Poettering -Lucas Werkmeister -Marcus Folkesson -Marin H. -Mathieu Desnoyers -Matthew Wilcox -Michael Kerrisk -Michal Hocko -Michał Zegan -Mihir Mehta -Mike Frysinger -Mike Kravetz -Mike Rapoport -Miklos Szeredi -NeilBrown -Oliver Ebert -Pedro Alves -Per Böhlin -Peter Zijlstra -Petr Malat -Petr Uzel -Prakash Sangappa -Raghavendra D Prabhu -Rahul Bedarkar -Ram Pai -Richard Knutsson -Rik van Riel -Scott Vokes -Seonghun Lim -Stas Sergeev -Stefan Puiu -Thomas Gleixner -Tobias Klausmann -Tomas Pospisek -Tyler Hicks -Victor Porton -Walter Harms -Wesley Aptekar-Cassels -Yubin Ruan -Zack Weinberg -Дилян Палаузов Apologies if I missed anyone! @@ -88,728 +17,19 @@ 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 document 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." ("confere"), which means "compare", - to mean "see" instead, for which the Latin abbreviation would be - 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 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 and 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 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 - -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 ALO: 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//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". diff --git a/Changes.old b/Changes.old index cfeb673fc..f7c951bf1 100644 --- a/Changes.old +++ b/Changes.old @@ -46395,3 +46395,820 @@ tcp.7 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 +Adrian Bunk +Ahmad Fatoum +Andrea Arcangeli +Bastien Roucaries +Breno Leitao +Carlos O'Donell +Christian Brauner +Christoph Hellwig +Colm MacCárthaigh +Craig Ringer +Cristian Rodríguez +David Eckardt +Don Brace +Elliot Hughes +Eric W. Biederman +Fabio Scotoni +Fangrui Song +Florian Weimer +G. Branden Robinson +Goldwyn Rodrigues +Grégory Vander Schueren +Jakub Wilk +Jann Horn +Jeff Layton +Jens Axboe +Jonny Grant +Julien Gomes +Kees Cook +Křištof Želechovski +Lennart Poettering +Lucas Werkmeister +Marcus Folkesson +Marin H. +Mathieu Desnoyers +Matthew Wilcox +Michael Kerrisk +Michal Hocko +Michał Zegan +Mihir Mehta +Mike Frysinger +Mike Kravetz +Mike Rapoport +Miklos Szeredi +NeilBrown +Oliver Ebert +Pedro Alves +Per Böhlin +Peter Zijlstra +Petr Malat +Petr Uzel +Prakash Sangappa +Raghavendra D Prabhu +Rahul Bedarkar +Ram Pai +Richard Knutsson +Rik van Riel +Scott Vokes +Seonghun Lim +Stas Sergeev +Stefan Puiu +Thomas Gleixner +Tobias Klausmann +Tomas Pospisek +Tyler Hicks +Victor Porton +Walter Harms +Wesley Aptekar-Cassels +Yubin Ruan +Zack Weinberg +Дилян Палаузов + +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 document 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." ("confere"), which means "compare", + to mean "see" instead, for which the Latin abbreviation would be + + +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 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 and 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 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 + +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 ALO: 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//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".