man-pages/Changes

==================== Changes in man-pages-2.63 ====================

Released: 2007-07-16


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

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

Arnd Bergmann <arndb@de.ibm.com>
Eduardo M. Fleury <efleury@br.ibm.com>
Ivana Varekova <varekova@redhat.com>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Marc Boyer <marc.boyer@enseeiht.fr>
Martin (Joey) Schulze <joey@infodrom.org>
Martin R<>hricht <martin@roehricht.info>
Patrick Mansfield <patmans@us.ibm.com>
Pierre Habouzit <madcoder@debian.org>
Stepan Kasal <kasal@ucw.cz>

Apologies if I missed anyone!


Global changes
--------------

gettimeofday.2
madvise.2
msgctl.2
select.2
semctl.2
shmctl.2
syslog.2
stat.2
a64l.3
printf.3
termios.3
xdr.3
sd.4
    mtk
        Minor wording changes.

obsolete.2
syscall.2
unimplemented.2
    mtk
        Added SEE ALSO reference to syscalls.2.


New pages
---------

sgetmask.2
    mtk
        A real man page for sgetmask(2) and ssetmask(2).
        (This page replaces a previous link of the same, which linked
        signal.2.)

spu_create.2
    Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
        Document the PowerPC SPU spu_create() system call.
        (Originally taken from the kernel source file
        Documentation/filesystems/spufs.txt.)

spu_run.2
    Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
        Document the PowerPC SPU spu_run() system call.
        (Originally taken from the kernel source file
        Documentation/filesystems/spufs.txt.)

spufs.7
    Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
        Document the PowerPC SPU file system.
        (Originally taken from the kernel source file
        Documentation/filesystems/spufs.txt.)


Removed Pages
-------------

__clone.2
    mtk
        This file was created by accident in 2.61, as a copy of clone.2.
        (it should have been a link to clone.2.)

obsolete.2
    mtk
        Details on this page are covered in syscalls.2 and in
        respective syscall man pages (stat.2, uname.2).

undocumented.2
    mtk
        This page is very out of date, and in any case difficult
        to maintain.  Information about undocumented system calls
        is maintained in the HOWTOHELP file, and probably in other 
        places soon.

killpg.3
    mtk
        This rather incomplete page seems unnecessary since there
        is a killpg.2.


New links
---------

chown32.2
fchown32.2
getegid32.2
geteuid32.2
getgid32.2
getgroups32.2
getresgid32.2
getresuid32.2
getuid32.2
lchown32.2
setfsgid32.2
setfsuid32.2
setgid32.2
setgroups32.2
setregid32.2
setresgid32.2
setresuid32.2
setreuid32.2
setuid32.2
    mtk
        Added as link to corresponding page without "32".

fcntl64.2
fstat64.2
fstatat64.2
fstatfs64.2
ftruncate64.2
getdents64.2
lstat64.2
pread64.2
pwrite64.2
sendfile64.2
stat64.2
statfs64.2
truncate64.2
    mtk
        Added as link to corresponding page without "64".

__clone2.2
clone2.2
    mtk
        Links to clone.2.

ugetrlimit.2
    mtk
        Link to getrlimit.2.

mq_notify.2
mq_open.2
mq_timedreceive.2
mq_timedsend.2
mq_unlink.2
    mtk
        Added as links to corresponding section 3 pages.

fadvise64.2
fadvise64_64.2
    mtk
        Links to posix_fadvise.2.

rt_sigaction.2
rt_sigpending.2
rt_sigprocmask.2
rt_sigtimedwait.2
    mtk
        Added as link to corresponding page without "rt_" prefix.

rt_sigqueueinfo.2
    mtk
        Link to sigqueue.2.

madvise1.2
tuxcall.2
vserver.2
    mtk / Ivana Varekova
        Link to unimplemented.2.


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

access.2
    mtk
        Fairly substantial rewrites of various parts,
        and a few additions.

chmod.2
    mtk
        Update SYNOPSIS to reflect the fact that fchmod(2) needs
        either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".

chown.2
    mtk
        Update SYNOPSIS to reflect the fact that fchmod(2) and lchown(2)
        need either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
        Added an example program.

killpg.2
    mtk
        Note that killpg() is actually a library function on Linux.

mmap.2
    mtk
        Added note that glibc mmap() wrapper nowadays invokes mmap2().

mmap2.2
    Ivana Varekova / mtk
        On most platforms the unit for 'offset' is 4096 bytes, not
        the system page size.
    mtk
        Rewrote NOTES to note that glibc mmap() wrapper nowadays
        invokes this system call.
    mtk
        Added an EXAMPLE program.

oldfstat.2
oldlstat.2
oldstat.2
    mtk
        Changed link to point to stat.2 (instead of obsolete.2).

olduname.2
oldolduname.2
    mtk
        Changed link to point to uname.2 (instead of obsolete.2).

sched_setaffinity.2
    Martin R<>hricht
        Added _GNU_SOURCE to SYNOPSIS.

semctl.2
    mtk
        Remove reference discussion of ipc(2), since none of the
        other System V IPC pages mention ipc(2).

semop.2
    mtk
        Add an example code segment.

shmctl.2
    mtk
        Add svipc(7) to SEE ALSO list.

sigaction.2
    mtk
        Reformatted tables as lists; other minor reformattings and
        wording changes.

sigqueue.2
    mtk
        Added info on rt_sigqueueinfo(2).

sigwaitinfo.2
    mtk
        Noted that sigwaitinfo() is a library function implemented on
        top of sigtimedwait().

ssetmask.2
    mtk
        Make this link point to new sgetmask.2 instead of signal.2.

stat.2
    mtk
        Add notes on the different system call interfaces that
        have appeared over time.

uname.2
    mtk
        Add notes on the different system call interfaces that
        have appeared over time.

unimplemented.2
    mtk
        Add vserver, madvise1 to NAME line.
        Removed SEE ALSO reference to obsolete.2.
    Ivana Varekova
        Add tuxcall to NAME line.

mktemp.3
    Patrick Mansfield
        Fix description of return value.

strcat.3
    Marc Boyer
        Minor fix to example program.

undocumented.3
    mtk
        Add section numbers to function names; remove some functions
        since they are documented.

proc.5
    mtk
        Update/correct text on /proc/malloc.
    mtk, after a note by Pierre Habouzit, and a few comments
            by Justin Pryzby
        Update description of /proc/PID/stat to match 2.6.21.
        See Debian bug 417933.

inotify.7
    mtk
        IN_DONT_FOLLOW and IN_ONLYDIR are only available from 2.6.15.

signal.7
    Stepan Kasal / mtk
        Note SIGRTMIN value depends on glibc.
    mtk
        Various rewrites and additions to the text in real-time signals.
        Add SEE ALSO reference to sgetmask.2.

svipc.7
    mtk
        Add ipc(2) to SEE ALSO.