blob: bfcaa900182462fb910a16aaee5eec4be3cd6c4b [file] [log] [blame]
==================== 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