LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Changes: Ready for 3.55 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2013-12-12 20:32:16 +13:00
parent f2d15dc910
commit 1c530bec32
1 changed files with 562 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

575
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.55 ====================
Released: ????-??-??, Munich
Released: ????-??-??, Christchurch
Contributors
@ -10,26 +10,575 @@ 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:
Alfred Agrell <alfred@agrell.info>
Andreas Sandberg <andreas.sandberg@it.uu.se>
Christoph Hellwig <hch@infradead.org>
David Gibson <david@gibson.dropbear.id.au>
David Prévot <taffit@debian.org>
Fabrice Bauzac <libnoon@gmail.com>
Greg Price <price@mit.edu>
Jon Grant <jg@jguk.org>
KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Liu Jiaming <storypku@gmail.com>
Maxin B. John <maxin.john@enea.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Paolo Bonzini <bonzini@gnu.org>
Peng Haitao <penght@cn.fujitsu.com>
Robert P. J. Day <rpjday@crashcourse.ca>
Rodrigo Campos <rodrigo@sdfg.com.ar>
Shawn Landden <shawn@churchofgit.com>
Trevor Bramwell <trevor@bramwell.net>
Vince Weaver <vincent.weaver@maine.edu>
Yang Yang <yangyang.gnu@gmail.com>
Yuanhang Zheng <zhengyhn@gmail.com>
Yuri Kozlov <yuray@komyakino.ru>
janh <a0vhv@t-online.de>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
Newly documented interfaces in existing pages
---------------------------------------------
New and changed links
---------------------
Global changes
--------------
assert.3
assert_perror.3
rexec.3
rpc.3
Michael Kerrisk [Jon Grant]
Reword a sentence to use more gender-neutral language
Changes to individual pages
---------------------------
execve.2
Michael Kerrisk
'arg...' for interpreter scripts starts with argv[1]
fallocate.2
Christoph Hellwig
Clarify the zeroing behavior
fallocate() zeroes only space that did not previously contain
data, but leaves existing data untouched.
futex.2
Rodrigo Campos
Fix link to Rusty's futex example library
When I asked to webmaster@kernel.org, Konstantin Ryabitsev
answered that the ".nl." is "an obsolete scheme and really
should be changed to just ftp.kernel.org".
getgroups.2
Michael Kerrisk
Note that NGROUPS_MAX is defined in <limits.h>
Michael Kerrisk
Clarify that sysconf(_SC_NGROUPS_MAX) is a run-time technique
Michael Kerrisk
Document /proc/sys/kernel/ngroups_max
ioctl.2
Michael Kerrisk [KOSAKI Motohiro, David Gibson]
'request' argument is typed as 'unsigned long' in glibc
See https://bugzilla.kernel.org/show_bug.cgi?id=42705
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.
pipe.2
Trevor Bramwell
Fix error in example program
poll.2
Michael Kerrisk [Paolo Bonzini]
Clarify meaning of events==0
events==0 does not mean that revents is always returned as
zero. The "output only" events (POLLHUP, POLLERR, POLLNVAL)
can still be returned.
See https://bugzilla.kernel.org/show_bug.cgi?id=61911
readlink.2
Michael Kerrisk [Yuanhang Zheng]
Fix typo in error message in example program
recv.2
Michael Kerrisk
Remove out-of-date statement that UNIX domain does not support MSG_TRUNC
Should have removed that sentence as part of
commit a25601b48b822eb1882ae336574b8d062a17e564
sched_get_priority_max.2
Michael Kerrisk
Add SCHED_IDLE to discussion
send.2
Michael Kerrisk
RETURN VALUE: these calls return number of bytes (not characters) sent
setreuid.2
Michael Kerrisk
Small clarification to description of when saved set-user-ID is set
sigpending.2
Michael Kerrisk
Note treatment of signals that are blocked *and* ignored
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
Cosmetic reworking of timestamp discussion in NOTES
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.
symlink.2
Michael Kerrisk
Further fine tuning of argument names
Follow-up to f2ae6dde0c68448bec986d12fe32268a2c98bfd9
See https://sourceware.org/bugzilla/show_bug.cgi?id=16073
Michael Kerrisk [Fabrice Bauzac]
Give arguments of symlink() more meaningful names
adjtime.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function adjtime() is thread safe.
alloca.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function alloca() is thread safe.
asinh.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions asinh(), asinhf() and asinhl() are thread safe.
atan.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions atan(), atanf() and atanl() are thread safe.
atof.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function atof() is thread safe with exceptions.
atoi.3
Peng Haitao
ATTRIBUTES: Note functions that are thread safe with exceptions
The functions atoi(), atol() and atoll() are thread safe with
exceptions.
bcmp.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function bcmp() is thread safe.
bcopy.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function bcopy() is thread safe.
bsd_signal.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function bsd_signal() is thread safe.
bzero.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function bzero() is thread safe.
cbrt.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions cbrt(), cbrtf() and cbrtl() are thread safe.
copysign.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions copysign(), copysignf() and copysignl() are thread
safe.
cos.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions cos(), cosf() and cosl() are thread safe.
cproj.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions cproj(), cprojf() and cprojl() are thread safe.
creal.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions creal(), crealf() and creall() are thread safe.
daemon.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function daemon() is thread safe.
des_crypt.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions ecb_crypt(), cbc_crypt() and des_setparity() are
thread safe.
difftime.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function difftime() is thread safe.
dysize.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function dysize() is thread safe.
erf.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions erf(), erff() and erfl() are thread safe.
erfc.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions erfc(), erfcf() and erfcl() are thread safe.
euidaccess.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions euidaccess() and eaccess() are thread safe.
expm1.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions expm1(), expm1f() and expm1l() are thread safe.
fexecve.3
Michael Kerrisk
POSIX.1-2008 specifies fexecve()
Michael Kerrisk
Explain the use and rationale of fexecve()
ftime.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function ftime() is thread safe.
ftok.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function ftok() is thread safe.
ftw.3
Michael Kerrisk
nftw() visits directories with FTW_D if FTW_DEPTH was not specified
Michael Kerrisk
Explain probable cause of FTW_NS
futimes.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions futimes() and lutimes() are thread safe.
getaddrinfo.3
Michael Kerrisk
Explain one use case for AI_ADDRCONFIG
Michael Kerrisk
Highlight difference in ai_flags when hints==NULL
NOTES already described how glibc differs from POSIX.
Add a pointer to that text from the point in DESCRIPTION
where hints==NULL is discussed.
kcmp.3
Shawn Landden
Reword slightly awkward section
malloc.3
Greg Price
Scale back promises of alignment
It's not true that the return value is suitably aligned for "any
variable"; for example, it's unsuitable for a variable like
float *x __attribute__ ((__vector_size__ (32)));
which requires 32-byte alignment. Types like this are defined in
<avxintrin.h>, and with 16-byte alignment in <emmintrin.h> and
<xmmintrin.h>, so the application programmer need not even know
that a vector_size attribute has been applied.
On an x86 architecture, a program that loads from or stores to a
pointer with this type derived from malloc can crash because GCC
generates an aligned load/store, like MOVDQA.
The C99 standard (TC3, as of N1256) does say the return value is
suitably aligned for "any type of object". The C11 standard (as
of N1570) revises this to any type with "fundamental alignment",
which means an alignment "supported by the implementation in all
contexts", which I suppose tautologically includes aligning
malloc/realloc return values.
The actual behavior of current glibc malloc is to align to the
greater of 2 * sizeof(size_t) and __alignof__ (long double),
which may be one bit greater than this commit promises.
mq_receive.3
Michael Kerrisk [janh]
msg_len must be greater than *or equal to* mq_msgsize
See https://bugzilla.kernel.org/show_bug.cgi?id=64571
setenv.3
Michael Kerrisk
Clarify that setenv() returns success in the overwrite==0 case
sigsetops.3
Michael Kerrisk [Robert P. J. Day]
Add 'const' to sigisemptyset(), sigorset(), sigandset() declarations
Michael Kerrisk
Rework text describing sigisemptyset(), sigorset(), and sigandset()
statvfs.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions statvfs() and fstatvfs() are thread safe.
stdarg.3
Peng Haitao
ATTRIBUTES: Note macros that are thread-safe
The macros va_start(), va_arg(), va_end() and va_copy() are
thread safe.
termios.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
The functions tcgetattr(), tcsetattr(), tcsendbreak(),
tcdrain(), tcflush(), tcflow(), cfmakeraw(), cfgetispeed(),
cfgetospeed(), cfsetispeed(), cfsetospeed() and cfsetspeed()
are thread safe.
ungetwc.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function ungetwc() is thread safe.
unlockpt.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function unlockpt() is thread safe.
usleep.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function usleep() is thread safe.
wcpcpy.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcpcpy() is thread safe.
wcscasecmp.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function wcscasecmp() is thread safe with exceptions.
wcscat.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcscat() is thread safe.
wcschr.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcschr() is thread safe.
wcscmp.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcscmp() is thread safe.
wcscpy.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcscpy() is thread safe.
wcscspn.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcscspn() is thread safe.
wcslen.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcslen() is thread safe.
wcsncasecmp.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function wcsncasecmp() is thread safe with exceptions.
wcsncat.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcsncat() is thread safe.
wcsncmp.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcsncmp() is thread safe.
wcsncpy.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcsncpy() is thread safe.
wcsnlen.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcsnlen() is thread safe.
wcspbrk.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcspbrk() is thread safe.
wcsrchr.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcsrchr() is thread safe.
wcsspn.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcsspn() is thread safe.
wcsstr.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcsstr() is thread safe.
wcstoimax.3
Peng Haitao
ATTRIBUTES: Note functions that are thread safe with exceptions
The functions wcstoimax() and wcstoumax() are thread safe with
exceptions.
wcstok.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wcstok() is thread safe.
wcswidth.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function wcswidth() is thread safe with exceptions.
wctrans.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function wctrans() is thread safe with exceptions.
wctype.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function wctype() is thread safe with exceptions.
wcwidth.3
Peng Haitao
ATTRIBUTES: Note function that is thread safe with exceptions
The function wcwidth() is thread safe with exceptions.
wmemchr.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wmemchr() is thread safe.
wmemcmp.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wmemcmp() is thread safe.
wmemcpy.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wmemcpy() is thread safe.
wmemmove.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wmemmove() is thread safe.
wmemset.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
The function wmemset() is thread safe.
tty_ioctl.4
Michael Kerrisk [Liu Jiaming]
Note that 'arg' should be 0 in the usual case when using TIOCSCTTY
Michael Kerrisk
Rework text on root to discuss just in terms of capabilities
proc.5
Michael Kerrisk
Document /proc/sys/kernel/ngroups_max
capabilities.7
Michael Kerrisk
Fix 2 version numbers under "Effect of user ID changes on capabilities"
Reported by Liu Jiaming <storypku@gmail.com>
feature_test_macros.7
Michael Kerrisk
Add _ISOC11_SOURCE to example program
tcp.7
Michael Kerrisk
Fix (nontrivial) wordo in discussion of MSG_TRUNC
s/MSG_PEEK/MSG_TRUNC/
ld.so.8
Michael Kerrisk [Alfred Agrell]
Fix crufty wording in one sentence