-==================== Changes in man-pages-4.11 ====================
+==================== Changes in man-pages-5.01 ====================
-Released: 2017-05-03, Baden, Switzerland
+Released: ????-??-??, Munich
Contributors
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