| ==================== Changes in man-pages-4.11 ==================== |
| |
| Released: 2017-05-03, Baden, Switzerland |
| |
| |
| Contributors |
| ------------ |
| |
| The following people contributed patches/fixes or (noted in brackets |
| in the changelog below) reports, notes, and ideas that have been |
| incorporated in changes in this release: |
| |
| Alexander Alemayhu <alexander@alemayhu.com> |
| Alexander Miller <alex.miller@gmx.de> |
| Andrea Arcangeli <aarcange@redhat.com> |
| Andreas Dilger <adilger@dilger.ca> |
| Andrew Clayton <andrew@digital-domain.net> |
| Arnd Bergmann <arnd@arndb.de> |
| Ben Dog <wsy2220@gmail.com> |
| Carlos O'Donell <carlos@redhat.com> |
| Chema Gonzalez <chema@google.com> |
| Christian Brauner <christian.brauner@ubuntu.com> |
| Cyril Hrubis <chrubis@suse.cz> |
| David Howells <dhowells@redhat.com> |
| Dmitry V. Levin <ldv@altlinux.org> |
| Florian Weimer <fweimer@redhat.com> |
| Francois Saint-Jacques <fsaintjacques@gmail.com> |
| Frank Theile |
| Georg Sauthoff <mail@georg.so> |
| Ian Abbott <abbotti@mev.co.uk> |
| Jakub Wilk <jwilk@jwilk.net> |
| Jan Heberer <jangc@t-online.de> |
| Marcin Ślusarz <marcin.slusarz@gmail.com> |
| Marko Myllynen <myllynen@redhat.com> |
| Matthew Wilcox <willy@infradead.org> |
| Michael Kerrisk <mtk.manpages@gmail.com> |
| Mike Frysinger <vapier@gentoo.org> |
| Mike Rapoport <rppt@linux.vnet.ibm.com> |
| Nicolas Biscos <nicolas.biscos+man7@gmail.com> |
| Nicolas Iooss <Nicolas.Iooss@ssi.gouv.fr> |
| Nikos Mavrogiannopoulos <nmav@redhat.com> |
| Nominal Animal <question@nominal-animal.net> |
| Silvan Jegen <s.jegen@gmail.com> |
| Stephan Bergmann <sbergman@redhat.com> |
| Walter Harms <wharms@bfs.de> |
| Zack Weinberg <zackw@panix.com> |
| 丁贵强<dingguiqiang@foxmail.com> |
| |
| Apologies if I missed anyone! |
| |
| |
| New and rewritten pages |
| ----------------------- |
| |
| ioctl_userfaultfd.2 |
| Michael Kerrisk, Mike Rapoport |
| New page describing ioctl(2) operations for userfaultfd |
| |
| statx.2 |
| David Howells, Michael Kerrisk [Andreas Dilger] |
| New page describing statx(2) system call added in Linux 4.11 |
| |
| userfaultfd.2 |
| Mike Rapoport, Michael Kerrisk [Andrea Arcangeli] |
| New page describing userfaultfd(2) system call. |
| |
| pthread_atfork.3 |
| Michael Kerrisk |
| New page describing pthread_atfork(3) |
| |
| slabinfo.5 |
| Michael Kerrisk |
| Rewrite to try to bring the content close to current reality |
| There's still gaps to fill in, but the existing page |
| was in any case hugely out of date. |
| |
| inode.7 |
| Michael Kerrisk |
| New page with information about inodes |
| David Howells provided a statx(2) page that duplicated much of |
| the information from 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 |