man-pages/Changes

==================== Changes in man-pages-3.36 ====================

Released: 2012-02-27, Christchurch


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:

Alain Benedetti <alainb06@free.fr>
carado <carado@savhon.org>
Christoph Hellwig <hch@lst.de>
Clemens Ladisch <clemens@ladisch.de>
David Prévot <taffit@debian.org>
Elie De Brauwer <eliedebrauwer@gmail.com>
Guillem Jover <guillem@hadrons.org>
Jessica McKellar <jesstess@mit.edu>
Josef Bacik <josef@redhat.com>
Junjiro Okajima <jro@mx3.ttcn.ne.jp>
Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Pat Pannuto <pat.pannuto@gmail.com>
Salvo Tomaselli <tiposchi@tiscali.it>
Simone Piccardi <piccardi@truelite.it>
Slaven Rezic <srezic@iconmobile.com>
starlight@binnacle.cx
Stephan Mueller <stephan.mueller@atsec.com>
Vijay Rao <vijay@portuosus.com>
Walter Haidinger <walter.haidinger@gmx.at>
Walter Harms <wharms@bfs.de>
Yang Yang <wdscxsj@gmail.com>

Apologies if I missed anyone!


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

sendmmsg.2
    Michael Kerrisk  [Stephan Mueller]
        New page for sendmmsg(2)
            Some pieces inspired by an initial attempt by Stephan Mueller.


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

fallocate.2
    Lucian Adrian Grijincu
        Document FALLOC_FL_PUNCH_HOLE
            FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
            for punching holes in the allocated space in a file.


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

dup.2
    Michael Kerrisk
        SYNOPSIS: Add "#include <fntl.h>" for O_* constants

fallocate.2
    Michael Kerrisk
        Substantial restructuring of DESCRIPTION
            The addition of a second class of operation ("hole punching")
            to the man page made it clear that some significant restructuring
            is required. So I substantially reworked the page, including the
            preexisting material on the default "file allocation" operation.
    Michael Kerrisk  [Josef Bacik]
        Add further details for FALLOC_FL_PUNCH_HOLE
    Michael Kerrisk
        ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE

fork.2
    Michael Kerrisk
        NOTES: Describe clone() call equivalent to fork()

fsync.2
    Christoph Hellwig
        Various improvements
            - explain the situation with disk caches better
            - remove the duplicate fdatasync() explanation in the NOTES
              section
            - remove an incorrect note about fsync() generally requiring two
              writes
            - remove an obsolete ext2 example note
            - fsync() works on any file descriptor (doesn't need to be
              writable); correct the EBADF error code explanation
    Michael Kerrisk  [Guillem Jover]
        Note that some systems require a writable file descriptor
            An edited version of Guillem Jover's comments:
            [While the file descriptor does not need to be writable on Linux]
            that's not a safe portable assumption to make on POSIX in general
            as that behavior is not specified and as such is
            implementation-specific. Some Unix systems do actually fail on
            read-only file descriptors, for example [HP-UX and AIX].

mount.2
    Michael Kerrisk  [Junjiro Okajima]
        Removed erroneous statement about MS_RDONLY and bind mounts

open.2
    Jessica McKellar
        Fix grammar in O_DIRECT description
            Some small grammar fixes to the O_DIRECT description.

pipe.2
    Michael Kerrisk  [Salvo Tomaselli]
        SYNOPSIS: Add "#include <fntl.h>" for O_* constants
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750

sched_rr_get_interval.2
    Clemens Ladisch
        Update notes on modifying quantum
            Since Linux 2.6.24, it is no longer possible to
            modify the SCHED_RR quantum using setpriority(2).
            (Slight edits to Clemens' patch by mtk.)
    Michael Kerrisk
        Reordered various pieces of text
    Michael Kerrisk
        Reworded text of ESRCH error

send.2
    Michael Kerrisk
        Add mention of sendmmsg(2)

sync.2
    Michael Kerrisk  [Simone Piccardi]
        PROTOTYPE: Fix return type of syncfs()

vfork.2
    Michael Kerrisk  [starlight@binnacle.cx]
        Clarify what is duplicated in the child
            Add some words to make it clear to the reader that vfork(),
            like fork(), creates duplicates of process attributes
            in the child.
    Michael Kerrisk
        Note clone() flags equivalent to vfork()
    Michael Kerrisk  [starlight@binnacle.cx, Mike Frysinger]
        Add some notes on reasons why vfork() still exists
    Michael Kerrisk  [starlight@binnacle.cx]
        Clarify that calling *thread* is suspended during vfork()
    Michael Kerrisk
        CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete

gets.3
    Michael Kerrisk
        Document C11 and glibc 2.16 changes affecting gets()

pthread_sigmask.3
    Michael Kerrisk  [Pat Pannuto]
        Fix comment that was inconsistent with code in example program

sem_wait.3
    Walter Harms
        EXAMPLE: Remove extraneous line of output from shell session

wcsnrtombs.3
wcsrtombs.3
wcstombs.3
    Michael Kerrisk
        Fix-ups for e9c23bc636426366d659809bc99cd84661e86464

core.5
    Michael Kerrisk  [Junjiro Okajima]
        Document %E specifier for core_pattern

passwd.5
    Michael Kerrisk  [Walter Haidinger]
        s/asterisk/asterisk (*)/ to improve clarity
    Michael Kerrisk
        Correct note on passwd field value when shadowing is enabled
            When password shadowing is enabled, the password field
            contains an 'x' (not a "8').

proc.5
    Elie De Brauwer
        Fix description of fourth field of /proc/loadavg
            SIgned-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>

resolv.conf.5
    Michael Kerrisk  [Slaven Rezic]
        Describe syntax used for comments
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994

feature_test_macros.7
    Michael Kerrisk
        Document _ISOC11_SOURCE

inotify.7
    Michael Kerrisk  [Yang Yang]
        Note that 'cookie' field is set to zero when unused

man.7
    Michael Kerrisk
        Various fixes for description of NAME section
            As noted by reporter:
            * The code sample given for the NAME section is incomplete because
              the actual content sample is not given.
            * Additionally, the description assumes that the item described is
              a command, which need not be the case.
            * The command makewhatis is not present on my system; the
              documented tool to create the whatis database is called mandb.
            * The description on .SH NAME in man(7) should either copy the
              relevant paragraph of lexgrog(1) or refer to it.

            Reported by: Kristof Zelechovski <giecrilj@stegny.2a.pl>