| ==================== 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 <kilobyte@angband.pl> |
| Adrian Reber <areber@redhat.com> |
| Andy Lutomirski <luto@kernel.org> |
| Antonin Décimo <antonin.decimo@gmail.com> |
| Benjamin Peterson <benjamin@python.org> |
| Brennan Vincent <brennan@materialize.io> |
| Christian Brauner <christian.brauner@ubuntu.com> |
| Colin Ian King <colin.king@canonical.com> |
| Cyril Hrubis <chrubis@suse.cz> |
| Daniel Colascione <dancol@google.com> |
| Denys Vlasenko <dvlasenk@redhat.com> |
| DJ Delorie <dj@redhat.com> |
| Dmitry V. Levin <ldv@altlinux.org> |
| Jakub Wilk <jwilk@jwilk.net> |
| Jashank Jeremy <jashank@rulingia.com.au> |
| Joel Fernandes <joel@joelfernandes.org> |
| John Hubbard <jhubbard@nvidia.com> |
| John Jones <jmjatlanta@gmail.com> |
| Joseph C. Sible <josephcsible@gmail.com> |
| kevin sztern <kevin.sztern@epita.fr> |
| Marko Myllynen <myllynen@redhat.com> |
| markus T Metzger <markus.t.metzger@intel.com> |
| Michael Kerrisk <mtk.manpages@gmail.com> |
| Michal Hocko <mhocko@suse.com> |
| Mike Frysinger <vapier@gentoo.org> |
| Mike Salvatore <mike.salvatore@canonical.com> |
| Mikhail Golubev <Mikhail.Golubev@opensynergy.com> |
| Nick Shipp <ns@segbrk.com> |
| Nikola Forró <nforro@redhat.com> |
| Peter Gajdos <pgajdos@suse.cz> |
| Petr Vorel <pvorel@suse.cz> |
| Ponnuvel Palaniyappan <pponnuvel@gmail.com> |
| Rich Felker <dalias@libc.org> |
| Robin Kuzmin <kuzmin.robin@gmail.com> |
| Samuel Thibault <samuel.thibault@ens-lyon.org> |
| Sam Varshavchik <mrsam@courier-mta.com> |
| Vegard Nossum <vegard.nossum@gmail.com> |
| Weitian LI <liweitianux@live.com> |
| Will <cassis@tricolore.lu> |
| Yang Xu <xuyang2018.jy@cn.fujitsu.com> |
| Yu Jian Wu <yujian.wu1@gmail.com> |
| |
| 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 |