mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-5.14: updating Changes and Changes.old
This commit is contained in:
parent
333691eb13
commit
2af47cd371
330
Changes
330
Changes
|
@ -1,47 +1,7 @@
|
||||||
==================== Changes in man-pages-5.13 ====================
|
==================== Changes in man-pages-5.14 ====================
|
||||||
|
|
||||||
Released: 2021-08-27, Christchurch
|
Released: ????-??-??, Munich
|
||||||
|
|
||||||
Ahelenia Ziemiańska (наб) <nabijaczleweli@nabijaczleweli.xyz>
|
|
||||||
Alan Peakall <Alan.Peakall@helpsystems.com>
|
|
||||||
Alejandro Colomar <alx.manpages@gmail.com>
|
|
||||||
Alexis Wilke <alexis@m2osw.com>
|
|
||||||
Askar Safin <safinaskar@mail.ru>
|
|
||||||
Christian Brauner <christian.brauner@ubuntu.com>
|
|
||||||
Christophe Leroy <christophe.leroy@csgroup.eu>
|
|
||||||
Christopher Yeleighton <giecrilj@stegny.2a.pl>
|
|
||||||
Cristian Morales Vega <christian.morales.vega@gmail.com>
|
|
||||||
Dan Robertson <dan@dlrobertson.com>
|
|
||||||
Darrick J. Wong <djwong@kernel.org>
|
|
||||||
Dominique Brazziel <dbrazziel@snet.net>
|
|
||||||
EmanueleTorre <torreemanuele6@gmail.com>
|
|
||||||
Eric W. Biederman <ebiederm@xmission.com>
|
|
||||||
G. Branden Robinson <g.branden.robinson@gmail.com>
|
|
||||||
Helge Kreutzmann <debian@helgefjell.de>
|
|
||||||
Jakub Wilk <jwilk@jwilk.net>
|
|
||||||
James O. D. Hunt <jamesodhunt@gmail.com>
|
|
||||||
Jonny Grant <jg@jguk.org>
|
|
||||||
Kees Cook <keescook@chromium.org>
|
|
||||||
Kir Kolyshkin <kolyshkin@gmail.com>
|
|
||||||
Kurt Kanzenbach <kurt@linutronix.de>
|
|
||||||
kXuan <kxuanobj@gmail.com>
|
|
||||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
|
||||||
Michael Weiß <michael.weiss@aisec.fraunhofer.de>
|
|
||||||
NeilBrown <neilb@suse.de>
|
|
||||||
Nora Platiel <nplatiel@gmx.us>
|
|
||||||
Pali Rohár <pali@kernel.org>
|
|
||||||
Peter Collingbourne <pcc@google.com>
|
|
||||||
Richard Palethorpe <rpalethorpe@suse.com>
|
|
||||||
Rodrigo Campos <rodrigo@kinvolk.io>
|
|
||||||
Sagar Patel <sagarmp@cs.unc.edu>
|
|
||||||
Serge E. Hallyn <serge@hallyn.com>
|
|
||||||
Sergey Petrakov <kr@spmail.info>
|
|
||||||
Stefan Kanthak <stefan.kanthak@nexgo.de>
|
|
||||||
Štěpán Němec <stepnem@gmail.com>
|
|
||||||
Thomas Gleixner <tglx@linutronix.de>
|
|
||||||
Thomas Voss <thomasavoss@protonmail.com>
|
|
||||||
Viet Than <thanhoangviet@gmail.com>
|
|
||||||
Will Manley <will@williammanley.net>
|
|
||||||
|
|
||||||
Contributors
|
Contributors
|
||||||
------------
|
------------
|
||||||
|
@ -57,301 +17,19 @@ Apologies if I missed anyone!
|
||||||
New and rewritten pages
|
New and rewritten pages
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
mount_setattr.2
|
|
||||||
Christian Brauner [Alejandro Colomar, Michael Kerrisk]
|
|
||||||
New manual page documenting the mount_setattr() system call
|
|
||||||
|
|
||||||
|
|
||||||
Newly documented interfaces in existing pages
|
Newly documented interfaces in existing pages
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
futex.2
|
|
||||||
Kurt Kanzenbach [Alejandro Colomar, Thomas Gleixner, Michael Kerrisk]
|
|
||||||
Document FUTEX_LOCK_PI2
|
|
||||||
|
|
||||||
ioctl_tty.2
|
New and changed links
|
||||||
Pali Rohár [Alejandro Colomar, Michael kerrisk]
|
---------------------
|
||||||
Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2
|
|
||||||
|
|
||||||
pidfd_open.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Document PIDFD_NONBLOCK
|
|
||||||
|
|
||||||
seccomp_unotify.2
|
|
||||||
Rodrigo Campos [Alejandro Colomar]
|
|
||||||
Document SECCOMP_ADDFD_FLAG_SEND
|
|
||||||
|
|
||||||
sigaction.2
|
|
||||||
Peter Collingbourne [Alejandro Colomar, Michael Kerrisk]
|
|
||||||
Document SA_EXPOSE_TAGBITS and the flag support detection protocol
|
|
||||||
|
|
||||||
statx.2
|
|
||||||
NeilBrown
|
|
||||||
Document STATX_MNT_ID
|
|
||||||
capabilities.7
|
|
||||||
user_namespaces.7
|
|
||||||
Michael Kerrisk, Kir Kolyshkin [Alejandro Colomar]
|
|
||||||
Describe CAP_SETFCAP for mapping UID 0
|
|
||||||
|
|
||||||
mount_namespaces.7
|
|
||||||
Michael Kerrisk [Christian Brauner, Eric W. Biederman]
|
|
||||||
More clearly explain the notion of locked mounts
|
|
||||||
For a long time, this manual page has had a brief discussion of
|
|
||||||
"locked" mounts, without clearly saying what this concept is, or
|
|
||||||
why it exists. Expand the discussion with an explanation of what
|
|
||||||
locked mounts are, why mounts are locked, and some examples of the
|
|
||||||
effect of locking.
|
|
||||||
user_namespaces.7
|
|
||||||
Michael Kerrisk
|
|
||||||
Document /proc/PID/projid_map
|
|
||||||
|
|
||||||
ld.so.8
|
|
||||||
Michael Kerrisk
|
|
||||||
Document --list-tunables option added in glibc 2.33
|
|
||||||
|
|
||||||
|
|
||||||
Global changes
|
Global changes
|
||||||
--------------
|
--------------
|
||||||
|
|
||||||
A few pages
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: correct alphabetic order
|
|
||||||
|
|
||||||
A few pages
|
|
||||||
Michael Kerrisk
|
|
||||||
Place SEE ALSO entries in correct order
|
|
||||||
|
|
||||||
A few pages
|
|
||||||
Michael Kerrisk
|
|
||||||
Arrange .SH sections in correct order
|
|
||||||
|
|
||||||
Various pages
|
|
||||||
Michael Kerrisk
|
|
||||||
Fix EBADF error description
|
|
||||||
Make the description of the EBADF error for invalid 'dirfd' more
|
|
||||||
uniform. In particular, note that the error only occurs when the
|
|
||||||
pathname is relative, and that it occurs when the 'dirfd' is
|
|
||||||
neither valid *nor* has the value AT_FDCWD.
|
|
||||||
|
|
||||||
Various pages
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: combine errors into a single alphabetic list
|
|
||||||
These pages split out extra errors for some APIs into a separate
|
|
||||||
list. Probably, the pages are easier to ready if all errors are
|
|
||||||
combined into a single list.
|
|
||||||
|
|
||||||
Note that there still remain a few pages where the errors are
|
|
||||||
listed separately for different APIs. For the moment, it seems
|
|
||||||
best to leave those pages as is, since the error lists are
|
|
||||||
largely distinct in those pages.
|
|
||||||
|
|
||||||
VArious pages
|
|
||||||
Michael Kerrisk
|
|
||||||
Terminology clean-up: "mount point" ==> "mount"
|
|
||||||
Many times, these pages use the terminology "mount point", where
|
|
||||||
"mount" would be better. A "mount point" is the location at which
|
|
||||||
a mount is attached. A "mount" is an association between a
|
|
||||||
filesystem and a mount point.
|
|
||||||
|
|
||||||
accept.2
|
|
||||||
access.2
|
|
||||||
getpriority.2
|
|
||||||
mlock.2
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: combine errors into a single list
|
|
||||||
These pages split out errors into separate lists (perhaps per API,
|
|
||||||
perhaps "may" vs "shall", perhaps "Linux-specific" vs
|
|
||||||
standard(??)), but there's no good reason to do this. It makes
|
|
||||||
the error list harder to read, and is inconsistent with other
|
|
||||||
pages. So, combine the errors into a single list.
|
|
||||||
|
|
||||||
fanotify_mark.2
|
|
||||||
futimesat.2
|
|
||||||
mount_setattr.2
|
|
||||||
statx.2
|
|
||||||
symlink.2
|
|
||||||
mkfifo.3
|
|
||||||
Michael Kerrisk
|
|
||||||
Refer the reader to openat(2) for explanation of why 'dirfd' is useful
|
|
||||||
|
|
||||||
Various pages
|
|
||||||
Thomas Voss [Alejandro Colomar]
|
|
||||||
Consistently use '*argv[]'
|
|
||||||
|
|
||||||
|
|
||||||
Changes to individual pages
|
Changes to individual pages
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
||||||
iconv.1
|
|
||||||
iconvconfig.8
|
|
||||||
Michael Kerrisk [Christopher Yeleighton]
|
|
||||||
FILES: note that files may be under /usr/lib64 rather than /lib/64
|
|
||||||
See https://bugzilla.kernel.org/show_bug.cgi?id=214163
|
|
||||||
|
|
||||||
ldd.1
|
|
||||||
Alejandro Colomar [EmanueleTorre]
|
|
||||||
Fix example command
|
|
||||||
|
|
||||||
add_key.2
|
|
||||||
keyctl.2
|
|
||||||
request_key.2
|
|
||||||
Michael Kerrisk [Dominique Brazziel]
|
|
||||||
Note that the "libkeyutils" package provides <keyutils.h>
|
|
||||||
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992377
|
|
||||||
|
|
||||||
close_range.2
|
|
||||||
Michael Kerrisk, Alejandro Colomar
|
|
||||||
Glibc 2.34 has added a close_range() wrapper
|
|
||||||
|
|
||||||
execve.2
|
|
||||||
Michael Kerrisk [Nora Platiel]
|
|
||||||
The pathname given to interpreter is not necessarily absolute
|
|
||||||
Michael Kerrisk
|
|
||||||
SEE ALSO: getauxval(3)
|
|
||||||
getauxval(3) is useful background regarding execve(2).
|
|
||||||
|
|
||||||
fanotify_mark.2
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: add missing EBADF error for invalid 'dirfd'
|
|
||||||
|
|
||||||
ioctl_tty.2
|
|
||||||
Pali Rohár [Alejandro Colomar]
|
|
||||||
Update DTR example
|
|
||||||
Do not include unused (and incompatible) header file termios.h and
|
|
||||||
include required header files for puts() and close() functions.
|
|
||||||
|
|
||||||
mount.2
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: add EPERM error for case where a mount is locked
|
|
||||||
Refer the reader to mount_namespaces(7) for details.
|
|
||||||
Michael Kerrisk
|
|
||||||
SEE ALSO: add mount_setattr(2)
|
|
||||||
|
|
||||||
open.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Explicitly describe the EBADF error that can occur with openat()
|
|
||||||
In particular, specifying an invalid file descriptor number
|
|
||||||
in 'dirfd' can be used as a check that 'pathname' is absolute.
|
|
||||||
Michael Kerrisk
|
|
||||||
Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH
|
|
||||||
Michael Kerrisk
|
|
||||||
Add mount_setattr(2) to list of 'dirfd' APIs
|
|
||||||
|
|
||||||
open_by_handle_at.2
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: add missing EBADF error for invalid 'dirfd'
|
|
||||||
|
|
||||||
readv2.2
|
|
||||||
Will Manley [Alejandro Colomar]
|
|
||||||
Note preadv2(..., RWF_NOWAIT) bug in BUGS section
|
|
||||||
|
|
||||||
readv.2
|
|
||||||
pipe.7
|
|
||||||
Michael Kerrisk [наб]
|
|
||||||
Make text on pipe writes more general to avoid a confusion in writev(2)
|
|
||||||
|
|
||||||
seccomp.2
|
|
||||||
Eric W. Biederman [Kees Cook]
|
|
||||||
Clarify that bad system calls kill the thread (not the process)
|
|
||||||
|
|
||||||
syscalls.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Add quotactl_fd(); remove quotactl_path()
|
|
||||||
quotactl_path() was never wired up in Linux 5.13.
|
|
||||||
It was replaced instead by quotactl_fd(),
|
|
||||||
Michael Kerrisk
|
|
||||||
Add system calls that are new in 5.13
|
|
||||||
|
|
||||||
umount.2
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: add EINVAL for case where mount is locked
|
|
||||||
|
|
||||||
wait.2
|
|
||||||
Richard Palethorpe [Alejandro Colomar]
|
|
||||||
Add ESRCH for when pid == INT_MIN
|
|
||||||
Michael Kerrisk
|
|
||||||
ERRORS: document EAGAIN for waitid() on a PID file descriptor
|
|
||||||
|
|
||||||
getaddrinfo.3
|
|
||||||
Alejandro Colomar [Cristian Morales Vega]
|
|
||||||
Note that 'errno' is set in parallel with EAI_SYSTEM
|
|
||||||
|
|
||||||
getauxval.3
|
|
||||||
Michael Kerrisk
|
|
||||||
SEE ALSO: add execve(2)
|
|
||||||
|
|
||||||
getopt.3
|
|
||||||
James O. D. Hunt [Alejandro Colomar]
|
|
||||||
Further clarification of 'optstring'
|
|
||||||
|
|
||||||
pthread_setname_np.3
|
|
||||||
Michael Kerrisk [Alexis Wilke]
|
|
||||||
EXAMPLES: remove a bug by simplifying the code
|
|
||||||
|
|
||||||
strlen.3
|
|
||||||
wcslen.3
|
|
||||||
Michael Kerrisk [Alejandro Colomar, Jonny Grant]
|
|
||||||
Recommend alternatives where input buffer might not be null-terminated
|
|
||||||
|
|
||||||
strstr.3
|
|
||||||
Alejandro Colomar [Stefan Kanthak]
|
|
||||||
Document special case for empty needle
|
|
||||||
|
|
||||||
termios.3
|
|
||||||
Pali Rohár [Alejandro Colomar]
|
|
||||||
SPARC architecture has 4 different Bnnn constants
|
|
||||||
Pali Rohár [Alejandro Colomar]
|
|
||||||
Add information how to set baud rate to any other value
|
|
||||||
Pali Rohár [Alejandro Colomar]
|
|
||||||
Use bold style for Bnn and EXTn macro constants
|
|
||||||
Pali Rohár [Alejandro Colomar]
|
|
||||||
Document missing baud-rate constants
|
|
||||||
|
|
||||||
tsearch.3
|
|
||||||
Michael Kerrisk
|
|
||||||
NAME: add twalk_r
|
|
||||||
|
|
||||||
wcstok.3
|
|
||||||
Jakub Wilk
|
|
||||||
Fix type mismatch in the example
|
|
||||||
|
|
||||||
proc.5
|
|
||||||
Michael Kerrisk
|
|
||||||
Add /proc/PID/projid_map, referring reader to user_namespaces(7)
|
|
||||||
Michael Kerrisk
|
|
||||||
Remove duplicated /proc/[pid]/gid_map entry
|
|
||||||
|
|
||||||
mount_namespaces.7
|
|
||||||
Michael Kerrisk
|
|
||||||
Terminology clean-up: "mount point" ==> "mount"
|
|
||||||
Many times, this page uses the terminology "mount point", where
|
|
||||||
"mount" would be better. A "mount point" is the location at which
|
|
||||||
a mount is attached. A "mount" is an association between a
|
|
||||||
filesystem and a mount point.
|
|
||||||
Michael Kerrisk
|
|
||||||
SEE ALSO: add mount_setattr(2)
|
|
||||||
|
|
||||||
namespaces.7
|
|
||||||
Štěpán Němec [Alejandro Colomar]
|
|
||||||
Fix confusion caused by text reorganization
|
|
||||||
|
|
||||||
path_resolution.7
|
|
||||||
Michael Kerrisk [Askar Safin]
|
|
||||||
Improve description of trailing slashes
|
|
||||||
See https://bugzilla.kernel.org/show_bug.cgi?id=212385
|
|
||||||
|
|
||||||
posixoptions.7
|
|
||||||
Alejandro Colomar [Alan Peakall]
|
|
||||||
Fix legacy functions list (s/getcwd/getwd/)
|
|
||||||
|
|
||||||
user_namespaces.7
|
|
||||||
Kir Kolyshkin [Alejandro Colomar]
|
|
||||||
Fix a reference to a kernel document
|
|
||||||
Michael Kerrisk [Eric W. Biederman]
|
|
||||||
Add a definition of "global root"
|
|
||||||
|
|
||||||
vdso.7
|
|
||||||
Michael Kerrisk [Christophe Leroy]
|
|
||||||
Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc
|
|
||||||
Alejandro Colomar [Christophe Leroy]
|
|
||||||
Add y2038 compliant gettime for ppc/32
|
|
||||||
|
|
359
Changes.old
359
Changes.old
|
@ -54583,3 +54583,362 @@ signal.7
|
||||||
vsock.7
|
vsock.7
|
||||||
Alyssa Ross
|
Alyssa Ross
|
||||||
ioctls are on /dev/vsock, not sockets
|
ioctls are on /dev/vsock, not sockets
|
||||||
|
|
||||||
|
|
||||||
|
==================== Changes in man-pages-5.13 ====================
|
||||||
|
|
||||||
|
Released: 2021-08-27, Christchurch
|
||||||
|
|
||||||
|
Ahelenia Ziemiańska (наб) <nabijaczleweli@nabijaczleweli.xyz>
|
||||||
|
Alan Peakall <Alan.Peakall@helpsystems.com>
|
||||||
|
Alejandro Colomar <alx.manpages@gmail.com>
|
||||||
|
Alexis Wilke <alexis@m2osw.com>
|
||||||
|
Askar Safin <safinaskar@mail.ru>
|
||||||
|
Christian Brauner <christian.brauner@ubuntu.com>
|
||||||
|
Christophe Leroy <christophe.leroy@csgroup.eu>
|
||||||
|
Christopher Yeleighton <giecrilj@stegny.2a.pl>
|
||||||
|
Cristian Morales Vega <christian.morales.vega@gmail.com>
|
||||||
|
Dan Robertson <dan@dlrobertson.com>
|
||||||
|
Darrick J. Wong <djwong@kernel.org>
|
||||||
|
Dominique Brazziel <dbrazziel@snet.net>
|
||||||
|
EmanueleTorre <torreemanuele6@gmail.com>
|
||||||
|
Eric W. Biederman <ebiederm@xmission.com>
|
||||||
|
G. Branden Robinson <g.branden.robinson@gmail.com>
|
||||||
|
Helge Kreutzmann <debian@helgefjell.de>
|
||||||
|
Jakub Wilk <jwilk@jwilk.net>
|
||||||
|
James O. D. Hunt <jamesodhunt@gmail.com>
|
||||||
|
Jonny Grant <jg@jguk.org>
|
||||||
|
Kees Cook <keescook@chromium.org>
|
||||||
|
Kir Kolyshkin <kolyshkin@gmail.com>
|
||||||
|
Kurt Kanzenbach <kurt@linutronix.de>
|
||||||
|
kXuan <kxuanobj@gmail.com>
|
||||||
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||||
|
Michael Weiß <michael.weiss@aisec.fraunhofer.de>
|
||||||
|
NeilBrown <neilb@suse.de>
|
||||||
|
Nora Platiel <nplatiel@gmx.us>
|
||||||
|
Pali Rohár <pali@kernel.org>
|
||||||
|
Peter Collingbourne <pcc@google.com>
|
||||||
|
Richard Palethorpe <rpalethorpe@suse.com>
|
||||||
|
Rodrigo Campos <rodrigo@kinvolk.io>
|
||||||
|
Sagar Patel <sagarmp@cs.unc.edu>
|
||||||
|
Serge E. Hallyn <serge@hallyn.com>
|
||||||
|
Sergey Petrakov <kr@spmail.info>
|
||||||
|
Stefan Kanthak <stefan.kanthak@nexgo.de>
|
||||||
|
Štěpán Němec <stepnem@gmail.com>
|
||||||
|
Thomas Gleixner <tglx@linutronix.de>
|
||||||
|
Thomas Voss <thomasavoss@protonmail.com>
|
||||||
|
Viet Than <thanhoangviet@gmail.com>
|
||||||
|
Will Manley <will@williammanley.net>
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
|
||||||
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
|
||||||
|
New and rewritten pages
|
||||||
|
-----------------------
|
||||||
|
|
||||||
|
mount_setattr.2
|
||||||
|
Christian Brauner [Alejandro Colomar, Michael Kerrisk]
|
||||||
|
New manual page documenting the mount_setattr() system call
|
||||||
|
|
||||||
|
|
||||||
|
Newly documented interfaces in existing pages
|
||||||
|
---------------------------------------------
|
||||||
|
|
||||||
|
futex.2
|
||||||
|
Kurt Kanzenbach [Alejandro Colomar, Thomas Gleixner, Michael Kerrisk]
|
||||||
|
Document FUTEX_LOCK_PI2
|
||||||
|
|
||||||
|
ioctl_tty.2
|
||||||
|
Pali Rohár [Alejandro Colomar, Michael kerrisk]
|
||||||
|
Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2
|
||||||
|
|
||||||
|
pidfd_open.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Document PIDFD_NONBLOCK
|
||||||
|
|
||||||
|
seccomp_unotify.2
|
||||||
|
Rodrigo Campos [Alejandro Colomar]
|
||||||
|
Document SECCOMP_ADDFD_FLAG_SEND
|
||||||
|
|
||||||
|
sigaction.2
|
||||||
|
Peter Collingbourne [Alejandro Colomar, Michael Kerrisk]
|
||||||
|
Document SA_EXPOSE_TAGBITS and the flag support detection protocol
|
||||||
|
|
||||||
|
statx.2
|
||||||
|
NeilBrown
|
||||||
|
Document STATX_MNT_ID
|
||||||
|
capabilities.7
|
||||||
|
user_namespaces.7
|
||||||
|
Michael Kerrisk, Kir Kolyshkin [Alejandro Colomar]
|
||||||
|
Describe CAP_SETFCAP for mapping UID 0
|
||||||
|
|
||||||
|
mount_namespaces.7
|
||||||
|
Michael Kerrisk [Christian Brauner, Eric W. Biederman]
|
||||||
|
More clearly explain the notion of locked mounts
|
||||||
|
For a long time, this manual page has had a brief discussion of
|
||||||
|
"locked" mounts, without clearly saying what this concept is, or
|
||||||
|
why it exists. Expand the discussion with an explanation of what
|
||||||
|
locked mounts are, why mounts are locked, and some examples of the
|
||||||
|
effect of locking.
|
||||||
|
user_namespaces.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Document /proc/PID/projid_map
|
||||||
|
|
||||||
|
ld.so.8
|
||||||
|
Michael Kerrisk
|
||||||
|
Document --list-tunables option added in glibc 2.33
|
||||||
|
|
||||||
|
|
||||||
|
Global changes
|
||||||
|
--------------
|
||||||
|
|
||||||
|
A few pages
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: correct alphabetic order
|
||||||
|
|
||||||
|
A few pages
|
||||||
|
Michael Kerrisk
|
||||||
|
Place SEE ALSO entries in correct order
|
||||||
|
|
||||||
|
A few pages
|
||||||
|
Michael Kerrisk
|
||||||
|
Arrange .SH sections in correct order
|
||||||
|
|
||||||
|
Various pages
|
||||||
|
Michael Kerrisk
|
||||||
|
Fix EBADF error description
|
||||||
|
Make the description of the EBADF error for invalid 'dirfd' more
|
||||||
|
uniform. In particular, note that the error only occurs when the
|
||||||
|
pathname is relative, and that it occurs when the 'dirfd' is
|
||||||
|
neither valid *nor* has the value AT_FDCWD.
|
||||||
|
|
||||||
|
Various pages
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: combine errors into a single alphabetic list
|
||||||
|
These pages split out extra errors for some APIs into a separate
|
||||||
|
list. Probably, the pages are easier to ready if all errors are
|
||||||
|
combined into a single list.
|
||||||
|
|
||||||
|
Note that there still remain a few pages where the errors are
|
||||||
|
listed separately for different APIs. For the moment, it seems
|
||||||
|
best to leave those pages as is, since the error lists are
|
||||||
|
largely distinct in those pages.
|
||||||
|
|
||||||
|
VArious pages
|
||||||
|
Michael Kerrisk
|
||||||
|
Terminology clean-up: "mount point" ==> "mount"
|
||||||
|
Many times, these pages use the terminology "mount point", where
|
||||||
|
"mount" would be better. A "mount point" is the location at which
|
||||||
|
a mount is attached. A "mount" is an association between a
|
||||||
|
filesystem and a mount point.
|
||||||
|
|
||||||
|
accept.2
|
||||||
|
access.2
|
||||||
|
getpriority.2
|
||||||
|
mlock.2
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: combine errors into a single list
|
||||||
|
These pages split out errors into separate lists (perhaps per API,
|
||||||
|
perhaps "may" vs "shall", perhaps "Linux-specific" vs
|
||||||
|
standard(??)), but there's no good reason to do this. It makes
|
||||||
|
the error list harder to read, and is inconsistent with other
|
||||||
|
pages. So, combine the errors into a single list.
|
||||||
|
|
||||||
|
fanotify_mark.2
|
||||||
|
futimesat.2
|
||||||
|
mount_setattr.2
|
||||||
|
statx.2
|
||||||
|
symlink.2
|
||||||
|
mkfifo.3
|
||||||
|
Michael Kerrisk
|
||||||
|
Refer the reader to openat(2) for explanation of why 'dirfd' is useful
|
||||||
|
|
||||||
|
Various pages
|
||||||
|
Thomas Voss [Alejandro Colomar]
|
||||||
|
Consistently use '*argv[]'
|
||||||
|
|
||||||
|
|
||||||
|
Changes to individual pages
|
||||||
|
---------------------------
|
||||||
|
|
||||||
|
iconv.1
|
||||||
|
iconvconfig.8
|
||||||
|
Michael Kerrisk [Christopher Yeleighton]
|
||||||
|
FILES: note that files may be under /usr/lib64 rather than /lib/64
|
||||||
|
See https://bugzilla.kernel.org/show_bug.cgi?id=214163
|
||||||
|
|
||||||
|
ldd.1
|
||||||
|
Alejandro Colomar [EmanueleTorre]
|
||||||
|
Fix example command
|
||||||
|
|
||||||
|
add_key.2
|
||||||
|
keyctl.2
|
||||||
|
request_key.2
|
||||||
|
Michael Kerrisk [Dominique Brazziel]
|
||||||
|
Note that the "libkeyutils" package provides <keyutils.h>
|
||||||
|
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992377
|
||||||
|
|
||||||
|
close_range.2
|
||||||
|
Michael Kerrisk, Alejandro Colomar
|
||||||
|
Glibc 2.34 has added a close_range() wrapper
|
||||||
|
|
||||||
|
execve.2
|
||||||
|
Michael Kerrisk [Nora Platiel]
|
||||||
|
The pathname given to interpreter is not necessarily absolute
|
||||||
|
Michael Kerrisk
|
||||||
|
SEE ALSO: getauxval(3)
|
||||||
|
getauxval(3) is useful background regarding execve(2).
|
||||||
|
|
||||||
|
fanotify_mark.2
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: add missing EBADF error for invalid 'dirfd'
|
||||||
|
|
||||||
|
ioctl_tty.2
|
||||||
|
Pali Rohár [Alejandro Colomar]
|
||||||
|
Update DTR example
|
||||||
|
Do not include unused (and incompatible) header file termios.h and
|
||||||
|
include required header files for puts() and close() functions.
|
||||||
|
|
||||||
|
mount.2
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: add EPERM error for case where a mount is locked
|
||||||
|
Refer the reader to mount_namespaces(7) for details.
|
||||||
|
Michael Kerrisk
|
||||||
|
SEE ALSO: add mount_setattr(2)
|
||||||
|
|
||||||
|
open.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Explicitly describe the EBADF error that can occur with openat()
|
||||||
|
In particular, specifying an invalid file descriptor number
|
||||||
|
in 'dirfd' can be used as a check that 'pathname' is absolute.
|
||||||
|
Michael Kerrisk
|
||||||
|
Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH
|
||||||
|
Michael Kerrisk
|
||||||
|
Add mount_setattr(2) to list of 'dirfd' APIs
|
||||||
|
|
||||||
|
open_by_handle_at.2
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: add missing EBADF error for invalid 'dirfd'
|
||||||
|
|
||||||
|
readv2.2
|
||||||
|
Will Manley [Alejandro Colomar]
|
||||||
|
Note preadv2(..., RWF_NOWAIT) bug in BUGS section
|
||||||
|
|
||||||
|
readv.2
|
||||||
|
pipe.7
|
||||||
|
Michael Kerrisk [наб]
|
||||||
|
Make text on pipe writes more general to avoid a confusion in writev(2)
|
||||||
|
|
||||||
|
seccomp.2
|
||||||
|
Eric W. Biederman [Kees Cook]
|
||||||
|
Clarify that bad system calls kill the thread (not the process)
|
||||||
|
|
||||||
|
syscalls.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Add quotactl_fd(); remove quotactl_path()
|
||||||
|
quotactl_path() was never wired up in Linux 5.13.
|
||||||
|
It was replaced instead by quotactl_fd(),
|
||||||
|
Michael Kerrisk
|
||||||
|
Add system calls that are new in 5.13
|
||||||
|
|
||||||
|
umount.2
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: add EINVAL for case where mount is locked
|
||||||
|
|
||||||
|
wait.2
|
||||||
|
Richard Palethorpe [Alejandro Colomar]
|
||||||
|
Add ESRCH for when pid == INT_MIN
|
||||||
|
Michael Kerrisk
|
||||||
|
ERRORS: document EAGAIN for waitid() on a PID file descriptor
|
||||||
|
|
||||||
|
getaddrinfo.3
|
||||||
|
Alejandro Colomar [Cristian Morales Vega]
|
||||||
|
Note that 'errno' is set in parallel with EAI_SYSTEM
|
||||||
|
|
||||||
|
getauxval.3
|
||||||
|
Michael Kerrisk
|
||||||
|
SEE ALSO: add execve(2)
|
||||||
|
|
||||||
|
getopt.3
|
||||||
|
James O. D. Hunt [Alejandro Colomar]
|
||||||
|
Further clarification of 'optstring'
|
||||||
|
|
||||||
|
pthread_setname_np.3
|
||||||
|
Michael Kerrisk [Alexis Wilke]
|
||||||
|
EXAMPLES: remove a bug by simplifying the code
|
||||||
|
|
||||||
|
strlen.3
|
||||||
|
wcslen.3
|
||||||
|
Michael Kerrisk [Alejandro Colomar, Jonny Grant]
|
||||||
|
Recommend alternatives where input buffer might not be null-terminated
|
||||||
|
|
||||||
|
strstr.3
|
||||||
|
Alejandro Colomar [Stefan Kanthak]
|
||||||
|
Document special case for empty needle
|
||||||
|
|
||||||
|
termios.3
|
||||||
|
Pali Rohár [Alejandro Colomar]
|
||||||
|
SPARC architecture has 4 different Bnnn constants
|
||||||
|
Pali Rohár [Alejandro Colomar]
|
||||||
|
Add information how to set baud rate to any other value
|
||||||
|
Pali Rohár [Alejandro Colomar]
|
||||||
|
Use bold style for Bnn and EXTn macro constants
|
||||||
|
Pali Rohár [Alejandro Colomar]
|
||||||
|
Document missing baud-rate constants
|
||||||
|
|
||||||
|
tsearch.3
|
||||||
|
Michael Kerrisk
|
||||||
|
NAME: add twalk_r
|
||||||
|
|
||||||
|
wcstok.3
|
||||||
|
Jakub Wilk
|
||||||
|
Fix type mismatch in the example
|
||||||
|
|
||||||
|
proc.5
|
||||||
|
Michael Kerrisk
|
||||||
|
Add /proc/PID/projid_map, referring reader to user_namespaces(7)
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove duplicated /proc/[pid]/gid_map entry
|
||||||
|
|
||||||
|
mount_namespaces.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Terminology clean-up: "mount point" ==> "mount"
|
||||||
|
Many times, this page uses the terminology "mount point", where
|
||||||
|
"mount" would be better. A "mount point" is the location at which
|
||||||
|
a mount is attached. A "mount" is an association between a
|
||||||
|
filesystem and a mount point.
|
||||||
|
Michael Kerrisk
|
||||||
|
SEE ALSO: add mount_setattr(2)
|
||||||
|
|
||||||
|
namespaces.7
|
||||||
|
Štěpán Němec [Alejandro Colomar]
|
||||||
|
Fix confusion caused by text reorganization
|
||||||
|
|
||||||
|
path_resolution.7
|
||||||
|
Michael Kerrisk [Askar Safin]
|
||||||
|
Improve description of trailing slashes
|
||||||
|
See https://bugzilla.kernel.org/show_bug.cgi?id=212385
|
||||||
|
|
||||||
|
posixoptions.7
|
||||||
|
Alejandro Colomar [Alan Peakall]
|
||||||
|
Fix legacy functions list (s/getcwd/getwd/)
|
||||||
|
|
||||||
|
user_namespaces.7
|
||||||
|
Kir Kolyshkin [Alejandro Colomar]
|
||||||
|
Fix a reference to a kernel document
|
||||||
|
Michael Kerrisk [Eric W. Biederman]
|
||||||
|
Add a definition of "global root"
|
||||||
|
|
||||||
|
vdso.7
|
||||||
|
Michael Kerrisk [Christophe Leroy]
|
||||||
|
Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc
|
||||||
|
Alejandro Colomar [Christophe Leroy]
|
||||||
|
Add y2038 compliant gettime for ppc/32
|
||||||
|
|
Loading…
Reference in New Issue