mirror of https://github.com/mkerrisk/man-pages
Changes: Ready for 5.08
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk
parent
b4c38a723f
commit
6743dc4434
315
Changes
315
Changes
|
|
@ -10,26 +10,329 @@ 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:
|
||||
|
||||
Alejandro Colomar <colomar.6.4.3@gmail.com>
|
||||
Aleksa Sarai <cyphar@cyphar.com>
|
||||
Alyssa Ross <hi@alyssa.is>
|
||||
Andrew Price <anprice@redhat.com>
|
||||
Andy Lutomirski <luto@kernel.org>
|
||||
Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
|
||||
Benjamin Peterson <benjamin@python.org>
|
||||
Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
|
||||
Bruno Haible <bruno@clisp.org>
|
||||
Carlos O'Donell <carlos@redhat.com>
|
||||
Catalin Marinas <catalin.marinas@arm.com>
|
||||
Dan Kenigsberg <danken@redhat.com>
|
||||
Dave Martin <Dave.Martin@arm.com>
|
||||
Diogo Miguel Ferreira Rodrigues <dmfrodrigues2000@gmail.com>
|
||||
Florian Weimer <fweimer@redhat.com>
|
||||
G. Branden Robinson <g.branden.robinson@gmail.com>
|
||||
Geoff Clare <gwc@opengroup.org>
|
||||
Helge Kreutzmann <debian@helgefjell.de>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Jeff Layton <jlayton@kernel.org>
|
||||
John Scott <jscott@posteo.net>
|
||||
Kumar Kartikeya Dwivedi <memxor@gmail.com>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
Oleksandr Kravchuk <open.source@oleksandr-kravchuk.com>
|
||||
Philip Adams <mail@philipadams.org>
|
||||
Rich Felker <dalias@libc.org>
|
||||
Saikiran Madugula <hummerbliss@gmail.com>
|
||||
Stephen Hemminger <stephen@networkplumber.org>
|
||||
Sven Hoexter <sven@stormbind.net>
|
||||
Thomas Bartelsmeier <t.bartelsmeier@gmail.com>
|
||||
Thomas Piekarski <t.piekarski@deloquencia.de>
|
||||
victorm007@yahoo.com
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
prctl.2
|
||||
Dave Martin
|
||||
Add SVE prctls (arm64)
|
||||
Add documentation for the the PR_SVE_SET_VL and PR_SVE_GET_VL
|
||||
prctls added in Linux 4.15 for arm64.
|
||||
Dave Martin [Catalin Marinas]
|
||||
Add tagged address ABI control prctls (arm64)
|
||||
Add documentation for the the PR_SET_TAGGED_ADDR_CTRL and
|
||||
PR_GET_TAGGED_ADDR_CTRL prctls added in Linux 5.4 for arm64.
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
setns.2
|
||||
Michael Kerrisk
|
||||
Document the use of PID file descriptors with setns()
|
||||
Starting with Linux 5.8, setns() can take a PID file descriptor as
|
||||
an argument, and move the caller into or more of the namespaces of
|
||||
the thread referred to by that descriptor.
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk
|
||||
Document CAP_BPF
|
||||
Michael Kerrisk
|
||||
Add CAP_PERFMON
|
||||
|
||||
symlink.7
|
||||
Aleksa Sarai
|
||||
Document magic links more completely
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
A few pages
|
||||
Michael Kerrisk
|
||||
Use \` rather than `
|
||||
\` produces better rendering in PDF.
|
||||
|
||||
Various pages
|
||||
Michael Kerrisk [Geoff Clare]
|
||||
Use "\(ti" instead of "~"
|
||||
A naked tilde ("~") renders poorly in PDF. Instead use "\(ti",
|
||||
which renders better in a PDF, and produces the same glyph
|
||||
when rendering on a terminal.
|
||||
|
||||
Various pages
|
||||
Michael Kerrisk [Geoff Clare]
|
||||
Use "\(ha" rather than "^" in code
|
||||
This renders better in PDF.
|
||||
|
||||
Various pages
|
||||
Mike Frysinger
|
||||
Drop "coding: UTF-8" header
|
||||
This header is used inconsistently -- man pages are UTF-8 encoded
|
||||
but not setting this marker. It's only respected by the man-db
|
||||
package, and seems a bit anachronistic at this point when UTF-8
|
||||
is the standard default nowadays.
|
||||
|
||||
Various pages
|
||||
Mike Frysinger
|
||||
Trim leading blank comment line
|
||||
Very few pages do this, so trim them.
|
||||
|
||||
Various pages
|
||||
Mike Frysinger
|
||||
Use standard .\" comment style
|
||||
The \" comment produces blank lines. Use the .\" that the vast
|
||||
majority of the codebase uses instead.
|
||||
|
||||
Various pages
|
||||
Mike Frysinger [G. Branden Robinson]
|
||||
Various pages: Drop t comment header
|
||||
Historically, a comment of the following form at the top of a
|
||||
manual page was used to indicate too man(1) that the use of tbl(1)
|
||||
was required in order to process tables:
|
||||
|
||||
'\" t
|
||||
|
||||
However, at least as far back as 2001 (according to Branden),
|
||||
man-db's man(1) automatically uses tbl(1) as needed, rendering
|
||||
this comment unnecessary. And indeed many existing pages in
|
||||
man-pages that have tables don't have this comment at the top of
|
||||
the file. So, drop the comment from those files where it is
|
||||
present.
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
ioctl_tty.2
|
||||
Michael Kerrisk
|
||||
Fix a confusing wording error in description of TIOCSPTLCK
|
||||
|
||||
iopl.2
|
||||
Thomas Piekarski [victorm007@yahoo.com]
|
||||
Updating description of permissions and disabling interrupts
|
||||
Update description of permissions for port-mapped I/O set
|
||||
per-thread and not per-process. Mention that iopl() can not
|
||||
disable interrupts since Linux 5.5 anymore and is in general
|
||||
deprecated and only provided for legacy X servers.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=205317
|
||||
|
||||
keyctl.2
|
||||
Oleksandr Kravchuk
|
||||
Declare auth_key to fix a compilation error in example code
|
||||
|
||||
lseek.2
|
||||
Andrew Price
|
||||
List gfs2 support for SEEK_HOLE/SEEK_DATA
|
||||
|
||||
mount.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EINVAL for bind mount of mount namespace inode
|
||||
|
||||
open.2
|
||||
Michael Kerrisk
|
||||
Say a bit more about what happens when 'mode' is wrongly omitted
|
||||
|
||||
pidfd_open.2
|
||||
Michael Kerrisk
|
||||
Add the setns(2) use case for PID file descriptors
|
||||
Michael Kerrisk
|
||||
Close the pidfd in EXAMPLE
|
||||
Close the PID file descriptor in the example program, to hint to
|
||||
the reader that like every other kind of file descriptor, a PID FD
|
||||
should be closed.
|
||||
|
||||
prctl.2
|
||||
Michael Kerrisk
|
||||
The parent death signal is cleared on some credential changes
|
||||
See kernel/cred.c::commit_creds() in the Linux 5.6 source code.
|
||||
|
||||
seccomp.2
|
||||
Andy Lutomirski
|
||||
Improve x32 and nr truncation notes
|
||||
|
||||
send.2
|
||||
recv.2
|
||||
Alyssa Ross
|
||||
Add msg_iovlen POSIX note
|
||||
msg_iovlen is incorrectly typed (according to POSIX) in addition
|
||||
to msg_controllen, but unlike msg_controllen, this wasn't
|
||||
mentioned for msg_iovlen.
|
||||
|
||||
setns.2
|
||||
Michael Kerrisk
|
||||
EXAMPLE: use O_CLOEXEC when opening namespace file descriptor
|
||||
Michael Kerrisk
|
||||
It is possible to setns() to the caller's current PID namespace
|
||||
The page currently incorrectly says that 'fd' must refer to
|
||||
a descendant PID namespace. However, 'fd' can also refer to
|
||||
the caller's current PID namespace. Verified by experiment,
|
||||
and also comments in kernel/pid_namespace.c (Linux 5.8-rc1).
|
||||
|
||||
sync.2
|
||||
Jeff Layton
|
||||
syncfs() now returns errors if writeback fails
|
||||
A patch has been merged for v5.8 that changes how syncfs() reports
|
||||
errors. Change the sync() manpage accordingly.
|
||||
|
||||
syscalls.2
|
||||
Michael Kerrisk
|
||||
Add faccessat2(), added in Linux 5.8
|
||||
|
||||
sysctl.2
|
||||
Michael Kerrisk
|
||||
glibc removed support for sysctl() starting in version 2.32
|
||||
|
||||
atoi.3
|
||||
Arkadiusz Drabczyk
|
||||
Explain disadvantages of atoi()
|
||||
Michael Kerrisk
|
||||
Relocate BUGS section
|
||||
Michael Kerrisk
|
||||
Add NOTES section explaining 0 return value on error
|
||||
And note that this is not specified by POSIX.
|
||||
|
||||
fread.3
|
||||
Arkadiusz Drabczyk
|
||||
Add example
|
||||
Arkadiusz Drabczyk
|
||||
Explain that file position is moved after calling fread()/fwrite()
|
||||
Corresponding manpage on FreeBSD already contains that
|
||||
information.
|
||||
|
||||
getpt.3
|
||||
posix_openpt.3
|
||||
pts.4
|
||||
Michael Kerrisk
|
||||
Use the term "pseudoterminal multiplexor device" for /dev/ptmx
|
||||
Let's use some consistent terminology for this device.
|
||||
|
||||
posix_memalign.3
|
||||
Bruno Haible
|
||||
Clarify how to free the result of posix_memalign
|
||||
|
||||
pthread_rwlockattr_setkind_np.3
|
||||
Carlos O'Donell [Kumar Kartikeya Dwivedi]
|
||||
Clarify a PTHREAD_RWLOCK_PREFER_WRITER_NP detail
|
||||
|
||||
queue.3
|
||||
Alejandro Colomar
|
||||
Remove wrong code from example
|
||||
Alejandro Colomar
|
||||
Comment out text for functions not in glibc (related: 6559169cac)
|
||||
|
||||
pts.4
|
||||
Michael Kerrisk
|
||||
Remove NOTES on BSD pseudoterminals
|
||||
This information is already covered better in pty(7). No need to
|
||||
mention it again here.
|
||||
|
||||
hosts.5
|
||||
Thomas Bartelsmeier
|
||||
Clarify capability for IPv6 outside of examples
|
||||
Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279
|
||||
|
||||
proc.5
|
||||
Jakub Wilk
|
||||
Use "pwd -P" for printing cwd
|
||||
"/bin/pwd" happens to work with the GNU coreutils implementation,
|
||||
which has -P as the default, contrary to POSIX requirements.
|
||||
|
||||
Use "pwd -P" instead, which is shorter, easier to type, and should
|
||||
work everywhere.
|
||||
Arkadiusz Drabczyk
|
||||
Inform that comm in /proc/pid/{stat,status} might also be truncated
|
||||
pgrep for example searches for a process name in /proc/pid/status
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk [Helge Kreutzmann]
|
||||
Clarify that ip6-bytestring was removed in 2.25
|
||||
|
||||
capabilities.7
|
||||
Dan Kenigsberg
|
||||
Clarify that CAP_SYS_NICE relates to *lowering* the nice value
|
||||
Saikiran Madugula
|
||||
CAP_SYS_RESOURCE: add two more items for POSIX message queues
|
||||
CAP_SYS_RESOURCE also allows overriding /proc/sys/fs/mqueue/msg_max
|
||||
and /proc/sys/fs/mqueue/msgsize_max.
|
||||
Michael Kerrisk [Dan Kenigsberg]
|
||||
Clarify wording around increasing process nice value
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add getpcaps(8)
|
||||
|
||||
cgroups.7
|
||||
cpuset.7
|
||||
Sven Hoexter
|
||||
Update kernel cgroup documentation references
|
||||
cgroups-v1/v2 documentation got moved to the "admin-guide" subfolder
|
||||
and converted from .txt files to .rst
|
||||
|
||||
ip.7
|
||||
Michael Kerrisk [Stephen Hemminger]
|
||||
Remove mention of ipfw(4) which was in long obsolete ipchains project
|
||||
|
||||
man-pages.7
|
||||
Michael Kerrisk
|
||||
Add some notes on generating optimal glyphs
|
||||
Getting nice renderings of ^ ` and ~ requires special
|
||||
steps in the page source.
|
||||
|
||||
pty.7
|
||||
Michael Kerrisk
|
||||
Explicitly mention CONFIG_LEGACY_PTYS
|
||||
Explicitly mention CONFIG_LEGACY_PTYS, and note that it is disabled
|
||||
by default since Linux 2.6.30.
|
||||
Michael Kerrisk
|
||||
Relocate a paragraph to NOTES
|
||||
|
||||
standards.7
|
||||
Michael Kerrisk
|
||||
Add an entry for POSIX.1-1988
|
||||
Michael Kerrisk [Geoff Clare]
|
||||
Correct various details in the explanation of XPG/POSIX/SUS
|
||||
|
||||
ld.so.8
|
||||
Florian Weimer [Michael Kerrisk]
|
||||
List more places in which dynamic string tokens are expanded
|
||||
This happens for more than just DT_RPATH/DT_RUNPATH.
|
||||
Arkadiusz Drabczyk
|
||||
Explain that empty entry in LD_LIBRARY_PATH means cwd
|
||||
|
||||
zic.8
|
||||
Michael Kerrisk
|
||||
Sync to 2020a tzdb release
|
||||
From https://www.iana.org/time-zones, version 2020a.
|
||||
|
|
|
|||
Loading…
Reference in New Issue