==================== Changes in man-pages-3.48 ====================

Released: 2013-03-05, 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:

Andrey Vagin <avagin@openvz.org>
Aristeu Rozanski <aris@ruivo.org>
Colin Walters <walters@verbum.org>
Cyril Hrubis <chrubis@suse.cz>
Cyrill Gorcunov <gorcunov@openvz.org>
Daniel P. Berrange <berrange@redhat.com>
David Prévot <taffit@debian.org>
D. Barbier <bouzim@gmail.com>
Denys Vlasenko <vda.linux@googlemail.com>
Flavio Leitner <fbl@redhat.com>
Graham Gower <graham.gower@gmail.com>
Ivana Varekova <varekova@redhat.com>
Kai Kunschke <kai@kunfoo.org>
Marcela Maslanova <mmaslano@redhat.com>
Marc Lehmann <debian-reportbug@plan9.de>
Marshel Abraham <Marshel.Abraham@in.bosch.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Nathan Stratton Treadway <kernelbugs@nathanst.com>
Pavel Emelyanov <xemul@parallels.com>
Peter Schiffer <pschiffe@redhat.com>
Simon Heimberg <simohe@besonet.ch>
Simon Paillard <spaillard@debian.org>
Török Edwin <edwintorok@gmail.com>
Ulrich Drepper <drepper@redhat.com>
Zack Weinberg <zackw@panix.com>

Apologies if I missed anyone!


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

getunwind.2
    Marcela Maslanova
        New page documenting getunwind(2)
            Taken from Red Hat downstream man pages set
    Michael Kerrisk
        Much rewriting
            Some text taken from arch/ia64/kernel/unwind.c.

perfmonctl.2
    Ivana Varekova
        New page documenting IA-64-specific perfmonctl(2)
            Taken from Red Hat downstream man pages
    Michael Kerrisk
        Rework discussion of PFM_CREATE_CONTEXT
        Add VERSIONS and CONFORMING TO
        Note that there is no glibc wrapper
        Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
            These don't exist, and it appears they never have.
        Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
            The types that were being used don't exist!
        Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL

gai.conf.5
    Ulrich Drepper
        New page documenting gai.conf
            Taken from Red Hat downstream pages

nss.conf.5
    Ulrich Drepper
        New page describing nss.conf


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

clock_getres.2
    Cyril Hrubis
        Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
    Cyril Hrubis
        Document CLOCK_BOOTTIME
    Michael Kerrisk
        Some improvements to CLOCK_BOOTTIME description

ptrace.2
    Denys Vlasenko
        Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
            Document PTRACE_GETREGSET, PTRACE_SETREGSET,
            PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.


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

fattach.2
fdetach.2
getmsg.2
isastream.2
putmsg.2
    Michael Kerrisk  [Peter Schiffer]
        New link to unimplemented.2
            Taken from Red Hat downstream.

            See https://bugzilla.redhat.com/show_bug.cgi?id=436407


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

Many pages
    Michael Kerrisk
        Global fix: remove unneeded double quotes in .SH headings

Many pages
    Michael Kerrisk
        Global fix: remove unneeded double quotes in .SS headings

Many pages
    Michael Kerrisk
        Global fix: use consistent capitalization in .SS headings
            Capitalization in .SS sections across pages (and sometimes even
            within a single page) is wildly inconsistent. Make it consistent.
            Capitalize first word in heading, but otherwise use lower case,
            except where English usage (e.g., proper nouns) or programming
            language requirements (e.g., identifier names) dictate otherwise.
Many pages
    Michael Kerrisk  [Denys Vlasenko]
        Remove double blank lines in output

Various pages
    Michael Kerrisk
        Fix order of SH sections


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

accept.2
    Michael Kerrisk
        NAME: Add "accept4"

access.2
    Colin Walters
        Note that access() may also fail for FUSE
            Since in some cases (e.g. libguestfs's guestmount) it also has the
            semantics where files can appear owned by root, but are actually
            mutable by the user, despite what one might infer from the Unix
            permissions.

getpeername.2
    Michael Kerrisk  [Kai Kunschke]
        Clarify semantics of getpeername() for datagram sockets
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034

getuid.2
    Michael Kerrisk
        Remove duplicate section heading

mmap.2
    Cyril Hrubis
        Add note about partial page in BUGS section
            This adds a note about Linux behavior with partial page at the end
            of the object. The problem here is that a page that contains only
            part of a file (because the file size is not multiple of PAGE_SIZE)
            stays in page cache even after the mapping is unmapped and the file
            is closed. So if some process dirties such page, other mappings
            will see the changes rather than zeroes.
    Michael Kerrisk  [Török Edwin]
        Some 'flags' values require a feature test macro to be defined
            Add text to NOTES noting that some MAP_* constants are
            defined only if a suitable feature test macro is defined.
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
    Cyril Hrubis
        Document EOVERFLOW error

open.2
    Michael Kerrisk
        Clarify list of file creation flags
            POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
            O_DIRECTORY, and O_NOFOLLOW are also in this list.

prctl.2
    Cyrill Gorcunov
        Add some details for PR_GET_TID_ADDRESS

read.2
    Michael Kerrisk  [Zack Weinberg]
        Clarify interaction of count==0 and error checking
            POSIX deliberately leaves this case open, so the man
            page should be less specific about what happens.

            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
    Michael Kerrisk  [Marc Lehmann]
        Remove crufty text about O_NONBLOCK on files
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
    Michael Kerrisk
        Clarify details for seekable files

unimplemented.2
    Michael Kerrisk  [Peter Schiffer]
        Add various STREAMS interfaces to NAME
            Taken from Red Hat downstream.

            See https://bugzilla.redhat.com/show_bug.cgi?id=436407

cexp2.3
    Michael Kerrisk
        Still does not exist in glibc 2.17

exit.3
    Michael Kerrisk
        Note that a call to execve() clears exit handler registrations

getaddrinfo.3
    Michael Kerrisk
        SEE ALSO: Add gai.conf(5)

malloc_trim.3
    Michael Kerrisk
        Remove duplicate section title

printf.3
    Marshel Abraham  [Graham Gower, Graham Gower]
        Fix error handling in example code
            See https://bugzilla.kernel.org/show_bug.cgi?id=23282

pthread_yield.3
    Michael Kerrisk  [Aristeu Rozanski]
        Add _GNU_SOURCE feature test macro to SYNOPSIS

resolver.3
resolv.conf.5
    Michael Kerrisk  [Nathan Stratton Treadway, Simon Heimberg]
        RES_DEBUG is only available if glibc is compiled with debug support
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
            and https://bugzilla.kernel.org/show_bug.cgi?id=43061

strtol.3
    Michael Kerrisk  [Peter Schiffer]
        Remove crufty text from previous fix

core.5
    Michael Kerrisk
        Document CONFIG_COREDUMP

capabilities.7
    Andrey Vagin
        Nonexistent bits are no longer shown as set in /proc/PID/status Cap*

inotify.7
    Michael Kerrisk
        A monitoring process can't easily distinguish events triggered by itself

ip.7
    Flavio Leitner  [Peter Schiffer]
        Improve explanation about calling listen() or connect()

man-pages.7
    Michael Kerrisk
        Describe rules for capitalization in .SS headings

rtnetlink.7
    Pavel Emelyanov
        Add info about ability to create links with given index
            Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
            values in ifi_index field. Mention this fact in the respective
            rtnetlink.7 section.

socket.7
    Pavel Emelyanov
        SO_BINDTODEVICE is now readable
            SO_BINDTODEVICE is readable since since kernel 3.8.
