mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-5.10: updating Changes and Changes.old
This commit is contained in:
Michael Kerrisk
parent
db9c2b96ab
commit
07d6c242cf
747
Changes
747
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)
|
||||
|
|
|
|||
780
Changes.old
780
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)
|
||||
|
|
|
|||
Loading…
Reference in New Issue