man-pages-4.13 is released

man-pages-4.13 is released

[Michael Kerrisk (man-pages)]

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/