Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754281AbdGUSyr (ORCPT ); Fri, 21 Jul 2017 14:54:47 -0400 Received: from mail-wm0-f48.google.com ([74.125.82.48]:35516 "EHLO mail-wm0-f48.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753502AbdGUSyq (ORCPT ); Fri, 21 Jul 2017 14:54:46 -0400 Cc: mtk.manpages@gmail.com To: lkml From: "Michael Kerrisk (man-pages)" Subject: man-pages-4.12 is released Message-ID: <6279a9cd-b874-5c22-4269-3bbb3e10e9b7@gmail.com> Date: Fri, 21 Jul 2017 20:54:43 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.4.0 MIME-Version: 1.0 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 Content-Length: 5737 Lines: 173 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/