Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754225AbaDFKCB (ORCPT ); Sun, 6 Apr 2014 06:02:01 -0400 Received: from mail-bk0-f53.google.com ([209.85.214.53]:37914 "EHLO mail-bk0-f53.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754143AbaDFKBz (ORCPT ); Sun, 6 Apr 2014 06:01:55 -0400 Message-ID: <5341260E.4040204@gmail.com> Date: Sun, 06 Apr 2014 12:01:50 +0200 From: "Michael Kerrisk (man-pages)" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.4.0 MIME-Version: 1.0 To: lkml CC: mtk.manpages@gmail.com Subject: man-pages-3.64 is released Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/