==================== Changes in man-pages-3.24 ====================

Released: 2010-02-25, Munich


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!


New and rewritten pages
-----------------------

add_key.2
    David Howells
        New page documenting add_key(2)
            Taken from keyutils-1.1 package.

keyctl.2
    David Howells
        New page documenting keyctl(2)
            Taken from keyutils-1.1 package.

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
