| ==================== Changes in man-pages-4.13 ==================== |
| |
| Released: 2017-09-15, Munich |
| |
| |
| Contributors |
| ------------ |
| |
| The following people contributed patches/fixes or (noted in brackets |
| in the changelog below) reports, notes, and ideas that have been |
| incorporated in changes in this release: |
| |
| Aleksa Sarai <asarai@suse.de> |
| Alex Henrie <alexhenrie24@gmail.com> |
| Benjamin Peterson <bp@benjamin.pe> |
| Bjarni Ingi Gislason <bjarniig@rhi.hi.is> |
| Cyrill Gorcunov <gorcunov@openvz.org> |
| Darrick J. Wong <darrick.wong@oracle.com> |
| David Wilder <dwilder@us.ibm.com> |
| Dennis Knorr <dennis.knorr@muenchen.de> |
| Don Brace <don.brace@microsemi.com> |
| Douglas Caetano dos Santos <douglascs@taghos.com.br> |
| Elliott Hughes <enh@google.com> |
| Eugene Syromyatnikov <evgsyr@gmail.com> |
| Fabio Scotoni <fabio@esse.ch> |
| Florian Weimer <fweimer@redhat.com> |
| Jakub Wilk <jwilk@jwilk.net> |
| Jason Noakes <jjnoakes@gmail.com> |
| Jens Axboe <axboe@kernel.dk> |
| Jonas Grabber <jobegrabber@gmail.com> |
| Kees Cook <keescook@chromium.org> |
| Konstantin Shemyak <konstantin@shemyak.com> |
| Li Zhijian <lizhijian@cn.fujitsu.com> |
| Marko Myllynen <myllynen@redhat.com> |
| Mark Wielaard <mark@klomp.org> |
| Meelis Roos <mroos@linux.ee> |
| Michael Kerrisk <mtk.manpages@gmail.com> |
| Mike Rapoport <rppt@linux.vnet.ibm.com> |
| NeilBrown <neilb@suse.com> |
| Otto Ebeling <oebeling@github.mail.kapsi.fi> |
| Paul Eggert <eggert@cs.ucla.edu> |
| Rick Jones <rick.jones2@hpe.com> |
| Sage Weil <sage@redhat.com> |
| Sam Varshavchik <mrsam@courier-mta.com> |
| Sergey Z. <zhurxx@gmail.com> |
| Shrikant Giridhar <shrikantgiridhar@gmail.com> |
| Stephan Müller <smueller@chronox.de> |
| Sukadev Bhattiprolu <sukadev@linux.vnet.ibm.com> |
| Tej Chajed <tchajed@mit.edu> |
| Thiago Jung Bauermann <bauerman@linux.vnet.ibm.com> |
| Vincent Bernat <vincent@bernat.im> |
| Yubin Ruan <ablacktshirt@gmail.com> |
| Ильдар Низамов <niya3@mail.ru> |
| |
| Apologies if I missed anyone! |
| |
| |
| New and rewritten pages |
| ----------------------- |
| |
| pthread_mutex_consistent.3 |
| Yubin Ruan, Michael Kerrisk |
| New page documenting pthread_mutex_consistent(3) |
| |
| pthread_mutexattr_getpshared.3 |
| Michael Kerrisk |
| New page for pthread_mutexattr_getpshared(3) and pthread_mutexattr_setpshared(3) |
| |
| pthread_mutexattr_init.3 |
| Michael Kerrisk |
| New page for pthread_mutexattr_init(3) and pthread_mutexattr_destroy(3) |
| |
| pthread_mutexattr_setrobust.3 |
| Yubin Ruan, Michael Kerrisk |
| New page for pthread_mutexattr_setrobust(3) and pthread_mutexattr_getrobust(3) |
| |
| sysfs.5 |
| Michael Kerrisk [Mark Wielaard] |
| New page documenting the sysfs filesystem |
| Just a skeleton page so far, but perhaps it will be filled out |
| over time. |
| |
| |
| Newly documented interfaces in existing pages |
| --------------------------------------------- |
| |
| fcntl.2 |
| Jens Axboe, Michael Kerrisk |
| Describe the set/get write hints commands that are added in Linux 4.13 |
| Document F_GET_RW_HINT, F_SET_RW_HINT, F_GET_FILE_RW_HINT, and |
| F_SET_FILE_RW_HINT. |
| |
| ioctl_tty.2 |
| Aleksa Sarai, Michael Kerrisk |
| Add TIOCGPTPEER documentation |
| |
| kcmp.2 |
| Cyrill Gorcunov |
| Add KCMP_EPOLL_TFD description |
| |
| keyctl.2 |
| Eugene Syromyatnikov |
| Document the KEYCTL_RESTRICT_KEYRING operation |
| Eugene Syromyatnikov [Stephan Müller] |
| Document the ability to provide KDF parameters in KEYCTL_DH_COMPUTE |
| |
| |
| New and changed links |
| --------------------- |
| |
| pthread_mutexattr_destroy.3 |
| Michael Kerrisk |
| New link to new pthread_mutexattr_init.3 page |
| |
| pthread_mutexattr_getrobust.3 |
| Michael Kerrisk |
| New link to new pthread_mutexattr_setrobust.3 page |
| |
| pthread_mutexattr_getrobust_np.3 |
| Michael Kerrisk |
| New link to new pthread_mutexattr_setrobust.3 page |
| |
| pthread_mutexattr_setpshared.3 |
| Michael Kerrisk |
| New link to new pthread_mutexattr_getpshared.3 page |
| |
| |
| Global changes |
| -------------- |
| |
| Various pages |
| Michael Kerrisk |
| Use .EX/.EE for EXAMPLE programs |
| |
| Various pages |
| Michael Kerrisk |
| Use consistent markup for code snippets |
| Change .nf/.fi to .EX/.EE |
| |
| Various pages |
| Michael Kerrisk |
| Use consistent markup for code snippets |
| The preferred form is |
| |
| .PP/.IP |
| .in +4n |
| .EX |
| <code> |
| .EE |
| .in |
| .PP/.IP |
| |
| Various pages |
| Michael Kerrisk |
| Formatting fix: replace blank lines with .PP/.IP |
| Blank lines shouldn't generally appear in *roff source (other |
| than in code examples), since they create large vertical |
| spaces between text blocks. |
| |
| Various pages |
| Michael Kerrisk [Bjarni Ingi Gislason] |
| Add a non-breaking space between a number and a unit (prefix) |
| Based on a patch by Bjarni Ingi Gislason. |
| |
| Various pages |
| Michael Kerrisk [Bjarni Ingi Gislason] |
| Use en-dash for ranges |
| Based on a patch by Bjarni Ingi Gislason. |
| |
| A few pages |
| Michael Kerrisk |
| Fix misordering of sections |
| Michael Kerrisk |
| Fix order of SEE ALSO entries |
| |
| |
| Changes to individual pages |
| --------------------------- |
| |
| ldd.1 |
| Michael Kerrisk |
| Add more detail on ldd security implications, noting glibc 2.27 changes |
| |
| add_key.2 |
| backtrace.3 |
| syslog.3 |
| Michael Kerrisk |
| Fix misordered SEE ALSO entries |
| |
| add_key.2 |
| request_key.2 |
| keyrings.7 |
| Eugene Syromyatnikov |
| Update Linux documentation pointers |
| |
| chown.2 |
| Michael Kerrisk |
| Update kernel version in note on support for grpid/nogrpid mount options |
| There has been no change since Linux 2.6.25, so update the |
| kernel version to 4.12. |
| |
| execve.2 |
| Michael Kerrisk |
| SEE ALSO: add get_robust_list(2) |
| |
| getrandom.2 |
| Michael Kerrisk [Fabio Scotoni] |
| SYNOPSIS: make return type of getrandom() 'ssize_t' |
| This accords with glibc headers and the Linux kernel source. |
| |
| getrlimit.2 |
| Thiago Jung Bauermann |
| Mention unit used by RLIMIT_CORE and RLIMIT_FSIZE |
| Michael Kerrisk |
| Note that RLIMIT_AS and RLIMIT_DATA are rounded down to system page size |
| Michael Kerrisk |
| Mention unit for RLIMIT_DATA |
| |
| getrlimit.2 |
| mmap.2 |
| malloc.3 |
| Jonas Grabber |
| RLIMIT_DATA affects mmap (2) since Linux 4.7 |
| |
| get_robust_list.2 |
| Michael Kerrisk |
| Detail the operation of robust futex lists |
| Michael Kerrisk |
| Since Linux 2.6.28, robust futex lists also have an effect for execve(2) |
| Michael Kerrisk |
| Clarify that "thread ID" means "kernel thread ID" |
| Michael Kerrisk |
| SEE ALSO: add pthread_mutexattr_setrobust(3) |
| |
| ioctl_getfsmap.2 |
| Darrick J. Wong |
| Correct semantics of FMR_OF_LAST flag |
| |
| ioctl_userfaultfd.2 |
| Mike Rapoport |
| Document replacement of ENOSPC with ESRCH |
| Mike Rapoport |
| Update uffdio_api.features description |
| There is no requirement that uffdio_api.features must be zero |
| for newer kernels. This field actually defines what features |
| space would like to enable. |
| |
| io_submit.2 |
| Sage Weil |
| Acknowledge possibility of short return |
| Note that the return value may be a value less than 'nr' |
| if not all iocbs were queued at once. |
| |
| ipc.2 |
| Michael Kerrisk |
| SEE ALSO: add svipc(7) |
| |
| keyctl.2 |
| Eugene Syromyatnikov |
| mention keyctl_dh_compute(3) and keyctl_dh_compute_alloc (3) |
| These functions have been added in keyutils 1.5.10 |
| Eugene Syromyatnikov |
| Mention ENOMEM in ERRORS |
| Eugene Syromyatnikov |
| Update kernel documentation path reference |
| |
| move_pages.2 |
| Otto Ebeling [Michael Kerrisk] |
| Note permission changes that occurred in Linux 4.13 |
| |
| mprotect.2 |
| Michael Kerrisk [Shrikant Giridhar] |
| Add warning about the use of printf() in the example code |
| |
| open.2 |
| NeilBrown |
| Improve O_PATH documentation |
| - fstatfs is now permitted. |
| - ioctl isn't, and is worth listing explicitly |
| - O_PATH allows an automount point to be opened with |
| triggering the mount. |
| |
| prctl.2 |
| seccomp.2 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel seccomp documentation |
| |
| prctl.2 |
| ptrace.2 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel Yama documentation |
| |
| prctl.2 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel no_new_privs flag documentation |
| |
| readlink.2 |
| Michael Kerrisk [Jason Noakes] |
| Fix an off-by-one error in example code |
| |
| seccomp.2 |
| Kees Cook |
| Clarify SECCOMP_RET_KILL kills tasks not processes |
| |
| select_tut.2 |
| Michael Kerrisk [Sergey Z.] |
| Clarify an ambiguity with respect to select() and EAGAIN |
| See https://bugzilla.kernel.org/show_bug.cgi?id=196345 |
| |
| set_tid_address.2 |
| Elliott Hughes |
| Note that there's no glibc wrapper for set_tid_address() |
| |
| socket.2 |
| Michael Kerrisk [Yubin Ruan] |
| socket() uses the lowest available file descriptor |
| |
| _syscall.2 |
| Michael Kerrisk |
| Remove redundant comment from EXAMPLE |
| A discussion of the nroff source of the manual |
| page isn't very useful... |
| |
| sysfs.2 |
| Michael Kerrisk |
| Add a pointer to sysfs(5) to help possibly confused readers |
| Michael Kerrisk |
| Make it clearer near the start of the page that sysfs(2) is obsolete |
| |
| timer_create.2 |
| Michael Kerrisk |
| Strengthen the warning about use of printf() in the example program |
| Michael Kerrisk |
| Update cross reference: signal(7) should be signal-safety(7) |
| |
| umount.2 |
| NeilBrown |
| Revise MNT_FORCE description |
| MNT_FORCE does not allow a busy filesystem to be unmounted. Only |
| MNT_DETACH allows that. MNT_FORCE only tries to abort pending |
| transactions, in the hope that might help umount not to block, |
| |
| Also, other filesystems than NFS support MNT_FORCE. |
| |
| unshare.2 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel unshare documentation |
| |
| wait.2 |
| Michael Kerrisk [Ильдар Низамов] |
| POSIX.1-2008 TC1 clarifies treatment of 'si_pid' for waitid() WNOHANG |
| |
| cmsg.3 |
| Sukadev Bhattiprolu |
| Add a scatter/gather buffer to sample code |
| Michael Kerrisk |
| Reorganize the text somewhat (no content changes) |
| |
| crypt.3 |
| Konstantin Shemyak [Michael Kerrisk] |
| Add description of previously undocumented 'rounds' parameter |
| Konstantin Shemyak |
| Encryption isn't done with SHA-xxx, but with a function based on SHA-xxx |
| Konstantin Shemyak |
| Clarify that ending of the salt string with '$' is optional |
| |
| exit.3 |
| Michael Kerrisk |
| Mention the prctl(2) PR_SET_PDEATHSIG operation |
| Michael Kerrisk |
| SEE ALSO: add get_robust_list(2) |
| Michael Kerrisk |
| Add a heading to delimit discussion of signals sent to other processes |
| |
| exp2.3 |
| Alex Henrie |
| Remove C89 designation |
| |
| log1p.3 |
| Alex Henrie |
| Document fixes to give EDOM or ERANGE on error |
| |
| matherr.3 |
| Michael Kerrisk |
| Note that glibc 2.27 removes the 'matherr' mechanism |
| Michael Kerrisk |
| Remove crufty feature test macro requirements |
| |
| pow10.3 |
| Michael Kerrisk |
| Note that pow10() is now obsolete in favor of exp10() |
| Also, the pow10() functions are no longer supported by glibc, |
| starting with version 2.27. |
| |
| sincos.3 |
| Michael Kerrisk |
| Note that sincos() is intended to be more efficient than sin() + cos() |
| |
| cciss.4 |
| hpsa.4 |
| Eugene Syromyatnikov [Don Brace, Meelis Roos] |
| Mention cciss removal in Linux 4.14 |
| During the Linux 4.13 development cycle, the cciss driver has been |
| removed in favor of the hpsa driver, which has been amended with |
| some legacy board support. |
| |
| initrd.4 |
| proc.5 |
| bootparam.7 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel initrd documentation |
| |
| initrd.4 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel root over NFS documentation |
| |
| intro.4 |
| Michael Kerrisk |
| SEE ALSO: add mknod(1) and mknod(2) |
| |
| host.conf.5 |
| Michael Kerrisk |
| Add cross-reference to hosts(5) |
| |
| locale.5 |
| Marko Myllynen |
| Refer to existing locales for encoding details |
| Since I don't think it would make sense to try to have different |
| explanation for each glibc version on the locale(5) man page, I'm |
| proposing that we apply the below patch so that we refer to |
| existing locale definition files in general and not spell out the |
| exact format or any certain locale as a definitive guideline. |
| |
| nologin.5 |
| Michael Kerrisk |
| Add a sentence explaining why nologin is useful |
| |
| proc.5 |
| Eugene Syromyatnikov |
| Document removal of htab-reclaim sysctl file |
| This PPC-specific sysctl option has been removed in Linux 2.4.9.2, |
| according to historic Linux repository commit log. |
| Eugene Syromyatnikov |
| Add description for cpuN lines in /proc/stat |
| Eugene Syromyatnikov |
| Add description for softirq line in /proc/stat |
| Eugene Syromyatnikov |
| Document removal of timer_stats file |
| Michael Kerrisk |
| Note Linux 4.9 changes to privileges for /proc/[pid]/timerslack_ns |
| Michael Kerrisk |
| Show command used to mount /proc |
| Michael Kerrisk |
| Explicitly note in intro that some /proc files are writable |
| Eugene Syromyatnikov |
| Update pointer to in-kernel SysRq documentation |
| Michael Kerrisk |
| SEE ALSO: add sysfs(5) |
| Eugene Syromyatnikov |
| Update pointer to in-kernel security keys documentation |
| Benjamin Peterson |
| Fix path to binfmt_misc docs |
| Eugene Syromyatnikov |
| Update pointer to in-kernel MTRR documentation |
| Eugene Syromyatnikov |
| Update reference to kernel's crypto API documentation |
| |
| tzfile.5 |
| Paul Eggert |
| Sync from tzdb upstream |
| This makes tzfile.5 a copy of the tzdb version, except that the |
| tzdb version's first line is replaced by man-pages boilerplate. |
| The new version documents version 3 format, among other things. |
| Also, it removes the "Summary of the timezone information file |
| format" section, which should no longer be needed due to |
| improvements in the the part of the man page. |
| |
| capabilities.7 |
| Michael Kerrisk |
| Note semantics for a program that is set-UID-root and has capabilities |
| Note semantics for a program that is both set-user-ID-root and has |
| file capabilities. |
| Michael Kerrisk [Dennis Knorr] |
| Note that a set-UID-root program may have an empty file capabilite set |
| |
| cgroups.7 |
| Michael Kerrisk |
| SEE ALSO: systemd-cgls(1) |
| |
| cpuset.7 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel cpusets documentation |
| |
| keyrings.7 |
| Eugene Syromyatnikov |
| Document description restriction for logon keys |
| "logon" type has additional check that enforces colon-separated |
| prefix in key descriptions. |
| Eugene Syromyatnikov |
| Add pointers to kernel's documentation |
| Mostly because of assymmetric-keys.txt, which is outside |
| security/keys for some reason. |
| |
| man-pages.7 |
| Michael Kerrisk |
| Expand the guidance on formatting code snippets |
| |
| netlink.7 |
| David Wilder |
| Change buffer size in example code about reading netlink message |
| Michael Kerrisk [Rick Jones] |
| Add a comment on 8192 buffer size in example code |
| |
| pthreads.7 |
| Michael Kerrisk |
| SEE ALSO: add pthread_mutexattr_destroy(3) and pthread_mutexattr_init(3) |
| |
| signal.7 |
| Michael Kerrisk |
| Since glibc 2.26, SIGUNUSED is no longer defined |
| |
| tcp.7 |
| Vincent Bernat |
| tcp_tw_recycle is removed from Linux 4.12 |
| And it is completely broken. |
| |
| unicode.7 |
| Eugene Syromyatnikov |
| Update pointer to in-kernel Unicode terminal support documentation |