Gidday, The Linux man-pages maintainer proudly announces:
man-pages-5.07 - man pages for Linux This release resulted from patches, bug reports, reviews, and comments from over 80 people, with over 380 commits making changes to more than 380 pages. One new page was added in this release, and one page was removed. 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_5.07 A short summary of the release is blogged at: https://linux-man-pages.blogspot.com/2020/06/man-pages-507-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-5.07 ==================== New and rewritten pages ----------------------- ioctl_fslabel.2 Eric Sandeen New page documenting filesystem get/set label ioctl(2) operations Removed pages ------------- ioctl_list.2 Michael Kerrisk [Heinrich Schuchardt, Eugene Syromyatnikov] This page was first added more than 20 years ago. Since that time it has seen hardly any update, and is by now very much out of date, as reported by Heinrich Schuchardt and confirmed by Eugene Syromyatnikov. As Heinrich says: Man-pages like netdevices.7 or ioctl_fat.2 are what is needed to help a user who does not want to read through the kernel code. If ioctl_list.2 has not been reasonably maintained since Linux 1.3.27 and hence is not a reliable source of information, shouldn't it be dropped? My answer is, yes (but let's move a little info into ioctl(2)). Newly documented interfaces in existing pages --------------------------------------------- adjtimex.2 Arnd Bergmann [Richard Cochran, Michael Kerrisk] Document clock_adjtime(2) clock_getres.2 Richard Cochran [Michael Kerrisk] Explain dynamic clocks clone.2 Christian Brauner, Michael Kerrisk Document the clone3() CLONE_INTO_CGROUP flag mremap.2 Brian Geffon, Michael Kerrisk [Lokesh Gidra] Document MREMAP_DONTUNMAP open.2 Joseph C. Sible [Michael Kerrisk] Document fs.protected_fifos and fs.protected_regular prctl.2 Dave Martin Add PR_SPEC_INDIRECT_BRANCH for SPECULATION_CTRL prctls Dave Martin Add PR_SPEC_DISABLE_NOEXEC for SPECULATION_CTRL prctls Dave Martin Add PR_PAC_RESET_KEYS (arm64) ptrace.2 Joseph C. Sible Document PTRACE_SET_SYSCALL proc.5 Michael Kerrisk Document /proc/sys/fs/protected_regular Michael Kerrisk Document /proc/sys/fs/protected_fifos Michael Kerrisk Document /proc/sys/fs/aio-max-nr and /proc/sys/fs/aio-nr Changes to individual pages --------------------------- bpf.2 Peter Wu Update enum bpf_map_type and enum bpf_prog_type Richard Palethorpe Change note on unprivileged access The kernel now allows calls to bpf() without CAP_SYS_ADMIN under some circumstances. close.2 Michael Kerrisk [Lukas Czerner, Peter Schiffer, Thierry Lelegard] Note behavior when close() happens in a parallel thread If one thread is blocked in an I/O system call on a file descriptor that is closed in another thread, then the blocking system call does not return immediately, but rather when the I/O operation completes. This surprises some people, but is longstanding behavior. execve.2 Michael Kerrisk [Eric Hopper] Changes to the "dumpable" flag may change ownership of /proc/PID files Nikola Forró Clarify signal sent to the process on late failure fanotify_init.2 Amir Goldstein [Jan Kara, Matthew Bobrowski] Clarification about FAN_EVENT_ON_CHILD and new events Amir Goldstein [Jan Kara, Matthew Bobrowski] Clarification about FAN_MARK_MOUNT and FAN_REPORT_FID mbind.2 Li Xinhai [Michael Kerrisk] Remove note about MPOL_MF_STRICT been ignored move_pages.2 Yang Shi [Michal Hocko] Returning positive value is a new error case prctl.2 Dave Martin Clarify that prctl can apply to threads The current synopsis for prctl(2) misleadingly claims that prctl operates on a process. Rather, some (in fact, most) prctls operate Dave Martin [Dave Hansen] Document removal of Intel MPX prctls Dave Martin [Michael Kerrisk] Add health warning syscall.2 Dave Martin [Will Deacon] arm64: Fix syscall number register size Dave Martin [Russell King] arm: Use real register names for arm/OABI core.5 Michael Kerrisk [Jonny Grant] Mention 'sysctl -w' as a way of changing core_pattern setting Michael Kerrisk [Jonny Grant] Explain that core_pattern %e is process/thread 'comm' value The 'comm' value is typically the same as the (possibly truncated) executable name, but may be something different. proc.5 Michael Kerrisk Note kernel version for /proc/PID/smaps VmFlags "wf" flag Michael Kerrisk Add "um" and "uw" to VmFlags in /proc/[pid]/smaps Michael Kerrisk Add "mp" to VmFlags in /proc/[pid]/smaps Michael Kerrisk Note kernel version that removed /proc/PID/smaps VmFlags "nl" flag Ian Rogers Add "wf" to VmFlags in /proc/[pid]/smaps Michael Kerrisk Note kernel version for /proc/PID/smaps VmFlags "dd" flag Michael Kerrisk Add "sf" to VmFlags in /proc/[pid]/smaps Michael Kerrisk [Kirill A. Shutemov] Remove "mp" under VmFlags in /proc/[pid]/smaps Michael Kerrisk [Eric Hopper] Alert the reader that UID/GID changes can reset the "dumpable" attribute Keno Fischer Fix an outdated note about map_files The restriction to CAP_SYS_ADMIN was removed from map_files in 2015. Michael Kerrisk [Helge Kreutzmann] Better explanation of some /proc/ide fields Michael Kerrisk TASK_COMM_LEN limit includes the terminating '\0' Clarify this detail in the discussion of /proc/[pid]/comm. Michael Kerrisk Add a detail to /proc/[pid]/comm Note the connection to the "%e" specifier in /proc/sys/kernel/core_pattern. bpf-helpers.7 Michael Kerrisk Resync against kernel 5.7 cgroups.7 Marcus Gelderie Mention cgroup.sane_behavior file The cgroup.sane_behavior file returns the hard-coded value "0" and is kept for legacy purposes. Mention this in the man-page. credentials.7 Michael Kerrisk Alert reader that UID/GID changes can affect process capabilities Michael Kerrisk Changes to process UIDs/GIDs can effect the "dumpable" attribute fanotify.7 fanotify_mark.2 Amir Goldstein [Matthew Bobrowski] Clarify FAN_ONDIR in output mask FAN_ONDIR was an input only flag before introducing FAN_REPORT_FID. Since the introduction of FAN_REPORT_FID, it can also be in output mask. namespaces.7 Michael Kerrisk Document /proc/sys/user/max_time_namespaces pid_namespaces.7 Michael Kerrisk Note that /proc/sys/kernel/ns_last_pid is virtualized per PID NS Michael Kerrisk Correct capability requirements for write to /proc/sys/kernel/ns_last_pid CAP_SYS_ADMIN is needed in the user NS that owns the PID NS. symlink.7 Michael Kerrisk Describe differences in the treatment of symlinks in the dirname Describe differences in the treatment of symlinks in the dirname part of pathname. tcp.7 Michael Kerrisk [vrafa...@msn.com] Update info on tcp_syn_retries default value See https://bugzilla.kernel.org/show_bug.cgi?id=202885. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/