X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=Changes;h=1470b1187fd9b30220e9be0b5b9788134ddd6ce9;hb=b83e27e8a809373664f91a773aac868fc84fea79;hp=7d2f4421779f555a27911a58a64f99c317a89c2d;hpb=135b9dcde0badf5a0283a4c55b1116238a2c57ae;p=thirdparty%2Fman-pages.git diff --git a/Changes b/Changes index 7d2f442177..1470b1187f 100644 --- a/Changes +++ b/Changes @@ -1,4 +1,4 @@ -==================== Changes in man-pages-4.16 ==================== +==================== Changes in man-pages-5.01 ==================== Released: ????-??-??, Munich @@ -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 -Andy Owen -Carlos O'Donell -Carsten Grohmann -Elvira Khabirova -Enrique Garcia -Frederic Brault -Heinrich Schuchardt -Howard Johnson -Jakub Wilk -Jan Kara -Jann Horn -John Hubbard -Jürg Billeter -Konstantin Grinemayer -Konstantin Khlebnikov -Martin Mares -Mathieu Desnoyers -Mattias Andrée -Michael Kerrisk -Michal Hocko -Mike Frysinger -Nikos Mavrogiannopoulos -Robin Kuzmin -Ross Zwisler -Rusty Russell -Serge E. Hallyn -Song Liu -Tomi Salminen 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, 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.