blob: 4dac387808ef4726e8eb08276e67083d4696d6a3 [file] [log] [blame]
==================== 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 <nabijaczleweli@nabijaczleweli.xyz>
Alejandro Colomar <alx.manpages@gmail.com>
Amir Goldstein <amir73il@gmail.com>
Arusekk <arek_koz@o2.pl>
Baruch Siach <baruch@tkos.co.il>
Bill Allombert <ballombe@debian.org>
Colin Ian King <colin.king@canonical.com>
Dave Martin <Dave.Martin@arm.com>
Davide Giorgio <davide@giorgiodavide.it>
Heinrich Schuchardt <xypron.glpk@gmx.de>
Jan Kara <jack@suse.cz>
Jing Peng <pj.hades@gmail.com>
John A. Leuenhagen <john@zlima12.com>
Mathias Rav <m@git.strova.dk>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Crowe <mac@mcrowe.com>
Namhyung Kim <namhyung@gmail.com>
Peter Oskolkov <posk@google.com>
Philip Rowlands <linux-kernel@dimebar.com>
Rob Landley <rob@landley.net>
Ross Zwisler <zwisler@chromium.org>
Sebastian Kirmayer <sebastian@kirmayer.de>
наб <nabijaczleweli@nabijaczleweli.xyz>
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 <linux/aio_abi.h>.
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.