diff --git a/Changes b/Changes index 75d1158a4..9ba4e9b3e 100644 --- a/Changes +++ b/Changes @@ -10,26 +10,252 @@ 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! -New and rewritten pages ------------------------ - - 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 -New and changed links ---------------------- +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 -Global changes --------------- +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