==================== 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.