Subject: man-pages-4.13 is released

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/