From 8b894afd0d87d2374ffd6c0797d9dbabf4b44ef0 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 3 May 2017 19:45:57 +0200 Subject: [PATCH] Start of man-pages-4.12: updating Changes and Changes.old --- Changes | 526 +----------------------------------------------- Changes.old | 559 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 561 insertions(+), 524 deletions(-) diff --git a/Changes b/Changes index 53ccb9d5c..e59876115 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-4.11 ==================== +==================== Changes in man-pages-4.12 ==================== -Released: 2017-05-03, Baden, Switzerland +Released: ????-??-??, Munich Contributors @@ -10,41 +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: -Alexander Alemayhu -Alexander Miller -Andrea Arcangeli -Andreas Dilger -Andrew Clayton -Arnd Bergmann -Ben Dog -Carlos O'Donell -Chema Gonzalez -Christian Brauner -Cyril Hrubis -David Howells -Dmitry V. Levin -Florian Weimer -Francois Saint-Jacques -Frank Theile -Georg Sauthoff -Ian Abbott -Jakub Wilk -Jan Heberer -Marcin Ślusarz -Marko Myllynen -Matthew Wilcox -Michael Kerrisk -Mike Frysinger -Mike Rapoport -Nicolas Biscos -Nicolas Iooss -Nikos Mavrogiannopoulos -Nominal Animal -Silvan Jegen -Stephan Bergmann -Walter Harms -Zack Weinberg -丁贵强 Apologies if I missed anyone! @@ -52,506 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -ioctl_userfaultfd.2 - Michael Kerrisk, Mike Rapoport - New page describing ioctl(2) operations for userfaultfd - -statx.2 - David Howells, Michael Kerrisk [Andreas Dilger] - New page describing statx(2) system call added in Linux 4.11 - -userfaultfd.2 - Mike Rapoport, Michael Kerrisk [Andrea Arcangeli] - New page describing userfaultfd(2) system call. - -pthread_atfork.3 - Michael Kerrisk - New page describing pthread_atfork(3) - -slabinfo.5 - Michael Kerrisk - Rewrite to try to bring the content close to current reality - There's still gaps to fill in, but the existing page - was in any case hugely out of date. - -inode.7 - Michael Kerrisk - New page with information about inodes - David Howells provided a statx(2) page that duplicated much of - the information from form stat(2). Avoid such duplication - by moving the common information in stat(2) and statx(2) - to a new page. - - -Renamed pages --------------- - -ioctl_console.2 - Michael Kerrisk - Renamed from console_ioctl.4 - Most ioctl() man pages are in section 2, so move this one there - for consistency. - Michael Kerrisk - Note type of 'argp' for a various operations - For some commands, there was no clear statement about the type - of the 'argp' argument. - -ioctl_tty.2 - Michael Kerrisk - Renamed from tty_ioctl(4) - All other ioctl(2) pages are in section 2. Make this - page consistent. - Michael Kerrisk - Packet mode state change events give POLLPRI events for poll(2) - Newly documented interfaces in existing pages --------------------------------------------- -ioctl_ns.2 - Michael Kerrisk - Document the NS_GET_NSTYPE operation added in Linux 4.11 - Michael Kerrisk - Document the NS_GET_OWNER_UID operation added in Linux 4.11 - -proc.5 - Michael Kerrisk - Document /proc/sys/kernel/sched_child_runs_first - New and changed links --------------------- -console_ioctl.4 - Michael Kerrisk - Link for old name of ioctl_console(2) page - -tty_ioctl.4 - Michael Kerrisk - Link for old name of ioctl_tty(2) page - Global changes -------------- -Various pages - Michael Kerrisk - Change page cross-references from tty_ioctl(4) to ioctl_tty(2) - Michael Kerrisk - Change page cross-references for console_ioctl(4) to ioctl_console(2) - Changes to individual pages --------------------------- -alarm.2 - Michael Kerrisk - SEE ALSO: add timer_create(2) and timerfd_create(2) - -chmod.2 -fsync.2 -mkdir.2 -mknod.2 -open.2 -truncate.2 -umask.2 -utime.2 -utimensat.2 - Michael Kerrisk - Add/replace references to inode(7) - -clone.2 - Michael Kerrisk - CLONE_NEWCGROUP by an unprivileged process also causes an EPERM error - -clone.2 -unshare.2 - Michael Kerrisk - Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC - Michael Kerrisk - CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached - Michael Kerrisk - Exceeding the maximum nested user namespace limit now gives ENOSPC - Formerly, if the limit of 32 nested user namespaces was exceeded, - the error EUSERS resulted. Starting with Linux 4.9, the error - is ENOSPC. - -epoll_ctl.2 - Michael Kerrisk - Defer to poll(2) for an explanation of EPOLLIN - Michael Kerrisk [Nicolas Biscos] - EPOLLERR is also set on write end of a pipe when the read end is closed - Michael Kerrisk [Nicolas Biscos] - Give the reader a clue that the 'events' field can be zero - 'events' specified as zero still allows EPOLLHUP and - EPOLLERR to be reported. - -_exit.2 - Michael Kerrisk - On exit, child processes may be inherited by a "subreaper" - It is no longer necessarily true that orphaned processes - are inherited by PID 1. - Michael Kerrisk - Only the least significant byte of exit status is passed to the parent - -fcntl.2 - Michael Kerrisk - Mention memfd_create() in the discussion of file seals - Give the reader a clue about what kinds of objects can - be employed with file seals. - Michael Kerrisk - File seals are not generally applicable to tmpfs(5) files - As far as I can see, file seals can be applied only to - memfd_create(2) file descriptors. This was checked by experiment - and by reading mm/shmem.c::shmem_get_inode((), where one finds - the following line that applies to all new shmem files: - - info->seals = F_SEAL_SEAL; - - Only in the code of the memfd_create() system call is this - setting reversed (in mm/shmem.c::memfd_create): - - if (flags & MFD_ALLOW_SEALING) - info->seals &= ~F_SEAL_SEAL; - -fork.2 - Michael Kerrisk - SEE ALSO: add pthread_atfork(3) - -getdents.2 -open.2 -stat.2 -statx.2 - Michael Kerrisk - SEE ALSO: add inode(7) - -getdtablesize.2 -attr.5 - Alexander Miller - Move .so directive to first line - Improves compatibility with the man and other dumb tools - that process man page files. - -getpid.2 - Michael Kerrisk - Mention init(1) and "subreapers" in discussion of parent PID - -ioctl_list.2 - Cyril Hrubis [Arnd Bergmann] - BLKRASET/BLKRAGET take unsigned long - -ioctl_ns.2 - Michael Kerrisk - ERRORS: document ENOTTY - -kexec_load.2 -sched_setaffinity.2 -bootparam.7 - Michael Kerrisk - Documentation/kernel-parameters.txt is now in Documentation/admin-guide/ - -lseek.2 - Michael Kerrisk - SEE ALSO: add fallocate(2) - Both of these pages discuss file holes. - -mincore.2 - Michael Kerrisk - SEE ALSO: add fincore(1) - -mmap.2 - Michael Kerrisk - Remove ancient reference to flags that appear on some other systems - MAP_AUTOGROW, MAP_AUTORESRV, MAP_COPY, and MAP_LOCAL may have - appeared on some systems many years ago, but the discussion here - mentions no details and the systems and flags probably ceased to - be relevant long ago. So, remove this text. - Michael Kerrisk - SEE ALSO: add userfaultfd(2) - -open.2 - Michael Kerrisk - Add statx() to list of "at" calls in rationale discussion - -poll.2 - Michael Kerrisk - Expand discussion of POLLPRI - Michael Kerrisk [Nicolas Biscos] - POLLERR is also set on write end of a pipe when the read end is closed - -posix_fadvise.2 - Michael Kerrisk - SEE ALSO: add fincore(1) - -prctl.2 - Mike Frysinger - PR_SET_MM: Refine CONFIG_CHECKPOINT_RESTORE requirement - The Linux 3.10 release dropped the c/r requirement and opened it - up to all users. - Mike Frysinger - PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers - Mike Frysinger - PR_SET_MM: Document arg4/arg5 zero behavior - The kernel will immediately reject calls where arg4/arg5 are not - zero. See kernel/sys.c:prctl_set_mm(). - Michael Kerrisk - Explain rationale for use of subreaper processes - Michael Kerrisk - Note semantics of child_subreaper setting on fork() and exec() - Michael Kerrisk - Improve description of PR_SET_CHILD_SUBREAPER - -rename.2 - Michael Kerrisk [Georg Sauthoff] - Note that there is no glibc wrapper for renameat2() - -sched_setaffinity.2 - Michael Kerrisk - SEE ALSO: add get_nprocs(3) - -select.2 - Michael Kerrisk [Matthew Wilcox, Carlos O'Donell] - Linux select() is buggy wrt POSIX in its check for EBADF errors - Michael Kerrisk - Show correspondence between select() and poll() readiness notifications - Michael Kerrisk - Give a hint that sets must be reinitialized if using select() in a loop - Michael Kerrisk - Refer to POLLPRI in poll(2) for info on exceptional conditions - Michael Kerrisk - Move mislocated text describing the self-pipe text from BUGS to NOTES - -sigaction.2 - Michael Kerrisk - Show the prototype of an SA_SIGINFO signal handler - -signalfd.2 - Michael Kerrisk - SIGKILL and SIGSTOP are silently ignored in 'mask' - -sigprocmask.2 - Dmitry V. Levin - Do not specify an exact value of rt_sigprocmask's 4th argument - As sizeof(kernel_sigset_t) is not the same for all architectures, - it would be better not to mention any numbers as its value. - Michael Kerrisk - 'set' and 'oldset' can both be NULL - -sigwaitinfo.2 - Michael Kerrisk - sigwaitinfo() can't be used to accept synchronous signals - -socketcall.2 - Mike Frysinger - Document call argument - -stat.2 - Michael Kerrisk - Remove information migrated to inode(7) page - Michael Kerrisk - Restructure field descriptions as a hanging list - Michael Kerrisk - Remove "Other systems" subsection - These details about other systems were added in 1999, - and were probably of limited use then, and even less today. - However, they do clutter the page, so remove them. - Michael Kerrisk - DESCRIPTION: add list entries for 'st_uid' and 'st_gid' - Michael Kerrisk - Add some subsection headings to ease readability - David Howells - ERRORS: correct description of ENOENT - Michael Kerrisk - Give 'struct stat' argument a more meaningful name ('statbuf') - Marcin Ślusarz - Tweak description of AT_EMPTY_PATH - Currently it says when dirfd is AT_FDCWD it can be something - other than directory, which doesn't make much sense. Just swap - the order of sentences. - Michael Kerrisk - Add slightly expanded description oif 'st_ino' field - Michael Kerrisk - DESCRIPTION: add a list entry for 'st_ino' - Michael Kerrisk - DESCRIPTION: add a list entry for 'st_nlinks' field - -syscalls.2 - Michael Kerrisk - Add membarrier(2) - Michael Kerrisk - Fix kernel version for userfaultfd(2) - Michael Kerrisk - Linux 4.11 added statx() - Michael Kerrisk - Include deprecated getunwind(2) in list - -wait.2 - Michael Kerrisk - Orphaned children may be adopted by a "subreaper", rather by than PD 1 - -bzero.3 - Michael Kerrisk [Zack Weinberg] - Add correct header file for exlicit_bzero() - -cfree.3 - Michael Kerrisk - cfree() is removed from glibc in version 2.26 - -exit.3 - Michael Kerrisk - Improve discussion of zombie processes - -getentropy.3 - Nikos Mavrogiannopoulos [Michael Kerrisk, Florian Weimer] - Correct header file - Michael Kerrisk [Frank Theile] - SYNOPSIS: add missing return type for getentropy() declaration - -grantpt.3 - Michael Kerrisk - Tell a more nuanced story about what grantpt() does or does not do - -insque.3 - Michael Kerrisk - SEE ALSO: add queue(3) - -queue.3 - Michael Kerrisk - SEE ALSO: add insque(3) - -shm_open.3 - Michael Kerrisk - Clarify that POSIX shared memory uses tmpfs(5) - -syslog.3 - Michael Kerrisk [Ian Abbott, Walter Harms] - Reorganize page text for easier parsing and better readability - Michael Kerrisk - Various rewordings and improvements - Michael Kerrisk - Note default value for 'facility' when calling openlog() - Michael Kerrisk - SEE ALSO: add journalctl(1) - -ttyname.3 - Dmitry V. Levin - Document ENODEV error code - Christian Brauner - NOTES: warn about a confusing case that may occur with mount namespaces - - -wcsdup.3 - Jan Heberer - RETURN VALUE: fix error in return value description - Return value for failure was accidentally changed from NULL to - -1 in man-pages commit 572acb41c48b6b8e690d50edff367d8b8b01702a. - -elf.5 - Michael Kerrisk - SEE ALSO: add elfedit(1), nm(1), size(1), strings(1), and strip(1) - -nsswitch.conf.5 - Florian Weimer - Mention sudoers - It turns out that sudo drops things into nsswitch.conf, too. - -proc.5 - Michael Kerrisk - Refer to namespaces(7) for discussion of /proc/sys/user/* files - Michael Kerrisk - Simplify /proc/slabinfo entry - Don't repeat (out-of-date) info from slabinfo(5); just defer to - that page. - -tmpfs.5 - Michael Kerrisk - tmpfs supports extended attributes, but not 'user' extended attributes - -environ.7 - Jakub Wilk - Fix name of function that honors TMPDIR - tempnam() takes the TMPDIR environment variable into account, unlike - tmpnam(), which always creates pathnames within /tmp. - -hostname.7 - Marko Myllynen - Use lower case for hostname example - Marko Myllynen - Use generic names in examples - Marko Myllynen - Describe accepted characters for hostname - -inotify.7 - Michael Kerrisk [Nicolas Iooss] - Mounting a filesystem on top of a monitored directory causes no event - -man-pages.7 - Michael Kerrisk - Note preferred approach for 'duplicate' errors - -namespaces.7 - Michael Kerrisk - Document the /proc/sys/user/* files added in Linux 4.9 - -pid_namespaces.7 - Michael Kerrisk - The maximum nesting depth for PID namespaces is 32 - -user_namespaces.7: Fixes to example - Stephan Bergmann - While toying around with the userns_child_exec example program on the - user_namespaces(7) man page, I noticed two things: - - * In the EXAMPLE section, we need to mount the new /proc before - looking at /proc/$$/status, otherwise the latter will print - information about the outer namespace's PID 1 (i.e., the real - init). So the two paragraphs need to be swapped. - - * In the program source, make sure to close pipe_fd[0] in the - child before exec'ing. - -pthreads.7 - Michael Kerrisk - SEE ALSO: add pthread_rwlockattr_setkind_np(3) - -pty.7 - Michael Kerrisk - Mention a couple of other applications of pseudoterminals - -sem_overview.7 - Michael Kerrisk - SEE ALSO: add shm_overview(7) - -signal.7 - Michael Kerrisk - SEE ALSO: add sigreturn(2) - -socket.7 - Michael Kerrisk - Enhance the description of SO_INCOMING_CPU - Francois Saint-Jacques - Document SO_INCOMING_CPU - -tcp.7 - Michael Kerrisk - Note indications for OOB data given by select(2) and poll(2) - Chema Gonzalez - tcp_abc was removed in 3.9 - -xattr.7 - Michael Kerrisk - SEE ALSO: add ioctl_iflags(2) - People sometimes confuse xattrs and inode flags. Provide a link - to the page that describes inode flags to give them a tip. - -ld.so.8 - Michael Kerrisk - Mention quoting when using "Rpath tokens" in LD_AUDIT and LD_PRELOAD - Michael Kerrisk - Expand description of /etc/ld.so.preload - Michael Kerrisk - Mention ldconfig(8) in discussion of /etc/ld.so.cache - -zdump.8 - Jakub Wilk - Add OPTIONS section heading diff --git a/Changes.old b/Changes.old index 91c3e5ea3..48a19cdb6 100644 --- a/Changes.old +++ b/Changes.old @@ -44843,3 +44843,562 @@ ld.so.8 Michael Kerrisk LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM + + +==================== Changes in man-pages-4.11 ==================== + +Released: 2017-05-03, Baden, Switzerland + + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes, and ideas that have been +incorporated in changes in this release: + +Alexander Alemayhu +Alexander Miller +Andrea Arcangeli +Andreas Dilger +Andrew Clayton +Arnd Bergmann +Ben Dog +Carlos O'Donell +Chema Gonzalez +Christian Brauner +Cyril Hrubis +David Howells +Dmitry V. Levin +Florian Weimer +Francois Saint-Jacques +Frank Theile +Georg Sauthoff +Ian Abbott +Jakub Wilk +Jan Heberer +Marcin Ślusarz +Marko Myllynen +Matthew Wilcox +Michael Kerrisk +Mike Frysinger +Mike Rapoport +Nicolas Biscos +Nicolas Iooss +Nikos Mavrogiannopoulos +Nominal Animal +Silvan Jegen +Stephan Bergmann +Walter Harms +Zack Weinberg +丁贵强 + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +ioctl_userfaultfd.2 + Michael Kerrisk, Mike Rapoport + New page describing ioctl(2) operations for userfaultfd + +statx.2 + David Howells, Michael Kerrisk [Andreas Dilger] + New page describing statx(2) system call added in Linux 4.11 + +userfaultfd.2 + Mike Rapoport, Michael Kerrisk [Andrea Arcangeli] + New page describing userfaultfd(2) system call. + +pthread_atfork.3 + Michael Kerrisk + New page describing pthread_atfork(3) + +slabinfo.5 + Michael Kerrisk + Rewrite to try to bring the content close to current reality + There's still gaps to fill in, but the existing page + was in any case hugely out of date. + +inode.7 + Michael Kerrisk + New page with information about inodes + David Howells provided a statx(2) page that duplicated much of + the information from form stat(2). Avoid such duplication + by moving the common information in stat(2) and statx(2) + to a new page. + + +Renamed pages +-------------- + +ioctl_console.2 + Michael Kerrisk + Renamed from console_ioctl.4 + Most ioctl() man pages are in section 2, so move this one there + for consistency. + Michael Kerrisk + Note type of 'argp' for a various operations + For some commands, there was no clear statement about the type + of the 'argp' argument. + +ioctl_tty.2 + Michael Kerrisk + Renamed from tty_ioctl(4) + All other ioctl(2) pages are in section 2. Make this + page consistent. + Michael Kerrisk + Packet mode state change events give POLLPRI events for poll(2) + + +Newly documented interfaces in existing pages +--------------------------------------------- + +ioctl_ns.2 + Michael Kerrisk + Document the NS_GET_NSTYPE operation added in Linux 4.11 + Michael Kerrisk + Document the NS_GET_OWNER_UID operation added in Linux 4.11 + +proc.5 + Michael Kerrisk + Document /proc/sys/kernel/sched_child_runs_first + + +New and changed links +--------------------- + +console_ioctl.4 + Michael Kerrisk + Link for old name of ioctl_console(2) page + +tty_ioctl.4 + Michael Kerrisk + Link for old name of ioctl_tty(2) page + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Change page cross-references from tty_ioctl(4) to ioctl_tty(2) + Michael Kerrisk + Change page cross-references for console_ioctl(4) to ioctl_console(2) + + +Changes to individual pages +--------------------------- + +alarm.2 + Michael Kerrisk + SEE ALSO: add timer_create(2) and timerfd_create(2) + +chmod.2 +fsync.2 +mkdir.2 +mknod.2 +open.2 +truncate.2 +umask.2 +utime.2 +utimensat.2 + Michael Kerrisk + Add/replace references to inode(7) + +clone.2 + Michael Kerrisk + CLONE_NEWCGROUP by an unprivileged process also causes an EPERM error + +clone.2 +unshare.2 + Michael Kerrisk + Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC + Michael Kerrisk + CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached + Michael Kerrisk + Exceeding the maximum nested user namespace limit now gives ENOSPC + Formerly, if the limit of 32 nested user namespaces was exceeded, + the error EUSERS resulted. Starting with Linux 4.9, the error + is ENOSPC. + +epoll_ctl.2 + Michael Kerrisk + Defer to poll(2) for an explanation of EPOLLIN + Michael Kerrisk [Nicolas Biscos] + EPOLLERR is also set on write end of a pipe when the read end is closed + Michael Kerrisk [Nicolas Biscos] + Give the reader a clue that the 'events' field can be zero + 'events' specified as zero still allows EPOLLHUP and + EPOLLERR to be reported. + +_exit.2 + Michael Kerrisk + On exit, child processes may be inherited by a "subreaper" + It is no longer necessarily true that orphaned processes + are inherited by PID 1. + Michael Kerrisk + Only the least significant byte of exit status is passed to the parent + +fcntl.2 + Michael Kerrisk + Mention memfd_create() in the discussion of file seals + Give the reader a clue about what kinds of objects can + be employed with file seals. + Michael Kerrisk + File seals are not generally applicable to tmpfs(5) files + As far as I can see, file seals can be applied only to + memfd_create(2) file descriptors. This was checked by experiment + and by reading mm/shmem.c::shmem_get_inode((), where one finds + the following line that applies to all new shmem files: + + info->seals = F_SEAL_SEAL; + + Only in the code of the memfd_create() system call is this + setting reversed (in mm/shmem.c::memfd_create): + + if (flags & MFD_ALLOW_SEALING) + info->seals &= ~F_SEAL_SEAL; + +fork.2 + Michael Kerrisk + SEE ALSO: add pthread_atfork(3) + +getdents.2 +open.2 +stat.2 +statx.2 + Michael Kerrisk + SEE ALSO: add inode(7) + +getdtablesize.2 +attr.5 + Alexander Miller + Move .so directive to first line + Improves compatibility with the man and other dumb tools + that process man page files. + +getpid.2 + Michael Kerrisk + Mention init(1) and "subreapers" in discussion of parent PID + +ioctl_list.2 + Cyril Hrubis [Arnd Bergmann] + BLKRASET/BLKRAGET take unsigned long + +ioctl_ns.2 + Michael Kerrisk + ERRORS: document ENOTTY + +kexec_load.2 +sched_setaffinity.2 +bootparam.7 + Michael Kerrisk + Documentation/kernel-parameters.txt is now in Documentation/admin-guide/ + +lseek.2 + Michael Kerrisk + SEE ALSO: add fallocate(2) + Both of these pages discuss file holes. + +mincore.2 + Michael Kerrisk + SEE ALSO: add fincore(1) + +mmap.2 + Michael Kerrisk + Remove ancient reference to flags that appear on some other systems + MAP_AUTOGROW, MAP_AUTORESRV, MAP_COPY, and MAP_LOCAL may have + appeared on some systems many years ago, but the discussion here + mentions no details and the systems and flags probably ceased to + be relevant long ago. So, remove this text. + Michael Kerrisk + SEE ALSO: add userfaultfd(2) + +open.2 + Michael Kerrisk + Add statx() to list of "at" calls in rationale discussion + +poll.2 + Michael Kerrisk + Expand discussion of POLLPRI + Michael Kerrisk [Nicolas Biscos] + POLLERR is also set on write end of a pipe when the read end is closed + +posix_fadvise.2 + Michael Kerrisk + SEE ALSO: add fincore(1) + +prctl.2 + Mike Frysinger + PR_SET_MM: Refine CONFIG_CHECKPOINT_RESTORE requirement + The Linux 3.10 release dropped the c/r requirement and opened it + up to all users. + Mike Frysinger + PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers + Mike Frysinger + PR_SET_MM: Document arg4/arg5 zero behavior + The kernel will immediately reject calls where arg4/arg5 are not + zero. See kernel/sys.c:prctl_set_mm(). + Michael Kerrisk + Explain rationale for use of subreaper processes + Michael Kerrisk + Note semantics of child_subreaper setting on fork() and exec() + Michael Kerrisk + Improve description of PR_SET_CHILD_SUBREAPER + +rename.2 + Michael Kerrisk [Georg Sauthoff] + Note that there is no glibc wrapper for renameat2() + +sched_setaffinity.2 + Michael Kerrisk + SEE ALSO: add get_nprocs(3) + +select.2 + Michael Kerrisk [Matthew Wilcox, Carlos O'Donell] + Linux select() is buggy wrt POSIX in its check for EBADF errors + Michael Kerrisk + Show correspondence between select() and poll() readiness notifications + Michael Kerrisk + Give a hint that sets must be reinitialized if using select() in a loop + Michael Kerrisk + Refer to POLLPRI in poll(2) for info on exceptional conditions + Michael Kerrisk + Move mislocated text describing the self-pipe text from BUGS to NOTES + +sigaction.2 + Michael Kerrisk + Show the prototype of an SA_SIGINFO signal handler + +signalfd.2 + Michael Kerrisk + SIGKILL and SIGSTOP are silently ignored in 'mask' + +sigprocmask.2 + Dmitry V. Levin + Do not specify an exact value of rt_sigprocmask's 4th argument + As sizeof(kernel_sigset_t) is not the same for all architectures, + it would be better not to mention any numbers as its value. + Michael Kerrisk + 'set' and 'oldset' can both be NULL + +sigwaitinfo.2 + Michael Kerrisk + sigwaitinfo() can't be used to accept synchronous signals + +socketcall.2 + Mike Frysinger + Document call argument + +stat.2 + Michael Kerrisk + Remove information migrated to inode(7) page + Michael Kerrisk + Restructure field descriptions as a hanging list + Michael Kerrisk + Remove "Other systems" subsection + These details about other systems were added in 1999, + and were probably of limited use then, and even less today. + However, they do clutter the page, so remove them. + Michael Kerrisk + DESCRIPTION: add list entries for 'st_uid' and 'st_gid' + Michael Kerrisk + Add some subsection headings to ease readability + David Howells + ERRORS: correct description of ENOENT + Michael Kerrisk + Give 'struct stat' argument a more meaningful name ('statbuf') + Marcin Ślusarz + Tweak description of AT_EMPTY_PATH + Currently it says when dirfd is AT_FDCWD it can be something + other than directory, which doesn't make much sense. Just swap + the order of sentences. + Michael Kerrisk + Add slightly expanded description oif 'st_ino' field + Michael Kerrisk + DESCRIPTION: add a list entry for 'st_ino' + Michael Kerrisk + DESCRIPTION: add a list entry for 'st_nlinks' field + +syscalls.2 + Michael Kerrisk + Add membarrier(2) + Michael Kerrisk + Fix kernel version for userfaultfd(2) + Michael Kerrisk + Linux 4.11 added statx() + Michael Kerrisk + Include deprecated getunwind(2) in list + +wait.2 + Michael Kerrisk + Orphaned children may be adopted by a "subreaper", rather by than PD 1 + +bzero.3 + Michael Kerrisk [Zack Weinberg] + Add correct header file for exlicit_bzero() + +cfree.3 + Michael Kerrisk + cfree() is removed from glibc in version 2.26 + +exit.3 + Michael Kerrisk + Improve discussion of zombie processes + +getentropy.3 + Nikos Mavrogiannopoulos [Michael Kerrisk, Florian Weimer] + Correct header file + Michael Kerrisk [Frank Theile] + SYNOPSIS: add missing return type for getentropy() declaration + +grantpt.3 + Michael Kerrisk + Tell a more nuanced story about what grantpt() does or does not do + +insque.3 + Michael Kerrisk + SEE ALSO: add queue(3) + +queue.3 + Michael Kerrisk + SEE ALSO: add insque(3) + +shm_open.3 + Michael Kerrisk + Clarify that POSIX shared memory uses tmpfs(5) + +syslog.3 + Michael Kerrisk [Ian Abbott, Walter Harms] + Reorganize page text for easier parsing and better readability + Michael Kerrisk + Various rewordings and improvements + Michael Kerrisk + Note default value for 'facility' when calling openlog() + Michael Kerrisk + SEE ALSO: add journalctl(1) + +ttyname.3 + Dmitry V. Levin + Document ENODEV error code + Christian Brauner + NOTES: warn about a confusing case that may occur with mount namespaces + + +wcsdup.3 + Jan Heberer + RETURN VALUE: fix error in return value description + Return value for failure was accidentally changed from NULL to + -1 in man-pages commit 572acb41c48b6b8e690d50edff367d8b8b01702a. + +elf.5 + Michael Kerrisk + SEE ALSO: add elfedit(1), nm(1), size(1), strings(1), and strip(1) + +nsswitch.conf.5 + Florian Weimer + Mention sudoers + It turns out that sudo drops things into nsswitch.conf, too. + +proc.5 + Michael Kerrisk + Refer to namespaces(7) for discussion of /proc/sys/user/* files + Michael Kerrisk + Simplify /proc/slabinfo entry + Don't repeat (out-of-date) info from slabinfo(5); just defer to + that page. + +tmpfs.5 + Michael Kerrisk + tmpfs supports extended attributes, but not 'user' extended attributes + +environ.7 + Jakub Wilk + Fix name of function that honors TMPDIR + tempnam() takes the TMPDIR environment variable into account, unlike + tmpnam(), which always creates pathnames within /tmp. + +hostname.7 + Marko Myllynen + Use lower case for hostname example + Marko Myllynen + Use generic names in examples + Marko Myllynen + Describe accepted characters for hostname + +inotify.7 + Michael Kerrisk [Nicolas Iooss] + Mounting a filesystem on top of a monitored directory causes no event + +man-pages.7 + Michael Kerrisk + Note preferred approach for 'duplicate' errors + +namespaces.7 + Michael Kerrisk + Document the /proc/sys/user/* files added in Linux 4.9 + +pid_namespaces.7 + Michael Kerrisk + The maximum nesting depth for PID namespaces is 32 + +user_namespaces.7: Fixes to example + Stephan Bergmann + While toying around with the userns_child_exec example program on the + user_namespaces(7) man page, I noticed two things: + + * In the EXAMPLE section, we need to mount the new /proc before + looking at /proc/$$/status, otherwise the latter will print + information about the outer namespace's PID 1 (i.e., the real + init). So the two paragraphs need to be swapped. + + * In the program source, make sure to close pipe_fd[0] in the + child before exec'ing. + +pthreads.7 + Michael Kerrisk + SEE ALSO: add pthread_rwlockattr_setkind_np(3) + +pty.7 + Michael Kerrisk + Mention a couple of other applications of pseudoterminals + +sem_overview.7 + Michael Kerrisk + SEE ALSO: add shm_overview(7) + +signal.7 + Michael Kerrisk + SEE ALSO: add sigreturn(2) + +socket.7 + Michael Kerrisk + Enhance the description of SO_INCOMING_CPU + Francois Saint-Jacques + Document SO_INCOMING_CPU + +tcp.7 + Michael Kerrisk + Note indications for OOB data given by select(2) and poll(2) + Chema Gonzalez + tcp_abc was removed in 3.9 + +xattr.7 + Michael Kerrisk + SEE ALSO: add ioctl_iflags(2) + People sometimes confuse xattrs and inode flags. Provide a link + to the page that describes inode flags to give them a tip. + +ld.so.8 + Michael Kerrisk + Mention quoting when using "Rpath tokens" in LD_AUDIT and LD_PRELOAD + Michael Kerrisk + Expand description of /etc/ld.so.preload + Michael Kerrisk + Mention ldconfig(8) in discussion of /etc/ld.so.cache + +zdump.8 + Jakub Wilk + Add OPTIONS section heading