==================== Changes in man-pages-4.12 ====================
Released: 2017-07-13, London
Contributors
------------
The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
Alex Henrie <alexhenrie24@gmail.com>
Andi Kleen <andi-bz.firstfloor.org>
Arjun Shankar <arjun.is@lostca.se>
Brad Bendily <bendily@gmail.com>
Cameron Wright <wright18@uw.edu>
Carlos O'Donell <carlos@redhat.com>
Darrick J. Wong <darrick.wong@oracle.com>
David Lewis <davlewi3@cisco.com>
DJ Delorie <dj@delorie.com>
Douglas Caetano dos Santos <douglascs@taghos.com.br>
Dr. Tobias Quathamer <toddy@debian.org>
Eric Biggers <ebiggers@google.com>
Ferdinand Thiessen <f.thiessen@gmx.de>
G. Branden Robinson <g.branden.robinson@gmail.com>
Heinrich Schuchardt <xypron.glpk@gmx.de>
Henry Bent <henry.r.bent@gmail.com>
Jakub Wilk <jwilk@jwilk.net>
Janne Snabb <snabb@epipe.com>
Joe Brown <joe.brown.89@outlook.com>
Jorge Nerin <jnerin@gmail.com>
Kirill Tkhai <ktkhai@virtuozzo.com>
lilydjwg <lilydjwg@gmail.com>
Long Wang <w@laoqinren.net>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@chromium.org>
Nadav Har'El <nyh@math.technion.ac.il>
NeilBrown <neilb@suse.com>
Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
Quentin Rameau <quinq@fifth.space>
Ruben Kerkhof <ruben@rubenkerkhof.com>
sulit <sulitsrc@foxmail.com>
石井大貴 <hiroki.ishii@miraclelinux.com>
Apologies if I missed anyone!
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'
chmod.2
Michael Kerrisk
Put fchmod() feature test macro requirements in a more readable format
Michael Kerrisk
Note glibc 2.24 feature test macro requirements changes for fchmod()
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().
get_mempolicy.2
Michael Kerrisk [Nadav Har'El, Andi Kleen]
SYNOPSIS: fix return type of get_mempolicy()
See https://bugzilla.kernel.org/show_bug.cgi?id=97051
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
ioctl.2
Michael Kerrisk
SEE ALSO: add ioctl_getfsmap(2)
ioctl_getfsmap.2
Michael Kerrisk
Fix ordering of sections
Michael Kerrisk
Add VERSIONS section
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.
Michael Kerrisk
ERRORS: order alphabetically
madvise.2
Michael Kerrisk
Remove bogus text re POSIX_MADV_NOREUSE
There is a POSIX_FADV_NOREUSE for posix_fadvise(),
but no POSIX_MADV_NOREUSE for any API in POSIX.
membarrier.2
Michael Kerrisk
Add ENOSYS error for 'nohz_full' CPU setting
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
pipe.2
Michael Kerrisk
SEE ALSO: add tee(2) and vmsplice(2)
readv.2
Michael Kerrisk
glibc 2.26 adds library support for preadv2() and pwritev2()
sched_setaffinity.2
Michael Kerrisk
Mention cpuset cgroups as a cause of EINVAL error
seccomp.2
Mike Frysinger
Expand SECCOMP_RET_KILL documentation
sigaction.2
Michael Kerrisk
Note feature test macro requirements for 'si_code' constants
Michael Kerrisk
Add a subheading for the description of 'si_code'
Michael Kerrisk
TRAP_BRANCH and TRAP_HWBKPT are present only on IA64
sigaltstack.2
Michael Kerrisk
Note that specifying SS_ONSTACK in ss.ss_flags decreases portability
In the Illumos source (which presumably mirrors its Solaris
ancestry), there is this check in the sigaltstack()
implementation:
if (ss.ss_flags & ~SS_DISABLE)
return (set_errno(EINVAL));
And in the FreeBSD source we find similar:
if ((ss->ss_flags & ~SS_DISABLE) != 0)
return (EINVAL);
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
splice.2
tee.2
vmsplice.2
Michael Kerrisk
SEE ALSO: add pipe(7)
splice.2
Michael Kerrisk
ERRORS: split EINVAL error cases
Michael Kerrisk
ERRORS: add EINVAL for case where both descriptors refer to same pipe
timer_create.2
Michael Kerrisk
Document the CONFIG_POSIX_TIMERS option added in Linux 4.10
wait.2
Michael Kerrisk
Note glibc 2.26 changes to feature test macro requirements for waitid()
acosh.3
asinh.3
atanh.3
Alex Henrie
Remove C89 designation.
See https://bugzilla.kernel.org/show_bug.cgi?id=196319
[mtk: confirmed from review of draft of C90 standard]
bsd_signal.3
Michael Kerrisk
Note feature test macro requirements changes for glibc 2.26
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.
Michael Kerrisk
Expand the code example, and show sample output
Michael Kerrisk
List values for the 'p_type' field
dlsym.3
Michael Kerrisk
_GNU_SOURCE is needed to get RTLD_DEFAULT and RTLD_NEXT definitions
flockfile.3
Michael Kerrisk
Note glibc 2.24 feature test macro requirement changes
fpathconf.3
Michael Kerrisk
Rework RETURN VALUE description to add more detail
Michael Kerrisk
Add an errors section
Michael Kerrisk
Largely rewrite the description of _PC_CHOWN_RESTRICTED
Michael Kerrisk
Rewrite description of _PC_PIPE_BUF
The existing description was not accurate, and lacked details.
ftw.3
Michael Kerrisk
BUGS: document a probable glibc regression in FTW_SLN case
See https://bugzilla.redhat.com/show_bug.cgi?id=1422736
and http://austingroupbugs.net/view.php?id=1121.
getaddrinfo.3
Quentin Rameau
Fix _POSIX_C_SOURCE value for getaddrinfo()
The correct _POSIX_C_SOURCE value is 200112L, not 201112L in features.h.
getcontext.3
Carlos O'Donell
Exemplar structure should use 'ucontext_t'.
In glibc we just finished a round of purging 'struct ucontext'
which is not in the POSIX reserved namespace of *_t tags. This has
some consequences to applications using the non-standard struct
ucontext:
https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
but it also fixes a namespace conformance issue which is always a
longterm pain for large portable programs.
It was noted by Peter Maydell
(https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
linux man pages still had references to 'struct ucontext' but only
in the form of an exemplar structure.
The patch fixes the exemplar to match what is in glibc
and therefore it won't ever suggest users can use 'struct
ucontext'.
getgrent.3
Michael Kerrisk
Note glibc 2.22 changes for feature test macro requirements
grantpt.3
ptsname.3
unlockpt.3
Ferdinand Thiessen [Michael Kerrisk]
Update feature test macro-requirements for glibc 2.24
if_nametoindex.3
Douglas Caetano dos Santos
Add ENODEV error for if_nametoindex()
Checked against glibc and kernel code: when given name isn't
a valid interface, kernel returns ENODEV and glibc just
forwards it.
malloc.3
Michael Kerrisk
Document the reallocarray() added in glibc 2.26
nl_langinfo.3
Michael Kerrisk
Note feature test macro requirements for nl_langinfo_l()
posix_madvise.3
Dr. Tobias Quathamer
Remove paragraph about POSIX_FADV_NOREUSE
POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.
Thanks to Marc Lehmann <debian-reportbug@plan9.de>
See https://bugs.debian.org/865699
ptsname.3
Michael Kerrisk [Arjun Shankar]
Since glibc 2.26, ptsname_r() no longer gives EINVAL for buf==NULL
rand.3
Michael Kerrisk
Note glibc 2.24 feature test macro requirement changes for rand_r()
resolver.3
Michael Kerrisk
Add basic notes on 'op' argument of res_nmkquery() and res_mkquery()
sigpause.3
Michael Kerrisk
Note glibc 2.26 changes to feature test macro requirements
sigwait.3
Michael Kerrisk
Note glibc 2.26 feature test macro changes
strtol.3
Heinrich Schuchardt
Mention 0X prefix
The prefix 0x may be capitalized as 0X.
See ISO/IEC 9899:1999.
sysconf.3
Michael Kerrisk [Pavel Tikhomirov]
Rework RETURN VALUE description to add more detail
Make the discussion clearer, and add a few details.
Also, fix the problem report from Pavel Tikhomirov
who noted that the man page falsely said that errno
is not changed on a successful return.
Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955
sysconf.3
Michael Kerrisk
Add ERRORS section
ttyslot.3
Michael Kerrisk
Fix error in feature test macro requirements
Michael Kerrisk
Note feature test macro requirements changes in glibc 2.24
Michael Kerrisk
Clarify details of use of <stdlib.h> file
unlocked_stdio.3
Michael Kerrisk
Note glibc 2.24 feature test macro requirement changes
elf.5
Michael Kerrisk
SEE ALSO: add dl_iterate_phdr(3)
nsswitch.conf.5
DJ Delorie
Clarify group merge rules
This minor patch clarifies when merging is not done,
and how duplicate entries are merged.
Found while extending glibc's NSS test suite, discussed with glibc
team and Stephen Gallagher.
proc.5
Michael Kerrisk
Document that 'iowait' field of /proc/stat is unreliable
Text taken from Chao Fan's kernel commit 9c240d757658a3ae996.
slabinfo.5
Michael Kerrisk [Jorge Nerin]
SEE ALSO: add some references to relevant kernel source files
tmpfs.5
Michael Kerrisk
SEE ALSO: add memfd_create(2), mmap(2), shm_open(3)
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
Michael Kerrisk
SEE ALSO: add filecap(8), netcap(8), pscap(8)
cgroup_namespaces.7
Michael Kerrisk
Add some further explanation of the example shell session
Michael Kerrisk
Fix a bug in shell session example
Michael Kerrisk
Some minor wording fixes and clarifications
inode.7
Michael Kerrisk
Note glibc 2.24 feature test macro changes for S_IFSOCK and S_ISSOCK()
man.7
G. Branden Robinson
Undocument "URL" macro in man(7) in favor .UR+.UE
pid_namespaces.7
Michael Kerrisk
Mention /proc/[pid]/ns/pid_for_children
pipe.7
Michael Kerrisk
SEE ALSO: add tee(2) and vmsplice(2)
sigevent.7
Michael Kerrisk
Mention signal.h header file
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.
Every 3 years we get asked why DT_RUNPATH doesn't work like DT_RPATH.
The most recent question was here:
https://www.sourceware.org/ml/libc-help/2017-06/msg00013.html
We need to expand the description of DT_RUNPATH to cover this
situation and explain that the DT_RUNPATH entries apply only to the
immediate DT_NEEDED, not that of another, say dlopen'd child object.
Michael Kerrisk
Since glibc 2.2.5, LD_PROFILE is ignored in secure-execution mode
Michael Kerrisk
Make notes on secure-execute mode more prominent
Place each note on secure-execution mode in a separate
paragraph, to make it more obvious.
Michael Kerrisk
Note that libraries in standard directories are not normally set-UID
In secure mode, LD_PRELOAD loads only libraries from standard
directories that are marked set-UID. Note that it is unusual for
a library to be marked in this way.
Michael Kerrisk
SEE ALSO: add elf(5)
Michael Kerrisk
Note version where secure-execution started ignoring LD_USE_LOAD_BIAS
Michael Kerrisk
Correct glibc version that ignores LD_SHOW_AUXV in secure-execution mode
Ignored since 2.3.4 (not 2.3.5).
Michael Kerrisk
Rewrite LD_DEBUG_OUTPUT description and note that .PID is appended
