mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-4.17: updating Changes and Changes.old
This commit is contained in:
parent
a4e17b66a3
commit
1166955680
364
Changes
364
Changes
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-4.16 ====================
|
||||
==================== Changes in man-pages-4.17 ====================
|
||||
|
||||
Released: 2018-04-30, Munich
|
||||
Released: ????-??-??, Munich
|
||||
|
||||
|
||||
Contributors
|
||||
|
@ -10,370 +10,26 @@ 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:
|
||||
|
||||
Adam Borowski <kilobyte@angband.pl>
|
||||
Andy Owen <andrew.owen@dolby.com>
|
||||
Carlos O'Donell <carlos@redhat.com>
|
||||
Carsten Grohmann <carstengrohmann@gmx.de>
|
||||
Elvira Khabirova <lineprinter@altlinux.org>
|
||||
Enrique Garcia <cquike@arcor.de>
|
||||
Frederic Brault <fbrault@xyalis.com>
|
||||
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
||||
Howard Johnson <hwj@BridgeportContractor.com>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Jan Kara <jack@suse.cz>
|
||||
Jann Horn <jannh@google.com>
|
||||
John Hubbard <jhubbard@nvidia.com>
|
||||
Jürg Billeter <j@bitron.ch>
|
||||
Konstantin Grinemayer <cdlscpmv@gmail.com>
|
||||
Konstantin Khlebnikov <khlebnikov@yandex-team.ru>
|
||||
Martin Mares <mj@ucw.cz>
|
||||
Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
|
||||
Mattias Andrée <maandree@kth.se>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Michal Hocko <mhocko@suse.com>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
Nikos Mavrogiannopoulos <nmavrogi@redhat.com>
|
||||
Robin Kuzmin <kuzmin.robin@gmail.com>
|
||||
Ross Zwisler <ross.zwisler@linux.intel.com>
|
||||
Rusty Russell <rusty@rustcorp.com.au>
|
||||
Serge E. Hallyn <serge@hallyn.com>
|
||||
Song Liu <songliubraving@fb.com>
|
||||
Tomi Salminen <tsalminen@forcepoint.com>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
membarrier.2
|
||||
Mathieu Desnoyers [Michael Kerrisk]
|
||||
Document new membarrier commands introduced in Linux 4.16
|
||||
Document the following membarrier commands introduced in
|
||||
Linux 4.16:
|
||||
|
||||
MEMBARRIER_CMD_GLOBAL_EXPEDITED
|
||||
(the old enum label MEMBARRIER_CMD_SHARED is now an
|
||||
alias to preserve header backward compatibility)
|
||||
MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED
|
||||
MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE
|
||||
MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
mmap.2
|
||||
Jan Kara [Ross Zwisler, Michael Kerrisk]
|
||||
Add description of MAP_SHARED_VALIDATE and MAP_SYNC
|
||||
Michal Hocko [John Hubbard, Michael Kerrisk, Jann Horn]
|
||||
Document new MAP_FIXED_NOREPLACE flag
|
||||
4.17+ kernels offer a new MAP_FIXED_NOREPLACE flag which allows
|
||||
the caller to atomically probe for a given address range.
|
||||
|
||||
readv.2
|
||||
io_submit.2
|
||||
Jürg Billeter
|
||||
Document RWF_APPEND added in Linux 4.16
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk
|
||||
Describe file capability versioning
|
||||
Michael Kerrisk [Serge E. Hallyn]
|
||||
Document namespaced-file capabilities
|
||||
[There's still more work to be done on this new text]
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
bpf.2
|
||||
Michael Kerrisk
|
||||
Update list of architectures that support JITed eBPF
|
||||
And note kernel version numbers where support is added.
|
||||
Michael Kerrisk
|
||||
Kernel 4.15 added CONFIG_BPF_JIT_ALWAYS_ON
|
||||
This causes the JIT compiler to be always on and
|
||||
forces bpf_jit_enable to 1.
|
||||
|
||||
execve.2
|
||||
Michael Kerrisk
|
||||
Note that describing execve as "executing a new process" is misleading
|
||||
This misdescription is so common that it's worth calling it out
|
||||
explicitly.
|
||||
Michael Kerrisk
|
||||
More explicitly describe effect of execve() in the opening paragraph
|
||||
|
||||
fallocate.2
|
||||
Michael Kerrisk
|
||||
Since Linux 4.16, Btrfs supports FALLOC_FL_ZERO_RANGE
|
||||
|
||||
getrlimit.2
|
||||
Michael Kerrisk
|
||||
CAP_SYS_RESOURCE capability is required in *initial user namespace*
|
||||
|
||||
io_submit.2
|
||||
Michael Kerrisk
|
||||
Add kernel version numbers for various 'aio_rw_flags' flags
|
||||
Michael Kerrisk
|
||||
Place 'aio_rw_flags' in alphabetical order
|
||||
|
||||
mmap.2
|
||||
Jann Horn
|
||||
MAP_FIXED is okay if the address range has been reserved
|
||||
Clarify that MAP_FIXED is appropriate if the specified address
|
||||
range has been reserved using an existing mapping, but shouldn't
|
||||
be used otherwise.
|
||||
Michael Kerrisk
|
||||
Move the text on MAP_FIXED to NOTES
|
||||
This text has become rather long, making it it somewhat
|
||||
unwieldy in the discussion of the mmap() flags. Therefore,
|
||||
move it to NOTES, with a pointer in DESCRIPTION referring
|
||||
the reader to NOTES.
|
||||
Michael Kerrisk [Heinrich Schuchardt]
|
||||
Clarify that when addr==NULL, address chosen by kernel is page-aligned
|
||||
Michael Kerrisk
|
||||
Add a little historical detail on the obsolete MAP_DENYWRITE
|
||||
|
||||
mount.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EBUSY for the case of trying to stack same mount twice
|
||||
Michael Kerrisk
|
||||
Remove a couple of obsolete EBUSY errors
|
||||
As far as I can tell, these EBUSY errors disappeared
|
||||
with the addition of stackable mounts in Linux 2.4.
|
||||
|
||||
msgget.2
|
||||
semget.2
|
||||
shmget.2
|
||||
Michael Kerrisk
|
||||
The purpose of "flags" == 0 is to obtain ID of an existing IPC object
|
||||
This was implied in these pages, but the meaning of "flags" == 0
|
||||
could be more explicit, as indicated by questions such as
|
||||
https://stackoverflow.com/questions/49833569/flag-value-of-semget-function
|
||||
|
||||
open.2
|
||||
Jann Horn
|
||||
Document more -ETXTBSY conditions
|
||||
Jakub Wilk
|
||||
Add missing argument for snprintf() in example code
|
||||
|
||||
perf_event_open.2
|
||||
Song Liu
|
||||
Add type kprobe and uprobe
|
||||
Two new types kprobe and uprobe are being added to
|
||||
perf_event_open(), which allow creating kprobe or
|
||||
uprobe with perf_event_open. This patch adds
|
||||
information about these types.
|
||||
|
||||
ptrace.2
|
||||
Jann Horn
|
||||
Copy retval info for SECCOMP_GET_FILTER to right section
|
||||
The "RETURN VALUE" section made a claim that was incorrect for
|
||||
PTRACE_SECCOMP_GET_FILTER. Explicitly describe the behavior of
|
||||
PTRACE_SECCOMP_GET_FILTER in the "RETURN VALUE" section (as
|
||||
usual), but leave the now duplicate description in the section
|
||||
describing PTRACE_SECCOMP_GET_FILTER, since the
|
||||
PTRACE_SECCOMP_GET_FILTER section would otherwise probably become
|
||||
harder to understand.
|
||||
|
||||
readv.2
|
||||
Michael Kerrisk
|
||||
Remove redundant sentence
|
||||
|
||||
seccomp.2
|
||||
Michael Kerrisk
|
||||
Note that execve() may change syscall numbers during life of process
|
||||
On a multiarch/multi-ABI platform such as modern x86, each
|
||||
architecture/ABI (x86-64, x32, i386)has its own syscall numbers,
|
||||
which means a seccomp() filter may see different syscall numbers
|
||||
over the life of the process if that process uses execve() to
|
||||
execute programs that has a different architectures/ABIs.
|
||||
Michael Kerrisk
|
||||
Note which architectures support seccomp BPF
|
||||
Michael Kerrisk
|
||||
In EXAMPLE, clearly note that x32 syscalls are >= X32_SYSCALL_BIT
|
||||
|
||||
shutdown.2
|
||||
Carsten Grohmann
|
||||
SEE ALSO: add close(2)
|
||||
|
||||
syscall.2
|
||||
Adam Borowski
|
||||
Add riscv
|
||||
|
||||
wait.2
|
||||
Michael Kerrisk [Robin Kuzmin]
|
||||
wait() and waitpid() block the calling thread (not process)
|
||||
|
||||
wait4.2
|
||||
Michael Kerrisk [Martin Mares]
|
||||
Soften the warning against the use of wait3()/wait4()
|
||||
These functions are nonstandard, but there is no replacement.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=199215
|
||||
|
||||
crypt.3
|
||||
encrypt.3
|
||||
Carlos O'Donell [Michael Kerrisk]
|
||||
Add notes about _XOPEN_CRYPT
|
||||
The distribution may choose not to support _XOPEN_CRYPT in the
|
||||
case that the distribution has transitioned from glibc crypt to
|
||||
libxcrypt.
|
||||
|
||||
fseek.3
|
||||
Michael Kerrisk [Andy Owen]
|
||||
ERRORS: EBADF should be ESPIPE
|
||||
Michael Kerrisk
|
||||
Improve EPIPE error text
|
||||
|
||||
getcwd.3
|
||||
Carlos O'Donell
|
||||
Mention that "(unreachable)" is no longer returned for glibc >= 2.27.
|
||||
|
||||
makedev.3
|
||||
Michael Kerrisk
|
||||
Since glibc 2.28, <sys/types.h> no longer defines these macros
|
||||
|
||||
pthread_create.3
|
||||
Frederic Brault
|
||||
Note default thread stack size for several architectures
|
||||
|
||||
tsearch.3
|
||||
Jann Horn
|
||||
Clarify items vs nodes
|
||||
The manpage claimed that tsearch() returns a pointer to a data
|
||||
item. This is incorrect; tsearch() returns a pointer to the
|
||||
corresponding tree node, which can also be interpreted as a
|
||||
pointer to a pointer to the data item.
|
||||
|
||||
Since this API is quite unintuitive, also add a clarifying
|
||||
sentence.
|
||||
Jann Horn
|
||||
tdelete() can return dangling pointers
|
||||
POSIX says that deleting the root node must cause tdelete() to
|
||||
return some unspecified non-NULL pointer. Glibc implements it by
|
||||
returning a dangling pointer to the (freed) root node.
|
||||
Therefore, explicitly note that tdelete() may return bad pointers
|
||||
that must not be accessed.
|
||||
|
||||
elf.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add patchelf(1)
|
||||
|
||||
filesystems.5
|
||||
Michael Kerrisk
|
||||
Add an entry for tmpfs(5)
|
||||
|
||||
group.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add vigr(8)
|
||||
|
||||
passwd.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add vipw(8)
|
||||
|
||||
sysfs.5
|
||||
Michael Kerrisk
|
||||
Add brief note on /sys/fs/smackfs
|
||||
|
||||
tmpfs.5
|
||||
Mike Frysinger
|
||||
Document current mount options
|
||||
Some of this content is moved from the mount(8) man page.
|
||||
Style was based on proc(5) sections.
|
||||
Michael Kerrisk
|
||||
Remove reference to mount(8) for discussion of mount options
|
||||
The mount options are now described in this page.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add Documentation/vm/transhuge.txt
|
||||
Michael Kerrisk
|
||||
Reformat 'huge' and 'mpol' mount option values as lists
|
||||
Michael Kerrisk
|
||||
Describe 'mpol' mount options
|
||||
Based on text from Documentation/filesystems/tmpfs.txt.
|
||||
Michael Kerrisk
|
||||
Document 'huge' mount options
|
||||
Based on text from Documentation/vm/transhuge.txt.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add set_mempolicy(2)
|
||||
Michael Kerrisk
|
||||
Document mpol=local mount option
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk
|
||||
Remove redundant mention of PTRACE_SECCOMP_GET_FILTER
|
||||
|
||||
cgroups.7
|
||||
Michael Kerrisk
|
||||
cgroup.events transitions generate POLLERR as well as POLLPRI
|
||||
|
||||
mount_namespaces.7
|
||||
Michael Kerrisk
|
||||
Note another case where shared "peer groups" are formed
|
||||
|
||||
namespaces.7
|
||||
Michael Kerrisk [Konstantin Khlebnikov]
|
||||
Mention that device ID should also be checked when comparing NS symlinks
|
||||
When comparing two namespaces symlinks to see if they refer to
|
||||
the same namespace, both the inode number and the device ID
|
||||
should be compared. This point was already made clear in
|
||||
ioctl_ns(2), but was missing from this page.
|
||||
Michael Kerrisk
|
||||
Note an idiosyncrasy of /proc/[pid]/ns/pid_for_children
|
||||
/proc/[pid]/ns/pid_for_children has a value only after first
|
||||
child is created in PID namespace. Verified by experiment.
|
||||
|
||||
network_namespaces.7
|
||||
Michael Kerrisk
|
||||
Network namespaces isolate the UNIX domain abstract socket namespace
|
||||
Michael Kerrisk
|
||||
Add cross reference to unix(7)
|
||||
For further information on UNIX domain abstract sockets.
|
||||
|
||||
posixoptions.7
|
||||
Carlos O'Donell
|
||||
Expand XSI Options groups
|
||||
We define in detail the X/Open System Interfaces i.e. _XOPEN_UNIX
|
||||
and all of the X/Open System Interfaces (XSI) Options Groups.
|
||||
|
||||
The XSI options groups include encryption, realtime, advanced
|
||||
realtime, realtime threads, advanced realtime threads, tracing,
|
||||
streams, and legacy interfaces.
|
||||
Michael Kerrisk
|
||||
Use a more consistent, less cluttered layout for option lists
|
||||
Michael Kerrisk
|
||||
Make function lists more consistent and less cluttered
|
||||
Use more consistent layout for lists of functions, and
|
||||
remove punctuation from the lists to make them less cluttered.
|
||||
|
||||
socket.7
|
||||
Michael Kerrisk [Tomi Salminen]
|
||||
Fix error in SO_INCOMING_CPU code snippet
|
||||
The last argument is passed by value, not reference.
|
||||
|
||||
time.7
|
||||
Michael Kerrisk [Enrique Garcia]
|
||||
Mention clock_gettime()/clock_settime() rather than [gs]ettimeofday()
|
||||
gettimeofday() is declared obsolete by POSIX. Mention instead
|
||||
the modern APIs for working with the realtime clock.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=199049
|
||||
|
||||
unix.7
|
||||
Michael Kerrisk [Rusty Russell]
|
||||
ERRORS: add EBADF for sending closed file descriptor with SCM_RIGHTS
|
||||
|
||||
vdso.7
|
||||
Michael Kerrisk
|
||||
VDSO symbols (system calls) are not visible to seccomp(2) filters
|
||||
|
||||
xattr.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add selinux(8)
|
||||
|
||||
ld.so.8
|
||||
Mike Frysinger
|
||||
Make lack of separator escaping explicit
|
||||
Make it clear that the delimiters in LD_PRELOAD, LD_LIBRARY_PATH,
|
||||
and LD_AUDIT cannot be escaped so people don't try various methods
|
||||
(such as \:) to workaround it.
|
||||
Michael Kerrisk
|
||||
Remove unneeded mention of PATH in discussion of LD_LIBRARY_PATH
|
||||
This brief sentence doesn't add value to the text.
|
||||
|
|
381
Changes.old
381
Changes.old
|
@ -47504,3 +47504,384 @@ sched.7
|
|||
user_namespaces.7
|
||||
Michael Kerrisk
|
||||
Mention NS_GET_OWNER_UID ioctl() operation
|
||||
|
||||
|
||||
==================== Changes in man-pages-4.16 ====================
|
||||
|
||||
Released: 2018-04-30, 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:
|
||||
|
||||
Adam Borowski <kilobyte@angband.pl>
|
||||
Andy Owen <andrew.owen@dolby.com>
|
||||
Carlos O'Donell <carlos@redhat.com>
|
||||
Carsten Grohmann <carstengrohmann@gmx.de>
|
||||
Elvira Khabirova <lineprinter@altlinux.org>
|
||||
Enrique Garcia <cquike@arcor.de>
|
||||
Frederic Brault <fbrault@xyalis.com>
|
||||
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
||||
Howard Johnson <hwj@BridgeportContractor.com>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Jan Kara <jack@suse.cz>
|
||||
Jann Horn <jannh@google.com>
|
||||
John Hubbard <jhubbard@nvidia.com>
|
||||
Jürg Billeter <j@bitron.ch>
|
||||
Konstantin Grinemayer <cdlscpmv@gmail.com>
|
||||
Konstantin Khlebnikov <khlebnikov@yandex-team.ru>
|
||||
Martin Mares <mj@ucw.cz>
|
||||
Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
|
||||
Mattias Andrée <maandree@kth.se>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Michal Hocko <mhocko@suse.com>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
Nikos Mavrogiannopoulos <nmavrogi@redhat.com>
|
||||
Robin Kuzmin <kuzmin.robin@gmail.com>
|
||||
Ross Zwisler <ross.zwisler@linux.intel.com>
|
||||
Rusty Russell <rusty@rustcorp.com.au>
|
||||
Serge E. Hallyn <serge@hallyn.com>
|
||||
Song Liu <songliubraving@fb.com>
|
||||
Tomi Salminen <tsalminen@forcepoint.com>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
membarrier.2
|
||||
Mathieu Desnoyers [Michael Kerrisk]
|
||||
Document new membarrier commands introduced in Linux 4.16
|
||||
Document the following membarrier commands introduced in
|
||||
Linux 4.16:
|
||||
|
||||
MEMBARRIER_CMD_GLOBAL_EXPEDITED
|
||||
(the old enum label MEMBARRIER_CMD_SHARED is now an
|
||||
alias to preserve header backward compatibility)
|
||||
MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED
|
||||
MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE
|
||||
MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE
|
||||
|
||||
mmap.2
|
||||
Jan Kara [Ross Zwisler, Michael Kerrisk]
|
||||
Add description of MAP_SHARED_VALIDATE and MAP_SYNC
|
||||
Michal Hocko [John Hubbard, Michael Kerrisk, Jann Horn]
|
||||
Document new MAP_FIXED_NOREPLACE flag
|
||||
4.17+ kernels offer a new MAP_FIXED_NOREPLACE flag which allows
|
||||
the caller to atomically probe for a given address range.
|
||||
|
||||
readv.2
|
||||
io_submit.2
|
||||
Jürg Billeter
|
||||
Document RWF_APPEND added in Linux 4.16
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk
|
||||
Describe file capability versioning
|
||||
Michael Kerrisk [Serge E. Hallyn]
|
||||
Document namespaced-file capabilities
|
||||
[There's still more work to be done on this new text]
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
bpf.2
|
||||
Michael Kerrisk
|
||||
Update list of architectures that support JITed eBPF
|
||||
And note kernel version numbers where support is added.
|
||||
Michael Kerrisk
|
||||
Kernel 4.15 added CONFIG_BPF_JIT_ALWAYS_ON
|
||||
This causes the JIT compiler to be always on and
|
||||
forces bpf_jit_enable to 1.
|
||||
|
||||
execve.2
|
||||
Michael Kerrisk
|
||||
Note that describing execve as "executing a new process" is misleading
|
||||
This misdescription is so common that it's worth calling it out
|
||||
explicitly.
|
||||
Michael Kerrisk
|
||||
More explicitly describe effect of execve() in the opening paragraph
|
||||
|
||||
fallocate.2
|
||||
Michael Kerrisk
|
||||
Since Linux 4.16, Btrfs supports FALLOC_FL_ZERO_RANGE
|
||||
|
||||
getrlimit.2
|
||||
Michael Kerrisk
|
||||
CAP_SYS_RESOURCE capability is required in *initial user namespace*
|
||||
|
||||
io_submit.2
|
||||
Michael Kerrisk
|
||||
Add kernel version numbers for various 'aio_rw_flags' flags
|
||||
Michael Kerrisk
|
||||
Place 'aio_rw_flags' in alphabetical order
|
||||
|
||||
mmap.2
|
||||
Jann Horn
|
||||
MAP_FIXED is okay if the address range has been reserved
|
||||
Clarify that MAP_FIXED is appropriate if the specified address
|
||||
range has been reserved using an existing mapping, but shouldn't
|
||||
be used otherwise.
|
||||
Michael Kerrisk
|
||||
Move the text on MAP_FIXED to NOTES
|
||||
This text has become rather long, making it it somewhat
|
||||
unwieldy in the discussion of the mmap() flags. Therefore,
|
||||
move it to NOTES, with a pointer in DESCRIPTION referring
|
||||
the reader to NOTES.
|
||||
Michael Kerrisk [Heinrich Schuchardt]
|
||||
Clarify that when addr==NULL, address chosen by kernel is page-aligned
|
||||
Michael Kerrisk
|
||||
Add a little historical detail on the obsolete MAP_DENYWRITE
|
||||
|
||||
mount.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EBUSY for the case of trying to stack same mount twice
|
||||
Michael Kerrisk
|
||||
Remove a couple of obsolete EBUSY errors
|
||||
As far as I can tell, these EBUSY errors disappeared
|
||||
with the addition of stackable mounts in Linux 2.4.
|
||||
|
||||
msgget.2
|
||||
semget.2
|
||||
shmget.2
|
||||
Michael Kerrisk
|
||||
The purpose of "flags" == 0 is to obtain ID of an existing IPC object
|
||||
This was implied in these pages, but the meaning of "flags" == 0
|
||||
could be more explicit, as indicated by questions such as
|
||||
https://stackoverflow.com/questions/49833569/flag-value-of-semget-function
|
||||
|
||||
open.2
|
||||
Jann Horn
|
||||
Document more -ETXTBSY conditions
|
||||
Jakub Wilk
|
||||
Add missing argument for snprintf() in example code
|
||||
|
||||
perf_event_open.2
|
||||
Song Liu
|
||||
Add type kprobe and uprobe
|
||||
Two new types kprobe and uprobe are being added to
|
||||
perf_event_open(), which allow creating kprobe or
|
||||
uprobe with perf_event_open. This patch adds
|
||||
information about these types.
|
||||
|
||||
ptrace.2
|
||||
Jann Horn
|
||||
Copy retval info for SECCOMP_GET_FILTER to right section
|
||||
The "RETURN VALUE" section made a claim that was incorrect for
|
||||
PTRACE_SECCOMP_GET_FILTER. Explicitly describe the behavior of
|
||||
PTRACE_SECCOMP_GET_FILTER in the "RETURN VALUE" section (as
|
||||
usual), but leave the now duplicate description in the section
|
||||
describing PTRACE_SECCOMP_GET_FILTER, since the
|
||||
PTRACE_SECCOMP_GET_FILTER section would otherwise probably become
|
||||
harder to understand.
|
||||
|
||||
readv.2
|
||||
Michael Kerrisk
|
||||
Remove redundant sentence
|
||||
|
||||
seccomp.2
|
||||
Michael Kerrisk
|
||||
Note that execve() may change syscall numbers during life of process
|
||||
On a multiarch/multi-ABI platform such as modern x86, each
|
||||
architecture/ABI (x86-64, x32, i386)has its own syscall numbers,
|
||||
which means a seccomp() filter may see different syscall numbers
|
||||
over the life of the process if that process uses execve() to
|
||||
execute programs that has a different architectures/ABIs.
|
||||
Michael Kerrisk
|
||||
Note which architectures support seccomp BPF
|
||||
Michael Kerrisk
|
||||
In EXAMPLE, clearly note that x32 syscalls are >= X32_SYSCALL_BIT
|
||||
|
||||
shutdown.2
|
||||
Carsten Grohmann
|
||||
SEE ALSO: add close(2)
|
||||
|
||||
syscall.2
|
||||
Adam Borowski
|
||||
Add riscv
|
||||
|
||||
wait.2
|
||||
Michael Kerrisk [Robin Kuzmin]
|
||||
wait() and waitpid() block the calling thread (not process)
|
||||
|
||||
wait4.2
|
||||
Michael Kerrisk [Martin Mares]
|
||||
Soften the warning against the use of wait3()/wait4()
|
||||
These functions are nonstandard, but there is no replacement.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=199215
|
||||
|
||||
crypt.3
|
||||
encrypt.3
|
||||
Carlos O'Donell [Michael Kerrisk]
|
||||
Add notes about _XOPEN_CRYPT
|
||||
The distribution may choose not to support _XOPEN_CRYPT in the
|
||||
case that the distribution has transitioned from glibc crypt to
|
||||
libxcrypt.
|
||||
|
||||
fseek.3
|
||||
Michael Kerrisk [Andy Owen]
|
||||
ERRORS: EBADF should be ESPIPE
|
||||
Michael Kerrisk
|
||||
Improve EPIPE error text
|
||||
|
||||
getcwd.3
|
||||
Carlos O'Donell
|
||||
Mention that "(unreachable)" is no longer returned for glibc >= 2.27.
|
||||
|
||||
makedev.3
|
||||
Michael Kerrisk
|
||||
Since glibc 2.28, <sys/types.h> no longer defines these macros
|
||||
|
||||
pthread_create.3
|
||||
Frederic Brault
|
||||
Note default thread stack size for several architectures
|
||||
|
||||
tsearch.3
|
||||
Jann Horn
|
||||
Clarify items vs nodes
|
||||
The manpage claimed that tsearch() returns a pointer to a data
|
||||
item. This is incorrect; tsearch() returns a pointer to the
|
||||
corresponding tree node, which can also be interpreted as a
|
||||
pointer to a pointer to the data item.
|
||||
|
||||
Since this API is quite unintuitive, also add a clarifying
|
||||
sentence.
|
||||
Jann Horn
|
||||
tdelete() can return dangling pointers
|
||||
POSIX says that deleting the root node must cause tdelete() to
|
||||
return some unspecified non-NULL pointer. Glibc implements it by
|
||||
returning a dangling pointer to the (freed) root node.
|
||||
Therefore, explicitly note that tdelete() may return bad pointers
|
||||
that must not be accessed.
|
||||
|
||||
elf.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add patchelf(1)
|
||||
|
||||
filesystems.5
|
||||
Michael Kerrisk
|
||||
Add an entry for tmpfs(5)
|
||||
|
||||
group.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add vigr(8)
|
||||
|
||||
passwd.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add vipw(8)
|
||||
|
||||
sysfs.5
|
||||
Michael Kerrisk
|
||||
Add brief note on /sys/fs/smackfs
|
||||
|
||||
tmpfs.5
|
||||
Mike Frysinger
|
||||
Document current mount options
|
||||
Some of this content is moved from the mount(8) man page.
|
||||
Style was based on proc(5) sections.
|
||||
Michael Kerrisk
|
||||
Remove reference to mount(8) for discussion of mount options
|
||||
The mount options are now described in this page.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add Documentation/vm/transhuge.txt
|
||||
Michael Kerrisk
|
||||
Reformat 'huge' and 'mpol' mount option values as lists
|
||||
Michael Kerrisk
|
||||
Describe 'mpol' mount options
|
||||
Based on text from Documentation/filesystems/tmpfs.txt.
|
||||
Michael Kerrisk
|
||||
Document 'huge' mount options
|
||||
Based on text from Documentation/vm/transhuge.txt.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add set_mempolicy(2)
|
||||
Michael Kerrisk
|
||||
Document mpol=local mount option
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk
|
||||
Remove redundant mention of PTRACE_SECCOMP_GET_FILTER
|
||||
|
||||
cgroups.7
|
||||
Michael Kerrisk
|
||||
cgroup.events transitions generate POLLERR as well as POLLPRI
|
||||
|
||||
mount_namespaces.7
|
||||
Michael Kerrisk
|
||||
Note another case where shared "peer groups" are formed
|
||||
|
||||
namespaces.7
|
||||
Michael Kerrisk [Konstantin Khlebnikov]
|
||||
Mention that device ID should also be checked when comparing NS symlinks
|
||||
When comparing two namespaces symlinks to see if they refer to
|
||||
the same namespace, both the inode number and the device ID
|
||||
should be compared. This point was already made clear in
|
||||
ioctl_ns(2), but was missing from this page.
|
||||
Michael Kerrisk
|
||||
Note an idiosyncrasy of /proc/[pid]/ns/pid_for_children
|
||||
/proc/[pid]/ns/pid_for_children has a value only after first
|
||||
child is created in PID namespace. Verified by experiment.
|
||||
|
||||
network_namespaces.7
|
||||
Michael Kerrisk
|
||||
Network namespaces isolate the UNIX domain abstract socket namespace
|
||||
Michael Kerrisk
|
||||
Add cross reference to unix(7)
|
||||
For further information on UNIX domain abstract sockets.
|
||||
|
||||
posixoptions.7
|
||||
Carlos O'Donell
|
||||
Expand XSI Options groups
|
||||
We define in detail the X/Open System Interfaces i.e. _XOPEN_UNIX
|
||||
and all of the X/Open System Interfaces (XSI) Options Groups.
|
||||
|
||||
The XSI options groups include encryption, realtime, advanced
|
||||
realtime, realtime threads, advanced realtime threads, tracing,
|
||||
streams, and legacy interfaces.
|
||||
Michael Kerrisk
|
||||
Use a more consistent, less cluttered layout for option lists
|
||||
Michael Kerrisk
|
||||
Make function lists more consistent and less cluttered
|
||||
Use more consistent layout for lists of functions, and
|
||||
remove punctuation from the lists to make them less cluttered.
|
||||
|
||||
socket.7
|
||||
Michael Kerrisk [Tomi Salminen]
|
||||
Fix error in SO_INCOMING_CPU code snippet
|
||||
The last argument is passed by value, not reference.
|
||||
|
||||
time.7
|
||||
Michael Kerrisk [Enrique Garcia]
|
||||
Mention clock_gettime()/clock_settime() rather than [gs]ettimeofday()
|
||||
gettimeofday() is declared obsolete by POSIX. Mention instead
|
||||
the modern APIs for working with the realtime clock.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=199049
|
||||
|
||||
unix.7
|
||||
Michael Kerrisk [Rusty Russell]
|
||||
ERRORS: add EBADF for sending closed file descriptor with SCM_RIGHTS
|
||||
|
||||
vdso.7
|
||||
Michael Kerrisk
|
||||
VDSO symbols (system calls) are not visible to seccomp(2) filters
|
||||
|
||||
xattr.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add selinux(8)
|
||||
|
||||
ld.so.8
|
||||
Mike Frysinger
|
||||
Make lack of separator escaping explicit
|
||||
Make it clear that the delimiters in LD_PRELOAD, LD_LIBRARY_PATH,
|
||||
and LD_AUDIT cannot be escaped so people don't try various methods
|
||||
(such as \:) to workaround it.
|
||||
Michael Kerrisk
|
||||
Remove unneeded mention of PATH in discussion of LD_LIBRARY_PATH
|
||||
This brief sentence doesn't add value to the text.
|
||||
|
|
Loading…
Reference in New Issue