Commit Graph

15622 Commits

Author SHA1 Message Date
Michael Kerrisk 43df1ab32c 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>
2016-05-09 23:08:53 +02:00
Michael Kerrisk b8355bfeac 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>
2016-05-09 23:08:53 +02:00
Michael Kerrisk 94eeedfd20 cgroups.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
Michael Kerrisk f0d27655d0 cgroups.7: List cgroups v1 controllers in order of implementation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
Michael Kerrisk 488c879a2f cgroups.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
Michael Kerrisk 0d29385896 cgroups.7: Add 'pids' controller
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
Michael Kerrisk 69c4753665 cgroups.7: SEE ALSO: add cpuset (7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
Michael Kerrisk ae9887ed8c cpuset.7: SEE ALSO: add cgroups(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:52 +02:00
Michael Kerrisk 35fae0aaa0 namespaces.7: SEE ALSO: add cgroups(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:52 +02:00
Michael Kerrisk 10f8f8cb75 namespaces.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:52 +02:00
Michael Kerrisk bbfdf727f8 cgroups.7: SEE ALSO: add namespaces(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:52 +02:00
Michael Kerrisk 21f0d132f3 cgroups.7: Formatting and wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:52 +02:00
Michael Kerrisk 014cb63b3c cgroups.7: Add copyright and license
Switched to verbatim license after email discussion with Serge.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:52 +02:00
Michael Kerrisk effa83cec8 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>
2016-05-09 23:08:52 +02:00
Michael Kerrisk c550a89728 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>
2016-05-09 23:06:27 +02:00
Michael Kerrisk 5c61e57f56 strtod.3: Improve a detail in RETURN VALUE
Reported-by: Ed Avis <eda@waniasset.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 22:53:25 +02:00
Nikola Forró ea5bce080a 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>
2016-05-09 22:45:36 +02:00
Marko Myllynen c9aec10afb 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.
2016-05-09 22:42:35 +02:00
Marko Myllynen a4f6f08769 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
2016-05-09 22:33:46 +02:00
Dr. Tobias Quathamer b31056e386 open.2: tfix 2016-05-09 22:32:35 +02:00
Michael Kerrisk 11a6d0506c clone.2, fork.2: srcfix: Add commit ID for ERESTARTNOINTR error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 22:31:01 +02:00
Nikola Forró 10e46057dd 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>
2016-05-09 22:30:34 +02:00
Heinrich Schuchardt 29ff7699b7 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>
2016-05-09 22:25:41 +02:00
Marko Myllynen b800a15b9d 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.
2016-05-09 22:23:30 +02:00
Michael Kerrisk d673870eba execve.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-08 17:41:26 +02:00
Michael Kerrisk 0f619d1f9e proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-07 07:59:09 +02:00
Michael Kerrisk 63ab29880e proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-07 07:52:46 +02:00
Michael Kerrisk 8d857fcb16 proc.5: Improve description of /proc/PID/mountinfo 'root' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-07 07:52:46 +02:00
Michael Kerrisk fb4bdaa1ea proc.5: Add some background on why /proc/PID/mountinfo was added
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-07 07:48:23 +02:00
Michael Kerrisk 7be43378e6 fcntl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-03 21:27:01 +02:00
Michael Kerrisk ba65cc12a8 memfd_create.2: Note that memfd_create() does not have a glibc wrapper
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-03 13:09:23 +02:00
Michael Kerrisk e57f8d34e4 memfd_create.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-03 12:45:16 +02:00
Michael Kerrisk 38f55864aa cmsg.3: Minor cosmetic changes in example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-22 15:38:49 +02:00
Michael Kerrisk 6cd7a2c6da cmsg.3: Minor cosmetic changes to example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-22 10:00:25 +02:00
Michael Kerrisk 03117dc0db 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>
2016-04-21 14:28:53 +02:00
Michael Kerrisk 0a8909c474 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>
2016-04-21 14:19:34 +02:00
Michael Kerrisk 71ffb3ed69 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>
2016-04-21 13:39:43 +02:00
Michael Kerrisk cf4e4d3419 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>
2016-04-21 11:22:14 +02:00
Michael Kerrisk d9f2d36adb core.5: Document /proc/sys/kernel/core_pipe_limit
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-21 11:22:14 +02:00
Michael Kerrisk 2a79c2ac32 execve.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-21 11:22:14 +02:00
Michael Kerrisk 246104f0bc 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>
2016-04-21 11:22:08 +02:00
Michael Kerrisk 85a4005516 makedev.3: NOTES: mention that <sys/types.h> may also define these macros
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-20 14:06:28 +02:00
Mike Frysinger 3350a86413 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>
2016-04-20 14:06:28 +02:00
Alexander Miller c1a2e851a1 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>
2016-04-20 14:06:00 +02:00
Michael Kerrisk 7d16624130 vdso.7: The __kernel_clock_* interfaces don't support *_COARSE clocks on PowerPC
Reported-by: Rasmus Villemoes <linux@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 16:23:56 +01:00
Michael Kerrisk c74bc51914 clock_getres.2: Note that coarse clock need architecture and VDSO support
Reported-by: Rasmus Villemoes <linux@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 16:23:51 +01:00
Jakub Wilk b155912e83 Changes.old: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 15:25:57 +01:00
Mike Frysinger cfc24701c0 locale(5): country_car: Add a better description
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 14:59:07 +01:00
Michael Kerrisk bfd08d7770 readv.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 14:57:34 +01:00
Michael Kerrisk 840dfaf0de readv.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-04-18 14:57:34 +01:00