man-pages-4.12 is released

man-pages-4.12 is released

[Michael Kerrisk (man-pages)]

The Linux man-pages maintainer proudly announces:

    man-pages-4.12 - man pages for Linux

This release resulted from patches, bug reports, reviews, and comments
from around 30 contributors. This relatively small release consists of
just under 200 commits changing around 90 pages. 

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.12

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2017/07/man-pages-412-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.12 ====================

New and rewritten pages
-----------------------

ioctl_getfsmap.2
    Darrick J. Wong
        Document the GETFSMAP ioctl
            Document the new GETFSMAP ioctl that returns the physical layout of a
            (disk-based) filesystem.


Newly documented interfaces in existing pages
---------------------------------------------

namespaces.7
    Kirill Tkhai  [Michael Kerrisk]
        Document the /proc/[pid]/ns/pid_for_children file


Changes to individual pages
---------------------------

ldd.1
    Michael Kerrisk
        'objdump -p prog | grep NEEDED' doesn't give quite same info as 'ldd'

chown.2
    Michael Kerrisk
        When file owner or group is changed, file capabilities are cleared
    Michael Kerrisk
        Changes to file owner by root also clear set-UID and set-GID bits

clone.2
    Michael Kerrisk
        Update BUGS to reflect fact that PID caching was removed in glibc 2.25

epoll_wait.2
    Michael Kerrisk
        Clarify semantics of returned 'data' field
            The returned 'data' is the 'data' most recently set via
            epoll_ctl().
getpid.2
    Carlos O'Donell, Michael Kerrisk
        Note that PID caching is removed as of glibc 2.25
            Since glibc 2.25 the PID cache is removed.

            Rationale given in the release notes:
            https://sourceware.org/glibc/wiki/Release/2.25#pid_cache_removal

mount.2
    NeilBrown
        Revise description of MS_REMOUNT | MS_BIND
            MS_REMOUNT|MS_BIND affects all per-mount-point
            flag.  MS_RDONLY is only special because it,
            uniquely, is both a per-mount-point flag *and* a
            per-filesystem flag.

            So the sections of per-mount-point flags and
            MS_REMOUNT can usefully be clarified.

open.2
    Michael Kerrisk
        Note some further advantages of the *at() APIs

seccomp.2
    Mike Frysinger
        Expand SECCOMP_RET_KILL documentation

sigaltstack.2
    Michael Kerrisk
        Note that specifying SS_ONSTACK in ss.ss_flags decreases portability
    Michael Kerrisk
        Note buggy addition of ss.ss_flags==SS_ONSTACK
            Note buggy addition of ss.ss_flags==SS_ONSTACK as a synonym
            for ss_flags==0. No other implemenation does this, AFAIK.
            And it was not needed :-(.
    Michael Kerrisk
        Specifying 'ss' returns the current settings without changing them
    Michael Kerrisk
        Give 'oss' argument a more meaningful name: 'old_ss'
    Michael Kerrisk
        Some minor reworking of the text
    Michael Kerrisk
        ERRORS: update description of EINVAL error

dl_iterate_phdr.3
    Michael Kerrisk
        dl_iterate_phdr() shows the order in which objects were loaded
            dl_iterate_phdr() tells us not just which objects are
            loaded, but also the order in which they are loaded
            (the "link-map order"). Since the order is relevant for
            understanding symbol resolution, give the reader this clue.
malloc.3
    Michael Kerrisk
        Document the reallocarray() added in glibc 2.26

capabilities.7
    Michael Kerrisk
        Clarify the effect on process capabilities when UID 0 does execve(2)
    Michael Kerrisk
        Note effect on capabilities when a process with UID != 0 does execve(2)
    Michael Kerrisk  [David Lewis]
        Fix reversed descriptions of CAP_MAC_OVERRIDE and CAP_MAC_ADMIN

cgroup_namespaces.7
    Michael Kerrisk
        Add some further explanation of the example shell session
    Michael Kerrisk
        Fix a bug in shell session example

signal.7
    Michael Kerrisk  [lilydjwg]
        Since Linux 3.8, read(2) on an inotify FD is restartable with SA_RESTART
            See https://bugzilla.kernel.org/show_bug.cgi?id=195711
    Michael Kerrisk
        read() from an inotify FD is no longer interrupted by a stop signal
            (Change was in Linux 3.8.)

tcp.7
    Michael Kerrisk
        Document value '2' for tcp_timestamps
            Since Linux 4.10, the value '2' is meaningful for tcp_timestamps
    Ruben Kerkhof
        Change default value of tcp_frto
            The default changed in c96fd3d461fa495400df24be3b3b66f0e0b152f9
            (Linux 2.6.24).

ld.so.8
    Michael Kerrisk
        Greatly expand the explanation of LD_DYNAMIC_WEAK
    Carlos O'Donell
        Expand DT_RUNPATH details.
            ld.so.8: Expand DT_RUNPATH details.
    Michael Kerrisk
        Since glibc 2.2.5, LD_PROFILE is ignored in secure-execution mode
    Michael Kerrisk
        Note version where secure-execution started ignoring LD_USE_LOAD_BIAS
    Michael Kerrisk
        Rewrite LD_DEBUG_OUTPUT description and note that .PID is appended

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/