From 5e207fcf115b4c9119b048ea4bb9c1b10f02c06e Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 22 Dec 2020 09:30:12 +0100 Subject: [PATCH] Start of man-pages-5.11: updating Changes and Changes.old --- Changes | 327 +----------------------------------------------- Changes.old | 352 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 358 insertions(+), 321 deletions(-) diff --git a/Changes b/Changes index 4dac38780..d364c0128 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.10 ==================== +==================== Changes in man-pages-5.11 ==================== -Released: 2020-12-21, Munich +Released: ????-??-??, Munich Contributors @@ -10,341 +10,26 @@ 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: -Ahelenia Ziemiańska -Alejandro Colomar -Amir Goldstein -Arusekk -Baruch Siach -Bill Allombert -Colin Ian King -Dave Martin -Davide Giorgio -Heinrich Schuchardt -Jan Kara -Jing Peng -John A. Leuenhagen -Mathias Rav -Michael Kerrisk -Mike Crowe -Namhyung Kim -Peter Oskolkov -Philip Rowlands -Rob Landley -Ross Zwisler -Sebastian Kirmayer -наб Apologies if I missed anyone! +New and rewritten pages +----------------------- + + Newly documented interfaces in existing pages --------------------------------------------- -access.2 - Michael Kerrisk - Document faccessat2() - faccessat2() was added in Linux 5.8 and enables a fix to - longstanding bugs in the faccessat() wrapper function. - -membarrier.2 - Peter Oskolkov [Alejandro Colomar] - Update for Linux 5.10 - Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840 - (part of 5.10 release) changed sys_membarrier prototype/parameters - and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ - and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ]. - New and changed links --------------------- -faccessat2.2 - Michael Kerrisk - New link to access.2 - -CIRCLEQ_EMPTY.3 -CIRCLEQ_FIRST.3 -CIRCLEQ_FOREACH.3 -CIRCLEQ_FOREACH_REVERSE.3 -CIRCLEQ_HEAD_INITIALIZER.3 -CIRCLEQ_LAST.3 -CIRCLEQ_LOOP_NEXT.3 -CIRCLEQ_LOOP_PREV.3 -CIRCLEQ_NEXT.3 -CIRCLEQ_PREV.3 - Michael Kerrisk - Add missing links to circleq.3 - -pthread_attr_getsigmask_np.3 - Michael Kerrisk - New link to pthread_attr_setsigmask_np.3 - Global changes -------------- -Various pages - Alejandro Colomar - Use Oxford comma - Changes to individual pages --------------------------- -access.2 - Michael Kerrisk - BUGS: note that faccessat() wrapper function emulation ignores ACLs - -bpf.2 - Michael Kerrisk - Place EXAMPLES section in correct location - -cacheflush.2 - Alejandro Colomar - Document Architecture-specific variants - Alejandro Colomar [Heinrich Schuchardt] - Document __builtin___clear_cache() as a more portable alternative - -chroot.2 -memfd_create.2 -tailq.3 - Michael Kerrisk [Alejandro Colomar] - Fix unbalanced .nf/.fi - -clock_getres.2 - Michael Kerrisk - Place ERRORS in alphabetical order - -clone.2 -sigaltstack.2 - Michael Kerrisk - clone(CLONE_VM) disables the alternate signal stack - -getrlimit.2 - Michael Kerrisk - State more precisely the range of kernel versions that had RLIMIT_LOCKS - -getrusage.2 - Michael Kerrisk - Note that the 'vtimes' symbol exists only up to glibc 2.32 - -io_cancel.2 -io_destroy.2 -io_getevents.2 -io_setup.2 -io_submit.2 - Alejandro Colomar - SYNOPSIS: s/io_context_t/aio_context_t/ - Linux uses aio_context_t for these syscalls, - and it's the type provided by . - Use it in the SYNOPSIS. - - libaio uses 'io_context_t', but that difference is already noted - in NOTES. - -io_setup.2 - Alejandro Colomar - SYNOPSIS: return long - -link.2 - Mathias Rav - ERRORS: add ENOENT when target is deleted - Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part - of kernel release v2.6.39) added a check to disallow creating a - hard link to an unlinked file. - -llseek.2 - Michael Kerrisk - Note size of 'loff_t' type - Michael Kerrisk - Point the reader to lseek64(3) for info about llseek(3) - Michael Kerrisk - Some mild rewriting to ease reading of the info in this page - -mmap.2 - Michael Kerrisk - Clarify SIGBUS text and treatment of partial page at end of a mapping - -mount.2 -statfs.2 - Ross Zwisler - Add NOSYMFOLLOW flags to mount(2) and statfs(2) - -msgctl.2 - Michael Kerrisk - Make comments in 'msqid_ds' definition more compact - Michael Kerrisk - Place list of field descriptions in same order as structure definition - Michael Kerrisk - Use field name "msg_cbytes" rather than "__msg_cbytes" - Michael Kerrisk - Add description of 'msg_cbytes' field - -openat.2 - Colin Ian King - Fix include path, should be linux/openat2.h - -perf_event_open.2 - Namhyung Kim [Alejandro Colomar] - Update man page with recent kernel changes - Alejandro Colomar - Assign calculated value explicitly to 'config' - -restart_syscall.2 - Alejandro Colomar - SYNOPSIS: Fix restart_syscall() return type - -set_tid_address.2 - Alejandro Colomar - SYNOPSIS: Fix set_tid_address() return type - -shmctl.2 - Michael Kerrisk - Place list of field descriptions in same order as structure definition - -sigaction.2 - Michael Kerrisk - Clarify description of SA_NODEFER - Clarify description of SA_NODEFER, and note interaction with - act.sa_mask. - Michael Kerrisk - Add a cross-reference to signal(7) for further info on 'ucontext_t' - -sigaltstack.2 - Michael Kerrisk - Clarify that the alternate signal stack is per-thread - Clarify that the alternate signal stack is per-thread (rather - than process-wide). - -spu_create.2 - Michael Kerrisk - Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM - Michael Kerrisk - Relocate paragraph on 'mode' argument - Michael Kerrisk [Alejandro Colomar] - Clarify that spu_create() now has 4 arguments but once had only 3 - -subpage_prot.2 - Alejandro Colomar - SYNOPSIS: Fix return type: s/long/int/ - -syscalls.2 - Michael Kerrisk - Add process_madvise() - Michael Kerrisk - Note that sysctl() was removed in Linux 5.5 - -timer_getoverrun.2 - Michael Kerrisk - timer_getoverrun() now clamps the overrun count to DELAYTIMER_MAX - See https://bugzilla.kernel.org/show_bug.cgi?id=12665. - -uselib.2 -posix_memalign.3 -profil.3 -rtime.3 - Michael Kerrisk - Remove some text about libc/libc5 - With this change, there remain almost no vestiges of information - about the long defunct Linux libc. - -errno.3 - Michael Kerrisk - Note another possible cause of the EMFILE error - -getcontext.3 - Michael Kerrisk - Mention SA_SIGINFO flag when talking about 3-argument signal handler - Michael Kerrisk - SEE ALSO: add signal(7) - -list.3 - Michael Kerrisk - NAME: remove LIST_PREV, which is not documented in this page - -lseek64.3 - Michael Kerrisk - Remove section numbers from interface list - Michael Kerrisk - Remove sentence saying lseek64() is an alias for llseek() - Michael Kerrisk - NOTES: describe the origin of lseek64() in LFS - -nextafter.3 - Michael Kerrisk - Remove duplicate "BUGS" section heading - -pthread_tryjoin_np.3 - Michael Kerrisk [Mike Crowe] - Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug - -rcmd.3 - Michael Kerrisk - SEE ALSO: remove intro(2) - -strnlen.3 - Michael Kerrisk [Heinrich Schuchardt] - Fix a small inconsistency in the text - -elf.5 - Michael Kerrisk - SEE ALSO: add objcopy(1) - -filesystems.5 - Ahelenia Ziemiańska [Alejandro Colomar] - Fix link to user space tooling for ncpfs - Ahelenia Ziemiańska [Alejandro Colomar] - Note ncpfs removal from kernel - -attributes.7 - Michael Kerrisk - SEE ALSO: add signal-safety(7) - -fanotify.7 - Amir Goldstein [Jan Kara] - fix outdated description - -kernel_lockdown.7 - Michael Kerrisk - Remove unneeded quotes - -packet.7 - Baruch Siach [Alejandro Colomar] - Update references to kernel documentation - -pthreads.7 - Michael Kerrisk - Rephrase function list in terms of POSIX rather than SUS - The list was using an inconsistent mixture of "POSIX" and "SUS". - -signal.7 - Michael Kerrisk [Heinrich Schuchardt, Dave Martin] - Add some details on the execution of signal handlers - Add a "big picture" of what happens when a signal handler - is invoked. - Michael Kerrisk - Add pidfd_send_signal() to list of APIs for sending signals - Michael Kerrisk - Mention 'ucontext_t' in the discussion of signal handler execution - Michael Kerrisk - SEE ALSO: add swapcontext(3) - -signal-safety.7 - Michael Kerrisk - Note async-signal-safety details for errno - -standards.7 - Michael Kerrisk - Add URL for POSIX.1-2008/SUSv4 - Michael Kerrisk - Add LFS (Large File Summit) - Michael Kerrisk [Rob Landley] - Fix some URLs for locations of the standards - Michael Kerrisk - Relocate the discussion on POSIX manual pages - -tcp.7 - Alejandro Colomar [Philip Rowlands] - tcp_syncookies: It is now an integer [0, 2] - Since Linux kernel 3.12, tcp_syncookies can have the value 2, - which sends out cookies unconditionally. diff --git a/Changes.old b/Changes.old index 16c84b4e3..53dfc0595 100644 --- a/Changes.old +++ b/Changes.old @@ -52987,3 +52987,355 @@ sigevent.7 socket.7 Michael Kerrisk SEE ALSO: add ipv6(7) + + +==================== Changes in man-pages-5.10 ==================== + +Released: 2020-12-21, 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: + +Ahelenia Ziemiańska +Alejandro Colomar +Amir Goldstein +Arusekk +Baruch Siach +Bill Allombert +Colin Ian King +Dave Martin +Davide Giorgio +Heinrich Schuchardt +Jan Kara +Jing Peng +John A. Leuenhagen +Mathias Rav +Michael Kerrisk +Mike Crowe +Namhyung Kim +Peter Oskolkov +Philip Rowlands +Rob Landley +Ross Zwisler +Sebastian Kirmayer +наб + +Apologies if I missed anyone! + + +Newly documented interfaces in existing pages +--------------------------------------------- + +access.2 + Michael Kerrisk + Document faccessat2() + faccessat2() was added in Linux 5.8 and enables a fix to + longstanding bugs in the faccessat() wrapper function. + +membarrier.2 + Peter Oskolkov [Alejandro Colomar] + Update for Linux 5.10 + Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840 + (part of 5.10 release) changed sys_membarrier prototype/parameters + and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ + and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ]. + + +New and changed links +--------------------- + +faccessat2.2 + Michael Kerrisk + New link to access.2 + +CIRCLEQ_EMPTY.3 +CIRCLEQ_FIRST.3 +CIRCLEQ_FOREACH.3 +CIRCLEQ_FOREACH_REVERSE.3 +CIRCLEQ_HEAD_INITIALIZER.3 +CIRCLEQ_LAST.3 +CIRCLEQ_LOOP_NEXT.3 +CIRCLEQ_LOOP_PREV.3 +CIRCLEQ_NEXT.3 +CIRCLEQ_PREV.3 + Michael Kerrisk + Add missing links to circleq.3 + +pthread_attr_getsigmask_np.3 + Michael Kerrisk + New link to pthread_attr_setsigmask_np.3 + + +Global changes +-------------- + +Various pages + Alejandro Colomar + Use Oxford comma + + +Changes to individual pages +--------------------------- + +access.2 + Michael Kerrisk + BUGS: note that faccessat() wrapper function emulation ignores ACLs + +bpf.2 + Michael Kerrisk + Place EXAMPLES section in correct location + +cacheflush.2 + Alejandro Colomar + Document Architecture-specific variants + Alejandro Colomar [Heinrich Schuchardt] + Document __builtin___clear_cache() as a more portable alternative + +chroot.2 +memfd_create.2 +tailq.3 + Michael Kerrisk [Alejandro Colomar] + Fix unbalanced .nf/.fi + +clock_getres.2 + Michael Kerrisk + Place ERRORS in alphabetical order + +clone.2 +sigaltstack.2 + Michael Kerrisk + clone(CLONE_VM) disables the alternate signal stack + +getrlimit.2 + Michael Kerrisk + State more precisely the range of kernel versions that had RLIMIT_LOCKS + +getrusage.2 + Michael Kerrisk + Note that the 'vtimes' symbol exists only up to glibc 2.32 + +io_cancel.2 +io_destroy.2 +io_getevents.2 +io_setup.2 +io_submit.2 + Alejandro Colomar + SYNOPSIS: s/io_context_t/aio_context_t/ + Linux uses aio_context_t for these syscalls, + and it's the type provided by . + Use it in the SYNOPSIS. + + libaio uses 'io_context_t', but that difference is already noted + in NOTES. + +io_setup.2 + Alejandro Colomar + SYNOPSIS: return long + +link.2 + Mathias Rav + ERRORS: add ENOENT when target is deleted + Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part + of kernel release v2.6.39) added a check to disallow creating a + hard link to an unlinked file. + +llseek.2 + Michael Kerrisk + Note size of 'loff_t' type + Michael Kerrisk + Point the reader to lseek64(3) for info about llseek(3) + Michael Kerrisk + Some mild rewriting to ease reading of the info in this page + +mmap.2 + Michael Kerrisk + Clarify SIGBUS text and treatment of partial page at end of a mapping + +mount.2 +statfs.2 + Ross Zwisler + Add NOSYMFOLLOW flags to mount(2) and statfs(2) + +msgctl.2 + Michael Kerrisk + Make comments in 'msqid_ds' definition more compact + Michael Kerrisk + Place list of field descriptions in same order as structure definition + Michael Kerrisk + Use field name "msg_cbytes" rather than "__msg_cbytes" + Michael Kerrisk + Add description of 'msg_cbytes' field + +openat.2 + Colin Ian King + Fix include path, should be linux/openat2.h + +perf_event_open.2 + Namhyung Kim [Alejandro Colomar] + Update man page with recent kernel changes + Alejandro Colomar + Assign calculated value explicitly to 'config' + +restart_syscall.2 + Alejandro Colomar + SYNOPSIS: Fix restart_syscall() return type + +set_tid_address.2 + Alejandro Colomar + SYNOPSIS: Fix set_tid_address() return type + +shmctl.2 + Michael Kerrisk + Place list of field descriptions in same order as structure definition + +sigaction.2 + Michael Kerrisk + Clarify description of SA_NODEFER + Clarify description of SA_NODEFER, and note interaction with + act.sa_mask. + Michael Kerrisk + Add a cross-reference to signal(7) for further info on 'ucontext_t' + +sigaltstack.2 + Michael Kerrisk + Clarify that the alternate signal stack is per-thread + Clarify that the alternate signal stack is per-thread (rather + than process-wide). + +spu_create.2 + Michael Kerrisk + Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM + Michael Kerrisk + Relocate paragraph on 'mode' argument + Michael Kerrisk [Alejandro Colomar] + Clarify that spu_create() now has 4 arguments but once had only 3 + +subpage_prot.2 + Alejandro Colomar + SYNOPSIS: Fix return type: s/long/int/ + +syscalls.2 + Michael Kerrisk + Add process_madvise() + Michael Kerrisk + Note that sysctl() was removed in Linux 5.5 + +timer_getoverrun.2 + Michael Kerrisk + timer_getoverrun() now clamps the overrun count to DELAYTIMER_MAX + See https://bugzilla.kernel.org/show_bug.cgi?id=12665. + +uselib.2 +posix_memalign.3 +profil.3 +rtime.3 + Michael Kerrisk + Remove some text about libc/libc5 + With this change, there remain almost no vestiges of information + about the long defunct Linux libc. + +errno.3 + Michael Kerrisk + Note another possible cause of the EMFILE error + +getcontext.3 + Michael Kerrisk + Mention SA_SIGINFO flag when talking about 3-argument signal handler + Michael Kerrisk + SEE ALSO: add signal(7) + +list.3 + Michael Kerrisk + NAME: remove LIST_PREV, which is not documented in this page + +lseek64.3 + Michael Kerrisk + Remove section numbers from interface list + Michael Kerrisk + Remove sentence saying lseek64() is an alias for llseek() + Michael Kerrisk + NOTES: describe the origin of lseek64() in LFS + +nextafter.3 + Michael Kerrisk + Remove duplicate "BUGS" section heading + +pthread_tryjoin_np.3 + Michael Kerrisk [Mike Crowe] + Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug + +rcmd.3 + Michael Kerrisk + SEE ALSO: remove intro(2) + +strnlen.3 + Michael Kerrisk [Heinrich Schuchardt] + Fix a small inconsistency in the text + +elf.5 + Michael Kerrisk + SEE ALSO: add objcopy(1) + +filesystems.5 + Ahelenia Ziemiańska [Alejandro Colomar] + Fix link to user space tooling for ncpfs + Ahelenia Ziemiańska [Alejandro Colomar] + Note ncpfs removal from kernel + +attributes.7 + Michael Kerrisk + SEE ALSO: add signal-safety(7) + +fanotify.7 + Amir Goldstein [Jan Kara] + fix outdated description + +kernel_lockdown.7 + Michael Kerrisk + Remove unneeded quotes + +packet.7 + Baruch Siach [Alejandro Colomar] + Update references to kernel documentation + +pthreads.7 + Michael Kerrisk + Rephrase function list in terms of POSIX rather than SUS + The list was using an inconsistent mixture of "POSIX" and "SUS". + +signal.7 + Michael Kerrisk [Heinrich Schuchardt, Dave Martin] + Add some details on the execution of signal handlers + Add a "big picture" of what happens when a signal handler + is invoked. + Michael Kerrisk + Add pidfd_send_signal() to list of APIs for sending signals + Michael Kerrisk + Mention 'ucontext_t' in the discussion of signal handler execution + Michael Kerrisk + SEE ALSO: add swapcontext(3) + +signal-safety.7 + Michael Kerrisk + Note async-signal-safety details for errno + +standards.7 + Michael Kerrisk + Add URL for POSIX.1-2008/SUSv4 + Michael Kerrisk + Add LFS (Large File Summit) + Michael Kerrisk [Rob Landley] + Fix some URLs for locations of the standards + Michael Kerrisk + Relocate the discussion on POSIX manual pages + +tcp.7 + Alejandro Colomar [Philip Rowlands] + tcp_syncookies: It is now an integer [0, 2] + Since Linux kernel 3.12, tcp_syncookies can have the value 2, + which sends out cookies unconditionally.