man-pages-3.55 is released
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
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
Hi,
Excerpt from http://man7.org/linux/man-pages/man2/socket.2.html :
Some socket types may not be implemented by all protocol families; for example, SOCK_SEQPACKET is not implemented for AF_INET.
This is not correct now, as Linux already had SCTP support.
Excerpt from http://tools.ietf.org/html/rfc6458#section-3.1.1 :
and one uses PF_INET or PF_INET6 as the domain, SOCK_SEQPACKET as the type, and IPPROTO_SCTP as the protocol.
Here, SOCK_SEQPACKET indicates the creation of a one-to-many style socket.
Regards,
Dongsheng
Quoted 102 lines · Michael Kerrisk (man-pages)
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.55A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2013/12/man-pages-355-is-released.htmlThe 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 theperf_eventmmap 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 addsPERF_SAMPLE_IDENTIFIER
A newPERF_SAMPLE_IDENTIFIERsample type was added in Linux 3.12.
Vince Weaver
E2BIG documentation
The following documents the E2BIG error return forperf_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 addsPERF_EVENT_IOC_ID
A newperf_eventrelated ioctl,PERF_EVENT_IOC_ID, was added in Linux 3.12.
Vince Weaver
PERF_COUNT_SW_DUMMYsupport
Support for thePERF_COUNT_SW_DUMMYevent type was added in Linux 3.12.
Vince Weaver [Andreas Sandberg]
PERF_EVENT_IOC_PERIODupdate
ThePERF_EVENT_IOC_PERIODioctl 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 TIOCSCTTYproc.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 [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
Quoted 11 lines · Dongsheng Song
Hi,
Excerpt from http://man7.org/linux/man-pages/man2/socket.2.html :
Some socket types may not be implemented by all protocol families; for example,
SOCK_SEQPACKETis not implemented forAF_INET.This is not correct now, as Linux already had SCTP support.
Excerpt from http://tools.ietf.org/html/rfc6458#section-3.1.1 :
Quoted 8 lines
and one uses
PF_INETorPF_INET6as the domain,SOCK_SEQPACKETas the type, andIPPROTO_SCTPas the protocol.Here,
SOCK_SEQPACKETindicates the creation of a one-to-many style socket.Regards,
Dongsheng
Hello Dongsheng,
Thanks for the report. I've updated the page to remove that crufty text:
Quoted 1 line
for example,
SOCK_SEQPACKETis not implemented forAF_INET.
For the future, bugs are best reported in a new subject line; see https://www.kernel.org/doc/man-pages/reporting_bugs.html
Cheers,
Michael