==================== Changes in man-pages-4.06 ====================

Released: 2016-05-09, Oslo


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:

Alexander Miller <alex.miller@gmx.de>
Alon Bar-Lev <alon.barlev@gmail.com>
Benjamin Poirier <bpoirier@suse.com>
Christoph Hellwig <hch@lst.de>
Colin Ian King <colin.king@canonical.com>
Dr. Tobias Quathamer <toddy@debian.org>
Ed Avis <eda@waniasset.com>
Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
Heinrich Schuchardt <xypron.glpk@gmx.de>
Jakub Wilk <jwilk@jwilk.net>
Jordan Birks <birkses@hotmail.com>
Marko Myllynen <myllynen@redhat.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Nikola Forró <nforro@redhat.com>
Rasmus Villemoes <linux@rasmusvillemoes.dk>
Serge E. Hallyn <serge@hallyn.com>
Serge Hallyn <serge.hallyn@ubuntu.com>
Valery Reznic <valery_reznic@yahoo.com>
Zubair Lutfullah Kakakhel <Zubair.Kakakhel@imgtec.com>

Apologies if I missed anyone!


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

cgroups.7
    Serge Hally, Michael Kerrisk
        New page documenting cgroups

cgroup_namespaces.7
    Michael Kerrisk  [Serge Hallyn]
        New page describing cgroup namespaces


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

clone.2
    Michael Kerrisk
        Document CLONE_NEWCGROUP

setns.2
    Michael Kerrisk
        Document CLONE_NEWCGROUP

unshare.2
    Michael Kerrisk
        Document CLONE_NEWCGROUP


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

clock_getres.2
    Michael Kerrisk  [Rasmus Villemoes]
        Note that coarse clocks need architecture and VDSO support

clone.2
fork.2
    Nikola Forró
        Document ERESTARTNOINTR error code

clone.2
    Michael Kerrisk  [Colin Ian King]
        ERRORS: add EINVAL for improperly aligned 'child_stack' value

execve.2
    Michael Kerrisk  [Valery Reznic]
        Since Linux 2.6.28, recursive script interpretation is supported

fcntl.2
    Michael Kerrisk
        Note that mandatory locking is now governed by a configuration option

fsync.2
    Michael Kerrisk  [Georg Sauthoff]
        Give some examples of files where sync can fail with EINVAL

getrlimit.2
    Michael Kerrisk
        SEE ALSO: add cgroups(7)

ioctl_fat.2
    Heinrich Schuchardt
        Use %04x to print volume ID
            Leading zeroes should be used when display a FAT volume ID.

ioprio_set.2
    Michael Kerrisk
        SEE ALSO: add cgroups(7)

lseek.2
    Michael Kerrisk
        Note that 'off_t' is an integer data type defined by POSIX

memfd_create.2
    Michael Kerrisk
        Note that memfd_create() does not have a glibc wrapper

mount.2
    Michael Kerrisk
        MS_MANDLOCK requires CAP_SYS_ADMIN (since Linux 4.5)

quotactl.2
    Michael Kerrisk
        Document Q_GETNEXTQUOTA and Q_XGETNEXTQUOTA
    Michael Kerrisk
        Rework/reorder ERRORS list
            Make into a single alphabetically ordered list
    Michael Kerrisk
        Note kernel version that removed Q_GETSTATS
    Michael Kerrisk
        Add kernel version for G_GETINFO, Q_SETINFO, and Q_GETFMT

readv.2
    Christoph Hellwig
        Document preadv2() and pwritev2()
    Michael Kerrisk
        Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX

semctl.2
    Michael Kerrisk
        From kernel 4.6, Linux now updates 'sempid' on SETALL operations

sigaction.2
    Michael Kerrisk
        Document SEGV_BNDERR
    Michael Kerrisk
        Document SEGV_PKUERR

syscalls.2
    Michael Kerrisk
        Add preadv2() and pwritev2()

