mirror of https://github.com/mkerrisk/man-pages
Changes: Ready for 3.61
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
17b028d622
commit
d1cc0fa80a
399
Changes
399
Changes
|
@ -10,6 +10,19 @@ The following people contributed patches/fixes or (noted in brackets
|
||||||
in the changelog below) reports, notes, and ideas that have been
|
in the changelog below) reports, notes, and ideas that have been
|
||||||
incorporated in changes in this release:
|
incorporated in changes in this release:
|
||||||
|
|
||||||
|
Andrew Hunter <ahh@google.com>
|
||||||
|
Carlos O'Donell <carlos@redhat.com>
|
||||||
|
Christoph Hellwig <hch@infradead.org>
|
||||||
|
Daniel Borkmann <dborkman@redhat.com>
|
||||||
|
Duncan de Wet <duncandewet@gmail.com>
|
||||||
|
Kir Kolyshkin <kir@openvz.org>
|
||||||
|
KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
|
||||||
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||||
|
Neil Horman <nhorman@tuxdriver.com>
|
||||||
|
Peng Haitao <penght@cn.fujitsu.com>
|
||||||
|
Simon Paillard <spaillard@debian.org>
|
||||||
|
Sulaiman Mustafa <seininn@hush.com>
|
||||||
|
Xiawei Chen <chenxiawei@gmail.com>
|
||||||
|
|
||||||
Apologies if I missed anyone!
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
@ -17,19 +30,401 @@ Apologies if I missed anyone!
|
||||||
New and rewritten pages
|
New and rewritten pages
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
|
A note from Christoph Hellwig prompted me to perform a task that has
|
||||||
|
been queued for a while: merging the text of the man pages for the
|
||||||
|
*at([23]) ("directory file descriptor") APIs into their corresponding
|
||||||
|
traditional pages. When the *at([23]) pages were originally written
|
||||||
|
(mostly in 2006), the APIs were not part of POSIX and (in most cases)
|
||||||
|
were not available on other systems. So, it made some sense to wall
|
||||||
|
them off into their own separate pages. Eight years later, with the
|
||||||
|
APIs now all in POSIX (except scandirat()), it is much more sensible
|
||||||
|
to document the newer APIs alongside their traditional counterparts,
|
||||||
|
so that the newer APIs are not "hidden", and the reader can more
|
||||||
|
easily see the differences between the APIs.
|
||||||
|
|
||||||
|
Thus, the text of 14 pairs of pages has been merged, and the "merged
|
||||||
|
from" pages have been converted to links to the "merged to" pages.
|
||||||
|
Along the way, a few other fixes were made to the pages, as noted
|
||||||
|
below.
|
||||||
|
|
||||||
|
One page that did not undergo such a change was utimensat(2), which
|
||||||
|
is different enough from utime(2) that it warrants a separate page.
|
||||||
|
Unlike the other *at() pages, the utimensat(2) page was also already
|
||||||
|
self-contained, rather than defining itself in terms of differences
|
||||||
|
from utime(2) as the other *at() pages did.
|
||||||
|
|
||||||
|
access.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text from faccessat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove faccessat() race warning
|
||||||
|
That point is already covered in existing text in this page.
|
||||||
|
Michael Kerrisk
|
||||||
|
access() also conforms to POSIX.1-2008
|
||||||
|
|
||||||
|
chmod.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text from fchmodat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
Use argument name 'pathname' throughout page
|
||||||
|
(Some APIs were using 'path' while others used 'pathname')
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: chmod() and fchmod() are also in POSIX.1-2008
|
||||||
|
|
||||||
|
chown.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of fchownat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
|
||||||
|
Michael Kerrisk
|
||||||
|
Use argument name 'pathname' throughout page
|
||||||
|
(Some APIs were using 'path' while others used 'pathname')
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove sentence that fchownat() is present on Solaris
|
||||||
|
That point was only really relevant before fchownat() was
|
||||||
|
standardized in POSIX.1.2008.
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: chown(), fchown(), lchown() are in POSIX.1-2008
|
||||||
|
|
||||||
|
link.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of linkat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: link() is in POSIX.1-2008
|
||||||
|
Michael Kerrisk
|
||||||
|
AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
|
||||||
|
|
||||||
|
mkdir.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of mkdirat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: mkdir() is in POSIX.1-2008
|
||||||
|
|
||||||
|
mknod.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of mknodat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: mknod(2) is in POSIX.1-2008
|
||||||
|
|
||||||
|
open.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text from openat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove sentence that openat() is present on Solaris
|
||||||
|
That point was only really relevant before openat() was
|
||||||
|
standardized in POSIX.1.2008.
|
||||||
|
|
||||||
|
readlink.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of readlinkat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: readlink() is in POSIX.1-2008.
|
||||||
|
Michael Kerrisk
|
||||||
|
Use argument name 'pathname' throughout page
|
||||||
|
(Some APIs were using 'path' while others used 'pathname')
|
||||||
|
|
||||||
|
rename.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of renameat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: rename(2) is in POSIX.1-2008
|
||||||
|
|
||||||
|
stat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text from fstatat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
AT_EMPTY_PATH and AT_NO_AUTOMOUNT are Linux-specific
|
||||||
|
These flags require _GNU_SOURCE.
|
||||||
|
Michael Kerrisk
|
||||||
|
Use argument name 'pathname' throughout page
|
||||||
|
(Some APIs were using 'path' while others used 'pathname')
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove sentence that fstatat() is present on Solaris
|
||||||
|
That point was only really relevant before fstatat() was
|
||||||
|
standardized in POSIX.1.2008.
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: stat(), fstat(), lstat() are specified in POSIX.1-2008
|
||||||
|
|
||||||
|
symlink.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of symlinkat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: symlink() is in POSIX.1-2008
|
||||||
|
|
||||||
|
unlink.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of unlinkat(2)
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove sentence that unlinkat() is present on Solaris
|
||||||
|
That point was only really relevant before unlinkat() was
|
||||||
|
standardized in POSIX.1.2008.
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: unlink() is in POSIX.1-2008
|
||||||
|
|
||||||
|
mkfifo.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of mkfifoat(3)
|
||||||
|
Michael Kerrisk
|
||||||
|
CONFORMING TO: mkfifo() is in POSIX.1-2008
|
||||||
|
|
||||||
|
scandir.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Merge text of scandirat(3)
|
||||||
|
Michael Kerrisk
|
||||||
|
Update feature test macro requirements
|
||||||
|
The FTM requirements changed in glibc 2.10.
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove libc4/libc5 note under CONFORMING TO
|
||||||
|
No-one much cares about Linux libc these days.
|
||||||
|
Michael Kerrisk
|
||||||
|
Put detail about alphasort under a NOTES heading
|
||||||
|
This text was under CONFORMING TO, which made no sense.
|
||||||
|
Michael Kerrisk
|
||||||
|
Rework CONFORMING TO text
|
||||||
|
|
||||||
|
|
||||||
Newly documented interfaces in existing pages
|
Newly documented interfaces in existing pages
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
|
prctl.2
|
||||||
|
Kir Kolyshkin
|
||||||
|
Document PR_SET_MM options in Linux 3.5
|
||||||
|
Some of the PR_SET_MM options were merged to vanilla kernel
|
||||||
|
later, and appeared in Linux 3.5. Those are:
|
||||||
|
|
||||||
|
- PR_SET_MM_ARG_START
|
||||||
|
- PR_SET_MM_ARG_END
|
||||||
|
- PR_SET_MM_ENV_START
|
||||||
|
- PR_SET_MM_ENV_END
|
||||||
|
- PR_SET_MM_AUXV
|
||||||
|
- PR_SET_MM_EXE_FILE
|
||||||
|
|
||||||
|
socket.7
|
||||||
|
Neil Horman
|
||||||
|
Document the SO_RXQ_OVFL socket option
|
||||||
|
Michael Kerrisk
|
||||||
|
|
||||||
|
|
||||||
New and changed links
|
New and changed links
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
|
faccessat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to access.2
|
||||||
|
|
||||||
Global changes
|
fchmodat.2
|
||||||
--------------
|
Michael Kerrisk
|
||||||
|
Convert to link to chmod.2
|
||||||
|
|
||||||
|
fchownat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to chown.2
|
||||||
|
|
||||||
|
fstatat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to stat.2
|
||||||
|
|
||||||
|
linkat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to link.2
|
||||||
|
|
||||||
|
mkdirat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to mkdir.2
|
||||||
|
|
||||||
|
mknodat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to mknod.2
|
||||||
|
|
||||||
|
openat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to open.2
|
||||||
|
|
||||||
|
readlinkat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to symlink.2
|
||||||
|
|
||||||
|
renameat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link rename.2
|
||||||
|
|
||||||
|
symlinkat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to symlink.2
|
||||||
|
|
||||||
|
unlinkat.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to unlink.2
|
||||||
|
|
||||||
|
mkfifoat.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to mkfifo.3
|
||||||
|
|
||||||
|
scandirat.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Convert to link to scandir.3
|
||||||
|
|
||||||
|
|
||||||
Changes to individual pages
|
Changes to individual pages
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
||||||
|
alarm.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Note semantics of alarm with respect to fork() and execve()
|
||||||
|
|
||||||
|
fcntl.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Warn that F_GETLK info may already be out of date when the call returns
|
||||||
|
|
||||||
|
intro.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Describe policy on documenting differences between syscall and glibc API
|
||||||
|
|
||||||
|
mmap2.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Reword note on glibc mmap() wrapper invocation of mmap2()
|
||||||
|
Michael Kerrisk
|
||||||
|
This system call does not exist on x86-64
|
||||||
|
|
||||||
|
msgctl.2
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: add EPERM for unprivileged attempt to set msg_qbytes > MSGMNB
|
||||||
|
|
||||||
|
prctl.2
|
||||||
|
Michael Kerrisk [Xiawei Chen]
|
||||||
|
Clarify that PR_GET_TIMERSLACK is returned as the function result
|
||||||
|
Michael Kerrisk
|
||||||
|
Clarify that PR_GET_SECCOMP is returned as function result
|
||||||
|
Michael Kerrisk
|
||||||
|
Clarify that PR_GET_NO_NEW_PRIVS is returned as function result
|
||||||
|
|
||||||
|
ptrace.2
|
||||||
|
Michael Kerrisk [Andrew Hunter]
|
||||||
|
Make it clearer that glibc and syscall APIs differ for PTRACE_PEEK*
|
||||||
|
Thanks to Denys Vlasenko's additions in 78686915aed6bd12
|
||||||
|
this page does note that the glibc API for PTRACE_PEEK*
|
||||||
|
differs from the raw syscall interface. But, as the report
|
||||||
|
at https://bugzilla.kernel.org/show_bug.cgi?id=70801 shows,
|
||||||
|
this information could be more obvious. This patch makes its so.
|
||||||
|
|
||||||
|
sgetmask.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Note that these system calls don't exist on x86-64
|
||||||
|
|
||||||
|
swapon.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Split EINVAL cases into separate entries under ERRORS
|
||||||
|
Michael Kerrisk
|
||||||
|
Add EINVAL error for invalid flags to swapon()
|
||||||
|
|
||||||
|
syscalls.2
|
||||||
|
Michael Kerrisk
|
||||||
|
SEE ALSO: add intro(2)
|
||||||
|
|
||||||
|
umount.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Split EINVAL cases into separate items
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: Add EINVAL case that was new in 2.6.34
|
||||||
|
|
||||||
|
utime.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Add note that modern applications probably want utimensat(2) etc.
|
||||||
|
|
||||||
|
crypt.3
|
||||||
|
Michael Kerrisk [KOSAKI Motohiro]
|
||||||
|
ERRORS: Add EINVAL and EPERM errors
|
||||||
|
See https://bugzilla.kernel.org/show_bug.cgi?id=69771
|
||||||
|
|
||||||
|
getifaddrs.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Enhance example program
|
||||||
|
Print statistics for AF_PACKET interfaces.
|
||||||
|
Add missing feature test macro definition.
|
||||||
|
Reformat output.
|
||||||
|
|
||||||
|
iswctype.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function iswctype() is thread safe.
|
||||||
|
|
||||||
|
sem_post.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function sem_post() is thread safe.
|
||||||
|
|
||||||
|
sem_unlink.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function sem_unlink() is thread safe.
|
||||||
|
|
||||||
|
sem_wait.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note functions that are thread-safe
|
||||||
|
The functions sem_wait(), sem_trywait() and sem_timedwait() are
|
||||||
|
thread safe.
|
||||||
|
|
||||||
|
setbuf.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note functions that are thread-safe
|
||||||
|
The functions setbuf(), setbuffer(), setlinebuf() and setvbuf()
|
||||||
|
are thread safe.
|
||||||
|
|
||||||
|
strlen.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function strlen() is thread safe.
|
||||||
|
|
||||||
|
strnlen.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function strnlen() is thread safe.
|
||||||
|
|
||||||
|
strpbrk.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function strpbrk() is thread safe.
|
||||||
|
|
||||||
|
strsep.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function strsep() is thread safe.
|
||||||
|
|
||||||
|
swab.3
|
||||||
|
Peng Haitao
|
||||||
|
ATTRIBUTES: Note function that is thread-safe
|
||||||
|
The function swab() is thread safe.
|
||||||
|
|
||||||
|
resolv.conf.5
|
||||||
|
Carlos O'Donell
|
||||||
|
DESCRIPTION: mention that the data is trusted
|
||||||
|
In a recent discussion about DNSSEC it was brought to my
|
||||||
|
attention that not all system administrators may understand
|
||||||
|
that the information in /etc/resolv.conf is fully trusted.
|
||||||
|
The resolver implementation in glibc treats /etc/resolv.conf
|
||||||
|
as a fully trusted source of DNS information and passes on
|
||||||
|
the AD-bit for DNSSEC as trusted.
|
||||||
|
|
||||||
|
This patch adds a clarifying sentence to make it absolutely
|
||||||
|
clear that indeed this source of information is trusted.
|
||||||
|
|
||||||
|
ascii.7
|
||||||
|
Michael Kerrisk [Sulaiman Mustafa]
|
||||||
|
Fix rendering of single quote (decimal character 39)
|
||||||
|
Michael Kerrisk
|
||||||
|
SEE ALSO: add utf-8(7)
|
||||||
|
Michael Kerrisk [Duncan de Wet]
|
||||||
|
Remove mention of ISO 8859-1 as being the default encoding on Linux
|
||||||
|
|
||||||
|
packet.7
|
||||||
|
Neil Horman
|
||||||
|
Document PACKET_FANOUT_QM fanout mode
|
||||||
|
Michael Kerrisk
|
||||||
|
Add kernel version for PACKET_FANOUT_QM
|
||||||
|
Daniel Borkmann
|
||||||
|
Improve PACKET_QDISC_BYPASS description
|
||||||
|
|
||||||
|
socket.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Add kernel version number for SO_BUSY_POLL
|
||||||
|
Add kernel version number for SO_RXQ_OVFL
|
||||||
|
|
Loading…
Reference in New Issue