Ready for 4.06

Removed trailing white space at end of lines

clock_getres.2, getrlimit.2, ioctl_fat.2, ioprio_set.2, quotactl.2, core.5, cpuset.7, vdso.7, ld.so.8: tstamp

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: Ready for 4.06

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: Note another of the benefits of cgroup namespaces

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: Add a little more detail in NOTES about remounting cgroupfs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: Minor fix to mount command

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: Minor improvement to description of cgroup namespaces

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: SEE ALSO: add cgroup_namespaces(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clone.2: Minor fix (page xref)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroup_namespaces.7: New page describing cgroup namespaces

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: Remove cgroup namespaces content to a separate page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: 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".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: Rework discussion of cgroup namespaces

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: Explain the more important benefit for cgroup namespaces

mtk: edited text supplied by Serge.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Remove redundant sentence

CONFIG_CGROUPS is already discussed elsewhere in the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Minor fix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Note other reasons why the hierarchy ID in /proc/cgroups may be 0

Reported-by: Serge Hallyn <serge.hallyn@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setns.2: Document CLONE_NEWCGROUP

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: Document CLONE_NEWCGROUP

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clone.2: Document CLONE_NEWCGROUP

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: Document cgroup namespaces (CLONE_NEWCGROUP)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

unshare.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: SEE ALSO: add systemd(1)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Add pointer to cgroups(7) for documentation of /proc/cgroups

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Document /proc/cgroups

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Enhance /proc/[pid]/cgroup description and add cgroups v2 details

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5, cgroups.7: Move /proc/PID/cgroup discussion to cgroups(7) page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: SEE ALSO: add clone(2)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Note kernel source files with further information on each v1 subsystem

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: wfix

Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>

cgroups.7: Note that one cannot remove filenames

Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>

cgroups.7: wfix

Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>

cgroups.7: wfix

Note though that I'm not sure about this.  Putting all the
cgroups under /sys/fs/cgroup is, i think, frowned upon now.
Certain lxc prefers mounts in a subdirectory of
/sys/fs/cgroup.

Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: SEE ALSO: add further entries

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Clarify some details of comounting all cgroup v1 hierarchies

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Note kernel version and configuration options for cgroups v1 controllers

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Add a section noting the "tasks" versus "processes" distinction

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Add a terminology subsection

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Add some text describing the progression from cgroups v1 to v2

And restructure the page a little to more clearly reflect the
v1 versus v2 differences.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Remove initial list of cgroup v1 subsystems

This list is repeated again later, and it doesn't really
help reader understanding to have the brief duplicate
list near the start of the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: List cgroups v1 controllers in order of implementation

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Add 'pids' controller

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: SEE ALSO: add cgroups(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

namespaces.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: SEE ALSO: add namespaces(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Formatting and wording fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: Add copyright and license

Switched to verbatim license after email discussion with Serge.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cgroups.7: New page document control groups (cgroups)

Just raw text at the moment. License, formatting,
and more text to come.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clone.2: ERRORS: add EINVAL for improperly aligned 'child_stack' value

As noted by Colin King:

    Currently, the aarch64 clone() system call requires the stack
    to be aligned at a 16 byte boundary, see
    arch/arm64/kernel/process.c, copy_thread():

        if (stack_start) {
                if (is_compat_thread(task_thread_info(p)))
                        childregs->compat_sp = stack_start;
                /* 16-byte aligned stack mandatory on AArch64 */
                else if (stack_start & 15)
                        return -EINVAL;
                else
                        childregs->sp = stack_start;
        }

    ..and returns -EINVAL if not aligned correctly.  This should
    be added to the manual page clone(2) as it took me a while to
    figure out why clone() was failing with -EINVAL for aarch64
    but not on x86.

Reported-by: Colin Ian King <colin.king@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

strtod.3: Improve a detail in RETURN VALUE

Reported-by: Ed Avis <eda@waniasset.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

popen.3: RETURN VALUE: describe successful case

Reference:
http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html

Signed-off-by: Nikola Forró <nforro@redhat.com>

locale.5: 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.

I think the LC_COLLATE section is still not enough to be used as
the only source when writing collation rules from scratch but
perhaps that's not even needed, it could be also thought that
the section 5 pages merely describe the format used in the files.
Naturally more information could be added later on top of this
patch.

Few notes:

- AFAICS coll_weight_max is not used anywhere in glibc
- I'm not aware of any C library implementation on Linux (for
  which this manual page would be relevant) which would
  implement the POSIX options not supported by glibc
- the glibc specific script keyword could still be documented

Sources:

http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html
http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf

PS. A couple of unrelated comment clean-ups slipped in as well,
sorry about those.

nsswitch.conf.5: Document group merging

Document the recently merged glibc group merge support.

https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=ced8f8933673f4efda1d666d26a1a949602035ed
https://sourceware.org/glibc/wiki/Proposals/GroupMerging

open.2: tfix

clone.2, fork.2: srcfix: Add commit ID for ERESTARTNOINTR error

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clone.2, fork.2: Document ERESTARTNOINTR error code

Since Linux 2.6.17, clone and fork syscalls return ERESTARTNOINTR
when interrupted by a signal before newly created process is added
to its process group.
This error code can only be seen by ptrace at syscall exit tracing.

The information was obtained from kernel source code:
http://bit.ly/24xdofn

Signed-off-by: Nikola Forró <nforro@redhat.com>

ioctl_fat.2: Use %04x to print volume ID

Leading zeroes should be used when display a FAT volume ID.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>

iconvconfig.8: Minor fix: improve readability

I had to read this paragraph twice to see the relevance (or,
actually, the lack of it). I think this tiny change makes the
page more readable.

execve.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Improve description of /proc/PID/mountinfo 'root' field

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Add some background on why /proc/PID/mountinfo was added

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fcntl.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

memfd_create.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cmsg.3: Minor cosmetic changes in example code

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cmsg.3: Minor cosmetic changes to example code

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fsync.2: Give some examples of files where sync can fail with EINVAL

Reported-by: Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ld.so.8: Document use of $ORIGIN, $LIB, and $PLATFORM in environment variables

These strings are meaningful in LD_LIBRARY_PATH and LD_PRELOAD.

Reported-by: Alon Bar-Lev <alon.barlev@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ld.so.8: wfix: remove redundant phrase

This point is already covered by the immediately following words

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Add reference to core(5) for info on /proc/sys/kernel/core_pipe_limit

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

core.5: Document /proc/sys/kernel/core_pipe_limit

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: Since Linux 2.6.28, recursive script interpretation is supported

Reported-by: Valery Reznic <valery_reznic@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

makedev.3: NOTES: mention that <sys/types.h> may also define these macros

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

makedev(3): 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.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Makefile: Drop compression support and 'screen' target

Compression is already handled properly by distros and
explicit support from the package is not desired nowadays.
The 'screen' target doesn't handle compressed files.
Removal suggested by Mike Frysinger.

Signed-off-by: Alexander Miller <alex.miller@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>