Gidday, The Linux man-pages maintainer proudly announces:
man-pages-4.13 - man pages for Linux This release resulted from patches, bug reports, reviews, and comments from around 40 contributors. The release is rather larger than average. (The context diff runs to more than 90k lines.) The release includes more than 350 commits and contains some fairly wide-ranging formatting fix-ups that meant that all 1028 existing manual pages saw some change(s). In addition, 5 new manual pages were added. Tarball download: http://www.kernel.org/doc/man-pages/download.html Git repository: https://git.kernel.org/cgit/docs/man-pages/man-pages.git/ Online changelog: http://man7.org/linux/man-pages/changelog.html#release_4.13 A short summary of the release is blogged at: http://linux-man-pages.blogspot.com/2017/09/man-pages-413-is-released.html The current version of the pages is browsable at: http://man7.org/linux/man-pages/ A selection of changes in this release that may be of interest to readers of LKML is shown below. Cheers, Michael ==================== Changes in man-pages-4.13 ==================== 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 Changes to individual pages --------------------------- ldd.1 Michael Kerrisk Add more detail on ldd security implications, noting glibc 2.27 changes 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) ioctl_userfaultfd.2 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. 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 move_pages.2 Otto Ebeling [Michael Kerrisk] Note permission changes that occurred in Linux 4.13 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. seccomp.2 Kees Cook Clarify SECCOMP_RET_KILL kills tasks not processes 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. 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 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 keyrings.7 Eugene Syromyatnikov Document description restriction for logon keys "logon" type has additional check that enforces colon-separated prefix in key descriptions. tcp.7 Vincent Bernat tcp_tw_recycle is removed from Linux 4.12 And it is completely broken. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/