man-pages-3.53 released
Gidday,
The Linux man-pages maintainer proudly announces:
man-pages-3.53 - 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.53
A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2013/08/man-pages-353-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
==================== Changes in man-pages-3.53 ====================
Released: 2013-07-31, 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:
Al Viro <[email protected]> Andrey Vagin <[email protected]> Benjamin Poirier <[email protected]> Chris Heath <[email protected]> Chuck Coffing <clc-FrUbXkNCsVf2fBVCVOL8/[email protected]> David Prévot <[email protected]> Denys Vlasenko <[email protected]> Dmitry V. Levin <ldv-u2l5PoMzF/[email protected]> [email protected] [email protected]
Michael Kerrisk <[email protected]> Oleg Nesterov <[email protected]> Peng Haitao <[email protected]> Peter Schiffer <[email protected]> Simon Paillard <[email protected]> Vince Weaver <[email protected]>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
restart_syscall.2
Michael Kerrisk
New page for restart_syscall(2) system call
Newly documented interfaces in existing pages
---------------------------------------------
fchownat.2
Michael Kerrisk
Document AT_EMPTY_PATH
fstatat.2
Michael Kerrisk
Document AT_EMPTY_PATH
linkat.2
Michael Kerrisk
Document AT_EMPTY_PATH
open.2
Michael Kerrisk [Al Viro]
Document O_PATH
See also https://bugzilla.redhat.com/show_bug.cgi?id=885740
Changes to individual pages
---------------------------
clock_nanosleep.2
futex.2
nanosleep.2
poll.2
sigaction.2
sigreturn.2
signal.7
Michael Kerrisk
SEE ALSO: add restart_syscall(2)
open.2
Michael Kerrisk [Geoffrey Thomas]
Remove warning that O_DIRECTORY is only for use with opendir(3)
O_DIRECTORY can also be used with, for example, O_PATH.
perf_event_open.2
Vince Weaver
Improve PERF_SAMPLE_BRANCH_STACK documentation
Vince Weaver
Fix indentation of the MMAP layout section
The indentation of the MMAP layout section wasn't quite right. I think this improves things but I admit I'm not an expert at the low-level indentation directives.
Vince Weaver
Update PERF_IOC_FLAG_GROUP info
It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9 (in Linux 2.6.31, the initial perf_event release) until 724b6daa1 (Linux 3.4).
I've done some extensive kernel source code digging plus running tests of various kernels and I hope the info presented is accurate now.
(Patch edited somewhat by mtk.)
Vince Weaver
Improve sysfs files documentation
This improves the documentation of the various perf_event_open()-related sysfs files.
ptrace.2
Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
If SEIZE was used, initial auto-attach stop is EVENT_STOP
For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.
Mention the same thing again in the description of PTRACE_EVENT_STOP.
Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
Mention that PTRACE_PEEK* libc API and kernel API are different
Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior
readlink.2
Michael Kerrisk
Document use of empty 'pathname' argument
Michael Kerrisk
Change error check in example program from "< 0" to "== -1"
Chuck Coffing
Fix possible race condition in readlink.2 example
I noticed that the example in the readlink.2 man pages does error checking for a race condition that would cause the value of the symbolic link to get larger. However, it doesn't handle the opposite case, in which the value gets shorter. (The NULL terminator is always set at the old, longer offset.) This could cause the program to operate on uninitialized data.
setpgid.2
Michael Kerrisk [[email protected]]
s/SIGTSTP/SIGTTIN/ when discussing reads from terminal
See https://bugzilla.kernel.org/show_bug.cgi?id=60504
clog2.3
Michael Kerrisk
Note that these functions are still not present in glibc 2.17
dirfd.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function dirfd() is thread safe.
div.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions div(), ldiv(), lldiv() and imaxdiv() are thread safe.
fabs.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions fabs(), fabsf() and fabsl() are thread safe.
fdim.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions fdim(), fdimf() and fdiml() are thread safe.
fflush.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function fflush() is thread safe.
finite.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions finite(), finitef(), finitel(), isinf(), isinff(), isinfl(), isnan(), isnanf() and isnanl() are thread safe.
flockfile.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions flockfile(), ftrylockfile() and funlockfile() are thread safe.
floor.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions floor(), floorf() and floorl() are thread safe.
resolv.conf.5
Simon Paillard
Explain how to set empty domain
See http://bugs.debian.org/463575
capabilities.7
Michael Kerrisk
Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH
inotify.7
Michael Kerrisk [[email protected]]
Clarify description of IN_MOVED_FROM and IN_MOVED_TO
man-pages.7
Michael Kerrisk
DESCRIPTION should note versions for new interface features or behavior
udp.7
Benjamin Poirier
Add missing #include directive
Using the UDP_CORK socket option documented in udp.7 requires including <netinet/udp.h>.
ld.so.8
Michael Kerrisk
Rework rpath token expansion text
Michael Kerrisk
Describe $PLATFORM rpath token
Michael Kerrisk
Describe $LIB rpath token
Michael Kerrisk
Document LD_BIND_NOT
Michael Kerrisk [Simon Paillard]
Add reference to pthreads(7) in discussion of LD_ASSUME_KERNEL
Signature · 7 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- 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