mirror of https://github.com/mkerrisk/man-pages
Changes: Ready for 5.12
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk
parent
41343ba512
commit
a23b0c5a5c
355
Changes
355
Changes
|
|
@ -10,6 +10,45 @@ 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>
|
||||
Akihiro Motoki <amotoki@gmail.com>
|
||||
Alejandro Colomar <alx.manpages@gmail.com>
|
||||
Alyssa Ross <hi@alyssa.is>
|
||||
Aurelien Aptel <aaptel@suse.com>
|
||||
Borislav Petkov <bp@suse.de>
|
||||
Bruce Merry <bmerry@ska.ac.za>
|
||||
Chris Keilbart <keilbartchris@gmail.com>
|
||||
Christian Brauner <christian@brauner.io>
|
||||
Christoph Anton Mitterer <calestyo@scientia.net>
|
||||
dann frazier <dann.frazier@canonical.com>
|
||||
Dmitry V. Levin <ldv@altlinux.org>
|
||||
Florian Weimer <fw@deneb.enyo.de>
|
||||
Huang Ying <ying.huang@intel.com>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
James O. D. Hunt <jamesodhunt@gmail.com>
|
||||
Jann Horn <jannh@google.com>
|
||||
Johannes Berg <johannes@sipsolutions.net>
|
||||
Jon Murphy <jonmurphy1618@gmail.com>
|
||||
Josh Triplett <josh@joshtriplett.org>
|
||||
Katsuhiro Numata <byakkomon@gmail.com>
|
||||
Kees Cook <keescook@chromium.org>
|
||||
Mark Kettenis <kettenis@openbsd.org>
|
||||
Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Mike Rapoport <rppt@linux.vnet.ibm.com>
|
||||
Peter Xu <peterx@redhat.com>
|
||||
Sargun Dhillon <sargun@sargun.me>
|
||||
Stefan Puiu <stefan.puiu@gmail.com>
|
||||
Štěpán Němec <stepnem@gmail.com>
|
||||
thomasavoss <thomasavoss@protonmail.com>
|
||||
Topi Miettinen <toiwoton@gmail.com>
|
||||
Tycho Andersen <tycho@tycho.pizza>
|
||||
Utkarsh Singh <utkarsh190601@gmail.com>
|
||||
Vishwajith K <vishuvikas1996@gmail.com>
|
||||
Walter Harms <wharms@bfs.de>
|
||||
Yang Xu <xuyang2018.jy@fujitsu.com>
|
||||
Zhiheng Li <phoenix_lzh@sina.com>
|
||||
наб <nabijaczleweli@nabijaczleweli.xyz>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
|
@ -17,19 +56,335 @@ Apologies if I missed anyone!
|
|||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
seccomp_unotify.2
|
||||
Michael Kerrisk [Tycho Andersen, Jann Horn, Kees Cook, Christian Brauner
|
||||
Sargun Dhillon]
|
||||
New page documenting the seccomp user-space notification mechanism
|
||||
|
||||
MAX.3
|
||||
Alejandro Colomar
|
||||
New page to document MAX() and MIN()
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
seccomp.2
|
||||
Tycho Andersen [MichaelKerrisk]
|
||||
Document SECCOMP_GET_NOTIF_SIZES
|
||||
Tycho Andersen
|
||||
Document SECCOMP_FILTER_FLAG_NEW_LISTENER [Michael Kerrisk]
|
||||
Tycho Andersen
|
||||
Document SECCOMP_RET_USER_NOTIF [Michael Kerrisk]
|
||||
|
||||
set_mempolicy.2
|
||||
Huang Ying [Alejandro Colomar, "Huang, Ying"]
|
||||
Add mode flag MPOL_F_NUMA_BALANCING
|
||||
|
||||
userfaultfd.2
|
||||
Peter Xu [Alejandro Colomar, Mike Rapoport]
|
||||
Add UFFD_FEATURE_THREAD_ID docs
|
||||
Peter Xu [Alejandro Colomar, Mike Rapoport]
|
||||
Add write-protect mode docs
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/vm/sysctl_hugetlb_shm_group
|
||||
|
||||
system_data_types.7
|
||||
Alejandro Colomar
|
||||
Add 'blksize_t'
|
||||
Alejandro Colomar
|
||||
Add 'blkcnt_t'
|
||||
Alejandro Colomar
|
||||
Add 'mode_t'
|
||||
Alejandro Colomar
|
||||
Add 'struct sockaddr'
|
||||
Alejandro Colomar
|
||||
Add 'cc_t'
|
||||
Alejandro Colomar
|
||||
Add 'socklen_t'
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
blkcnt_t.3
|
||||
Alejandro Colomar
|
||||
New link to system_data_types(7)
|
||||
|
||||
blksize_t.3
|
||||
Alejandro Colomar
|
||||
New link to system_data_types(7)
|
||||
|
||||
cc_t.3
|
||||
Alejandro Colomar
|
||||
New link to system_data_types(7)
|
||||
|
||||
MIN.3
|
||||
Michael Kerrisk
|
||||
New link to MIN.3
|
||||
|
||||
mode_t.3
|
||||
Alejandro Colomar
|
||||
New link to system_data_types(7)
|
||||
|
||||
sockaddr.3
|
||||
Alejandro Colomar
|
||||
New link to system_data_types(7)
|
||||
|
||||
socklen_t.3
|
||||
Alejandro Colomar
|
||||
New link to system_data_types(7)
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
Many pages
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Use syscall(SYS_...); for system calls without a wrapper
|
||||
|
||||
Many pages
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Document why each header is required
|
||||
|
||||
Many pages
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Remove unused includes
|
||||
|
||||
Various pages
|
||||
Alejandro Colomar
|
||||
Add note about the use of syscall(2)
|
||||
|
||||
Various pages
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Miscellaneous fixes to includes
|
||||
|
||||
A few pages
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Add missing 'const'
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
dup.2
|
||||
Michael Kerrisk
|
||||
Rewrite the description of dup() somewhat
|
||||
As can be seen by any number of StackOverflow questions, people
|
||||
persistently misunderstand what dup() does, and the existing manual
|
||||
page text, which talks of "copying" a file descriptor doesn't help.
|
||||
Rewrite the text a little to try to prevent some of these
|
||||
misunderstandings, in particular noting at the start that dup()
|
||||
allocates a new file descriptor.
|
||||
Michael Kerrisk
|
||||
Clarify what silent closing means
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Use consistent comments through pages
|
||||
|
||||
epoll_wait.2
|
||||
Alejandro Colomar
|
||||
Move misplaced subsection to NOTES from BUGS
|
||||
|
||||
execveat.2
|
||||
Michael Kerrisk
|
||||
Library support has been added in glibc 2.34
|
||||
|
||||
_exit.2
|
||||
Michael Kerrisk
|
||||
Add a little more detail on the raw _exit() system cal
|
||||
|
||||
exit_group.2
|
||||
Alejandro Colomar
|
||||
Use 'noreturn' in prototypes
|
||||
|
||||
flock.2
|
||||
Aurelien Aptel [Alejandro Colomar]
|
||||
Add CIFS details
|
||||
CIFS flock() locks behave differently than the standard.
|
||||
Give an overview of those differences.
|
||||
|
||||
ioperm.2
|
||||
Alejandro Colomar
|
||||
Remove obvious comment
|
||||
|
||||
memfd_create.2
|
||||
mmap.2
|
||||
shmget.2
|
||||
Michael Kerrisk [Yang Xu]
|
||||
Document the EPERM error for huge page allocations
|
||||
This error can occur if the caller is does not have CAP_IPC_LOCK
|
||||
and is not a member of the sysctl_hugetlb_shm_group.
|
||||
|
||||
mmap.2
|
||||
Bruce Merry
|
||||
Clarify that MAP_POPULATE is best-effort
|
||||
|
||||
mount.2
|
||||
Topi Miettinen
|
||||
Document SELinux use of MS_NOSUID mount flag
|
||||
|
||||
open.2
|
||||
Alejandro Colomar [Walter Harms]
|
||||
Fix bug in linkat(2) call example
|
||||
AT_EMPTY_PATH works with empty strings (""), but not with NULL
|
||||
(or at least it's not obvious).
|
||||
Michael Kerrisk
|
||||
Make it clearer that an FD is an index into the process's FD table
|
||||
Sometimes people are confused, thinking a file descriptor is just a
|
||||
number....
|
||||
|
||||
perfmonctl.2
|
||||
Michael Kerrisk
|
||||
This system call was removed in Linux 5.10
|
||||
|
||||
pipe.2
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Fix incorrect prototype
|
||||
Michael Kerrisk
|
||||
Rearrange SYNOPSIS so that minority version pipe() is at end
|
||||
|
||||
ptrace.2
|
||||
Dmitry V. Levin [Alejandro Colomar, Mathieu Desnoyers]
|
||||
Mention PTRACE_GET_SYSCALL_INFO in RETURN VALUE section
|
||||
|
||||
seccomp.2
|
||||
Michael Kerrisk
|
||||
Reorder list of SECCOMP_SET_MODE_FILTER flags alphabetically
|
||||
(No content changes.)
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add seccomp_unotify(2)
|
||||
|
||||
select.2
|
||||
Michael Kerrisk
|
||||
Strengthen the warning regarding the low value of FD_SETSIZE
|
||||
All modern code should avoid select(2) in favor of poll(2)
|
||||
or epoll(7).
|
||||
Michael Kerrisk
|
||||
Relocate sentence about the fd_set value-result arguments to BUGS
|
||||
|
||||
syscalls.2
|
||||
Michael Kerrisk
|
||||
perfmonctl(2) was removed in Linux 5.10
|
||||
|
||||
bswap.3
|
||||
Alejandro Colomar
|
||||
bswap_*() are implemented using functions
|
||||
Even though it's true that they are macros,
|
||||
it's transparent to the user.
|
||||
|
||||
The user will see their results casted to unsigned types
|
||||
after the conversion due to the underlying functions,
|
||||
so it's better to document these as the underlying functions,
|
||||
specifying the types.
|
||||
|
||||
cmsg.3
|
||||
unix.7
|
||||
Michael Kerrisk
|
||||
Refer to seccomp_unotify(2) for an example of SCM_RIGHTS usage
|
||||
|
||||
cpow.3
|
||||
Alejandro Colomar
|
||||
Use 'complex' after the type consistently
|
||||
|
||||
ctime.3
|
||||
Michael Kerrisk [Katsuhiro Numata]
|
||||
Restore documentation of 'tm_gmtoff' field
|
||||
|
||||
errno.3
|
||||
Alejandro Colomar [Florian Weimer, Mark Kettenis]
|
||||
Fix ENODATA text
|
||||
ENODATA is an XSI STREAMS extension (not base POSIX).
|
||||
|
||||
exec.3
|
||||
Josh Triplett [Alejandro Colomar]
|
||||
Clarify that execvpe() uses PATH from the caller, not envp
|
||||
Josh Triplett [Alejandro Colomar]
|
||||
Fix description of 'e' variants
|
||||
The envp argument specifies the environment of the new process
|
||||
image, not "the environment of the caller".
|
||||
|
||||
fflush.3
|
||||
Alejandro Colomar
|
||||
SEE ALSO: Add fpurge(3)
|
||||
|
||||
getline.3
|
||||
наб [Ahelenia Ziemiańska, Alejandro Colomar]
|
||||
!*lineptr is sufficient
|
||||
No implementation or spec requires *n to be 0 to allocate
|
||||
a new buffer.
|
||||
|
||||
getopt.3
|
||||
James O. D. Hunt [Alejandro Colomar]
|
||||
Clarify behaviour
|
||||
|
||||
printf.3
|
||||
Utkarsh Singh [Alejandro Colomar]
|
||||
Add overall structure of format string
|
||||
|
||||
pthread_attr_setinheritsched.3
|
||||
pthread_attr_setschedparam.3
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Use 'restrict' in prototypes
|
||||
|
||||
pthread_mutexattr_setrobust.3
|
||||
Michael Kerrisk
|
||||
Note that the *_np() APIs are deprecated since glibc 2.34
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Remove incorrect 'const'
|
||||
|
||||
pthread_mutex_consistent.3
|
||||
Michael Kerrisk
|
||||
Note that pthread_mutexattr_setrobust() is now deprecated
|
||||
|
||||
pthread_yield.3
|
||||
Michael Kerrisk
|
||||
Note that this function is deprecated since glibc 2.34
|
||||
|
||||
rpc.3
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Fix prototypes (misc.)
|
||||
|
||||
scanf.3
|
||||
Alyssa Ross [Alejandro Colomar]
|
||||
Clarify that %n supports type modifiers
|
||||
|
||||
xdr.3
|
||||
Alejandro Colomar
|
||||
SYNOPSIS: Fix prototype types
|
||||
Use the same types glibc uses, and add a missing 'const'.
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk
|
||||
CAP_IPC_LOCK also governs memory allocation using huge pages
|
||||
|
||||
environ.7
|
||||
Josh Triplett [Alejandro Colomar]
|
||||
Remove obsolete admonishment of the GZIP environment variable
|
||||
|
||||
kernel_lockdown.7
|
||||
dann frazier [Alejandro Colomar]
|
||||
Remove description of lifting via SysRq (not upstream)
|
||||
The patch that implemented lockdown lifting via SysRq ended up
|
||||
getting dropped[*] before the feature was merged upstream. Having
|
||||
the feature documented but unsupported has caused some confusion
|
||||
for our users.
|
||||
|
||||
mount_namespaces.7
|
||||
namespaces.7
|
||||
Michael Kerrisk
|
||||
Relocate reference to pam_namespace(8) from namespaces.7 to
|
||||
mount_namespaces.7.
|
||||
|
||||
signal.7
|
||||
Michael Kerrisk
|
||||
Add reference to seccomp_unotify(2)
|
||||
The seccomp user-space notification feature can cause changes in
|
||||
the semantics of SA_RESTART with respect to system calls that
|
||||
would never normally be restarted. Point the reader to the page
|
||||
that provide further details.
|
||||
|
||||
vsock.7
|
||||
Alyssa Ross
|
||||
ioctls are on /dev/vsock, not sockets
|
||||
|
|
|
|||
Loading…
Reference in New Issue