Gidday,
The Linux man-pages maintainer proudly announces:
man-pages-4.16 - man pages for Linux
This release resulted from patches, bug reports, reviews, and comments
from 29 contributors. Around 160 commits changed 62 pages.
Tarball download:
http://www.kernel.org/doc/man-pages/download.html
Git repository:
https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
http://man7.org/linux/man-pages/changelog.html#release_4.16
A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2018/04/man-pages-416-is-released.html
The current version of the pages is browsable at:
http://man7.org/linux/man-pages/
A selection of changes in this release that may be of interest
to readers of LKML is shown below.
Cheers,
Michael
==================== Changes in man-pages-4.16 ====================
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.
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*
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.
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.
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.
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
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.
cgroups.7
Michael Kerrisk
cgroup.events transitions generate POLLERR as well as POLLPRI
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
vdso.7
Michael Kerrisk
VDSO symbols (system calls) are not visible to seccomp(2) filters
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/