Commit Graph

5986 Commits

Author SHA1 Message Date
Darrick J. Wong 9eb18e174c man2: New page documenting FICLONE and FICLONERANGE ioctls
Document the FICLONE and FICLONERANGE ioctls, formerly known as
the BTRFS_IOC_CLONE and BTRFS_IOC_CLONE_RANGE ioctls.

Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
2016-06-08 12:34:45 +02:00
Mitch Walker 7f891e5db7 add_key.2: Empty payloads are not allowed in user-defined keys
iBoth add_key and the utility "keyctl add" return EINVAL when
attempting to add a user key with an empty or NULL payload.

The manpage implies that this should be valid.

From my reading of the kernel source, this has not been possible
since at least linux kernel commit 1da177e4 (2.6.12-rc2 on
2005-04-16).

Until kernel commit cf7f601c,
security/keys/user_defined.c:user_instantiate returned -EINVAL
if datalen <= 0.  That commit only moved this behavior to a new
user_preparse function, where it remains today in b562e44f
(4.5.0 on 2016-03-13).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 11:56:58 +02:00
Jakub Wilk d1f84ed72a clone.2, confstr.3, hpsa.4, tcp.7: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-06-08 11:24:08 +02:00
Michael Kerrisk 9c2678e629 mount.2: MS_LAZYTIME and MS_RELATIME can be changed on remount
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-05 13:00:57 -05:00
Michael Kerrisk d8b67bc9b2 mount.2: Explicitly note that MS_DIRSYNC setting cannot be changed on remount
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-05 13:00:57 -05:00
Michael Kerrisk 014b17c608 mount.2: Remove version numbers attached to flags that are modifiable on remount
This information was simply bogus. Mea culpa.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-05 06:21:02 -05:00
Michael Kerrisk 9e1ae4f847 mount.2: Minor restructuring/rewording in ERRORS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:47:11 -05:00
Michael Kerrisk eac1e05005 mount.2: Document the MS_REC flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
Michael Kerrisk c8e5f55869 mount.2: Document flags used to set propagation type
Document MS_SHARED, MS_PRIVATE, MS_SLAVE, and MS_UNBINDABLE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
Michael Kerrisk 4a19136b83 mount.2: Note kernel version that added MS_MOVE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
Michael Kerrisk 74b46b5f77 mount.2: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:42:31 -05:00
Michael Kerrisk f429fadc96 mount.2: Restructure discussion of 'mountflags' into functional groups
The existing text makes no differentiation between different
"classes" of mount flags. However, certain flags such as
MS_REMOUNT, MS_BIND, MS_MOVE, etc. determine the general
type of operation that mount() performs. Furthermore, the
choice of which class of operation to perform is performed in
a certain order, and that order is significant if multiple
flags are specified. Restructure and extend the text to
reflect these details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 10:41:50 -05:00
Michael Kerrisk f54e02b4bf mount.2: Relocate text on multimounting and mount stacking to NOTES
The text was somewhat out of place in its previous location;
NOTES is a better location.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:28:06 -05:00
Michael Kerrisk b3ae9c7d6f mount.2: Move text describing 'data' argument higher up in page
In preparation for other reworking.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:25:56 -05:00
Michael Kerrisk 9792cd169c mount.2: Update example list of filesystem types
Put more modern examples in; remove many older examples.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:20:56 -05:00
Michael Kerrisk 52f00c053c mount.2: Relocate/demote/rework text on MS_MGC_VAL
The use of this constant has not been needed for 15 years now.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 07:20:56 -05:00
Michael Kerrisk 49f6854626 mount.2: Note the default treatment of ATIME flags during MS_REMOUNT
The behavior changed in Linux 3.17.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-04 06:57:44 -05:00
Michael Kerrisk f5da58a8f2 mount.2: Since Linux 2.6.26, bind mounts can be made read-only
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-03 11:12:31 -05:00
Michael Kerrisk 16008a4146 mount.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-03 11:05:44 -05:00
Michael Kerrisk 4014230990 mmap.2: EXAMPLE: for completeness, add munmap() and close() calls
Reported-by: Rahul Bedarkar <rahulbedarkar89@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-03 06:53:41 -05:00
Michael Kerrisk 69a7267960 get_mempolicy.2: Correct rounding to 'maxnodes' (bits, not bytes)
Reported-by: Jörn Engel <joern@purestorage.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-02 21:32:22 -05:00
Michael Kerrisk f9e2bea7ca get_mempolicy.2: Fix prototype for get_mempolicy()
In numaif.h, 'add' is typed as 'void *'

