man-pages-3.57 released

Gidday,

The Linux man-pages maintainer proudly announces:

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/

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to linux-man-u79uwXL29TaiAVqoAR/[email protected]

c) I have information (possibly inaccurate) that you are the maintainer of a translation of the manual pages, or are the maintainer of the manual pages set in a particular distribution, or have expressed interest in helping with man-pages maintenance, or have otherwise expressed interest in being notified about man-pages releases. If you don't want to receive such messages from me, or you know of some other translator or maintainer who may want to receive such notifications, send me a message.

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

Contributors
------------

The following people contributed patches/fixes or (noted in brackets in the changelog below) reports, notes, and ideas that have been incorporated in changes in this release:

Andi Kleen <andi-Vw/[email protected]> Andre Majorel <aym-xunil-Bi/[email protected]> Andrey Vagin <[email protected]> Andy Lutomirski <[email protected]> Axel Beckert <[email protected]> Bernhard Walle <[email protected]> Brandon Edens <[email protected]> Eliezer Tamir <eliezer.tamir-VuQAYsv1563Yd54FQh9/[email protected]> Gioele Barabucci <[email protected]> Ian Abbott <abbotti-GUHe90Wt2aFaa/[email protected]> Jerry Chu <[email protected]> Jonas Jonsson <[email protected]> Marc Lehmann <[email protected]> Michael Kerrisk <[email protected]> Mike Frysinger <[email protected]> Peng Haitao <[email protected]> Reuben Thomas <[email protected]>
Simone Piccardi <[email protected]> Simon Paillard <[email protected]> Thomas Posch <[email protected]> Tilman Schmidt <[email protected]>
Vince Weaver <[email protected]> Yuri Kozlov <[email protected]> Марк Коренберг <[email protected]>

Apologies if I missed anyone!

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

Global changes
--------------

Various pages
Michael Kerrisk
Reword to avoid use of "etc."

Various pages
Peng Haitao [Andre Majorel]
Make wording around thread-safety and setlocale() more precise

getdate.3
strptime.3
locale.5
Michael Kerrisk
Replace "weekday" with less ambiguous language
Notwithstanding POSIX's use of the term "weekday", in everyday English, "weekday" is commonly understood to mean a day in the set [Monday..Friday] (vs one of the "weekend" days).

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

epoll_wait.2
Michael Kerrisk [Jonas Jonsson]
Clarify wording of EINTR error
See https://bugzilla.kernel.org/show_bug.cgi?id=66571

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
Michael Kerrisk
Add susbsections under BUGS
There's several bugs listed. It's helpful to mark them separately.
Michael Kerrisk
POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG

getrlimit.2
Michael Kerrisk [Марк Коренберг]
Note that rlim_cur can be set lower than current resource consumption

getsockopt.2
Michael Kerrisk
SEE ALSO: add ip(7) and udp(7)

keyctl.2
Michael Kerrisk
SEE ALSO: mention Documentation/security/keys.txt

linkat.2
Michael Kerrisk
Add ENOENT for O_TMPFILE created with O_EXCL
Michael Kerrisk
ERRORS: Add EINVAL

lseek.2
Michael Kerrisk
Note which filesystems support SEEK_HOLE/SEEK_DATA

msgop.2
Michael Kerrisk
Note that MSG_EXCEPT is Linux-specific

open.2
Michael Kerrisk
Update CONFORMING TO
Add POSIX.1-2008. Add mention of O_TMPFILE.
Update text on various flags that were added in POSIX.1-2008, and whose definitions can, since glibc 2.12, be obtained by suitably defining _POSIX_C_SOURCE or _XOPEN_SOURCE
Michael Kerrisk
Add pointer in description to BUGS, for O_ASYNC limitation
Michael Kerrisk
Remove crufty duplicate text on modifying file status flags

ptrace.2
Michael Kerrisk
Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK

select.2
Michael Kerrisk [Marc Lehmann]
RETURN VALUE: Fix discussion of treatment of file descriptor sets
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370

syscalls.2
Michael Kerrisk
Remove madvise1() from main list
madvise1() is one of the system calls that was never implemented, and listed toward the bottom of the page.

timer_create.2
Michael Kerrisk
Add pointer to proc(5) for info on /proc/[pid]/timers

unlinkat.2
Michael Kerrisk [Mike Frysinger:]
ERRORS: Add EISDIR
See https://bugzilla.kernel.org/show_bug.cgi?id=29702

ferror.3
Michael Kerrisk
clearerr(), feof(), and ferror() are also POSIX-conformant
Michael Kerrisk [Reuben Thomas]
CONFORMING TO: add fileno()

gets.3
Ian Abbott
SEE ALSO: add fgets(3)

mq_receive.3
mq_send.3
Michael Kerrisk [Simone Piccardi]
SYNOPSIS: s/unsigned/unsigned int/

printf.3
Michael Kerrisk
Small reorganization of text in EXAMPLE

rand.3
Michael Kerrisk
s/unsigned/unsigned int/ in example

stpcpy.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function stpcpy() is thread safe.

stpncpy.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function stpncpy() is thread safe.

strcat.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions strcat() and strncat() are thread safe.

strchr.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions strchr(), strrchr() and strchrnul() are thread safe.

strcmp.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions strcmp() and strncmp() are thread safe.

strftime.3
Brandon Edens
Change "week day" to "day of week"
See https://bugzilla.kernel.org/show_bug.cgi?id=68861

strstr.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function strstr() is thread safe.
The function strcasestr() is thread safe with exceptions.

strtod.3
Peng Haitao
ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtod(), strtof() and strtold() are thread safe with exceptions.

strtoimax.3
Peng Haitao
ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtoimax() and strtoumax() are thread safe with exceptions.

strtol.3
Peng Haitao
ATTRIBUTES: Note functions that are thread safe with exceptions
The functions strtol(), strtoll() and strtoq() are thread safe with exceptions.

tcgetpgrp.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions tcgetpgrp() and tcsetpgrp() are thread safe.

tcgetsid.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function tcgetsid() is thread safe.

core.5
Bernhard Walle
Mention that %E exists since Linux 3.0
'%E' in the 'core_pattern' has been introduced in kernel commit 57cc083ad9e1bfeeb4a0ee831e7bb008c8865bf0 which was included in version 3.0. Add that information to the manual page.

filesystems.5
Michael Kerrisk [Axel Beckert]
Add reference to proc(5) for more details on /proc/filesystems
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=735590

locale.5
Michael Kerrisk
SEE ALSO: add locale(7)

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

environ.7
Michael Kerrisk [Gioele Barabucci]
Correct reference to locale(7) (not locale(5))
locale(7) is the right place for details of the LC_* environment variables.

See http://bugs.debian.org/638186
Michael Kerrisk
Improve references for discussion of locale environment variables
Michael Kerrisk
SEE ALSO: add catopen(3)
Michael Kerrisk
SEE ALSO: add locale(5)

man-pages.7
Michael Kerrisk
Prefer "usable" over "useable"

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.

While I'm at it, also generally clarify the section on SIOCGIFCONF.

standards.7
Michael Kerrisk
Enhance description of V7
Michael Kerrisk
Add C11

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/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html