==================== Changes in man-pages-3.33 ====================

Released: 2011-09-16, Munich


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

The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes and ideas that have been
incorporated in changes in this release:

Akira Fujita <a-fujita@rs.jp.nec.com>
Alexander Schuch <Alex.Schuch@gmx.de>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Brian M. Carlson <sandals@crustytoothpaste.net>
Dan Jacobson <jidanni@jidanni.org>
Folkert van Heusden <folkert.mobiel@gmail.com>
Graham Gower <graham.gower@gmail.com>
Hendrik Jan Thomassen <hjt@atcomputing.nl>
Jan Engelhardt <jengelh@medozas.de>
Joey Adams <joeyadams3.14159@gmail.com>
Johannes Laire <johannes@laire.fi>
Jon Grant <jg@jguk.org>
Josh Triplett <josh@joshtriplett.org>
Konstantin Ritt <ritt.ks@gmail.com>
Luis Javier Merino <ninjalj@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Mikel Ward <mikel@mikelward.com>
Nick Black <dankamongmen@gmail.com>
Paul Evans <leonerd@leonerd.org.uk>
Petr Pisar <ppisar@redhat.com>
Przemyslaw Pawelczyk <przemyslaw@pawelczyk.it>
Regid Ichira <regid23@yahoo.com>
Reuben Thomas <rrt@sc3d.org>
Richard B. Kreckel <kreckel@ginac.de>
Ryan Mullen <rmmullen@gmail.com>
Sebastian Geiger <sbastig@gmx.net>
Sebastian Unger <sebunger@gmx.net>
Seonghun Lim <wariua@gmail.com>
Serge E. Hallyn <serge.hallyn@canonical.com>
Simon Cross <hodgestar@gmail.com>
Simon Paillard <spaillard@debian.org>
Stan Sieler <sieler@me.com>
Timmy Lee <scuttimmy@gmail.com>
Tolga Dalman <tolga.dalman@googlemail.com>
Tomislav Jonjic <jonjic@cs.unibo.it>
Yuri Kozlov <yuray@komyakino.ru>
Wei Luosheng <weiluosheng001@gmail.com>

Apologies if I missed anyone!


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

sync.2
    Michael Kerrisk
        Added new syncfs() system call
            syncfs() was added in Linux 2.6.39.


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

syncfs.2
    Michael Kerrisk
        New link for sync(2).


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

Various pages
    Simon Paillard
        Global fix:  properly escape minus sign


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

clone.2
    Michael Kerrisk
        Note that CLONE_STOPPED was removed in 2.6.38

execve.2
    Michael Kerrisk  [Sebastian Geiger]
        Note that the first argv[] value should contain name of executable

fcntl.2
    Michael Kerrisk  [Reuben Thomas]
        Note that F_GETFL also retrieves file access mode

getrlimit.2
    Michael Kerrisk  [Ryan Mullen]
        Remove mention of kernel versions in discussion RLIMIT_CPU
    Michael Kerrisk  [Seonghun Lim]
        Fix example program and add _FILE_OFFSET_BITS requirement

mlock.2
    Michael Kerrisk  [Brian M. Carlson]
        Clarify EINVAL error
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?625747
    Michael Kerrisk  [Seonghun Lim]
        Simplify and correct text for EPERM error

mprotect.2
    Seonghun Lim
        fix off-by-one error in a memory range
    Seonghun Lim
        Fix small bug in example program
            The description of the example program says that it makes the
            third page "read-only". Thus use PROT_READ instead of PROT_NONE.

open.2
    Folkert van Heusden
        Remove text describing O_CLOEXEC as Linux-specific
            O_CLOEXEC is specified in POSIX.1-2008, as noted
            elsewhere in the page.

readlink.2
    Michael Kerrisk  [Dan Jacobson]
        SEE ALSO: Add readlink(1)

sendfile.2
    Akira Fujita
        Since 2.6.33, 'out_fd' can refer to any file type
            Linux kernel commit cc56f7de7f00d188c7c4da1e9861581853b9e92f
            meant sendfile(2) can work with any output file.
    Michael Kerrisk
        Shift text on falling back to read()/write() to NOTES
    Michael Kerrisk  [Tolga Dalman]
        Remove mention of kernel version for 'in_fd' argument
    Tolga Dalman
        Add an explicit reference to splice(2)
            Unlike sendfile(), splice() can transfer data
            between a pair of sockets.

sigaction.2
    Michael Kerrisk  [Tolga Dalman]
        Add a little info about ucontext_t

stat.2
    Michael Kerrisk  [Jon Grant]
        Small rewording of ENAMETOOLONG error

sync.2
    Michael Kerrisk
        Some rewrites to description of sync()

syscalls.2
    Michael Kerrisk
        Added fanotify_init() and fanotify_mark() to syscall list
    Michael Kerrisk
        Added new 2.6.39 system calls
    Michael Kerrisk
        Updated for Linux 3.0 system calls
    Michael Kerrisk
        Update kernel version at head of syscall list
    Michael Kerrisk
        Update to mention 3.x kernel series

syslog.2
    Michael Kerrisk  [Serge E. Hallyn]
        Update for kernel 2.6.37 changes
            Document /proc/sys/kernel/dmesg_restrict.
            Document CAP_SYSLOG.

time.2
    Michael Kerrisk  [Alexander Schuch]
        NOTES: Fix description of "Seconds since the Epoch"

