man-pages/Changes

==================== Changes in man-pages-3.32 ====================

Released: 2010-12-03, Munich


Contributors
------------

The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:

A. Costa <agcosta@gis.net>
Denis Barbier <bouzim@gmail.com>
Emil Mikulic <emikulic@gmail.com>
Eugene Kapun <abacabadabacaba@gmail.com>
Hugh Dickins <hughd@google.com>
Ivana Hutarova Varekova <varekova@redhat.com>
Joern Heissler <kernelbugs@joern.heissler.de>
Lars Wirzenius <liw@liw.fi>
Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
Michael Kerrisk <mtk.manpages@gmail.com>
Petr Uzel <petr.uzel@suse.cz>
Roger Pate <roger@qxxy.com>
Török Edwin <edwintorok@gmail.co
Yuri Kozlov <yuray@komyakino.ru>

Apologies if I missed anyone!


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

pthread_sigqueue.3
    Michael Kerrisk
        New page documenting ptrhead_sigqueue()
            pthread_sigqueue() is new in glibc 2.11 (requires a kernel with
            rt_tgsigqueinfo(), added in Linux 2.6.31).


Newly documented interfaces in existing pages
---------------------------------------------

readv.2
    Michael Kerrisk
        Add documentation of preadv() and pwritev()
            The preadv() and pwritev() system calls were added in
            Linux 2.6.30.


New and changed links
---------------------

preadv.2
    Michael Kerrisk
        New link to readv.2

pwritev.2
    Michael Kerrisk
        New link to readv.2


Changes to individual pages
---------------------------

chdir.2
    Michael Kerrisk
        Remove redundant and incorrect info on FTMs from NOTES

chown.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

clock_nanosleep.2
    Michael Kerrisk
        Clarify that clock_nanosleep() suspends the calling *thread*

epoll_create.2
    Michael Kerrisk
        Note that 'size' argument must be greater than 0
            See https://bugzilla.kernel.org/show_bug.cgi?id=23872
    Michael Kerrisk
        Added VERSIONS section

epoll_ctl.2
    Michael Kerrisk
        Added VERSIONS section

epoll_wait.2
    Michael Kerrisk
        Updated VERSIONS section

fcntl.2
    Michael Kerrisk
        Add notes on fcntl64()

fstatat.2
    Michael Kerrisk
        Add NOTES on fstatat64(), the name of the underlying system call

getdents.2
    Michael Kerrisk
        Added notes on getdents64()

getgid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

getgroups.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

getpagesize.2
    Michael Kerrisk
        Improve description of getpagesize()
            Improve description of getpagesize() and relocate discussion
            of sysconf(_SC_PAGESIZE).

            In part inspired by
            http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537272

getresuid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

getrlimit.2
    Michael Kerrisk
        Add example program for prlimit()

getuid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

open.2
    Ivana Hutarova Varekova
        O_EXCL can be used without O_CREAT for block devices
            Since Linux 2.6 there is a possibility to use O_EXCL without
            O_CREAT. See patch: http://lkml.org/lkml/2003/8/10/221.

pread.2
    Michael Kerrisk
        Add notes on pread64() and pwrite64()
            See https://bugzilla.kernel.org/show_bug.cgi?id=23072
    Michael Kerrisk
        SEE ALSO: add readv(3)

readv.2
    Michael Kerrisk
        Wording fix: readv() and writev() are system calls, not functions

sendfile.2
    Michael Kerrisk
        Add notes on sendfile64()

setfsgid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

setfsuid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

setgid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

setresuid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

setreuid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

setuid.2
    Michael Kerrisk
        Add NOTES explaining 32-bit system calls added in Linux 2.4

sigqueue.2
pthreads.7
signal.7
    Michael Kerrisk
        SEE ALSO: Add pthread_sigqueue(3)

stat.2
    Michael Kerrisk
        Fix EOVERFLOW error description
            2<<31 should read 1<<31 (which equals 2^31).

statfs.2
    Michael Kerrisk
        Add notes on statfs64() and fstatfs64()

swapon.2
    Hugh Dickins
        Document SWAP_FLAG_DISCARD and discarding of swap pages

truncate.2
    Michael Kerrisk
        Add notes on truncate64() and ftruncate64()

memcpy.3
    Michael Kerrisk
        Change "should not overlap" to "must not overlap"
            glibc 2.12 changed things so that applications that use memcpy() on
            overlapping regions will encounter problems. (The standards have
            long said that the behavious is undefined if the memory areas
            overlap.)

            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=603144
            In reference of http://lwn.net/Articles/414467/
            and http://article.gmane.org/gmane.comp.lib.glibc.alpha/15278

usleep.3
    Petr Uzel
        usleep() suspends calling thread, not process

core.5
    Michael Kerrisk
        Change single quote to double quote in shell session example
            The example section has a sample shell session containing:

            echo '|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s'

            But $PWD won't be expanded in single quotes. It should be double
            quotes around the entire argument or some other form.

pthreads.7
    Michael Kerrisk
        Added description of async-cancel-safe functions

unix.7
    Michael Kerrisk
        Reworded the text of various errors
    Michael Kerrisk
        Added ENOENT error