-==================== Changes in man-pages-4.16 ====================
+==================== Changes in man-pages-5.02 ====================
Released: ????-??-??, Munich
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
-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.
+New and changed links
+---------------------
-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 idiosyncracy 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.