timerfd_create.2
    Michael Kerrisk  [Josh Triplett]
        Note behavior when timerdfd_settime() old_value is NULL
        See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
    Tomislav Jonjic
        Fix small error in description of timerfd_settime()

truncate.2
    Seonghun Lim
        Remove redundant EINTR description

unlink.2
    Hendrik Jan Thomassen
        Improve EBUSY description

cacos.3
cacosh.3
catan.3
catanh.3
    Michael Kerrisk  [Richard B. Kreckel, Andries Brouwer]
        Fix formula describing function
            The man pages for cacos(), cacosh(), catan(), catanh()
            contain incorrect formulae describing the functions.

cacos.3
    Michael Kerrisk
        Add example program

cacosh.3
    Michael Kerrisk
        Add example program

cacosh.3
casinh.3
catan.3
catanh.3
    Michael Kerrisk
        SEE ALSO: Add reference to inverse function

catan.3
    Michael Kerrisk
        Add example program

catanh.3
    Michael Kerrisk
        Add example program

ccos.3
ccosh.3
csin.3
csinh.3
ctan.3
ctanh.3
    Michael Kerrisk
        SEE ALSO Add reference to "arc" inverse function

cexp.3
    Michael Kerrisk
        SEE ALSO: add cexp(3)

clog.3
    Michael Kerrisk
        SEE ALSO: Add reference to clog(2)

crypt.3
    Michael Kerrisk  [Jan Engelhardt]
        Fix header file and feature test macro requirements for crypt_r()

err.3
    Seonghun Lim
        Clean up description of error message source
            In the second paragraph of DESCRIPTION section, one of the
            sources of error messages is incorrect: the four functions obtain
            error message only from errno, and "a code" is just relevant
            with errc() and warnc(), which are not present on Linux.
            see http://www.unix.com/man-page/freebsd/3/ERR/ .

            Then, the third paragraph becomes a duplicate.

fflush.3
    Regid Ichira
        Fix wording error
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?614021

hsearch.3
    Seonghun Lim
        Update ERRORS section
            EINVAL can occur for hdestroy_r().
            EINVAL can't occur for hcreate().
            Other minor fixes.

lockf.3
    Michael Kerrisk  [Mikel Ward]
        ERRORS: EBADF can also occur for nonwritable file descriptor
            As noted in the DESCRIPTION, the file descriptor must be writable
            in order to place a lock.

malloc.3
    Seonghun Lim
        Reorder prototypes in SYNOPSIS
            calloc() comes before realloc() in the other sections,
            so should do in SYNOPSIS, too.

mbstowcs.3
    Michael Kerrisk
        SEE ALSO: add reference to wcstombs(3)

memcmp.3
    Michael Kerrisk  [Sebastian Unger]
        Clarify that comparison interprets bytes as "unsigned char"

realpath.3
    Michael Kerrisk  [Seonghun Lim]
        Fix EINVAL error
            Since glibc 2.3, resolved_path can be non-NULL (with the
            semantics already documented in the page).

scandir(3)
    Mike Frysinger
        Add ENOENT/ENOTDIR errors

siginterrupt.3
    Michael Kerrisk  [Luis Javier Merino]
        Remove misleading sentence about signal(2) and system call interruption

strlen.3
    Michael Kerrisk  [Jon Grant]
        SEE ALSO: Add strnlen(3)

strnlen.3
    Michael Kerrisk  [Jon Grant]
        CONFORMING TO: Note that strnlen() is in POSIX.1-2008

strtoul.3
    Michael Kerrisk  [Tolga Dalman]
        Fix NOTES section constants

termios.3
    Michael Kerrisk
        Use "terminal special characters" consistently throughout page
    Michael Kerrisk  [Paul Evans]
        Add documentation of _POSIX_VDISABLE
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=627841
    Michael Kerrisk
        Add a description of STATUS character
    Michael Kerrisk
        Added description of SWTCH character
    Michael Kerrisk
        Add names of terminal special characters
    Michael Kerrisk
        List terminal special characters in alphabetical order

wcstombs.3
    Michael Kerrisk
        SEE ALSO: add mbstowcs(3)

console_codes.4
    Petr Pisar
        Add ESC [ 3 J
            Linux 3.0 (commit f8df13e0a901fe55631fed66562369b4dba40f8b)
            implements \E[3J to allow scrambling content of console
            including scroll-back buffer
            (http://thread.gmane.org/gmane.linux.kernel/1125792).

proc.5
    Michael Kerrisk  [Stan Sieler]
        Add description of 'PPid' field of /proc/PID/status
    Michael Kerrisk  [Stan Sieler]
        Add description of 'SigQ' field of /proc/PID/status

capabilities.7
    Michael Kerrisk  [Serge E. Hallyn]
        Document CAP_SYSLOG and related changes in Linux 2.6.37
    Michael Kerrisk
        File capabilities are no longer optional
            Starting with Linux 2.6.33, the CONFIG_SECURITY_FILE_CAPABILITIES
            has been removed, and file capabilities are always part of the
            kernel.

complex.7
    Michael Kerrisk
        Updated SEE ALSO list to include all complex math functions

ipv6.7
    Michael Kerrisk  [Simon Cross]
        Fix description of address notation: "8 4-digit hexadecimal numbers"

signal.7
    Seonghun Lim
        Remove crufty repeated info about LinuxThreads

unix.7
    Michael Kerrisk
        Add pointer to cmsg(3) for an example of use of SCM_RIGHTS