Reported-by: Jörn Engel <joern@purestorage.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-02 21:18:16 -05:00
Michael Kerrisk 1f7191bb03 open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-02 20:08:38 -05:00
Michael Kerrisk 27f5380d5c quotactl.2: 'dqb_curspace' is in bytes, not blocks
This error appears to have been injected into glibc
when copying some headers from BSD.

See https://bugs.debian.org/825548

Reported-by: Jacob Willoughby <jacob@spacemonkey.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-01 14:37:34 -05:00
Michael Kerrisk cd32ec849d wait.2: Since Linux 4.7, __WALL is implied if child being ptraced
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
Michael Kerrisk ff82608eb6 wait.2: waitid() now (since Linux 4.7) also supports __WNOTHREAD/__WCLONE/__WALL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
Michael Kerrisk 36c8e72131 recv.2: With pending 0-length datagram read() and recv() with flags == 0 differ
Quoting Tom:

The statement "With a zero flags argument, recv() is equivalent to
read(2)." is not correct. In the case of passing a UDP socket an
empty buffer the two calls differ. read(2) will be a noop (as it
rightly says in its manpage), but recv(2) will discard the
packet.

We ran into this in networkd, as we use FIONREAD to determine the
buffer size (and allocate the right buffer), so in case someone
passed us an empty packet we would end up in a busy loop when we
were using read(2).  Changing to recv(2) fixed the issue
[https://github.com/systemd/systemd/pull/3299].

Reported-by: Tom Gundersen <teg@jklm.no>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
Michael Kerrisk c3cfbeb992 recv.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:48 -05:00
Eric Biggers c89a9937ca open.2: Refer to correct functions in description of O_TMPFILE
Signed-off-by: Eric Biggers <ebiggers3@gmail.com>
2016-05-26 16:17:17 -05:00
Iustin Pop 42f194cf22 fnctl.2: tfix - remove duplicate paragraph in NOTES
This paragraph already appears above, right before the "File Locking"
one.

Signed-off-by: Iustin Pop <iustin@k1024.org>
2016-05-26 16:16:29 -05:00
Michael Kerrisk 0c00a52e49 umask.2: NOTES: Mention /proc/PID/status 'Umask' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-26 16:14:26 -05:00
Michael Kerrisk 5d92f6e91a mount.2: Clarify that MS_MOVE ignores remaining bits in 'mountflags'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-21 11:36:33 -05:00
Michael Kerrisk 59dea18e1d mount.2: Minor clarification to MS_BIND
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-21 11:35:55 -05:00
Omar Sandoval 373c8b2536 mount.2: MS_BIND still ignores mountflags
This is clear from the do_mount() function in the kernel as of v4.6.

Signed-off-by: Omar Sandoval <osandov@fb.com>
2016-05-21 11:28:35 -05:00
Michael Kerrisk 751de899b5 mount.2: Clarify that 'source' and 'target' are pathnames, and can refer to files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-19 13:13:54 +02:00
Marko Kevac 9aae8d48a7 memfd_create.2: tfix
This is patch for current master. Fixes small typo.

From 94292ebe260a64920c63fe64075e0fa636a126cb Mon Sep 17 00:00:00 2001
From: Marko Kevac <marko@kevac.org>
Date: Sun, 15 May 2016 23:56:34 +0300
Subject: [PATCH] memfd_create.2: tfix
2016-05-18 13:14:06 +02:00
Michael Kerrisk 2641953087 pwritev2.2: New link to readv(2)
This link should have been added in the previous release...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-16 22:20:14 +02:00
Michael Kerrisk 62bd1ef2e8 preadv2.2: New link to readv(2)
This link should have been added in the previous release...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-16 22:18:33 +02:00
Michael Kerrisk f516d6d979 fork.2: Add ENOMEM error for PID namespace where "init" has died
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-13 09:47:41 +02:00
Michael Kerrisk 4be9e801da mount.2: MS_NOSUID also disables file capabilities
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-10 20:01:10 +01:00
Michael Kerrisk 9f496381ef 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>
2016-05-09 23:37:59 +02:00
Michael Kerrisk b9fe4bc3d7 clone.2: Minor fix (page xref)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
Michael Kerrisk 46dd317603 setns.2: Document CLONE_NEWCGROUP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
Michael Kerrisk 216131bdf5 unshare.2: Document CLONE_NEWCGROUP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
Michael Kerrisk c5af067406 clone.2: Document CLONE_NEWCGROUP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
Michael Kerrisk 6881dc4717 unshare.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:54 +02:00
Michael Kerrisk 99851d8b2e getrlimit.2: SEE ALSO: add cgroups(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +02:00
Michael Kerrisk ae2ff8f944 ioprio_set.2: SEE ALSO: add cgroups(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-09 23:08:53 +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
Dr. Tobias Quathamer b31056e386 open.2: tfix 2016-05-09 22:32:35 +02:00