Gidday,
The Linux man-pages maintainer proudly announces:
man-pages-4.01 - man pages for Linux
This release includes two new man pages and makes changes
in over 100 other pages, based on input and contributions from
nearly 50 people.
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_4.01
A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2015/07/man-pages-401-is-released.html
A selection of changes in this release that may be interesting
for readers of this list is shown below.
Cheers,
Michael
==================== Changes in man-pages-4.01 ====================
New and rewritten pages
-----------------------
bpf.2
Alexei Starovoitov, Michael Kerrisk [Daniel Borkmann]
New page documenting bpf(2)
__ppc_get_timebase.3
Tulio Magno Quites Machado Filho
New page documenting __ppc_get_timebase() and __ppc_get_timebase_freq()
Glibc 2.16 was released with a new function for the Power
architecture that can read its Time Base Register.
Glibc 2.17 adds a function to read the frequency at which the Time
Base Register of Power processors is updated.
queue.3
Michael Kerrisk [David Leppik, Doug Klima]
Reimport from latest FreeBSD page
Long ago, Doug Klima noted that many macros were not
documented in the queue(3) page. Fix by reimporting from
latest [1] FreeBSD man page.
Newly documented interfaces in existing pages
---------------------------------------------
rename.2
Michael Kerrisk [Miklos Szeredi]
Document RENAME_WHITEOUT
Heavily based on text by Miklos Szeredi.
Changes to individual pages
---------------------------
chroot.2
Jann Horn
chroot() is not intended for security; document attack
It is unfortunate that this discourages this use of chroot(2)
without pointing out alternative solutions - for example,
OpenSSH and vsftpd both still rely on chroot(2) for security.
Bind mounts should theoretically be usable as a replacement, but
currently, they have a similar problem (CVE-2015-2925) that hasn't
been fixed in ~6 months, so I'd rather not add it to the manpage
as a solution before a fix lands.
fallocate.2
Namjae Jeon [Michael Kerrisk]
Document FALLOC_FL_INSERT_RANGE
mmap.2
Michal Hocko [Eric B Munson]
Clarify MAP_POPULATE
David Rientjes has noticed that MAP_POPULATE wording might promise
much more than the kernel actually provides and intends to provide.
The primary usage of the flag is to pre-fault the range. There is
no guarantee that no major faults will happen later on. The pages
might have been reclaimed by the time the process tries to access
them.
Michal Hocko [Eric B Munson]
Clarify MAP_LOCKED semantics
mprotect.2
Michael Kerrisk
Note ENOMEM error that can occur when we reach limit on maximum VMAs
perf_event_open.2
Vince Weaver [Joerg Roedel]
Exclude_host/exclude_guest clarification
Vince Weaver
Document PERF_SAMPLE_REGS_INTR
pread.2
read.2
readv.2
sendfile.2
write.2
Michael Kerrisk
Clarify that Linux limits transfers to a maximum of 0x7ffff000 bytes
See https://bugs.debian.org/629994 and
https://bugs.debian.org/630029.
recv.2
send.2
Michael Kerrisk
Explain some subtleties of MSG_DONTWAIT versus O_NONBLOCK
sched_setaffinity.2
Michael Kerrisk
Add an example program
Michael Kerrisk [Florian Weimer]
Explain how to deal with 1024-CPU limitation of glibc's cpu_set_t type
proc.5
Michael Kerrisk [Kees Cook]
Document /proc/sys/kernel/sysctl_writes_strict
Based on text in Documentation/sysctl/kernel.txt.
capabilities.7
Michael Kerrisk
CAP_SYS_ADMIN allows calling bpf(2)
packet.7
文剑 [Cortland Setlow]
Fix description of binding a packet socket to an interface
pty.7
NeilBrown [Peter Hurley]
Clarify asynchronous nature of PTY I/O
A PTY is not like a pipe - there may be delayed between data
being written at one end and it being available at the other.
vdso.7
Nathan Lynch [Mike Frysinger]
Update for ARM
The 32-bit ARM architecture in Linux has gained a vDSO as of the
4.1 release.
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/