Commit Graph

18591 Commits

Author SHA1 Message Date
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
NeilBrown 57bc46c231 stat.2: Correct AT_NO_AUTOMOUNT text and general revisions
Expand on the relationship between fstatat() and the other three
functions, and improve the description of AT_NO_AUTOMOUNT.
Specifically, both  stat() and lstat() act the same way with
respect to automounts, and that behavior matches fstatat() with
the AT_NO_AUTOMOUNT flag.

The text in the NOTES is removed and places with the text for
AT_NO_AUTOMOUNT to improve cohesion.

New text for a difference to be introduced in 4.14.

Cc: Ian Kent <ikent@redhat.com>
Signed-off-by: NeilBrown <neilb@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:07:36 +02:00
Michael Kerrisk d1304ede08 open.2: Note use of O_PATH to provide O_EXEC functionality
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:05:49 +02:00
Michael Kerrisk b9307a4a0b open.2: Minor reworking of O_PATH list to separate distinct system calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 14:58:26 +02:00