2020-11-02 06:58:09 +00:00
|
|
|
==================== Changes in man-pages-5.10 ====================
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2020-12-21 15:20:35 +00:00
|
|
|
Released: 2020-12-21, Munich
|
2007-09-19 21:40:03 +00:00
|
|
|
|
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Contributors
|
|
|
|
|
------------
|
2007-10-23 11:33:49 +00:00
|
|
|
|
2011-09-16 02:56:20 +00:00
|
|
|
The following people contributed patches/fixes or (noted in brackets
|
2012-03-05 20:07:17 +00:00
|
|
|
in the changelog below) reports, notes, and ideas that have been
|
2011-09-16 02:56:20 +00:00
|
|
|
incorporated in changes in this release:
|
2007-09-20 18:15:23 +00:00
|
|
|
|
2020-12-21 15:13:16 +00:00
|
|
|
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>
|
2013-03-10 10:24:30 +00:00
|
|
|
|
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
|
|
|
|
|
2020-08-13 11:49:52 +00:00
|
|
|
Newly documented interfaces in existing pages
|
|
|
|
|
---------------------------------------------
|
2018-02-02 06:50:23 +00:00
|
|
|
|
2020-12-21 15:13:16 +00:00
|
|
|
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].
|
|
|
|
|
|
2020-08-13 07:55:59 +00:00
|
|
|
|
2020-08-13 11:49:52 +00:00
|
|
|
New and changed links
|
|
|
|
|
---------------------
|
2017-07-13 12:22:09 +00:00
|
|
|
|
2020-12-21 15:13:16 +00:00
|
|
|
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
|
|
|
|
|
|
2019-11-19 21:09:30 +00:00
|
|
|
|
2020-02-09 16:49:10 +00:00
|
|
|
Global changes
|
|
|
|
|
--------------
|
2017-07-13 12:22:09 +00:00
|
|
|
|
2020-12-21 15:13:16 +00:00
|
|
|
Various pages
|
|
|
|
|
Alejandro Colomar
|
|
|
|
|
Use Oxford comma
|
|
|
|
|
|
2017-07-13 12:22:09 +00:00
|
|
|
|
2017-07-13 22:12:22 +00:00
|
|
|
Changes to individual pages
|
|
|
|
|
---------------------------
|
2014-10-02 21:44:42 +00:00
|
|
|
|
2020-12-21 15:13:16 +00:00
|
|
|
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.
|
