diff --git a/Changes b/Changes index bfcaa9001..812f01db9 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.05 ==================== +==================== Changes in man-pages-5.06 ==================== -Released: 2020-02-09, Munich +Released: ????-??-??, Munich Contributors @@ -10,252 +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 -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 -fcntl.2 - Joel Fernandes [Michael Kerrisk] - Update manpage with new memfd F_SEAL_FUTURE_WRITE seal +New and changed links +--------------------- -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 +Global changes +-------------- 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 diff --git a/Changes.old b/Changes.old index 5728a8120..c870270ee 100644 --- a/Changes.old +++ b/Changes.old @@ -50305,3 +50305,266 @@ netdevice.7 uts_namespaces.7 Michael Kerrisk Add a little more detail on scope of UTS namespaces + + +==================== 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