summaryrefslogtreecommitdiffstats
path: root/Changes
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2021-08-27 22:13:35 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2021-08-27 22:13:35 +0200
commit2af47cd37198d7dfb417ab9d5a430faf134ac37b (patch)
treeea7781dcfd2e7f08efd0875b8d404fdabbb69f2f /Changes
parent333691eb13cf49d4b3edc904abfee20e2d69ee0f (diff)
Start of man-pages-5.14: updating Changes and Changes.old
Diffstat (limited to 'Changes')
-rw-r--r--Changes330
1 files changed, 4 insertions, 326 deletions
diff --git a/Changes b/Changes
index fde7c6742..5087f32f7 100644
--- a/Changes
+++ b/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
------------
@@ -57,301 +17,19 @@ 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
+New and changed links
+---------------------
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