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

Changes: Update for 3.24 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-02-25 10:34:24 +01:00
parent 4509c62e84
commit 8757bb38e4
1 changed files with 376 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

382
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.24 ====================
Released: ????-??-??, Munich
Released: 2010-02-25, Munich
Contributors
@ -9,6 +9,39 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Andi Kleen <andi@firstfloor.org>
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Ansgar Burchardt <ansgar@2008.43-1.org>
Bella Lubkin <filbo@armory.com>
Bill O. Gallmeister <bog.kernel@gmail.com>
Christoph Hellwig <hch@lst.de>
Colin Watson <cjwatson@debian.org>
Dan Jacobson <jidanni@jidanni.org>
David Howells <dhowells@redhat.com>
Denis Barbier <bouzim@gmail.com>
Doug Manley <doug.manley@gmail.com>
Edward Welbourne <eddy@opera.com>
Fang Wenqi <anton.fang@gmail.com>
Frédéric Brière <fbriere@fbriere.net>
Garrett Cooper <yaneurabeya@yahoo.com>
Ihar Hrachyshka <ihar.hrachyscka@gmail.com>
Jann Poppinga <jann.poppinga@gmx.de>
Jason Goldfine-Middleton <jasonwoodfine@gmail.com>
Jason Noakes <jjnoakes@gmail.com>
Jonathan Nieder <jrnieder@gmail.com>
Kevin <tsubasa.xw@gmail.com>
Mark Hills <mark@pogo.org.uk>
Markus Peuhkuri <puhuri@iki.fi>
Michael Kerrisk <mtk.manpages@gmail.com>
Michael Witten <mfwitten@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Sam Liao <phyomh@gmail.com>
Samy Al Bahra <sbahra@repnop.org>
Stuart Kemp <skemp@alertlogic.com>
sunjiangangok <sunjiangangok@gmail.com>
Tobias Stoeckmann <tobias@bugol.de>
Vlastimil Babka <caster@gentoo.org>
Yuri Kozlov <yuray@komyakino.ru>
Apologies if I missed anyone!
@ -16,19 +49,356 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
add_key.2
David Howells
New page documenting add_key(2)
Taken from keyutils-1.1 package.
Newly documented interfaces in existing pages
---------------------------------------------
keyctl.2
David Howells
New page documenting keyctl(2)
Taken from keyutils-1.1 package.
New and changed links
---------------------
request_key.2
David Howells
New page documenting request_key(2)
Taken from keyutils-1.1 package.
Global changes
--------------
Various pages
Michael Kerrisk
Global fix: s/non-root/unprivileged/
Various pages
Michael Kerrisk
Global fix: s/non-privileged/unprivileged/
Various pages
Michael Kerrisk
Global fix: /non-superuser/unprivileged user/
Various pages
Michael Kerrisk
s/non-/non/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Various pages
Michael Kerrisk
Global fix: s/re-/re/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "re-" etc.
Various pages
Michael Kerrisk
Global fix: s/multi-/multi/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "multi-" etc.
Various pages
Michael Kerrisk
Global fix: s/pre-/pre/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "pre-" etc.
Various pages
Michael Kerrisk
Global fix: s/sub-/sub/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "sub-" etc.
stime.2
time.2
utimensat.2
ctime.3
difftime.3
ftime.3
getspnam.3
mq_receive.3
mq_send.3
rtime.3
sem_wait.3
strftime.3
strptime.3
timeradd.3
rtc.4
core.5
proc.5
icmp.7
time.7
Michael Witten
Global fix: Consistently define the Epoch
All definitions of the Epoch have been refactored to the following:
1970-01-01 00:00:00 +0000 (UTC)
That form is more consistent, logical, precise, and internationally
recognizable than the other variants.
Also, some wording has been altered as well.
spu_create.2
getopt.3
passwd.5
Michael Kerrisk
Global fix: s/non-existing/nonexistent/
faccessat.2
fchmodat.2
fchownat.2
fstatat.2
futimesat.2
linkat.2
mkdirat.2
mknodat.2
openat.2
readlinkat.2
renameat.2
symlinkat.2
unlinkat.2
utimensat.2
mkfifoat.3
Michael Kerrisk
Update feature test macro requirements
Starting in glibc 2.10, defining _XOPEN_SOURCE >= 700,
or _POSIX_C_SOURCE >= 200809 exposes the declarations of
these functions.
Changes to individual pages
---------------------------
clock_getres.2
Michael Kerrisk
Update text on nonsetabble CLOCK_*_CPUTIME_ID clocks
SUSv3 permits, but does not require CLOCK_THREAD_CPUTIME_ID and
CLOCK_PROCESS_CPUTIME_ID to be settable.
See http://bugzilla.kernel.org/show_bug.cgi?id=11972.
execve.2
Colin Watson
Fix description of treatment of caught signals
Caught signals reset to their default on an execve() (not
to being ignored).
fcntl.2
Michael Kerrisk
s/F_OWNER_GID/F_OWNER_PGRP/
Peter Zijlstra took the name change I suggested.
fcntl.2
Michael Kerrisk
Document F_[SG]ETOWN_EX; update details on F_SETOWN
Linux 2.6.32 adds F_SETOWN_EX and F_GETOWN_EX.
Linux 2.6.12 changed (broke) the former behavior of
F_SETOWN with respect to threads.
intro.2, intro.3
Michael Kerrisk
Make subsection heading consistent with other intro.? pages
These pages used "Copyright Terms"; the other intro.? pages
used "Copyright Conditions". Make these pages like the others.
sendfile.2
Michael Kerrisk
Clarify behavior when offset is NULL
seteuid.2
Michael Kerrisk
Note unstandardized behavior for effective ID
POSIX.1 doesn't require that the effective ID can be changed
to the same value it currently has (a no-op). The man page
should note this, since some other implementations
don't permit it.
setgid.2
Michael Kerrisk
Fix EPERM error description
s/effective group ID/real group ID/
This bug lived in man pages for 15 years before Jason
spotted it! I checked back in Linux 1.0, and the behavior
was as the fixed man page describes.
setreuid.2
Michael Kerrisk
Add more detail on POSIX.1 specification for these syscalls
setuid.2
Michael Kerrisk
Remove crufty statement that seteuid() is not in POSIX
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=569812
stime.2, strftime.3, tzset.3, zic.8
Michael Witten
GMT -> UTC (where appropriate)
sync_file_range.2
Christoph Hellwig
Add some big warnings re data integrity
This system call is by design completely unsuitable for any data
integrity operations. Make that very clear in the manpage.
CPU_SET.3
Vlastimil Babka
SYNOPSIS: Fix return types for CPU_COUNT_*()
These functions return 'int' not void'.
confstr.3
Michael Kerrisk
Fix feature test macro requirements
daemon.3
Michael Kerrisk
Fix description of 'nochdir' argument.
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=554819
gethostbyname.3
Michael Kerrisk
Document feature test macro requirements for herror() and hstrerror()
Since glibc 2.8, one of _BSD_SOURCE, _SVID_SOURCE,
or _GNU_SOURCE is required.
getline.3
Michael Kerrisk
Update to reflect that these functions were standardized in POSIX.1-2008
getnameinfo.3
Michael Kerrisk
Document feature test macros requirements for NI_MAXHOST and NI_MAXSERV
Since glibc 2.8, one of _BSD_SOURCE, _SVID_SOURCE, or _GNU_SOURCE
must be defined to obtain these definitions.
getopt.3
Jonathan Nieder
Fix feature test macro requirements
memchr.3
Michael Kerrisk
Add feature text macro requirements for memrchr()
nextafter.3
Michael Kerrisk
Fix notable error in DESCRIPTION.
"less than y" should be "less than x".
popen.3
Michael Kerrisk
Fix feature test macro requirements
pthread_attr_setdetachstate.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3
Denis Barbier
Argument name is 'attr' not 'thread'
The function argument was misnamed in the DESCRIPTION on these
three pages.
rtnetlink.3
Michael Kerrisk
Various fixes in example code
Edward reported a problem in the example code, where a variable
seems to be misnamed. Upon inspection, there seem to be a few
such instances, and this patch is my best guess at how things
should look.
sched_getcpu.3
Michael Kerrisk
Place correct header file in SYNOPSIS
sleep.3
Bill O. Gallmeister
sleep() puts calling *thread* to sleep (not calling *process*)
sleep.3
Bill O. Gallmeister
Add nanosleep(2) to SEE ALSO
strftime.3
Michael Kerrisk
%z is defined in SUSv3
So, substitute "GNU" tag in man page by "SU".
strftime.3
Michael Witten
Move 822-compliant date format example to EXAMPLES section
The RFC 822-compliant date format given in the description
of `%z' is now moved to the `EXAMPLES' section (note: `EXAMPLE'
has been renamed `EXAMPLES').
Furthermore, that format example is now actually
RFC 822-compliant (using `%y' instead of `%Y') and has been
qualified as being correct only when in the context of at least
an English locale. Also, `%T' is used in place of `%H:%M:%S'.
For completeness, an RFC 2822-compliant format example has been
similarly added.
strftime.3
Michael Witten
Expand introductory text
strftime.3
Michael Witten
Clarification of %z specifier
string.3
Mark Hills
Add stpcpy() to this list of string functions
strptime.3
Michael Kerrisk
Initialize tm structure in example program
undocumented.3
Michael Kerrisk
Remove pages now documented
By now, the following are documented:
fopencookie(3)
freeifaddrs(3)
rawmemchr(3)
readdir_r(3)
getutmp(3)
getutmpx(3)
utmpxname(3)
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=554819
group.5
Michael Kerrisk
s/passwd/password/
The page inconsistently used "passwd" and "password"
to refer to the same field.
capabilities.7
Michael Kerrisk
Update securebits discussion to use SECBIT_* flags
feature_test_macros.7
Michael Kerrisk
_POSIX_C_SOURCE >= 200808 defines _ATFILE_SOURCE
Since glibc 2.10, _POSIX_C_SOURCE >= 200808 defines _ATFILE_SOURCE
path_resolution.7
Michael Kerrisk
Add readlink(2) to SEE ALSO
path_resolution.7
Michael Kerrisk
Fix NAME line
The poorly constructed part receding "\-" causes apropos
not to be able to find the subject.
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=558300
signal.7
Michael Kerrisk
Fix discussion of SIGUNUSED
Clarify that this signal really is synonymous with SIGSYS.
See http://bugzilla.kernel.org/show_bug.cgi?id=14449