==================== Changes in man-pages-5.05 ==================== Released: 2020-02-09, 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 Adrian Reber Andy Lutomirski Antonin Décimo Benjamin Peterson Brennan Vincent Christian Brauner Colin Ian King Cyril Hrubis Daniel Colascione Denys Vlasenko DJ Delorie Dmitry V. Levin Jakub Wilk Jashank Jeremy Joel Fernandes John Hubbard John Jones Joseph C. Sible kevin sztern Marko Myllynen markus T Metzger Michael Kerrisk Michal Hocko Mike Frysinger Mike Salvatore Mikhail Golubev Nick Shipp Nikola Forró Peter Gajdos Petr Vorel Ponnuvel Palaniyappan Rich Felker Robin Kuzmin Samuel Thibault Sam Varshavchik Vegard Nossum Weitian LI Will Yang Xu Yu Jian Wu Apologies if I missed anyone! Newly documented interfaces in existing pages --------------------------------------------- clone.2 Adrian Reber [Christian Brauner, Michael Kerrisk] Add clone3() set_tid information Michael Kerrisk Document CLONE_CLEAR_SIGHAND fcntl.2 Joel Fernandes [Michael Kerrisk] Update manpage with new memfd F_SEAL_FUTURE_WRITE seal memfd_create.2 Joel Fernandes Update manpage with new memfd F_SEAL_FUTURE_WRITE seal loop.4 Yang Xu Document LOOP_SET_BLOCK_SIZE Yang Xu Document LOOP_SET_DIRECT_IO proc.5 Michael Kerrisk Document /proc/sys/vm/unprivileged_userfaultfd Changes to individual pages --------------------------- capget.2 Michael Kerrisk [Yang Xu] Add missing details in EPERM error for setting inheritable capabilities clone.2 Michael Kerrisk Note that CLONE_THREAD causes similar behavior to CLONE_PARENT The introductory paragraphs note that "the calling process" is normally synonymous with the "the parent process", except in the case of CLONE_PARENT. The same is also true of CLONE_THREAD. Christian Brauner [Michael Kerrisk] Mention that CLONE_PARENT is off-limits for inits Michael Kerrisk [Colin Ian King] Add old EINVAL error for AArch64 Michael Kerrisk ERRORS: add EINVAL for use of CLONE_PARENT by an init process futex.2 Ponnuvel Palaniyappan Fix a bug in the example listen.2 Michael Kerrisk [Peter Gajdos] The 'somaxconn' default value has increased to 4096 modify_ldt.2 set_thread_area.2 Andy Lutomirski [Markus T Metzger] Fix type of base_addr move_pages.2 John Hubbard [Michal Hocko] Remove ENOENT from the list of possible return values open.2 Adam Borowski No need for /proc to make an O_TMPFILE file permanent In the example snippet, we already have the fd, thus there's no need to refer to the file by name. And, /proc/ might be not mounted or not accessible. Michael Kerrisk [Joseph C. Sible] In O_TMPFILE example, describe alternative linkat() call This was already shown in an earlier version of the page, but Adam Borowski's patch replaced it with an alternative. Probably, it is better to show both possibilities. perf_event_open.2 Daniel Colascione Mention EINTR for perf_event_open ptrace.2 Denys Vlasenko PTRACE_EVENT_STOP does not always report SIGTRAP quotactl.2 Michael Kerrisk Don't show numeric values of Q_XQUOTAON XFS_QUOTA_?DQ_* flags The programmer should not need to care about the numeric values, and their inclusion is verbosity. Yang Xu [Michael Kerrisk] Add EINVAL error of Q_XQUOTARM operation stime.2 Michael Kerrisk Note that stime() is deprecated syscall.2 Petr Vorel [Cyril Hrubis] Update feature test macro requirements sysctl.2 Michael Kerrisk This system call was removed in Linux 5.5; adjust the page accordingly userfaultfd.2 Yang Xu [Michael Kerrisk] Add EPERM error cmsg.3 Rich Felker Clarify alignment issues and correct method of accessing CMSG_DATA() From an email by Rich Felker: It came to my attention while reviewing possible breakage with move to 64-bit time_t that some applications are dereferencing data in socket control messages (particularly SCM_TIMESTAMP*) in-place as the message type, rather than memcpy'ing it to appropriate storage. This necessarily does not work and is not supportable if the message contains data with greater alignment requirement than the header. In particular, on 32-bit archs, cmsghdr has size 12 and alignment 4, but struct timeval and timespec may have alignment requirement 8. Michael Kerrisk [Rich Felker] Modify CMSG_DATA() example to use memcpy() See previous patch to this page for rationale exit.3 Benjamin Peterson [Mike Frysinger] Use hex for the status mask ftime.3 Michael Kerrisk Note that this function is deprecated getpt.3 Samuel Thibault Remove mention of O_NOCTTY The glibc implementation of getpt has actually never been setting malloc.3 Vegard Nossum Clarify realloc() return value Petr Vorel Remove duplicate _GNU_SOURCE console_codes.4 Adam Borowski Document \e[90m to 97, 100 to 107 Adam Borowski \e[21m is now underline Since 65d9982d7e523a1a8e7c9af012da0d166f72fc56 (4.17), it follows xterm rather than common sense and consistency, being the only command 1..9 where N+20 doesn't undo what N did. As libvte 0.51.90 got changed the same way, this behaviour will probably stay. Adam Borowski Update \e[38m and \e[48m Supported since cec5b2a97a11ade56a701e83044d0a2a984c67b4 (3.16). cgroups.7 Michael Kerrisk The v2 freezer controller was added in Linux 5.2 Michael Kerrisk Split discussion of cgroups.events file and v2 release notification In preparation for adding a description of the "frozen" key. Michael Kerrisk Describe the cgroup.events "frozen" key Michael Kerrisk Improve the discussion of the advantages of v2 release notification inotify.7 Nick Shipp Merge late perror() into fprintf() in example code netlink.7 Antonin Décimo Fix alignment issue in example packet.7 kevin sztern [Michael Kerrisk] Add missing tpacket_auxdata field (tp_vlan_tpid) rtnetlink.7 Antonin Décimo ifa_index is an unsigned int tcp.7 Michael Kerrisk tcp_low_latency is ignored since Linux 4.14 unix.7 Michael Kerrisk The PID sent with SCM_CREDENTIALS must match an existing process vsock.7 Mikhail Golubev [Michael Kerrisk] Add missing structure element The structure 'struct sockaddr_vm' has additional element 'unsigned char svm_zero[]' since version v3.9-rc1. ldconfig.8 DJ Delorie Document file filter and symlink pattern expectations