Commit Graph

18594 Commits

Author SHA1 Message Date
Oliver Ebert f38dfdf16a proc.5: Add KPF_BALLOON, KPF_ZERO_PAGE, and KPF_IDLE for /proc/kpageflags
See Linux commit 56873f43abdcd574b25105867a990f067747b2f4
and Linux commit f074a8f49eb87cde95ac9d040ad5e7ea4f029738

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:12 +02:00
Oliver Ebert d0ffc687c4 proc.5: tfix
See Linux commit 63f8e8d2a575ef62e5b705516b491a98a60517ff.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 08:17:56 +02:00
Michael Kerrisk ac0c9466d6 reboot.2: Fix bogus description of reboot() from non-initial PID namespace
The current text was confused (mea culpa). No signal is sent to
the init() process. Rather, depending on the 'cmd' given to
reboot(), the 'group_exit_code' value will set to either SIGHUP or
SIGINT, with the effect that one of those signals is reported to
wait() in the parent process.

See https://bugzilla.kernel.org/show_bug.cgi?id=195899

Reported-by: Michał Zegan <webczat_200@poczta.onet.pl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-24 11:06:04 +02:00
Michael Kerrisk ce08dedca4 lround.3: Clarify that lround() rounds *halfway cases" away from zero
See https://bugzilla.kernel.org/show_bug.cgi?id=194601

Reported-by: David Eckardt <david.eckardt@sociomantic.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-24 09:53:49 +02:00
Craig Ringer 404de594ff fsync.2: ERRORS: add ENOSPC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-24 09:44:48 +02:00
Michael Kerrisk e6bafbe601 getrandom.2: ERRORS: add ENOSYS
See https://bugzilla.kernel.org/show_bug.cgi?id=196883

Reported-by: Fabio Scotoni <fabio@esse.ch>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-24 09:40:43 +02:00
Michael Kerrisk 85f0310cb8 sysfs.5: Add a brief description of /sys/class/net
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 10:09:30 +02:00
Julien Gomes 13e69b6c6a openpty.3: tfix
Signed-off-by: Julien Gomes <julien@arista.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 10:04:56 +02:00
Michael Kerrisk 5ade353db4 memfd_create.2: Note the limit for size of 'name'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 0fd5731e6e memfd_create.2: Minor tweak: split EINVAL errors into separate entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 88aa124ab2 memfd_create.2: Minor reworking of Mike Kavetz''s patch
Move info about EINVAL error into ERRORS.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 589883606d memfd_create.2: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 4332849f41 memfd_create.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk d2cfa322a9 memfd_create.2: srcfix: rewrap source lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Mike Kravetz ce7fa2be52 memfd_create.2: Add description of MFD_HUGETLB (hugetlbfs) support
hugetlbfs support for memfd_create() was recently merged by Linus
and should be in the Linux 4.14 release.  To request hugetlbfs
support a new memfd_create() flag (MFD_HUGETLB) was added.

This patch documents the following commit:

commit 749df87bd7bee5a79cef073f5d032ddb2b211de8
Author: Mike Kravetz <mike.kravetz@oracle.com>
Date:   Wed Sep 6 16:24:16 2017 -0700

    mm/shmem: add hugetlbfs support to memfd_create()

