==================== Changes in man-pages-3.53 ====================

Released: 2013-07-31, 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:

Al Viro <viro@ZenIV.linux.org.uk>
Andrey Vagin <avagin@openvz.org>
Benjamin Poirier <bpoirier@suse.de>
Chris Heath <chris@heathens.co.nz>
Chuck Coffing <clc@alum.mit.edu>
David Prévot <taffit@debian.org>
Denys Vlasenko <dvlasenk@redhat.com>
Dmitry V. Levin <ldv@altlinux.org>
Felix_Schulte@McAfee.com
graud@gmx.com
Michael Kerrisk <mtk.manpages@gmail.com>
Oleg Nesterov <oleg@redhat.com>
Peng Haitao <penght@cn.fujitsu.com>
Peter Schiffer <pschiffe@redhat.com>
Simon Paillard <spaillard@debian.org>
Vince Weaver <vincent.weaver@maine.edu>

Apologies if I missed anyone!


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

restart_syscall.2
    Michael Kerrisk
        New page for restart_syscall(2) system call


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

fchownat.2
    Michael Kerrisk
        Document AT_EMPTY_PATH

fstatat.2
    Michael Kerrisk
        Document AT_EMPTY_PATH

linkat.2
    Michael Kerrisk
        Document AT_EMPTY_PATH

open.2
    Michael Kerrisk [Al Viro]
        Document O_PATH
            See also https://bugzilla.redhat.com/show_bug.cgi?id=885740


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

clock_nanosleep.2
futex.2
nanosleep.2
poll.2
sigaction.2
sigreturn.2
signal.7
    Michael Kerrisk
        SEE ALSO: add restart_syscall(2)

open.2
    Michael Kerrisk [Geoffrey Thomas]
        Remove warning that O_DIRECTORY is only for use with opendir(3)
            O_DIRECTORY can also be used with, for example, O_PATH.

perf_event_open.2
    Vince Weaver
        Improve PERF_SAMPLE_BRANCH_STACK documentation
    Vince Weaver
        Fix indentation of the MMAP layout section
            The indentation of the MMAP layout section wasn't quite right.
            I think this improves things but I admit I'm not an expert at the
            low-level indentation directives.
    Vince Weaver
        Update PERF_IOC_FLAG_GROUP info
            It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9
            (in Linux 2.6.31, the initial perf_event release) until
            724b6daa1 (Linux 3.4).

            I've done some extensive kernel source code digging plus
            running tests of various kernels and I hope the info
            presented is accurate now.

            (Patch edited somewhat by mtk.)
    Vince Weaver
        Improve sysfs files documentation
            This improves the documentation of the various
            perf_event_open()-related sysfs files.

ptrace.2
    Denys Vlasenko  [Oleg Nesterov, Dmitry V. Levin]
        If SEIZE was used, initial auto-attach stop is EVENT_STOP
            For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
            is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.

            Mention the same thing again in the description of
            PTRACE_EVENT_STOP.
    Denys Vlasenko  [Oleg Nesterov, Dmitry V. Levin]
        Mention that PTRACE_PEEK* libc API and kernel API are different
    Denys Vlasenko  [Oleg Nesterov, Dmitry V. Levin]
        Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior

readlink.2
    Michael Kerrisk
        Document use of empty 'pathname' argument
    Michael Kerrisk
        Change error check in example program from "< 0" to "== -1"

setpgid.2
    Michael Kerrisk  [graud@gmx.com]
        s/SIGTSTP/SIGTTIN/ when discussing reads from terminal
            See https://bugzilla.kernel.org/show_bug.cgi?id=60504

clog2.3
    Michael Kerrisk
        Note that these functions are still not present in glibc 2.17

dirfd.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function dirfd() is thread safe.

div.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions div(), ldiv(), lldiv() and imaxdiv() are thread
            safe.

fabs.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions fabs(), fabsf() and fabsl() are thread safe.

fdim.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions fdim(), fdimf() and fdiml() are thread safe.

fflush.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function fflush() is thread safe.

finite.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions finite(), finitef(), finitel(), isinf(), isinff(),
            isinfl(), isnan(), isnanf() and isnanl() are thread safe.

flockfile.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions flockfile(), ftrylockfile() and funlockfile() are
            thread safe.

floor.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions floor(), floorf() and floorl() are thread safe.

resolv.conf.5
    Simon Paillard
        Explain how to set empty domain
            See http://bugs.debian.org/463575

capabilities.7
    Michael Kerrisk
        Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH

inotify.7
    Michael Kerrisk  [Felix_Schulte@McAfee.com]
        Clarify description of IN_MOVED_FROM and IN_MOVED_TO

man-pages.7
    Michael Kerrisk
        DESCRIPTION should note versions for new interface features or behavior

udp.7
    Benjamin Poirier
        Add missing #include directive
            Using the UDP_CORK socket option documented in udp.7 requires
            including <netinet/udp.h>.

ld.so.8
    Michael Kerrisk
        Rework rpath token expansion text
    Michael Kerrisk
        Describe $PLATFORM rpath token
    Michael Kerrisk
        Describe $LIB rpath token
    Michael Kerrisk
        Document LD_BIND_NOT
    Michael Kerrisk  [Simon Paillard]
        Add reference to pthreads(7) in discussion of LD_ASSUME_KERNEL

readlink.2
    Chuck Coffing
        Fix possible race condition in readlink.2 example
            I noticed that the example in the readlink.2 man pages does error
            checking for a race condition that would cause the value of the
            symbolic link to get larger.  However, it doesn't handle the
            opposite case, in which the value gets shorter.  (The NULL
            terminator is always set at the old, longer offset.)  This could
            cause the program to operate on uninitialized data.
