Gidday,
The Linux man-pages maintainer proudly announces:
man-pages-5.08 - man pages for Linux
This release resulted from patches, bug reports, reviews, and
comments from more than 30 people, with over 190 commits making
changes to more than 340 pages.
Tarball download:
http://www.kernel.org/doc/man-pages/download.html
Git repository:
https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
http://man7.org/linux/man-pages/changelog.html#release_5.08
A short summary of the release is blogged at:
https://linux-man-pages.blogspot.com/2020/08/man-pages-508-is-released.html
The current version of the pages is browsable at:
http://man7.org/linux/man-pages/
You are receiving this message either because:
a) You contributed to the content of this release.
b) You are subscribed to linux-man@xxxxxxxxxxxxxxx or
libc-alpha@xxxxxxxxxxxxxx.
c) I have information (possibly inaccurate) that you are the maintainer
of a translation of the manual pages, or are the maintainer of the
manual pages set in a particular distribution, or have expressed
interest in helping with man-pages maintenance, or have otherwise
expressed interest in being notified about man-pages releases.
If you don't want to receive such messages from me, or you know of
some other translator or maintainer who may want to receive such
notifications, send me a message.
Cheers,
Michael
==================== Changes in man-pages-5.08 ====================
Released: 2020-08-13, 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:
Alejandro Colomar <colomar.6.4.3@xxxxxxxxx>
Aleksa Sarai <cyphar@xxxxxxxxxx>
Alyssa Ross <hi@xxxxxxxxx>
Andrew Price <anprice@xxxxxxxxxx>
Andy Lutomirski <luto@xxxxxxxxxx>
Arkadiusz Drabczyk <arkadiusz@xxxxxxxxxxxx>
Benjamin Peterson <benjamin@xxxxxxxxxx>
Bjarni Ingi Gislason <bjarniig@xxxxxxxxx>
Bruno Haible <bruno@xxxxxxxxx>
Carlos O'Donell <carlos@xxxxxxxxxx>
Catalin Marinas <catalin.marinas@xxxxxxx>
Dan Kenigsberg <danken@xxxxxxxxxx>
Dave Martin <Dave.Martin@xxxxxxx>
Diogo Miguel Ferreira Rodrigues <dmfrodrigues2000@xxxxxxxxx>
Florian Weimer <fweimer@xxxxxxxxxx>
G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Geoff Clare <gwc@xxxxxxxxxxxxx>
Helge Kreutzmann <debian@xxxxxxxxxxxxx>
Jakub Wilk <jwilk@xxxxxxxxx>
Jeff Layton <jlayton@xxxxxxxxxx>
John Scott <jscott@xxxxxxxxxx>
Kumar Kartikeya Dwivedi <memxor@xxxxxxxxx>
Michael Kerrisk <mtk.manpages@xxxxxxxxx>
Mike Frysinger <vapier@xxxxxxxxxx>
Oleksandr Kravchuk <open.source@xxxxxxxxxxxxxxxxxxxxxx>
Philip Adams <mail@xxxxxxxxxxxxxxx>
Rich Felker <dalias@xxxxxxxx>
Saikiran Madugula <hummerbliss@xxxxxxxxx>
Stephen Hemminger <stephen@xxxxxxxxxxxxxxxxxx>
Sven Hoexter <sven@xxxxxxxxxxxxx>
Thomas Bartelsmeier <t.bartelsmeier@xxxxxxxxx>
Thomas Piekarski <t.piekarski@xxxxxxxxxxxxxx>
victorm007@xxxxxxxxx
Apologies if I missed anyone!
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.
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@xxxxxxxxx]
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.
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
