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

Start of man-pages-3.58: updating Changes and Changes.old

This commit is contained in:
Michael Kerrisk 2014-01-24 12:31:54 +01:00
parent 6986a101da
commit 95072db497
2 changed files with 375 additions and 338 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

346
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.57 ====================
==================== Changes in man-pages-3.58 ====================
Released: 2014-01-24, Munich
Released: ????-??-??, Munich
Contributors
@ -10,356 +10,26 @@ 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@firstfloor.org>
Andre Majorel <aym-xunil@teaser.fr>
Andrey Vagin <avagin@openvz.org>
Andy Lutomirski <luto@amacapital.net>
Axel Beckert <abe@debian.org>
Bernhard Walle <bernhard@bwalle.de>
Brandon Edens <bedens@fitbit.com>
Eliezer Tamir <eliezer.tamir@linux.intel.com>
Gioele Barabucci <gioele@svario.it>
Ian Abbott <abbotti@mev.co.uk>
Jerry Chu <hkchu@google.com>
Jonas Jonsson <jonas@websystem.se>
Marc Lehmann <debian-reportbug@plan9.de>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger: <vapier@gentoo.org>
Peng Haitao <penght@cn.fujitsu.com>
Reuben Thomas <rrt@sc3d.org>
Simone Piccardi <piccardi@truelite.it>
Simon Paillard <spaillard@debian.org>
Thomas Posch <man-pages@online.posch.name>
Tilman Schmidt <tilman@imap.cc>
Vince Weaver <vincent.weaver@maine.edu>
Yuri Kozlov <yuray@komyakino.ru>
Марк Коренберг <socketpair@gmail.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
Newly documented interfaces in existing pages
---------------------------------------------
open.2
Michael Kerrisk, Andy Lutomirski
Document O_TMPFILE
O_TMPFILE is new in Linux 3.11
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.
New and changed links
---------------------
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
Document MSG_COPY
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
perf_event_open.2
Vince Weaver [Andi Kleen]
1e043959034888ce1b1a25346316d06f7d64f0fe perf_event_open.2 : PERF_SAMPLE_TRANSACTION support in Linux 3.13 (fwd)
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.
Also, someone with better manpage formatting skills than I have
should probably investigate why I can't get the last line of
the change to properly tab-align with the .I transaction
heading.
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.
socket.7
Eliezer Tamir
Add description for SO_BUSY_POLL
Add description for the SO_BUSY_POLL socket option.
standards.7
Michael Kerrisk
Enhance description of V7
Michael Kerrisk
Add C11
tcp.7
Michael Kerrisk [Jerry Chu]
Document TCP_USER_TIMEOUT
Text slightly adapted from Jerry Chu's (excellent) commit
message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
Michael Kerrisk
Describe format of tcp_*_congestion_control /proc files
Describe format of tcp_allowed_congestion_control and
tcp_available_congestion_control.
Michael Kerrisk
Document TCP_CONGESTION

367
Changes.old
View File

@ -28922,3 +28922,370 @@ ld.so.8
Default output file for D_DEBUG is stderr not stdout
See https://sourceware.org/bugzilla/show_bug.cgi?id=6874
==================== 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@firstfloor.org>
Andre Majorel <aym-xunil@teaser.fr>
Andrey Vagin <avagin@openvz.org>
Andy Lutomirski <luto@amacapital.net>
Axel Beckert <abe@debian.org>
Bernhard Walle <bernhard@bwalle.de>
Brandon Edens <bedens@fitbit.com>
Eliezer Tamir <eliezer.tamir@linux.intel.com>
Gioele Barabucci <gioele@svario.it>
Ian Abbott <abbotti@mev.co.uk>
Jerry Chu <hkchu@google.com>
Jonas Jonsson <jonas@websystem.se>
Marc Lehmann <debian-reportbug@plan9.de>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger: <vapier@gentoo.org>
Peng Haitao <penght@cn.fujitsu.com>
Reuben Thomas <rrt@sc3d.org>
Simone Piccardi <piccardi@truelite.it>
Simon Paillard <spaillard@debian.org>
Thomas Posch <man-pages@online.posch.name>
Tilman Schmidt <tilman@imap.cc>
Vince Weaver <vincent.weaver@maine.edu>
Yuri Kozlov <yuray@komyakino.ru>
Марк Коренберг <socketpair@gmail.com>
Apologies if I missed anyone!
Newly documented interfaces in existing pages
---------------------------------------------
open.2
Michael Kerrisk, Andy Lutomirski
Document O_TMPFILE
O_TMPFILE is new in Linux 3.11
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.
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
Document MSG_COPY
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
perf_event_open.2
Vince Weaver [Andi Kleen]
1e043959034888ce1b1a25346316d06f7d64f0fe perf_event_open.2 : PERF_SAMPLE_TRANSACTION support in Linux 3.13 (fwd)
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.
Also, someone with better manpage formatting skills than I have
should probably investigate why I can't get the last line of
the change to properly tab-align with the .I transaction
heading.
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.
socket.7
Eliezer Tamir
Add description for SO_BUSY_POLL
Add description for the SO_BUSY_POLL socket option.
standards.7
Michael Kerrisk
Enhance description of V7
Michael Kerrisk
Add C11
tcp.7
Michael Kerrisk [Jerry Chu]
Document TCP_USER_TIMEOUT
Text slightly adapted from Jerry Chu's (excellent) commit
message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
Michael Kerrisk
Describe format of tcp_*_congestion_control /proc files
Describe format of tcp_allowed_congestion_control and
tcp_available_congestion_control.
Michael Kerrisk
Document TCP_CONGESTION