2009-09-30 03:21:56 +00:00
|
|
|
|
==================== Changes in man-pages-3.24 ====================
|
2007-09-19 21:40:03 +00:00
|
|
|
|
|
2010-02-25 09:34:24 +00:00
|
|
|
|
Released: 2010-02-25, Munich
|
2007-09-19 21:40:03 +00:00
|
|
|
|
|
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
|
Contributors
|
|
|
|
|
------------
|
2007-10-23 11:33:49 +00:00
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
|
The following people contributed notes, ideas, or patches that have
|
|
|
|
|
been incorporated in changes in this release:
|
2007-09-20 18:15:23 +00:00
|
|
|
|
|
2010-02-25 09:34:24 +00:00
|
|
|
|
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<EFBFBD>d<EFBFBD>ric Bri<72>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>
|
2008-10-07 08:54:13 +00:00
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
|
Apologies if I missed anyone!
|
2007-11-24 10:49:28 +00:00
|
|
|
|
|
|
|
|
|
|
2009-09-30 03:21:56 +00:00
|
|
|
|
New and rewritten pages
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2010-02-25 09:34:24 +00:00
|
|
|
|
add_key.2
|
|
|
|
|
David Howells
|
|
|
|
|
New page documenting add_key(2)
|
|
|
|
|
Taken from keyutils-1.1 package.
|
2009-09-30 03:21:56 +00:00
|
|
|
|
|
2010-02-25 09:34:24 +00:00
|
|
|
|
keyctl.2
|
|
|
|
|
David Howells
|
|
|
|
|
New page documenting keyctl(2)
|
|
|
|
|
Taken from keyutils-1.1 package.
|
2009-09-30 03:21:56 +00:00
|
|
|
|
|
2010-02-25 09:34:24 +00:00
|
|
|
|
request_key.2
|
|
|
|
|
David Howells
|
2010-02-26 04:45:17 +00:00
|
|
|
|
New page documenting request_key(2)
|
2010-02-25 09:34:24 +00:00
|
|
|
|
Taken from keyutils-1.1 package.
|
2009-09-30 03:21:56 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Global changes
|
|
|
|
|
--------------
|
|
|
|
|
|
2010-02-25 09:34:24 +00:00
|
|
|
|
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.
|
|
|
|
|
|
2009-09-30 03:21:56 +00:00
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
|
Changes to individual pages
|
|
|
|
|
---------------------------
|
2008-06-05 20:14:50 +00:00
|
|
|
|
|
2010-02-25 09:34:24 +00:00
|
|
|
|
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
|