man-pages-3.71 is released

man-pages-3.71 is released

[Michael Kerrisk]

Gidday,

The Linux man-pages maintainer proudly announces:

    man-pages-3.71 - man pages for Linux

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_3.71

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2014/08/man-pages-371-is-released.html

The current version of the pages is browsable at:
http://man7.org/linux/man-pages/

A few changes in this release that may be of interest to readers of
this list are given below.

Cheers,

Michael

==================== Changes in man-pages-3.71 ====================

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

group_member.3
    Michael Kerrisk
        New page documenting group_member(3)

isfdtype.3
    Michael Kerrisk
        New page documenting isfdtype(3)


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

perf_event_open.2
    Vince Weaver
        Document new comm_exec flag
            Linux 3.16 (more specifically, commit 82b897782d10fcc4 )
            added support for differentiating between process renames
            caused by exec versus those caused by other methods.
    Vince Weaver
        Document new mmap2 record type
            Linux 3.16 (more specifically, commit a5a5ba72843dd05f9 )
            enabled the enhanced mmap2 record support.
            The interface was added in Linux 3.12 but disabled until
            Linux 3.16.
    Vince Weaver
        Document PERF_SAMPLE_BRANCH_COND
            Linux 3.16 (more specifically, commit bac52139f0b7ab31330 )
            adds support for gathering PERF_SAMPLE_BRANCH_COND
            conditional branch values when doing PERF_SAMPLE_BRANCH_STACK
            sampling.

proc.5
    Michael Kerrisk
        Document /proc/PID/comm
    Michael Kerrisk
        Document /proc/PID/pagemap
    Michael Kerrisk
        Document /proc/PID/personality
    Michael Kerrisk
        Document /proc/PID/syscall
    Michael Kerrisk
        Document /proc/kpagecount
    Michael Kerrisk
        Document /proc/kpageflags
    Michael Kerrisk
        Document /proc/sys/vm/overcommit_kbytes

capabilities.7
    Michael Kerrisk
        Add CAP_AUDIT_READ
            CAP_AUDIT_READ is new in Linux 3.16.


Global changes
--------------

Various pages
    Michael Kerrisk
        Remove ancient Linux libc details

Various pages
    Michael Kerrisk
        NOTES: add "C library/kernel ABI differences" subheading


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

access.2
    Michael Kerrisk
        Glibc falls back to using access() on kernels that lack faccessat()

chmod.2
    Michael Kerrisk
        Glibc falls back to chmod() on kernels that don't support fchmodat()
    Michael Kerrisk
        Glibc falls back to chown()/lchown() on kernels that lack fchownat()

epoll_wait.2
    Michael Kerrisk
        NOTES: describe raw epoll_pwait() system call differences

getrlimit.2
    Michael Kerrisk
        Describe the "large" resource limit bug on 32-bit platforms
            See https://bugzilla.kernel.org/show_bug.cgi?id=5042.
    Michael Kerrisk
        Glibc's setrlimit() and getrlimit() are implemented using prlimit()

link.2
    Michael Kerrisk
        Glibc falls back to link() on kernels that lack linkat()
            Unless 'flags' contains AT_SYMLINK_FOLLOW.

mkdir.2
    Michael Kerrisk
        Glibc falls back to mkdir() on kernels that don't support mkdirat()

perf_event_open.2
    Vince Weaver
        Clarify PERF_SAMPLE_STACK_USER usage
            This clarifies the PERF_SAMPLE_STACK_USER section.
            I found these issue while implementing some code that uses
            the option.  The important change is fixing the name of the
            sample_stack_user parameter, the rest is just some wording
            fixes and minor clarifications.
    Vince Weaver
        Clarify PERF_SAMPLE_DATA_SRC usage
            When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
            you need to shift the masks before doing the compare.

            Although the value you are checking (perf_mem_data_src) is
            specified as a bitfield so this might all fall apart if trying
            to access the field in a cross-endian way.  The Power people
            were working on this issue, not sure if they resolved it.

poll.2
    Michael Kerrisk
        Describe fifth argument (sigsetsize) of raw ppoll() system call

readlink.2
    Michael Kerrisk
        Glibc falls back to readlink() on kernels that lack readlinkat()

rename.2
    Michael Kerrisk
        Glibc falls back to rename() when the kernel doesn't have renameat()

sigwaitinfo.2
    Michael Kerrisk
        The raw sigtimedwait() system call has a fifth argument

symlink.2
    Michael Kerrisk
        Glibc falls back to symlink() on kernels that lack symlinkat()

unlink.2
    Michael Kerrisk
        Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()

getauxval.3
    Michael Kerrisk
        Document ENOENT error
            And add an entry to BUGS explaining the ambiguity that was
            present before the addition of this error.

proc.5
    Jan Chaloupka
        Add missing proc stats fields
            Adding missing proc stats fields from
            https://www.kernel.org/doc/Documentation/filesystems/proc.txt
    Michael Kerrisk
        Update /proc/PID/stat 'state' field documentation
    Michael Kerrisk
        Improve description of /proc/PID/stat fields added in Linux 3.3 and 3.5
    Michael Kerrisk
        Rework discussion of CommitLimit and /proc/sys/vm/overcommit_memory
    Michael Kerrisk
        Improve discussion of /proc/sys/vm/overcommit_ratio

inotify.7
    Michael Kerrisk
        Note that IN_ONLY_DIR can be used to avoid races
    Michael Kerrisk
        Note that insertion of IN_MOVED_FROM+IN_MOVED_TO pair is not atomic
    Michael Kerrisk
        Mention use of timeout when reading IN_MOVED_TO after IN_MOVED_FROM

man-pages.7
    Michael Kerrisk
        Add description of "C library/kernel ABI differences" subsection

vdso.7
    Mike Frysinger
        Add new i386 vdso symbols in Linux 3.15