==================== Changes in man-pages-4.15 ====================

Released: 2018-02-02, Palo Alto

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:

Adam Liddell <ml+kernel.org@aliddell.com>

Andrea Parri <parri.andrea@gmail.com>

Andries E. Brouwer <Andries.Brouwer@cwi.nl>

Elie Roudninski <xademax@gmail.com>

Eric Benton <erbenton@comcast.net>

Florian Weimer <fweimer@redhat.com>

G. Branden Robinson <g.branden.robinson@gmail.com>

Jakub Wilk <jwilk@jwilk.net>

Joel Williamson <jwilliamson@carnegietechnologies.com>

John Hubbard <jhubbard@nvidia.com>

Jorgen Hansen <jhansen@vmware.com>

Keno Fischer <keno@juliacomputing.com>

Michael Kerrisk <mtk.manpages@gmail.com>

Michal Hocko <mhocko@kernel.org>

NeilBrown <neilb@suse.com>

Nikola Forró <nforro@redhat.com>

Nikolay Borisov <nborisov@suse.com>

Pradeep Kumar <pradeepsixer@gmail.com>

QingFeng Hao <haoqf@linux.vnet.ibm.com>

Ricardo Biehl Pasquali <pasqualirb@gmail.com>

roblabla <man-pages@roblab.la>

Roman Gushchin <guro@fb.com>

Shawn Landden <slandden@gmail.com>

Stefan Hajnoczi <stefanha@redhat.com>

Stefan Raspl <raspl@linux.vnet.ibm.com>

Tejun Heo <tj@kernel.org>

Apologies if I missed anyone!

New and rewritten pages

-----------------------

s390_sthyi.2

    QingFeng Hao  [Michael Kerrisk]

        New page for s390-specific s390_sthyi(2)

network_namespaces.7

    Michael Kerrisk

        New page describing network namespaces

            Based on content moved from namespaces(7)

    Michael Kerrisk

        Reorganize text

            No content changes...

    Michael Kerrisk

        When a NW namespace is freed, veth devices are destroyed

vsock.7

    Stefan Hajnoczi  [Jorgen Hansen, Michael Kerrisk]

        Document the VSOCK socket address family

Newly documented interfaces in existing pages

---------------------------------------------

cgroups.7

    Michael Kerrisk  [Tejun Heo]

        Document cgroups v2 "thread mode"

    Michael Kerrisk  [Tejun Heo]

        Document cgroup v2 delegation via the 'nsdelegate' mount option

    Michael Kerrisk

        Document the cgroup.max.depth and cgroup.max.descendants files

    Michael Kerrisk

        Document 'release_agent' mount option

    Michael Kerrisk  [Roman Gushchin]

        Document /sys/kernel/cgroup/delegate

    Michael Kerrisk  [Roman Gushchin]

        Document /sys/kernel/cgroup/features

    Michael Kerrisk  [Roman Gushchin]

        Document cgroups v2 cgroup.stat file

Global changes

--------------

Various pages

    G. Branden Robinson

        Standardize on "nonzero"

            Also add this term to the style guide in man-pages(7).

Changes to individual pages

---------------------------

bpf.2

    Nikolay Borisov

        Sync list of supported map types with 4.14 kernel

copy_file_range.2

    Michael Kerrisk

        Library support was added in glibc 2.27

    Shawn Landden

        glibc provides a user-space emulation where the system call is absent

    Florian Weimer

        EFBIG errors are possible, similar to write(2)

    Michael Kerrisk

        ERRORS: add EISDIR

    Michael Kerrisk

        Order ERRORS alphabetically

    Michael Kerrisk

        Add comment to code example explaining use of syscall(2)

fcntl.2

read.2

write.2

    NeilBrown

        Document "Lost locks" as cause for EIO.

            If an advisory lock is lost, then read/write requests on any

            affected file descriptor can return EIO - for NFSv4 at least.

memfd_create.2

    Michael Kerrisk

        glibc support for memfd_create() was added in version 2.27

mlock.2

    Michael Kerrisk

        Make details for MLOCK_ONFAULT a little more explicit

    Michael Kerrisk

        glibc support for mlock2() is added in version 2.27

mmap.2

    John Hubbard  [Michael Hocko]

        MAP_FIXED is no longer discouraged

            MAP_FIXED has been widely used for a very long time, yet the man

            page still claims that "the use of this option is discouraged".

    John Hubbard

        MAP_FIXED updated documentation

                -- Expand the documentation to discuss the hazards in

                   enough detail to allow avoiding them.

                -- Mention the upcoming MAP_FIXED_SAFE flag.

                -- Enhance the alignment requirement slightly.

mount.2

    Keno Fischer  [Michael Kerrisk]

        Add EINVAL error condition when MS_BINDing MNT_LOCKED submounts

