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/