write.2
    Michael Kerrisk
        Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX

makedev.3
    Mike Frysinger
        Use <sys/sysmacros.h> in SYNOPSIS
            Defining these functions via <sys/types.h> causes problems for
            some folk. As noted by Zack Wein:

                libstdc++ force-enables _GNU_SOURCE, which means people
                writing in C++ _can't_ avoid these nonstandard macros by
                using a strict conformance mode.

            Since glibc has basically always used <sys/sysmacros.h>,
            update the docs to have people include that instead.
    Michael Kerrisk
        NOTES: mention that <sys/types.h> may also define these macros

popen.3
    Nikola Forró
        RETURN VALUE: describe successful case
            Reference:
            http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
            http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html

strtod.3
    Michael Kerrisk  [Ed Avis]
        Improve a detail in RETURN VALUE

core.5
    Michael Kerrisk
        Document /proc/sys/kernel/core_pipe_limit

locale.5
    Marko Myllynen
        Adjust LC_IDENTIFICATION / abbreviation
            Tiny tweak to locale.5 based on the on ISO/IEC TR 14652:

            http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf
    Marko Myllynen
        Update LC_ADDRESS after glibc change
            This patch updates locale.5 to match the recent glibc change
            in commit a837257199ffab76237385b830cc7b6179fc2f18
    Marko Myllynen
        Complete LC_COLLATE
            Here's the first attempt to (almost) complete the locale.5 manual
            page by documenting all (but perhaps one) of the missing
            LC_COLLATE keywords.
    Mike Frysinger
        country_car: Add a better description


nsswitch.conf.5
    Marko Myllynen
        Document group merging
            Document the recently merged glibc group merge support.
            Glibc commit ced8f8933673f4efda1d666d26a1a949602035ed
            https://sourceware.org/glibc/wiki/Proposals/GroupMerging

proc.5
    Michael Kerrisk
        Move /proc/PID/cgroup discussion to cgroups(7) page
    Michael Kerrisk
        Add some background on why /proc/PID/mountinfo was added
    Michael Kerrisk
        Improve description of /proc/PID/mountinfo 'root' field
    Michael Kerrisk
        Add pointer to cgroups(7) for documentation of /proc/cgroups
    Michael Kerrisk
        Add reference to core(5) for info on /proc/sys/kernel/core_pipe_limit

cpuset.7
    Michael Kerrisk
        SEE ALSO: add cgroups(7)

ip.7
    Benjamin Poirier
        Fix incorrect sockopt name
            "IP_LEAVE_GROUP" does not exist. It was perhaps a confusion with
            MCAST_LEAVE_GROUP. Change the text to IP_DROP_MEMBERSHIP which has
            the same function as MCAST_LEAVE_GROUP and is documented in the
            ip.7 man page.

            Reference:
            Linux kernel net/ipv4/ip_sockglue.c do_ip_setsockopt()

            Cc: Radek Pazdera <rpazdera@redhat.com>

namespaces.7
    Michael Kerrisk
        Add /proc/PID/mountinfo discussion under cgroup namespaces
            The discussion here is contingent on the acceptance of
            Serge Hallyn's patch, "mountinfo: implement show_path
            for kernfs and cgroup".
    Michael Kerrisk
        SEE ALSO: add cgroups(7), cgroup_namespaces(7)

vdso.7
    Zubair Lutfullah Kakakhel  [Mike Frysinger]
        Update for MIPS
            Document the symbols exported by the MIPS VDSO.
            VDSO support was added from kernel 4.4 onwards.

            See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso
    Michael Kerrisk  [Rasmus Villemoes]
        The __kernel_clock_* interfaces don't support *_COARSE clocks on PowerPC

ld.so.8
    Michael Kerrisk  [Alon Bar-Lev]
        Document use of $ORIGIN, $LIB, and $PLATFORM in environment variables
            These strings are meaningful in LD_LIBRARY_PATH and LD_PRELOAD.