mprotect.2

pkey_alloc.2

    Michael Kerrisk

        Glibc support for memory protection keys was added in version 2.27

perf_event_open.2

    Michael Kerrisk

        SEE ALSO: add perf(1)

pkey_alloc.2

    Michael Kerrisk

        Clarify description of pkey_alloc() 'flags' argument

prctl.2

    Michael Kerrisk

        Defer to capabilities(7) for discussion of the "keep capabilities" flag

recvmmsg.2

sendmmsg.2

    Nikola Forró

        Point out that error handling is unreliable

seccomp.2

    Michael Kerrisk

        Clarify that SECCOMP_RET_TRAP SIGSYS signal is thread-directed

syscalls.2

    Michael Kerrisk

        Add s390-specific s390_sthyi(2) to syscall list

unshare.2

    Michael Kerrisk

        Clarify the EUSERS occurred only until kernel 4.8

errno.3

    Michael Kerrisk

        'errno -s' can be used to search for errors by string in description

    Michael Kerrisk

        Add Linux error text corresponding to ENOMEM

fgetpwent.3

    Michael Kerrisk

        Add missing ATTRIBUTES preamble

fts.3

    Michael Kerrisk  [Pradeep Kumar]

        fts_pathlen = strlen(fts_path) + strlen(fts_name)

fuse.4

    Michael Kerrisk

        Places errors in alphabetical order (no content changes)

veth.4

    Michael Kerrisk

        Add network_namespaces(7)

sysfs.5

    Michael Kerrisk

        Refer to cgroups(7) for information about files in /sys/kernel/cgroup

capabilities.7

    Michael Kerrisk

        Note which capability sets are affected by SECBIT_NO_SETUID_FIXUP

            Note explicitly that SECBIT_NO_SETUID_FIXUP is relevant for

            the permitted, effective, and ambient capability sets.

    Michael Kerrisk

        Deemphasize the ancient prctl(2) PR_SET_KEEPCAPS command

            The modern approach is SECBITS_KEEP_CAPS.

    Michael Kerrisk

        Clarify effect of CAP_SETFCAP

            Make it clear that CAP_SETFCAP allows setting arbitrary

            capabilities on a file.

    Michael Kerrisk

        Clarify which capability sets are effected by SECBIT_KEEP_CAPS

            This flag has relevance only for the process permitted and

            effective sets.

    Michael Kerrisk

        Rephrase CAP_SETPCAP description

            * Mention kernel versions.

            * Place current kernel behavior first

    Michael Kerrisk

        SECBIT_KEEP_CAPS is ignored if SECBIT_NO_SETUID_FIXUP is set

    Michael Kerrisk

        Ambient set is also cleared when UIDs are set to nonzero value

cgroups.7

    Michael Kerrisk

        Add a more complete description of cgroup v1 named hierarchies

    Michael Kerrisk

        Add a section on unmounting cgroup v1 filesystems

    Michael Kerrisk

        Add subsection describing cgroups v2 subtree delegation

    Michael Kerrisk

        Mention ENOENT error that can occur when writing to subtree_control file

    Michael Kerrisk

        Add list of currently available version 2 controllers

    Nikolay Borisov

        Add information about RDMA controller

    Michael Kerrisk

        Rewrite the description of cgroup v2 subtree control

    Michael Kerrisk  [Tejun Heo]

        Note Linux 4.11 changes to cgroup v2 delegation containment rules

    Michael Kerrisk

        systemd(1) nowadays automatically mounts the cgroup2 filesystem

    Michael Kerrisk

        Clarify that cgroup.controllers is read-only

    Michael Kerrisk

        Elaborate a little on problems of splitting threads across cgroups in v1

    Michael Kerrisk  [Tejun Heo]

        Tweak the description of delegation of cgroup.subtree_control

ip.7

    Ricardo Biehl Pasquali

        INADDR_* values cannot be assigned directly to 's_addr'

    Michael Kerrisk

        s/INADDR_ANY/INADDR_LOOPBACK/ in discussion of htonl()

            INADDR_LOOPBACK is a better example, since it is not

            byte-order neutral.

namespaces.7

network_namespaces.7

    Michael Kerrisk

        Move content from namespaces(7) to network_namespaces(7)

pid_namespaces.7

    Michael Kerrisk

        SEE ALSO: add mount_namespaces(7)

sched.7

    Michael Kerrisk  [Andrea Parri]

        Correctly describe effect of priority changes for RT threads

            The placement of a thread in the run queue for its new

            priority depends on the direction of movement in priority.

            (This appears to contradict POSIX, except in the case of

            pthread_setschedprio().)

user_namespaces.7

    Michael Kerrisk

        Mention NS_GET_OWNER_UID ioctl() operation