man-pages-3.64 is released

[Michael Kerrisk (man-pages)]

Gidday,

The Linux man-pages maintainer proudly announces:

    man-pages-3.64 - 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.64

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2014/04/man-pages-364-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.64 ====================


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

open_by_handle_at.2
    Michael Kerrisk [Mike Frysinger, Neil Brown, Aneesh Kumar K.V,
    Christoph Hellwig]
        New page describing name_to_handle_at(2) and open_by_handle_at(2)

inotify.7
    Michael Kerrisk
        Rewrite introductory section
        Reorganize "Limitations and caveats" subsection
    Michael Kerrisk
        Further describe the race when adding a watch to a new subtree
    Michael Kerrisk
        Directory renames may invalidate multiple paths cached by application
    Michael Kerrisk
        Add paragraph on cache consistency checking
    Michael Kerrisk
        Mention cache rebuilding to handle overflow events
    Michael Kerrisk
        Moving an object to another filesystem generates IN_DELETE_SELF
    Michael Kerrisk [Jan Kara]
        Add text on dealing with rename() events
    Michael Kerrisk
        Note rationale and consequences of event coalescing
    Michael Kerrisk  [Eric W. Biederman]
        Inotify doesn't work for remote and pseudo filesystems
    Michael Kerrisk
        Add some examples of events generated by various system calls
    Michael Kerrisk
        BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
            A silent change as a result of the fanotify work in kernel 2.6.36.
    Michael Kerrisk
        Note that IN_DELETE_SELF will be followed by IN_IGNORED
    Michael Kerrisk
        Note that IN_UNMOUNT will be followed by an IN_IGNORED event
    Michael Kerrisk
        Inotify does not report events for mmap(2) and msync(2)
    Michael Kerrisk
        Add examples of syscalls that trigger IN_ATTRIB
    Michael Kerrisk
        Add some examples of syscalls that trigger IN_MODIFY
    Michael Kerrisk
        execve(2) also generates IN_ACCESS
    Michael Kerrisk
        Add examples of syscalls that trigger IN_CREATE


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

perf_event_open.2
    Vince Weaver [Michael Kerrisk]
        Document the PERF_FLAG_FD_CLOEXEC flag
            The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
            flag.

feature_test_macros.7
    Michael Kerrisk
        Document _LARGEFILE_SOURCE


tcp.7
    Michael Kerrisk  [Eric Dumazet]
        Document /proc/sys/net/ipv4/tcp_autocorking
            Text heavily based on Documentation/networking/ip-sys

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

perf_event_open.2
    Vince Weaver
        Document PERF_EVENT_IOC_PERIOD behavior change
            Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
            changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
            on all architectures to update immediately, to match the behavior
            found on ARM.

stat.2
    Michael Kerrisk
        Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used

syscalls.2
    Michael Kerrisk
        Add sched_getattr() and sched_setattr()
            And update kernel version to 3.14

getline.3
    Alexey Samsonov
        Caller should free the allocated buffer even if getline() failed
            Relevant discussion in glibc bugzilla:
            https://sourceware.org/bugzilla/show_bug.cgi?id=5666

termios.3
    Michael Kerrisk  [Peter Hurley]
        Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
            As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:

                read() may unblock when MIN bytes are available but return
                up to the 'count' parameter if more input arrives in between
                waking and copying into the user buffer.
                ...
                read() may also _not_ return until MIN bytes have been
                received, even if 'count' bytes have been received.
    Michael Kerrisk
        Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
            POSIX leaves the behavior open.
    Michael Kerrisk
        Clarify termination conditions for MIN > 0, TIME > 0
    Michael Kerrisk
        Clarify behavior if data is available before noncanonical read()
    Michael Kerrisk
        Add descriptive titles to noncanonical read() cases

symlink.7
    Michael Kerrisk
        Add subsection on opening a symbolic link with O_PATH
    Michael Kerrisk
        name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
    Michael Kerrisk
        Mention use of readlink(2) to read contents of a symlink

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/