Signed-off-by: Mike Kravetz <mike.kravetz@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk db419c969a sysfs.5: Add a description of /sys/kernel/mm/hugepages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk cf4a2cfb02 sysfs.5: Add a brief description of /sys/kernel/mm
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 59514c5619 sysfs.5: Add a brief explanation of /sys/kernel
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk c551100943 fexecve.3: Add some detail on the glibc implementation of fexecve() via execveat(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 136badedfd fexecve.3: Minor tweaks to Cristian's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Cristian Rodríguez b71753c1fc fexecve.3: fexecve() is now implemented with execveat(2), where available
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 997d21e192 prctl.2, hier.7: spfix: sharable-->shareable
Even in American English, it seems that "shareable"
is the more common form these days.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 2e510f32d1 mremap.2: BUGS: describe older behavior for old_size==0 on private mappings
Explain the older behavior, and why it changed. This is a
follow-up to Mike Kravetz's patch documenting the behavior
for old_size==0 with shared mappings.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 7d4bed40a2 mremap.2: Reformat EINVAL errors as a list
Make the information easier to parse...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk dd9e077103 mremap.2: Minor fixes to Mike's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 11e8c314c3 mremap.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Mike Kravetz aa002e8145 mremap.2: Add description of old_size == 0 functionality
Since at least the 2.6 time frame, mremap() would create a new
mapping of the same pages if 'old_size == 0'.  It would also leave
the original mapping.  This was used to create a 'duplicate
mapping'.

A recent change was made to mremap() so that an attempt to create a
duplicate a private mapping will fail.

Document the 'old_size == 0' behavior and new return code from
below commit.

    commit dba58d3b8c5045ad89c1c95d33d01451e3964db7
    Author: Mike Kravetz <mike.kravetz@oracle.com>
    Date:   Wed Sep 6 16:20:55 2017 -0700

        mm/mremap: fail map duplication attempts for private mappings

v2: Fix incorrect wording noticed by Jann Horn.
    Remove deprecated and memfd_create() discussion as
    suggested by Florian Weimer.

Reviewed-by: Florian Weimer <fweimer@redhat.com>
Reviewed-by: Jann Horn <jannh@google.com>
Signed-off-by: Mike Kravetz <mike.kravetz@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:08 +02:00
Michael Kerrisk 2c63b13e3d madvise.2: Some tweaks to Rik's MADV_WIPEONFORK patch
Reviewed-by: Rik van Riel <riel@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-20 08:26:34 +02:00
Rik van Riel 399f3e392b fork.2: Document effect of MADV_WIPEONFORK
Signed-off-by: Rik van Riel <riel@redhat.com>
Signed-off-by: Colm MacCárthaigh <colm@allcosts.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-20 08:26:34 +02:00
Rik van Riel c0c4f6c29c madvise.2: Document MADV_WIPEONFORK and MADV_KEEPONFORK
Add MADV_WIPEONFORK and MADV_KEEPONFORK documentation,
which has been merged for the 4.14 kernel.

While documenting what EINVAL means for MADV_WIPEONFORK,
I realized that MADV_FREE has the same thing going on,
so I documented EINVAL for both in the ERRORS section.

This patch documents the following kernel commit:

    commit d2cd9ede6e193dd7d88b6d27399e96229a551b19
    Author: Rik van Riel <riel@redhat.com>
    Date:   Wed Sep 6 16:25:15 2017 -0700

        mm,fork: introduce MADV_WIPEONFORK

Signed-off-by: Rik van Riel <riel@redhat.com>
Signed-off-by: Colm MacCárthaigh <colm@allcosts.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-20 08:26:24 +02:00
Mathieu Desnoyers b9aff60ed3 membarrier.2: Update example to take TSO into account
The existing example given specifically states that it focus on
x86 (TSO memory model), but gives a read-read vs write-write
ordering example, even though this scenario does not require
explicit barriers on TSO.

So either we change the example architecture to a weakly-ordered
architecture, or we change the example to a scenario requiring
barriers on x86.

Let's stay on x86, but provide a Dekker as example instead.

Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
CC: Michael Kerrisk <mtk.manpages@gmail.com>
CC: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Link: https://stackoverflow.com/questions/45970525/is-the-example-in-the-membarrier-man-page-pointless-in-x86
Link: https://lwn.net/Articles/573436/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-20 08:26:24 +02:00
Michael Kerrisk f63588bd36 madvise.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-20 08:26:24 +02:00
Michael Kerrisk 069d2f9aec open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 22:09:25 +02:00
Michael Kerrisk 4a3b9ffc46 open.2: By contrast with O_RDONLY, no file permissions are required for O_PATH
Note one of the significant advantages of O_PATH: many of the
operations applied to O_PATH file descriptors don't require
read permission, so there's no readon why the open() itself
should require read permission.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 22:08:26 +02:00
Michael Kerrisk f3cd742ceb open.2: Minor technical fix
In the discussion of O_PATH, make it completely obvious that
fchdir() file descriptor must refer to a directory.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 15:48:48 +02:00
Michael Kerrisk 0b79679dc8 statfs.2: Add some comments noting filesystems that are no longer current
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 14:37:13 +02:00
Michael Kerrisk d7fb74b417 statfs.2: Add comments describing a few filesystem types
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 14:37:13 +02:00
Michael Kerrisk 4c4fda8ac2 statfs.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 12:54:05 +02:00
Michael Kerrisk a710e35952 open.2: Change pathname used in discussion of rationale for openat()
/path/to/file is a little confusing as a pathname

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-18 14:55:11 +02:00
Michael Kerrisk ebab32e163 open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:51:25 +02:00
Michael Kerrisk e982cebf24 open.2: Mention O_PATH file descriptor use with fexecve(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:43:29 +02:00
Michael Kerrisk 046a128700 fexecve.3: O_PATH file descriptors are also usable with fexecve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:38:21 +02:00
Jakub Wilk 4db7389594 ldconfig.8: ffix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:13:55 +02:00
Jakub Wilk 3775c1ca40 seccomp.2: srcfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:13:03 +02:00
Jakub Wilk 6771ab48fe fallocate.2: srcfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:12:55 +02:00
Jakub Wilk 21b07f83c3 proc.5: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:12:08 +02:00
Jakub Wilk 2285c2c27f fcntl.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:11:57 +02:00
Jakub Wilk d0f1bf9a78 Changes.old: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:11:44 +02:00
Michael Kerrisk 3d5c9255d4 stat.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:10:57 +02:00
Michael Kerrisk 76e4954f4d stat.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:10:28 +02:00