Skip to contentSkip to conversation

man-pages-3.55 is released

DISCUSSION Michael Kerrisk (man-pages) 2 participants 3 messages Dec 30, 2013 – Jan 1, 2014

lore
Share & tools
lore
#0 lore raw

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/
#1 lore raw

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.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 [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

#2 lore raw
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_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 :

Quoted 8 lines

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

Hello Dongsheng,

Thanks for the report. I've updated the page to remove that crufty text:

Quoted 1 line

for example, SOCK_SEQPACKET is not implemented for AF_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