aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2020-11-02 07:58:09 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2020-11-02 07:58:09 +0100
commit07d6c242cff6c983e52f5d52eaded88484dcfbe0 (patch)
tree976bcda205ee4c454f3d4c20b3ca030bef8b6cb9
parentdb9c2b96ab7e1766a349590b90d82d830316b0e7 (diff)
downloadman-pages-07d6c242cff6c983e52f5d52eaded88484dcfbe0.tar.gz
Start of man-pages-5.10: updating Changes and Changes.old
-rw-r--r--Changes747
-rw-r--r--Changes.old780
2 files changed, 782 insertions, 745 deletions
diff --git a/Changes b/Changes
index 497c793fb3..041fa967cd 100644
--- a/Changes
+++ b/Changes
@@ -1,6 +1,6 @@
-==================== Changes in man-pages-5.09 ====================
+==================== Changes in man-pages-5.10 ====================
-Released: 2020-11-01, Munich
+Released: ????-??-??, Munich
Contributors
@@ -10,47 +10,6 @@ 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:
-Alejandro Colomar <colomar.6.4.3@gmail.com>
-Aleksa Sarai <cyphar@cyphar.com>
-Alexey Budankov <alexey.budankov@linux.intel.com>
-Amir Goldstein <amir73il@gmail.com>
-Carlos O'Donell <carlos@redhat.com>
-Dave Martin <Dave.Martin@arm.com>
-David Howells <dhowells@redhat.com>
-David Laight <David.Laight@ACULAB.COM>
-Dmitry V. Levin <ldv@altlinux.org>
-Érico Rolim <erico.erc@gmail.com>
-Florian Weimer <fweimer@redhat.com>
-G. Branden Robinson <g.branden.robinson@gmail.com>
-Hauke Fath <hf@spg.tu-darmstadt.de>
-Heinrich Schuchardt <xypron.glpk@gmx.de>
-henrik@optoscale.no
-Ira Weiny <ira.weiny@intel.com>
-Jakub Wilk <jwilk@jwilk.net>
-Jan Kara <jack@suse.cz>
-Jann Horn <jannh@google.com>
-Jing Peng <pj.hades@gmail.com>
-Jonathan Wakely <jwakely@redhat.com>
-Jonny Grant <jg@jguk.org>
-Konstantin Bukin <kbukin@gmail.com>
-Mark Mossberg <mark.mossberg@gmail.com>
-Marko Hrastovec <marko.hrastovec@gmail.com>
-Matthew Bobrowski <mbobrowski@mbobrowski.org>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Mike Frysinger <vapier@gentoo.org>
-Paul Eggert <eggert@cs.ucla.edu>
-Paul Moore <paul@paul-moore.com>
-Rich Felker <dalias@libc.org>
-Samanta Navarro <ferivoz@riseup.net>
-Serge Hallyn <serge@hallyn.com>
-Simon McVittie <smcv@collabora.com>
-Sridhar Samudrala <sridhar.samudrala@intel.com>
-Stephen Smalley <stephen.smalley.work@gmail.com>
-Steve Hilder <stevehilder@yahoo.co.uk>
-Thomas Piekarski <t.piekarski@deloquencia.de>
-Tony May <tony.may@mediakind.com>
-Tycho Andersen <tycho@tycho.ws>
-Yang Xu <xuyang2018.jy@cn.fujitsu.com>
Apologies if I missed anyone!
@@ -58,721 +17,19 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
-circleq.3
- Alejandro Colomar
- New page with 'circleq' content extracted from queue(3)
-
-list.3
- Alejandro Colomar
- New page with 'list' content extracted from queue(3)
-
-
-pthread_attr_setsigmask_np.3
- Michael Kerrisk
- New page for pthread_attr_setsigmask_np() + pthread_attr_getsigmask_np()
- Add a page documenting the pthread_attr_setsigmask_np(3) and
- pthread_attr_getsigmask_np(3) functions added in glibc 2.32.
-
-slist.3
- Alejandro Colomar
- New page with 'slist' content extracted from queue(3)
-
-stailq.3
- Alejandro Colomar
- New page with 'stailq' content extracted from queue(3)
-
-tailq.3
- Alejandro Colomar
- New page with 'tailq' content extracted from queue(3)
-
-system_data_types.7
- Alejandro Colomar, Michael Kerrisk
- A new page documenting a wide range of system data types.
-
-kernel_lockdown.7
- David Howells, Heinrich Schuchardt [Michael Kerrisk]
- New page documenting the Kernel Lockdown feature
-
-queue.7
- Alejandro Colomar
- Create summary page for 'queue' APIs
- The former queue(3) page was rather unwieldy, as it attempted to
- describe too many APIs. After splitting that content out into a
- number of smaller pages ( circleq.3, list.3, slist.3, stailq.3,
- and tailq.3) move the much-reduced queue(3) page, which is now
- essentially a summary of those APIs, from Section 3 to Section 7.
-
Newly documented interfaces in existing pages
---------------------------------------------
-fanotify_init.2
-fanotify.7
- Amir Goldstein [Jan Kara, Matthew Bobrowski]
- Document FAN_REPORT_DIR_FID
-
-fanotify_init.2
-fanotify.7
- Amir Goldstein [Jan Kara, Matthew Bobrowski]
- Document FAN_REPORT_NAME
-
-statx.2
- Ira Weiny
- Add STATX_ATTR_DAX
-
-strerror.3
- Michael Kerrisk
- Document strerrorname_np() and strerrordesc_np()
- strerrorname_np() and strerrordesc_np() were added in glibc 2.32.
-
-strsignal.3
- Michael Kerrisk
- Document sigabbrev_np() and sigdescr_np().
- sigabbrev_np() and sigdescr_np() were added in glibc 2.32.
-
-loop.4
- Yang Xu
- Document LOOP_CONFIGURE ioctl
- Yang Xu
- Document LO_FLAGS_DIRECT_IO flag
-
-capabilities.7
- Michael Kerrisk
- Document the CAP_CHECKPOINT_RESTORE capability added in Linux 5.9
-
-ip.7
- Stephen Smalley [Paul Moore]
- Document IP_PASSSEC for UDP sockets
-
-ip.7
-socket.7
- Stephen Smalley
- Document SO_PEERSEC for AF_INET sockets
- Sridhar Samudrala
- Document SO_INCOMING_NAPI_ID
-
-socket.7
-unix.7
- Stephen Smalley [Serge Hallyn, Simon McVittie]
- Add initial description for SO_PEERSEC
-
New and changed links
---------------------
-aiocb.3
-clock_t.3
-clockid_t.3
-dev_t.3
-div_t.3
-double_t.3
-fenv_t.3
-fexcept_t.3
-FILE.3
-float_t.3
-gid_t.3
-id_t.3
-imaxdiv_t.3
-int8_t.3
-int16_t.3
-int32_t.3
-int64_t.3
-intN_t.3
-intmax_t.3
-intptr_t.3
-lconv.3
-ldiv_t.3
-lldiv_t.3
-off_t.3
-pid_t.3
-ptrdiff_t.3
-regex_t.3
-regmatch_t.3
-regoff_t.3
-siginfo_t.3
-sigset_t.3
-sigval.3
-size_t.3
-ssize_t.3
-suseconds_t.3
-time_t.3
-timer_t.3
-timespec.3
-timeval.3
-uid_t.3
-uint8_t.3
-uint16_t.3
-uint32_t.3
-uint64_t.3
-uintN_t.3
-uintptr_t.3
-va_list.3
-void.3
- Alejandro Colomar, Michael kerrisk
- New links to system_data_types(7)
-
-CIRCLEQ_ENTRY.3
-CIRCLEQ_HEAD.3
-CIRCLEQ_INIT.3
-CIRCLEQ_INSERT_AFTER.3
-CIRCLEQ_INSERT_BEFORE.3
-CIRCLEQ_INSERT_HEAD.3
-CIRCLEQ_INSERT_TAIL.3
-CIRCLEQ_REMOVE.3
- Alejandro Colomar
- Link to the new circleq(3) page instead of queue(3)
-
-LIST_EMPTY.3
-LIST_ENTRY.3
-LIST_FIRST.3
-LIST_FOREACH.3
-LIST_HEAD.3
-LIST_HEAD_INITIALIZER.3
-LIST_INIT.3
-LIST_INSERT_AFTER.3
-LIST_INSERT_BEFORE.3
-LIST_INSERT_HEAD.3
-LIST_NEXT.3
-LIST_REMOVE.3
- Alejandro Colomar
- Link to the new list.3 page instead of queue.3
-
-SLIST_EMPTY.3
-SLIST_ENTRY.3
-SLIST_FIRST.3
-SLIST_FOREACH.3
-SLIST_HEAD.3
-SLIST_HEAD_INITIALIZER.3
-SLIST_INIT.3
-SLIST_INSERT_AFTER.3
-SLIST_INSERT_HEAD.3
-SLIST_NEXT.3
-SLIST_REMOVE.3
-SLIST_REMOVE_HEAD.3
- Alejandro Colomar
- Link to the new slist(3) page instead of queue(3)
-
-STAILQ_CONCAT.3
-STAILQ_EMPTY.3
-STAILQ_ENTRY.3
-STAILQ_FIRST.3
-STAILQ_FOREACH.3
-STAILQ_HEAD.3
-STAILQ_HEAD_INITIALIZER.3
-STAILQ_INIT.3
-STAILQ_INSERT_AFTER.3
-STAILQ_INSERT_HEAD.3
-STAILQ_INSERT_TAIL.3
-STAILQ_NEXT.3
-STAILQ_REMOVE.3
-STAILQ_REMOVE_HEAD.3
- Alejandro Colomar
- Link to the new stailq(3) page instead of queue(3)
-
-TAILQ_CONCAT.3
-TAILQ_EMPTY.3
-TAILQ_ENTRY.3
-TAILQ_FIRST.3
-TAILQ_FOREACH.3
-TAILQ_FOREACH_REVERSE.3
-TAILQ_HEAD.3
-TAILQ_HEAD_INITIALIZER.3
-TAILQ_INIT.3
-TAILQ_INSERT_AFTER.3
-TAILQ_INSERT_BEFORE.3
-TAILQ_INSERT_HEAD.3
-TAILQ_INSERT_TAIL.3
-TAILQ_LAST.3
-TAILQ_NEXT.3
-TAILQ_PREV.3
-TAILQ_REMOVE.3
-TAILQ_SWAP.3
- Alejandro Colomar
- Link to the new tailq(3) page instead of queue(3)
-
-getcwd.2
-mq_notify.2
-mq_open.2
-mq_timedreceive.2
-mq_timedsend.2
-mq_unlink.2
- Michael Kerrisk
- Reinstate links to section 3 pages that document system calls
- Some of the links removed in commit 247c654385128fd0748 should
- have been kept, because in some cases there are real system
- calls whose wrapper functions are documented in Section 3.
-
-queue.3
- Alejandro Colomar
- Link to queue(7)
-
-sigabbrev_np.3
- Michael Kerrisk
- New link to strsignal.3
-
-sigdescr_np.3
- Michael Kerrisk
- New link to strsignal.3
-
-strerrordesc_np.3
- Michael Kerrisk
- New link to strerror(3)
-
-strerrorname_np.3
- Michael Kerrisk
- New link to strerror(3)
-
-sys_siglist.3
- Michael Kerrisk
- New link to strsignal(3)
-
Global changes
--------------
-Various pages
- Alejandro Colomar
- Use ``sizeof`` consistently through all the examples in the
- following way:
-
- - Use the name of the variable instead of its type as argument for
- ``sizeof``.
-
-Various pages
- Alejandro Colomar
- Use sizeof() to get buffer size (instead of hardcoding macro name)
-
-Various pages
- Michael Kerrisk
- Use \(aq instead of ' inside monospace fonts
- Use \(aq to get an unslanted single quote inside monospace code
- blocks. Using a simple ' results in a slanted quote inside PDFs.
-
-Various pages
- Michael Kerrisk, Alejandro Colomar
- Use C99 style to declare loop counter variables
- Rather than:
-
- sometype x;
-
- for (x = ....; ...)
-
- use
-
- for (sometype x = ...; ...)
-
- This brings the declaration and use closer together (thus aiding
- readability) and also clearly indicates the scope of the loop
- counter variable.
-
-Various pages
- Alejandro Colomar
- Switch printf() casts to use [u]intmax_t + %ju / %jd
- Let's move to the 21st century. Instead of casting system data
- types to long/long long/etc. in printf() calls, instead cast to
- intmax_t or uintmax_t, the largest available signed/unsigned
- integer types.
-
-Various pages
- Alejandro Colomar
- Omit 'int' keyword for 'short', 'long' and 'long long' types
-
-Various pages
- Alejandro Colomar
- Remove unneeded casts
-
-Various pages
- Alejandro Colomar
- In printf(): s/0x%/%#/ except when followed by X instead of x
- Use printf()'s '#' flag character to prepend the string "0x".
-
- However, when the number is printed in uppercase, and the prefix
- is in lowercase, the string "0x" needs to be manually written.
-
-Various pages
- Michael Kerrisk
- Use C99-style declarations for readability
- Rather than writing things such as:
-
- struct sometype *x;
- ...
- x = malloc(sizeof(*x));
-
- let's use C99 style so that the type info is in the same line as
- the allocation:
-
- struct sometype *x = malloc(sizeof(*x));
-
-Various pages
- Alejandro Colomar
- Cast to 'unsigned long' rather than 'long' when printing with "%lx"
-
-stdarg.3
- Alejandro Colomar
- Declare variables with different types in different lines
- In particular, don's mix a variable and a pointer declaration
- on the same line: TYPE x, *p;
-
Changes to individual pages
---------------------------
-memusage.1
- Michael Kerrisk
- EXAMPLES: remove doubled calculations
- The same calculations are repeated in malloc() and printf() calls.
- For better readability, do the calculations once.
- Michael Kerrisk
- Use %zu rather than %zd when printing 'size_t' values
-
-clock_getres.2
- Alejandro Colomar
- EXAMPLES: use 'const' when appropriate
- Alejandro Colomar [Jakub Wilk]
- Cast 'time_t' to 'int' for printf() and fix the length modifiers
- Michael Kerrisk [Tony May]
- Fix type and variable name in dynamic clock code example
-
-clone.2
- Michael Kerrisk
- CAP_CHECKPOINT_RESTORE can now be used to employ 'set_tid'
-
-epoll_ctl.2
- Michael Kerrisk
- epoll instances can be nested to a maximum depth of 5
- This limit appears to be an off-by-one count against
- EP_MAX_NESTS (4).
- Michael Kerrisk
- Move some version info from CONFORMING TO to VERSIONS
-
-eventfd.2
- Alejandro Colomar
- Use 'PRIxN' macros when printing C99 fixed-width integer types
-
-futex.2
- Alejandro Colomar
- Use appropriate types
-
-getdents.2
- Alejandro Colomar
- SYNOPSIS: add missing header and feature test macro
-
-intro.2
-intro.3
-credentials.7
-feature_test_macros.7
-standards.7
- Michael Kerrisk
- SEE ALSO: add system_data_types(7)
-
-ioctl_ns.2
-stat.2
- Alejandro Colomar [Konstantin Bukin]
- Fix signedness of printf specifiers
-
-membarrier.2
- Alejandro Colomar
- Note that glibc does not provide a wrapper
-
-mprotect.2
- Alejandro Colomar
- Use "%p" rather than casting to 'long' when printing pointer values
-
-mq_getsetattr.2
- Alejandro Colomar
- Use 'const' when appropriate
-
-msgop.2
- Yang Xu
- Add restriction on ENOSYS error
-
-open.2
- Michael Kerrisk [henrik@optoscale.no]
- ERRORS: add EBUSY
-
-openat.2
- Alejandro Colomar
- SYNOPSIS: return long
- The Linux kernel uses long as the return type for this syscall.
- As glibc provides no wrapper, use the same type the kernel uses.
-
-open_by_handle_at.2
- Alejandro Colomar
- Use "%u" rather than "%d" when printing 'unsigned int' values
-
-perf_event_open.2
- Alexey Budankov
- Update the man page with CAP_PERFMON related information
-
-recv.2
-send.2
- Michael Kerrisk
- Add cross references to pages with further info about ancillary data
-
-sched_getattr.2
- Aleksa Sarai
- Update to include changed size semantics
-
-seccomp.2
- Michael Kerrisk [Jann Horn]
- Warn reader that SECCOMP_RET_TRACE can be overridden
- Highlight to the reader that if another filter returns a
- higher-precedence action value, then the ptracer will not
- be notified.
- Michael Kerrisk [Rich Felker]
- Warn against the use of SECCOMP_RET_KILL_THREAD
- Killing a thread with SECCOMP_RET_KILL_THREAD is very likely
- to leave the rest of the process in a broken state.
- Michael Kerrisk [Rich Felker]
- EXAMPLES: use SECCOMP_RET_KILL_PROCESS rather than SECCOMP_RET_KILL
- Alejandro Colomar
- Use ARRAY_SIZE() macro instead of raw sizeof division
-
-setns.2
- Michael Kerrisk
- Correct the version for time namespace support
-
-sigaction.2
- Michael Kerrisk [Alejandro Colomar]
- Use correct POSIX type for siginfo_t.si_value
-
-syscalls.2
- Michael Kerrisk
- Move system calls from discontinued ports out of main syscall list
- Various ports that had their own indigenous system calls have
- been discontinued. Remove those system calls (none of which had
- manual pages!) to a separate part of the page, to avoid
- cluttering the main list of system calls.
- Michael Kerrisk
- Add close_range (Linux 5.9)
-
-timerfd_create.2
- Alejandro Colomar
- Use 'PRIxN' macros when printing C99 fixed-width integer types
-
-userfaultfd.2
- Michael Kerrisk
- Use a better type (uint64_t) for 'len' in EXAMPLES
- Alejandro Colomar
- Use 'PRIx64' rather than "%llx" when printing 64-bit fixed-width types
-
-argz_add.3
-envz_add.3
- Michael Kerrisk [Jonny Grant]
- Point out that 'error_t' is an integer type
-
-bsearch.3
- Alejandro Colomar
- Fix intermediate type and remove unneeded casts
-
-bswap.3
- Jakub Wilk
- Use strtoull() for parsing 64-bit numbers
-
-dlopen.3
- Michael Kerrisk
- Clarify DT_RUNPATH/DT_RPATH details
- It is the DT_RUNPATH/DT_RPATH of the calling object (not the
- executable) that is relevant for the library search. Verified
- by experiment.
-
-errno.3
- Michael Kerrisk [Alejandro Colomar]
- Note that the pthreads APIs do not set errno
-
-fopencookie.3
- Alejandro Colomar
- printf()'s .* expects an int; cast accordingly
- Alejandro Colomar
- Fix bugs in example
-
-fread.3
- Alejandro Colomar
- Move ARRAY_SIZE logic into macro
-
-freeaddrinfo.3
- Marko Hrastovec
- Fix memory leaks in freeaddrinfo() examples
-
-getline.3
- Alejandro Colomar
- Use %zd rather than %zu when printing 'ssize_t' values
-
-lseek64.3
- Michael Kerrisk
- Since glibc 2.28. the 'llseek' symbol is no longer available
-
-mallinfo.3
- Michael Kerrisk
- The 'usmblks' field is nowadays always 0
-
-offsetof.3
- Alejandro Colomar
- Use "%zu" rather than "%zd" when printing 'size_t' values
-
-perror.3
- Michael Kerrisk
- sys_errlist and sys_nerr are no longer exposed by <stdio.h>
- The change came with the release of glibc 2.32.
-
-posix_fallocate.3
- Érico Rolim
- Add EOPNOTSUPP error code.
-
-psignal.3
-strsignal.3
- Michael Kerrisk
- Consolidate information on 'sys_siglist' in one page (strsignal(3))
-
-pthread_attr_init.3
- Michael Kerrisk
- SEE ALSO: add pthread_attr_init(3)
-
-pthread_attr_init.3
-pthread_create.3
-pthread_getattr_np.3
- Michael Kerrisk
- Use correct type (size_t) for some variables
-
-pthread_getattr_np.3
- Alejandro Colomar
- Use "%zu" and "%zx" when printing 'size_t' values
-
-pthread_sigmask.3
- Michael Kerrisk
- SEE ALSO: add pthread_attr_setsigmask_np(3)
-
-qsort.3
- Alejandro Colomar
- Fix casts
- Alejandro Colomar
- SYNOPSIS: move code from queue.3 to stailq.3
-
-regex.3
- Alejandro Colomar
- Add example program
- Alejandro Colomar
- Remove unnecessary include
-
-strsignal.3
- Michael Kerrisk [Hauke Fath]
- Note that starting with v2.32, glibc no longer exports 'sys_siglist'
- Michael Kerrisk
- Further addition on version range for sys_siglist
- Michael Kerrisk
- Note that 'sys_siglist' is nonstandard
-
-strtod.3
- Jonathan Wakely
- Fix return value for underflow
-
-strtol.3
- Alejandro Colomar
- EXAMPLES: simplify errno checking
- Alejandro Colomar
- EXAMPLES: as the default base, use special value 0
- Alejandro Colomar
- EXAMPLES: delimit output string using ""
-
-tsearch.3
- Alejandro Colomar
- Simplify type usage and remove unneeded casts
- Alejandro Colomar
- Use size_t for malloc() argument
-
-loop.4
- Yang Xu
- Add some details about lo_flags
-
-core.5
- Alejandro Colomar
- Use adequate type
-
-locale.5
- Florian Weimer
- Decimal points, thousands separators must be one character
-
-proc.5
- Michael Kerrisk
- Update capability requirements for accessing /proc/[pid]/map_files
- Jann Horn [Mark Mossberg]
- Document inaccurate RSS due to SPLIT_RSS_COUNTING
- Michael Kerrisk
- Note "open file description" as (better) synonym for "file handle"
-
-resolv.5
- Florian Weimer
- Document the trust-ad option
-
-aio.7
- Alejandro Colomar
- Use perror() directly
-
-bpf-helpers.7
- Michael Kerrisk [Jakub Wilk]
- Resync with current kernel source
-
-capabilities.7
- Michael Kerrisk
- Under CAP_SYS_ADMIN, group "sub-capabilities" together
- CAP_BPF, CAP_PERFMON, and CAP_CHECKPOINT_RESTORE have all been
- added to split out the power of CAP_SYS_ADMIN into weaker pieces.
- Group all of these capabilities together in the list under
- CAP_SYS_ADMIN, to make it clear that there is a pattern to these
- capabilities.
- Michael Kerrisk
- CAP_SYS_ADMIN implies CAP_CHECKPOINT_RESTORE
- But the latter, weaker capability is preferred.
- Michael Kerrisk
- Add kernel doc reference for CAP_PERFMON
-
-fanotify.7
- Alejandro Colomar
- Pass array to read(2) directly instead of a pointer to it
-
-fanotify.7
-fanotify_mark.2
- Amir Goldstein [Jan Kara, Matthew Bobrowski]
- Generalize documentation of FAN_REPORT_FID
-
-feature_test_macros.7
- Jakub Wilk
- Update list of macros that inhibit default definitions
-
-man.7
- Michael Kerrisk [G. Branden Robinson]
- Clarify that alternating typeface macros print arguments without spaces
-
-man-pages.7
- Michael Kerrisk
- Add some more requests re code examples
- Michael Kerrisk
- Soften the statement that ideal programs should be short
-
-namespaces.7
- Michael Kerrisk
- A 'time_for_children' symlink can also pin a namespace
-
-pid_namespaces.7
- Michael Kerrisk
- Update capability requirements for /proc/sys/kernel/ns_last_pid
-
-pthreads.7
- Michael Kerrisk
- Explicitly note that pthreads APIs return an errno-style value on error
-
-rtld-audit.7
- Florian Weimer [Carlos O'Donell]
- Clarify la_version handshake
- Returning its argument without further checks is almost always
- wrong for la_version.
- Alejandro Colomar
- Use "%u" rather than "%d" when printing 'unsigned int' values
-
-sigevent.7
- Michael Kerrisk
- Note that 'sigev_notify_thread_id' is Linux-specific
-
-socket.7
- Michael Kerrisk
- SEE ALSO: add ipv6(7)
diff --git a/Changes.old b/Changes.old
index 23df1cd062..16c84b4e39 100644
--- a/Changes.old
+++ b/Changes.old
@@ -52207,3 +52207,783 @@ zic.8
Michael Kerrisk
Sync to 2020a tzdb release
From https://www.iana.org/time-zones, version 2020a.
+
+
+==================== Changes in man-pages-5.09 ====================
+
+Released: 2020-11-01, Munich
+
+
+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:
+
+Alejandro Colomar <colomar.6.4.3@gmail.com>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexey Budankov <alexey.budankov@linux.intel.com>
+Amir Goldstein <amir73il@gmail.com>
+Carlos O'Donell <carlos@redhat.com>
+Dave Martin <Dave.Martin@arm.com>
+David Howells <dhowells@redhat.com>
+David Laight <David.Laight@ACULAB.COM>
+Dmitry V. Levin <ldv@altlinux.org>
+Érico Rolim <erico.erc@gmail.com>
+Florian Weimer <fweimer@redhat.com>
+G. Branden Robinson <g.branden.robinson@gmail.com>
+Hauke Fath <hf@spg.tu-darmstadt.de>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+henrik@optoscale.no
+Ira Weiny <ira.weiny@intel.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Jing Peng <pj.hades@gmail.com>
+Jonathan Wakely <jwakely@redhat.com>
+Jonny Grant <jg@jguk.org>
+Konstantin Bukin <kbukin@gmail.com>
+Mark Mossberg <mark.mossberg@gmail.com>
+Marko Hrastovec <marko.hrastovec@gmail.com>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Paul Eggert <eggert@cs.ucla.edu>
+Paul Moore <paul@paul-moore.com>
+Rich Felker <dalias@libc.org>
+Samanta Navarro <ferivoz@riseup.net>
+Serge Hallyn <serge@hallyn.com>
+Simon McVittie <smcv@collabora.com>
+Sridhar Samudrala <sridhar.samudrala@intel.com>
+Stephen Smalley <stephen.smalley.work@gmail.com>
+Steve Hilder <stevehilder@yahoo.co.uk>
+Thomas Piekarski <t.piekarski@deloquencia.de>
+Tony May <tony.may@mediakind.com>
+Tycho Andersen <tycho@tycho.ws>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+circleq.3
+ Alejandro Colomar
+ New page with 'circleq' content extracted from queue(3)
+
+list.3
+ Alejandro Colomar
+ New page with 'list' content extracted from queue(3)
+
+
+pthread_attr_setsigmask_np.3
+ Michael Kerrisk
+ New page for pthread_attr_setsigmask_np() + pthread_attr_getsigmask_np()
+ Add a page documenting the pthread_attr_setsigmask_np(3) and
+ pthread_attr_getsigmask_np(3) functions added in glibc 2.32.
+
+slist.3
+ Alejandro Colomar
+ New page with 'slist' content extracted from queue(3)
+
+stailq.3
+ Alejandro Colomar
+ New page with 'stailq' content extracted from queue(3)
+
+tailq.3
+ Alejandro Colomar
+ New page with 'tailq' content extracted from queue(3)
+
+system_data_types.7
+ Alejandro Colomar, Michael Kerrisk
+ A new page documenting a wide range of system data types.
+
+kernel_lockdown.7
+ David Howells, Heinrich Schuchardt [Michael Kerrisk]
+ New page documenting the Kernel Lockdown feature
+
+queue.7
+ Alejandro Colomar
+ Create summary page for 'queue' APIs
+ The former queue(3) page was rather unwieldy, as it attempted to
+ describe too many APIs. After splitting that content out into a
+ number of smaller pages ( circleq.3, list.3, slist.3, stailq.3,
+ and tailq.3) move the much-reduced queue(3) page, which is now
+ essentially a summary of those APIs, from Section 3 to Section 7.
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+fanotify_init.2
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Document FAN_REPORT_DIR_FID
+
+fanotify_init.2
+fanotify.7
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Document FAN_REPORT_NAME
+
+statx.2
+ Ira Weiny
+ Add STATX_ATTR_DAX
+
+strerror.3
+ Michael Kerrisk
+ Document strerrorname_np() and strerrordesc_np()
+ strerrorname_np() and strerrordesc_np() were added in glibc 2.32.
+
+strsignal.3
+ Michael Kerrisk
+ Document sigabbrev_np() and sigdescr_np().
+ sigabbrev_np() and sigdescr_np() were added in glibc 2.32.
+
+loop.4
+ Yang Xu
+ Document LOOP_CONFIGURE ioctl
+ Yang Xu
+ Document LO_FLAGS_DIRECT_IO flag
+
+capabilities.7
+ Michael Kerrisk
+ Document the CAP_CHECKPOINT_RESTORE capability added in Linux 5.9
+
+ip.7
+ Stephen Smalley [Paul Moore]
+ Document IP_PASSSEC for UDP sockets
+
+ip.7
+socket.7
+ Stephen Smalley
+ Document SO_PEERSEC for AF_INET sockets
+ Sridhar Samudrala
+ Document SO_INCOMING_NAPI_ID
+
+socket.7
+unix.7
+ Stephen Smalley [Serge Hallyn, Simon McVittie]
+ Add initial description for SO_PEERSEC
+
+
+New and changed links
+---------------------
+
+aiocb.3
+clock_t.3
+clockid_t.3
+dev_t.3
+div_t.3
+double_t.3
+fenv_t.3
+fexcept_t.3
+FILE.3
+float_t.3
+gid_t.3
+id_t.3
+imaxdiv_t.3
+int8_t.3
+int16_t.3
+int32_t.3
+int64_t.3
+intN_t.3
+intmax_t.3
+intptr_t.3
+lconv.3
+ldiv_t.3
+lldiv_t.3
+off_t.3
+pid_t.3
+ptrdiff_t.3
+regex_t.3
+regmatch_t.3
+regoff_t.3
+siginfo_t.3
+sigset_t.3
+sigval.3
+size_t.3
+ssize_t.3
+suseconds_t.3
+time_t.3
+timer_t.3
+timespec.3
+timeval.3
+uid_t.3
+uint8_t.3
+uint16_t.3
+uint32_t.3
+uint64_t.3
+uintN_t.3
+uintptr_t.3
+va_list.3
+void.3
+ Alejandro Colomar, Michael kerrisk
+ New links to system_data_types(7)
+
+CIRCLEQ_ENTRY.3
+CIRCLEQ_HEAD.3
+CIRCLEQ_INIT.3
+CIRCLEQ_INSERT_AFTER.3
+CIRCLEQ_INSERT_BEFORE.3
+CIRCLEQ_INSERT_HEAD.3
+CIRCLEQ_INSERT_TAIL.3
+CIRCLEQ_REMOVE.3
+ Alejandro Colomar
+ Link to the new circleq(3) page instead of queue(3)
+
+LIST_EMPTY.3
+LIST_ENTRY.3
+LIST_FIRST.3
+LIST_FOREACH.3
+LIST_HEAD.3
+LIST_HEAD_INITIALIZER.3
+LIST_INIT.3
+LIST_INSERT_AFTER.3
+LIST_INSERT_BEFORE.3
+LIST_INSERT_HEAD.3
+LIST_NEXT.3
+LIST_REMOVE.3
+ Alejandro Colomar
+ Link to the new list.3 page instead of queue.3
+
+SLIST_EMPTY.3
+SLIST_ENTRY.3
+SLIST_FIRST.3
+SLIST_FOREACH.3
+SLIST_HEAD.3
+SLIST_HEAD_INITIALIZER.3
+SLIST_INIT.3
+SLIST_INSERT_AFTER.3
+SLIST_INSERT_HEAD.3
+SLIST_NEXT.3
+SLIST_REMOVE.3
+SLIST_REMOVE_HEAD.3
+ Alejandro Colomar
+ Link to the new slist(3) page instead of queue(3)
+
+STAILQ_CONCAT.3
+STAILQ_EMPTY.3
+STAILQ_ENTRY.3
+STAILQ_FIRST.3
+STAILQ_FOREACH.3
+STAILQ_HEAD.3
+STAILQ_HEAD_INITIALIZER.3
+STAILQ_INIT.3
+STAILQ_INSERT_AFTER.3
+STAILQ_INSERT_HEAD.3
+STAILQ_INSERT_TAIL.3
+STAILQ_NEXT.3
+STAILQ_REMOVE.3
+STAILQ_REMOVE_HEAD.3
+ Alejandro Colomar
+ Link to the new stailq(3) page instead of queue(3)
+
+TAILQ_CONCAT.3
+TAILQ_EMPTY.3
+TAILQ_ENTRY.3
+TAILQ_FIRST.3
+TAILQ_FOREACH.3
+TAILQ_FOREACH_REVERSE.3
+TAILQ_HEAD.3
+TAILQ_HEAD_INITIALIZER.3
+TAILQ_INIT.3
+TAILQ_INSERT_AFTER.3
+TAILQ_INSERT_BEFORE.3
+TAILQ_INSERT_HEAD.3
+TAILQ_INSERT_TAIL.3
+TAILQ_LAST.3
+TAILQ_NEXT.3
+TAILQ_PREV.3
+TAILQ_REMOVE.3
+TAILQ_SWAP.3
+ Alejandro Colomar
+ Link to the new tailq(3) page instead of queue(3)
+
+getcwd.2
+mq_notify.2
+mq_open.2
+mq_timedreceive.2
+mq_timedsend.2
+mq_unlink.2
+ Michael Kerrisk
+ Reinstate links to section 3 pages that document system calls
+ Some of the links removed in commit 247c654385128fd0748 should
+ have been kept, because in some cases there are real system
+ calls whose wrapper functions are documented in Section 3.
+
+queue.3
+ Alejandro Colomar
+ Link to queue(7)
+
+sigabbrev_np.3
+ Michael Kerrisk
+ New link to strsignal.3
+
+sigdescr_np.3
+ Michael Kerrisk
+ New link to strsignal.3
+
+strerrordesc_np.3
+ Michael Kerrisk
+ New link to strerror(3)
+
+strerrorname_np.3
+ Michael Kerrisk
+ New link to strerror(3)
+
+sys_siglist.3
+ Michael Kerrisk
+ New link to strsignal(3)
+
+
+Global changes
+--------------
+
+Various pages
+ Alejandro Colomar
+ Use ``sizeof`` consistently through all the examples in the
+ following way:
+
+ - Use the name of the variable instead of its type as argument for
+ ``sizeof``.
+
+Various pages
+ Alejandro Colomar
+ Use sizeof() to get buffer size (instead of hardcoding macro name)
+
+Various pages
+ Michael Kerrisk
+ Use \(aq instead of ' inside monospace fonts
+ Use \(aq to get an unslanted single quote inside monospace code
+ blocks. Using a simple ' results in a slanted quote inside PDFs.
+
+Various pages
+ Michael Kerrisk, Alejandro Colomar
+ Use C99 style to declare loop counter variables
+ Rather than:
+
+ sometype x;
+
+ for (x = ....; ...)
+
+ use
+
+ for (sometype x = ...; ...)
+
+ This brings the declaration and use closer together (thus aiding
+ readability) and also clearly indicates the scope of the loop
+ counter variable.
+
+Various pages
+ Alejandro Colomar
+ Switch printf() casts to use [u]intmax_t + %ju / %jd
+ Let's move to the 21st century. Instead of casting system data
+ types to long/long long/etc. in printf() calls, instead cast to
+ intmax_t or uintmax_t, the largest available signed/unsigned
+ integer types.
+
+Various pages
+ Alejandro Colomar
+ Omit 'int' keyword for 'short', 'long' and 'long long' types
+
+Various pages
+ Alejandro Colomar
+ Remove unneeded casts
+
+Various pages
+ Alejandro Colomar
+ In printf(): s/0x%/%#/ except when followed by X instead of x
+ Use printf()'s '#' flag character to prepend the string "0x".
+
+ However, when the number is printed in uppercase, and the prefix
+ is in lowercase, the string "0x" needs to be manually written.
+
+Various pages
+ Michael Kerrisk
+ Use C99-style declarations for readability
+ Rather than writing things such as:
+
+ struct sometype *x;
+ ...
+ x = malloc(sizeof(*x));
+
+ let's use C99 style so that the type info is in the same line as
+ the allocation:
+
+ struct sometype *x = malloc(sizeof(*x));
+
+Various pages
+ Alejandro Colomar
+ Cast to 'unsigned long' rather than 'long' when printing with "%lx"
+
+stdarg.3
+ Alejandro Colomar
+ Declare variables with different types in different lines
+ In particular, don's mix a variable and a pointer declaration
+ on the same line: TYPE x, *p;
+
+
+Changes to individual pages
+---------------------------
+
+memusage.1
+ Michael Kerrisk
+ EXAMPLES: remove doubled calculations
+ The same calculations are repeated in malloc() and printf() calls.
+ For better readability, do the calculations once.
+ Michael Kerrisk
+ Use %zu rather than %zd when printing 'size_t' values
+
+clock_getres.2
+ Alejandro Colomar
+ EXAMPLES: use 'const' when appropriate
+ Alejandro Colomar [Jakub Wilk]
+ Cast 'time_t' to 'int' for printf() and fix the length modifiers
+ Michael Kerrisk [Tony May]
+ Fix type and variable name in dynamic clock code example
+
+clone.2
+ Michael Kerrisk
+ CAP_CHECKPOINT_RESTORE can now be used to employ 'set_tid'
+
+epoll_ctl.2
+ Michael Kerrisk
+ epoll instances can be nested to a maximum depth of 5
+ This limit appears to be an off-by-one count against
+ EP_MAX_NESTS (4).
+ Michael Kerrisk
+ Move some version info from CONFORMING TO to VERSIONS
+
+eventfd.2
+ Alejandro Colomar
+ Use 'PRIxN' macros when printing C99 fixed-width integer types
+
+futex.2
+ Alejandro Colomar
+ Use appropriate types
+
+getdents.2
+ Alejandro Colomar
+ SYNOPSIS: add missing header and feature test macro
+
+intro.2
+intro.3
+credentials.7
+feature_test_macros.7
+standards.7
+ Michael Kerrisk
+ SEE ALSO: add system_data_types(7)
+
+ioctl_ns.2
+stat.2
+ Alejandro Colomar [Konstantin Bukin]
+ Fix signedness of printf specifiers
+
+membarrier.2
+ Alejandro Colomar
+ Note that glibc does not provide a wrapper
+
+mprotect.2
+ Alejandro Colomar
+ Use "%p" rather than casting to 'long' when printing pointer values
+
+mq_getsetattr.2
+ Alejandro Colomar
+ Use 'const' when appropriate
+
+msgop.2
+ Yang Xu
+ Add restriction on ENOSYS error
+
+open.2
+ Michael Kerrisk [henrik@optoscale.no]
+ ERRORS: add EBUSY
+
+openat.2
+ Alejandro Colomar
+ SYNOPSIS: return long
+ The Linux kernel uses long as the return type for this syscall.
+ As glibc provides no wrapper, use the same type the kernel uses.
+
+open_by_handle_at.2
+ Alejandro Colomar
+ Use "%u" rather than "%d" when printing 'unsigned int' values
+
+perf_event_open.2
+ Alexey Budankov
+ Update the man page with CAP_PERFMON related information
+
+recv.2
+send.2
+ Michael Kerrisk
+ Add cross references to pages with further info about ancillary data
+
+sched_getattr.2
+ Aleksa Sarai
+ Update to include changed size semantics
+
+seccomp.2
+ Michael Kerrisk [Jann Horn]
+ Warn reader that SECCOMP_RET_TRACE can be overridden
+ Highlight to the reader that if another filter returns a
+ higher-precedence action value, then the ptracer will not
+ be notified.
+ Michael Kerrisk [Rich Felker]
+ Warn against the use of SECCOMP_RET_KILL_THREAD
+ Killing a thread with SECCOMP_RET_KILL_THREAD is very likely
+ to leave the rest of the process in a broken state.
+ Michael Kerrisk [Rich Felker]
+ EXAMPLES: use SECCOMP_RET_KILL_PROCESS rather than SECCOMP_RET_KILL
+ Alejandro Colomar
+ Use ARRAY_SIZE() macro instead of raw sizeof division
+
+setns.2
+ Michael Kerrisk
+ Correct the version for time namespace support
+
+sigaction.2
+ Michael Kerrisk [Alejandro Colomar]
+ Use correct POSIX type for siginfo_t.si_value
+
+syscalls.2
+ Michael Kerrisk
+ Move system calls from discontinued ports out of main syscall list
+ Various ports that had their own indigenous system calls have
+ been discontinued. Remove those system calls (none of which had
+ manual pages!) to a separate part of the page, to avoid
+ cluttering the main list of system calls.
+ Michael Kerrisk
+ Add close_range (Linux 5.9)
+
+timerfd_create.2
+ Alejandro Colomar
+ Use 'PRIxN' macros when printing C99 fixed-width integer types
+
+userfaultfd.2
+ Michael Kerrisk
+ Use a better type (uint64_t) for 'len' in EXAMPLES
+ Alejandro Colomar
+ Use 'PRIx64' rather than "%llx" when printing 64-bit fixed-width types
+
+argz_add.3
+envz_add.3
+ Michael Kerrisk [Jonny Grant]
+ Point out that 'error_t' is an integer type
+
+bsearch.3
+ Alejandro Colomar
+ Fix intermediate type and remove unneeded casts
+
+bswap.3
+ Jakub Wilk
+ Use strtoull() for parsing 64-bit numbers
+
+dlopen.3
+ Michael Kerrisk
+ Clarify DT_RUNPATH/DT_RPATH details
+ It is the DT_RUNPATH/DT_RPATH of the calling object (not the
+ executable) that is relevant for the library search. Verified
+ by experiment.
+
+errno.3
+ Michael Kerrisk [Alejandro Colomar]
+ Note that the pthreads APIs do not set errno
+
+fopencookie.3
+ Alejandro Colomar
+ printf()'s .* expects an int; cast accordingly
+ Alejandro Colomar
+ Fix bugs in example
+
+fread.3
+ Alejandro Colomar
+ Move ARRAY_SIZE logic into macro
+
+freeaddrinfo.3
+ Marko Hrastovec
+ Fix memory leaks in freeaddrinfo() examples
+
+getline.3
+ Alejandro Colomar
+ Use %zd rather than %zu when printing 'ssize_t' values
+
+lseek64.3
+ Michael Kerrisk
+ Since glibc 2.28. the 'llseek' symbol is no longer available
+
+mallinfo.3
+ Michael Kerrisk
+ The 'usmblks' field is nowadays always 0
+
+offsetof.3
+ Alejandro Colomar
+ Use "%zu" rather than "%zd" when printing 'size_t' values
+
+perror.3
+ Michael Kerrisk
+ sys_errlist and sys_nerr are no longer exposed by <stdio.h>
+ The change came with the release of glibc 2.32.
+
+posix_fallocate.3
+ Érico Rolim
+ Add EOPNOTSUPP error code.
+
+psignal.3
+strsignal.3
+ Michael Kerrisk
+ Consolidate information on 'sys_siglist' in one page (strsignal(3))
+
+pthread_attr_init.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_attr_init(3)
+
+pthread_attr_init.3
+pthread_create.3
+pthread_getattr_np.3
+ Michael Kerrisk
+ Use correct type (size_t) for some variables
+
+pthread_getattr_np.3
+ Alejandro Colomar
+ Use "%zu" and "%zx" when printing 'size_t' values
+
+pthread_sigmask.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_attr_setsigmask_np(3)
+
+qsort.3
+ Alejandro Colomar
+ Fix casts
+ Alejandro Colomar
+ SYNOPSIS: move code from queue.3 to stailq.3
+
+regex.3
+ Alejandro Colomar
+ Add example program
+ Alejandro Colomar
+ Remove unnecessary include
+
+strsignal.3
+ Michael Kerrisk [Hauke Fath]
+ Note that starting with v2.32, glibc no longer exports 'sys_siglist'
+ Michael Kerrisk
+ Further addition on version range for sys_siglist
+ Michael Kerrisk
+ Note that 'sys_siglist' is nonstandard
+
+strtod.3
+ Jonathan Wakely
+ Fix return value for underflow
+
+strtol.3
+ Alejandro Colomar
+ EXAMPLES: simplify errno checking
+ Alejandro Colomar
+ EXAMPLES: as the default base, use special value 0
+ Alejandro Colomar
+ EXAMPLES: delimit output string using ""
+
+tsearch.3
+ Alejandro Colomar
+ Simplify type usage and remove unneeded casts
+ Alejandro Colomar
+ Use size_t for malloc() argument
+
+loop.4
+ Yang Xu
+ Add some details about lo_flags
+
+core.5
+ Alejandro Colomar
+ Use adequate type
+
+locale.5
+ Florian Weimer
+ Decimal points, thousands separators must be one character
+
+proc.5
+ Michael Kerrisk
+ Update capability requirements for accessing /proc/[pid]/map_files
+ Jann Horn [Mark Mossberg]
+ Document inaccurate RSS due to SPLIT_RSS_COUNTING
+ Michael Kerrisk
+ Note "open file description" as (better) synonym for "file handle"
+
+resolv.5
+ Florian Weimer
+ Document the trust-ad option
+
+aio.7
+ Alejandro Colomar
+ Use perror() directly
+
+bpf-helpers.7
+ Michael Kerrisk [Jakub Wilk]
+ Resync with current kernel source
+
+capabilities.7
+ Michael Kerrisk
+ Under CAP_SYS_ADMIN, group "sub-capabilities" together
+ CAP_BPF, CAP_PERFMON, and CAP_CHECKPOINT_RESTORE have all been
+ added to split out the power of CAP_SYS_ADMIN into weaker pieces.
+ Group all of these capabilities together in the list under
+ CAP_SYS_ADMIN, to make it clear that there is a pattern to these
+ capabilities.
+ Michael Kerrisk
+ CAP_SYS_ADMIN implies CAP_CHECKPOINT_RESTORE
+ But the latter, weaker capability is preferred.
+ Michael Kerrisk
+ Add kernel doc reference for CAP_PERFMON
+
+fanotify.7
+ Alejandro Colomar
+ Pass array to read(2) directly instead of a pointer to it
+
+fanotify.7
+fanotify_mark.2
+ Amir Goldstein [Jan Kara, Matthew Bobrowski]
+ Generalize documentation of FAN_REPORT_FID
+
+feature_test_macros.7
+ Jakub Wilk
+ Update list of macros that inhibit default definitions
+
+man.7
+ Michael Kerrisk [G. Branden Robinson]
+ Clarify that alternating typeface macros print arguments without spaces
+
+man-pages.7
+ Michael Kerrisk
+ Add some more requests re code examples
+ Michael Kerrisk
+ Soften the statement that ideal programs should be short
+
+namespaces.7
+ Michael Kerrisk
+ A 'time_for_children' symlink can also pin a namespace
+
+pid_namespaces.7
+ Michael Kerrisk
+ Update capability requirements for /proc/sys/kernel/ns_last_pid
+
+pthreads.7
+ Michael Kerrisk
+ Explicitly note that pthreads APIs return an errno-style value on error
+
+rtld-audit.7
+ Florian Weimer [Carlos O'Donell]
+ Clarify la_version handshake
+ Returning its argument without further checks is almost always
+ wrong for la_version.
+ Alejandro Colomar
+ Use "%u" rather than "%d" when printing 'unsigned int' values
+
+sigevent.7
+ Michael Kerrisk
+ Note that 'sigev_notify_thread_id' is Linux-specific
+
+socket.7
+ Michael Kerrisk
+ SEE ALSO: add ipv6(7)