==================== Changes in man-pages-3.50 ====================

Released: 2013-03-15, 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>
Bernhard Kuemel <bernhard@bksys.at>
Elie De Brauwer <eliedebrauwer@gmail.com>
Erik Saule <erik.saule@bmi.osu.edu>
Florian Weimer <fweimer@bfk.de>
Friedrich Delgado Friedrichs <friedel@nomaden.org>
Jonathan Nieder <jrnieder@gmail.com>
Jose Luis Domingo Lopez <debian@24x7linux.com>
Mark R Bannister <mark@proseconsulting.co.uk>
Michael Kerrisk <mtk.manpages@gmail.com>
Sam Varshavchik <mrsam@courier-mta.com>
Simon Paillard <spaillard@debian.org>

Apologies if I missed anyone!


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

canonicalize_file_name.3
    Michael Kerrisk
        Rewrite page, adding much more detail


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

Various pages
    Michael Kerrisk
        Global fix: s/END_LICENSE/LICENSE_END/

Various pages
    Michael Kerrisk
        Global fix: s/bitmask/bit mask/


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

getent.1
    Mark R Bannister
        netgroup description incorrectly refers to initgroups

capget.2
    Michael Kerrisk
        Update URL for libcap

fork.2
    Michael Kerrisk
        Port access permission bits (ioperm()) are turned off in the child

futex.2
    Michael Kerrisk
        'timeout' is a minimum duration that the call will wait, not a maximum

ioperm.2
    Michael Kerrisk
        Note that iopl() level of 3 is needed to access ports
    Michael Kerrisk
        'num' is *bits* not bytes!
    Michael Kerrisk
        Linux 2.6.8 lifted the port limit to 65,536
            See http://article.gmane.org/gmane.linux.kernel/202624/
            From: Stas Sergeev <stsp <at> aknet.ru>
            Subject: [patch][rfc] Larger IO bitmap
            Date: 2004-05-07 19:55:03 GMT
    Michael Kerrisk
        ioperm() operates on the calling *thread* (not process)
    Michael Kerrisk
        Clarify meaning of 'turn_on' argument
            Plus form formatting fixes.
    Michael Kerrisk
        Clarify that default state of permission bits in child is off
    Michael Kerrisk
        NOTES: add mention of /proc/ioports
    Michael Kerrisk
        SEE ALSO: add outb(2)

iopl.2
    Michael Kerrisk
        CAP_SYS_RAWIO is required to *raise* the I/O privilege level
    Michael Kerrisk
        Clarify that the two least significant bits of 'level' are what matter
    Michael Kerrisk
        SEE ALSO: add outb(2)

syscalls.2
    Michael Kerrisk
        Add version information for all (other) syscalls
    Michael Kerrisk
        Add perfmonctl(2)

futimes.3
    Michael Kerrisk  [Jonathan Nieder]
        ERRORS: Add ENOSYS for lutimes()
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746

getpass.3
    Michael Kerrisk  [Erik Saule]
        Suggest use of the ECHO flag as an alternative
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261

realpath.3
    Michael Kerrisk
        Document GNU extensions for EACCES and ENOENT errors

stdarg.3
    Michael Kerrisk  [Friedrich Delgado Friedrichs]
        Describe va_copy()
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077

termios.3
    Michael Kerrisk  [Bernhard Kuemel]
        Mention that noncanonical mode does not do input processing
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854

random.4
    Elie De Brauwer
        Document write and document the ioctl interface of /dev/random
            The update consists out of two parts:
             - a minor thing which just documents what happens if a write to
               /dev/(u)random is performed, which is used in the example
               script but not explicitly mentioned.
             - the other (biggest) part is the documentation of the ioctl()
               interface which /dev/(u)random exposes. This ioctl() lives in
               drivers/char/random.c and the primitives can be found in
               include/linux/random.h

            One comment remains, there used to be an RNDGETPOOL ioctl() which
            disappeared in v2.6.9. I found two patches on the net:
            - http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
            - https://lkml.org/lkml/2004/3/25/168

            But as far as I can tell the first one got applied but the 2nd
            one seems more correct. The result is that even today one can
            still find traces of the RNDGETPOOL ioctl() in the header files.
            Is this there for historical reasons or because it might break
            userspace, even though using it will just give an EINVAL.

bootparam.7
    Jose Luis Domingo Lopez
        Document 'rootfstype' option
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014

capabilities.7
    Michael Kerrisk
        Add various pieces under CAP_SYS_RAWIO
            Info obtained by grepping the kernel source.
    Michael Kerrisk
        Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case

netlink.7
    Andrey Vagin
        Add a note about broadcast messages to multiple groups

socket.7
    Michael Kerrisk  [Florian Weimer]
        Define _GNU_SOURCE to obtain the definition of 'struct ucred'
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210