mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-3.54: updating Changes and Changes.old
This commit is contained in:
Michael Kerrisk
parent
b27ab95a5d
commit
0a4861e466
195
Changes
195
Changes
|
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-3.53 ====================
|
||||
==================== Changes in man-pages-3.54 ====================
|
||||
|
||||
Released: 2013-07-31, Munich
|
||||
Released: ????-??-??, Munich
|
||||
|
||||
|
||||
Contributors
|
||||
|
|
@ -10,22 +10,6 @@ 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 <viro@ZenIV.linux.org.uk>
|
||||
Andrey Vagin <avagin@openvz.org>
|
||||
Benjamin Poirier <bpoirier@suse.de>
|
||||
Chris Heath <chris@heathens.co.nz>
|
||||
Chuck Coffing <clc@alum.mit.edu>
|
||||
David Prévot <taffit@debian.org>
|
||||
Denys Vlasenko <dvlasenk@redhat.com>
|
||||
Dmitry V. Levin <ldv@altlinux.org>
|
||||
Felix_Schulte@McAfee.com
|
||||
graud@gmx.com
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Oleg Nesterov <oleg@redhat.com>
|
||||
Peng Haitao <penght@cn.fujitsu.com>
|
||||
Peter Schiffer <pschiffe@redhat.com>
|
||||
Simon Paillard <spaillard@debian.org>
|
||||
Vince Weaver <vincent.weaver@maine.edu>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
|
@ -33,186 +17,19 @@ 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
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
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
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
|
||||
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"
|
||||
|
||||
setpgid.2
|
||||
Michael Kerrisk [graud@gmx.com]
|
||||
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 [Felix_Schulte@McAfee.com]
|
||||
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
|
||||
|
||||
readlink.2
|
||||
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.
|
||||
|
|
|
|||
220
Changes.old
220
Changes.old
|
|
@ -27295,3 +27295,223 @@ tcp.7
|
|||
udp.7
|
||||
Michael Kerrisk
|
||||
Note that 'optval' for socket options is an 'int' in most cases
|
||||
|
||||
|
||||
==================== 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 <viro@ZenIV.linux.org.uk>
|
||||
Andrey Vagin <avagin@openvz.org>
|
||||
Benjamin Poirier <bpoirier@suse.de>
|
||||
Chris Heath <chris@heathens.co.nz>
|
||||
Chuck Coffing <clc@alum.mit.edu>
|
||||
David Prévot <taffit@debian.org>
|
||||
Denys Vlasenko <dvlasenk@redhat.com>
|
||||
Dmitry V. Levin <ldv@altlinux.org>
|
||||
Felix_Schulte@McAfee.com
|
||||
graud@gmx.com
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Oleg Nesterov <oleg@redhat.com>
|
||||
Peng Haitao <penght@cn.fujitsu.com>
|
||||
Peter Schiffer <pschiffe@redhat.com>
|
||||
Simon Paillard <spaillard@debian.org>
|
||||
Vince Weaver <vincent.weaver@maine.edu>
|
||||
|
||||
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"
|
||||
|
||||
setpgid.2
|
||||
Michael Kerrisk [graud@gmx.com]
|
||||
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 [Felix_Schulte@McAfee.com]
|
||||
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
|
||||
|
||||
readlink.2
|
||||
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.
|
||||
|
|
|
|||
Loading…
Reference in New Issue