man-pages-3.55 is released

From: Michael Kerrisk (man-pages)
Date: Mon Dec 30 2013 - 05:18:57 EST


Gidday,

I've released man-pages-3.55 - 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.55

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2013/12/man-pages-355-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

==================== Changes in man-pages-3.55 ====================

Changes to individual pages
---------------------------

fallocate.2
Christoph Hellwig
Clarify the zeroing behavior
fallocate() zeroes only space that did not previously contain
data, but leaves existing data untouched.

perf_event_open.2
Vince Weaver
Linux 3.12 rdpmc/mmap
It turns out that the perf_event mmap page rdpmc/time setting was
broken, dating back to the introduction of the feature. Due
to a mistake with a bitfield, two different values mapped to
the same feature bit.

A new somewhat backwards compatible interface was introduced
in Linux 3.12. A much longer report on the issue can be found
here:
https://lwn.net/Articles/567894/
Vince Weaver
Linux 3.12 adds PERF_SAMPLE_IDENTIFIER
A new PERF_SAMPLE_IDENTIFIER sample type was added in Linux 3.12.
Vince Weaver
E2BIG documentation
The following documents the E2BIG error return for
perf_event_open().

I actually ran into this error the hard way and it took me
half a day to figure out why my ->size value was changing.
Vince Weaver
Linux 3.12 adds PERF_EVENT_IOC_ID
A new perf_event related ioctl, PERF_EVENT_IOC_ID, was added
in Linux 3.12.
Vince Weaver
PERF_COUNT_SW_DUMMY support
Support for the PERF_COUNT_SW_DUMMY event type was added in
Linux 3.12.
Vince Weaver [Andreas Sandberg]
PERF_EVENT_IOC_PERIOD update
The PERF_EVENT_IOC_PERIOD ioctl was broken until 2.6.36,
and it turns out that the ARM architecture has some
differing behavior too.

stat.2
Michael Kerrisk
Note filesystem support for nanosecond timestamps
Add some detail on which native filesystems do and don't
support nanosecond timestamps.
Michael Kerrisk [Yang Yang]
Update discussion of nanosecond timestamps
The existing text describes the timestamp fields as 'time_t'
and delegates discussion of nanosecond timestamps under NOTES.
Nanosecond timestamps have been around for a while now,
and are in POSIX.1-2008, so reverse the orientation of the
discussion, putting the nanosecond fields into DESCRIPTION
and detailing the historical situation under NOTES.

tty_ioctl.4
Michael Kerrisk [Liu Jiaming]
Note that 'arg' should be 0 in the usual case when using TIOCSCTTY

proc.5
Michael Kerrisk
Document /proc/sys/kernel/ngroups_max

--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/