Gidday,
I've released man-pages-3.57 - man pages for Linux.
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_3.57
A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2014/01/man-pages-357-is-released.html
The current version of the pages is browsable at:
http://man7.org/linux/man-pages/
A few changes in this release that may be of interest to readers of
this list are given below.
Cheers,
Michael
PS In passing, it's worth noting that the number of projects whose man pages
are rendered at http://man7.org/linux/man-pages/ has now grown to more than 70
(http://man7.org/linux/man-pages/dir_by_project.html).
The goal of these renderings is twofold:
* To provide a set of online renderings that are up to date (in many cases,
the pages are pulled directly from the corresponding source code repository
when the online renderings are updated) and whose origin and timestamp are
clearly documented on the rendered pages.
* To short circuit the task of reporting bugs in the man pages, all of the
rendered pages add a COLOPHON that identifies the project home page and
(in most cases) includes a specific email address for reporting bugs
or the URL of a project web page with instructions on how to report bugs.
With luck, this means that users are more likely to actually report bugs
in man pages.
I am open to adding further (relevant) projects to the set of rendered pages;
see http://blog.man7.org/2013/05/adding-further-man-pages-to-html.html
==================== Changes in man-pages-3.57 ====================
Released: 2014-01-24, Munich
Newly documented interfaces in existing pages
---------------------------------------------
msgop.2
Michael Kerrisk
Document MSG_COPY
open.2
Michael Kerrisk, Andy Lutomirski
Document O_TMPFILE
O_TMPFILE is new in Linux 3.11
perf_event_open.2
Vince Weaver [Andi Kleen]
PERF_SAMPLE_TRANSACTION support in Linux 3.13
The following patch adds descriptions of the new perf_event_open.2
PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13.
The descriptions are based on information provided by Andi Kleen,
both in the e-mail
[PATCH 1/6] perf, core: Add generic transaction flags v5
sent to the linux-kernel list as well as an e-mail
[PATCH] Document transaction flags in perf_event_open manpage
sent to the linux-man list.
The implementation is based heavily on the Intel Haswell
processor. Documentation can be found at this page:
http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0
as well as in section 18.11.5.1 of volume 3 of the
Intel 64 and IA-32 Architecture Software Developer's Manual.
ptrace.2
Andrey Vagin
Add description for PTRACE_PEEKSIGINFO
Retrieve signals without removing them from a queue.
Andrey Vagin
Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
These two commands allow to examine and change mask of blocked
signals.
socket.7
Eliezer Tamir
Add description for SO_BUSY_POLL
Add description for the SO_BUSY_POLL socket option.
tcp.7
Michael Kerrisk [Jerry Chu]
Document TCP_USER_TIMEOUT
Text slightly adapted from Jerry Chu's (excellent) commit
message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
Michael Kerrisk
Document TCP_CONGESTION
Changes to individual pages
---------------------------
faccessat.2
Michael Kerrisk
Note that the system call takes only three arguments
fallocate.2
Michael Kerrisk
Note filesystems that support FALLOC_FL_PUNCH_HOLE operation
fcntl.2
Michael Kerrisk
BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
lseek.2
Michael Kerrisk
Note which filesystems support SEEK_HOLE/SEEK_DATA
proc.5
Michael Kerrisk
Document /proc/[pid]/timers
Michael Kerrisk
Update discussion of wchan
Remove crufty reference to /etc/psdatabase in /proc/PID/stat.
Add /proc/PID/wchan.
See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/737452
netdevice.7
Tilman Schmidt
Document SIOCGIFCONF case ifc_req==NULL
Add the missing description of the possibility to call SIOCGIFCONF
with ifc_req==NULL to determine the needed buffer size, as
described in
http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html
and verified against source files net/core/dev_ioctl.c and
net/ipv4/devinet.c in the current kernel git tree.
This functionality has been present since the beginning of the 2.6
series. It's about time it gets documented.
tcp.7
Michael Kerrisk
Describe format of tcp_*_congestion_control /proc files
Describe format of tcp_allowed_congestion_control and
tcp_available_congestion_control.
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/