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/