364270d01f
ioctl_userfaultfd.2: Rework version information for feature bits
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 10:39:34 +02:00
e81833beb2
userfaultfd.2: Minor fixes to Prakash Sangappa's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 10:37:29 +02:00
1df2779d72
ioctl_userfaultfd.2: Minor fixes to Prakash Sangappa's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 10:33:18 +02:00
2c371032cf
ioctl_userfaultfd.2, userfaultfd.2: Add description for UFFD_FEATURE_SIGBUS
...
Userfaultfd feature UFFD_FEATURE_SIGBUS was merged recently and
should be available in the Linux 4.14 release. This patch is for
the man page changes documenting this API.
Documents the following commit:
commit 2d6d6f5a09a96cc1fec7ed992b825e05f64cb50e
Author: Prakash Sangappa <prakash.sangappa@oracle.com>
Date: Wed Sep 6 16:23:39 2017 -0700
mm: userfaultfd: add feature to request for a signal delivery
Reviewed-by: Andrea Arcangeli <aarcange@redhat.com>
Reviewed-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Prakash Sangappa <prakash.sangappa@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 10:25:12 +02:00
9ea5bc667b
clone.2, getcpu.2, shmget.2, syscall.2, dladdr.3, proc.5, vdso.7: Consistently use "x86-64", not "x86_64"
...
When referring to the architecture, consistently use "x86-64",
not "x86_64". Hitherto, there was a mixture of usages, with
"x86-64" predominant.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
b219e68cfa
clone.2: Combine redundant paragraphs describing child_stack==NULL
...
Combine two redundant paragraphs (one of which I recently
added) describing child_stack==NULL for the raw system call.
Also, make sure this text is in a more obvious place than
its previous location.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:53:43 +02:00
1c173eb337
clone.2: Rework the discussion of the historical CLONE_PID for clarity
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
2551f80148
clone.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
e5f3df4833
clone.2: Remove a redundant paragraph
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
7495cbc7b3
clone.2: Eliminate some redundant phrasing in discussion of "fn()"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
4ba17a6deb
clone.2: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
1c6ebc4b4c
clone.2: Warn that the clone() wrapper modifies child_stack in the parent
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-17 22:24:49 +02:00
1874193ebf
clone.2: Add NOTES heading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-17 22:17:26 +02:00
d35f5c3402
clone.2: Note that child_stack can be NULL when using the raw system call
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-17 15:52:54 +02:00
161fce30ef
clone.2: Minor wording fix (in preparation for subsequent patch)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-17 15:51:43 +02:00
35bf8cb47f
clone.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-17 14:47:11 +02:00
dca5d444b3
madvise.2: Note fork() and execve() semantics for wipe-on-fork setting
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 21:43:00 +02:00
292e6c071c
fork.2: The MADV_WIPEONFORK setting is preserved in child of fork()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 21:26:53 +02:00
64f89da83f
fork.2: Minor reworking of MADV_WIPEONFORK text
...
The wipe-on-fork setting is specified on address ranges,
not mappings.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 21:24:06 +02:00
da06433e6d
getrlimit.2: Make it clear RLIMIT_NPROC is a limit on current number of processes
...
https://twitter.com/silentbicycle/status/893849097903505409
Reported-by: Scott Vokes <vokes.s@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 15:48:47 +02:00
63345f2229
getrlimit.2: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 15:35:47 +02:00
fe03cbd88e
shmop.2: Note that return value of shmat() is page-aligned
...
At the current man page for shmat(2)[1], there is no mentioning
whether the returned memory address of shmat(2) will be page size
aligned or not. As that is quite important to many applications(e.g.,
those that use locks heavily and would like to avoid some locks by
some atomic guarantees provided by the CPU), it would be great to
specify that for Linux.
I walked down the current implementation of shmat(2) in the latest
kernel src and found that shmat(2) does return a page size aligned
memory address:
SYSCALL_DEFINE3(shmat, int, shmid, char __user *, shmaddr, int, shmflg)
-> do_shmat(...)
-> do_mmap_pgoff(...)
-> do_mmap(...)
-> get_unmapped_area(...)
-> get_area(...) -> offset_in_page(addr)
there is a `offset_in_page(addr)' assertion at the end and if that is
true a -EINVAL would be returned, by which we can be sure that
shmat(2) will return a page size aligned memory address on success[2].
[1]: http://man7.org/linux/man-pages/man2/shmat.2.html
[2]: there is also a `offset_in_page(2)' in get_unmapped_area(...),
but that doesn't lead to -EINVAL...I am not sure whether the logic of
that code is right.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 10:26:10 +02:00
b739c378ff
shmop.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 23:36:56 +02:00
be98c938b5
sigaction.2: Mention that libc sets the act.sa_restorer field
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:48:40 +02:00
3ddb841ebb
sigaction.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:48:40 +02:00
7276186d6c
sigaction.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:48:40 +02:00
89559e3c1c
sigreturn.2: Minor fixes to description of sa_restorer field
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:48:34 +02:00
cc158fa3ac
sigreturn.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:30:05 +02:00
d03e0ad324
sigreturn.2: glibc has a simple wrapper for sigreturn() that returns ENOSYS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 13:05:56 +02:00
56f3b63bea
sigaction.2: Rework discussion of SA_SIGINFO handler arguments
...
Expand and rework the text a little, in particular adding
a reference to sigreturn(2) as a source of further
information about the ucontext argument.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 10:49:36 +02:00
dea3ec0c24
sigreturn.2: Make it a little clearer that a stack frame is created by the kernel
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 10:00:26 +02:00
e1846db58e
statfs.2: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-05 20:36:40 +02:00
ff8bc61434
flock.2: Placing an exclusive lock over NFS requires the file is open for writing
...
Reported-by: Petr Uzel <petr.uzel@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 15:28:59 +02:00
3b53a603c4
flock.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 15:28:30 +02:00
657a14bfa0
flock.2: Break NFS details int two separate paragraphs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 15:23:53 +02:00
50bfd0b3e2
flock.2: Move NFS details to a headed subsection
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 15:23:37 +02:00
b0ea1ea30d
prctl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 14:25:47 +02:00
4c3e123384
splice.2: Since Linux 2.6.31,'fd_in' and 'fd_out' may both refer to pipes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 14:13:56 +02:00
bf3e64ce7c
mremap.2: Update timestamp: review of new BUGS by Michal Hocko and Mike Kravetz
...
Reviewed-by: Mike Kravetz <mike.kravetz@oracle.com>
Reviewed-by: Michal Hocko <mhocko@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 23:38:35 +02:00
9ce1d9202d
sched_yield.2: sched_yield() is intended for use with real-time scheduling policies
...
Reported-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 22:43:30 +02:00
5c6f8de052
open.2: ERRORS: document EINVAL error for invalid filename
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 11:40:03 +02:00
cd37d57ed6
mkdir.2: ERRORS: document EINVAL error for invalid filename
...
Reported-by: Raghavendra D Prabhu <me@rdprabhu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 11:38:46 +02:00
c6822f6930
fsync.2, write.2: Minor tweaks to NeilBrown's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 18:17:01 +02:00
9c93cce7a7
write.2, fsync.2, close.2: update description of error codes
...
Since 4.13, errors from writeback are more reliably reported
to all file descriptors that might be relevant.
Add notes to this effect, and also add detail about ENOSPC and
EDQUOT which can be delayed in a similar many to EIO - for NFS
in particular.
Reviewed-by: Jeff Layton <jlayton@redhat.com>
Signed-off-by: NeilBrown <neilb@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 18:08:28 +02:00
bf1420bb85
fcntl.2: Inode read-write hints persist only until the filesystem is unmounted
...
Reported-by: Jens Axboe <axboe@kernel.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
6a11a5d439
open.2: Clarify that O_TMPFILE creates a *regular* file
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
ca20a8a5c8
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
431161696a
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
ef81e101f5
open.2: Make the purpose of open() a little clearer at the start of the page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
6f72cae5db
open.2: Make it explicit that O_CREAT creates a regular file
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
57c80845d0
getpid.2: Mention that PID == TGID, and note contrast with TID
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:08 +02:00
80b435e1ba
getpid.2: Minor wording fix: clarify that PID is the acronym for "process ID"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 09:13:09 +02:00
c9269da6d1
gettid.2: SEE ALSO: add getpid(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 09:08:23 +02:00
12fe9b1750
getpid.2: SEE ALSO: add gettid(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 09:07:47 +02:00
c8d6cd34da
sched_setaffinity.2: SEE ALSO: add numactl(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:56:44 +02:00
53506ea9c7
ptrace.2: SEE ALSO: add ltrace(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:37:43 +02:00
8abf3239a1
keyctl.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:33:03 +02:00
cd6d0def2f
copy_file_range.2: wfix: s/COPY/COPY_FILE_RANGE/ in .TH line
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:22:28 +02:00
b2bced6d6d
pivot_root.2: SEE ALSO: add switch_root(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 10:46:39 +02:00
ed36181160
reboot.2: SEE ALSO: add systemctl(1), systemd(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 10:39:01 +02:00
7445c301e3
reboot.2: SEE ALSO: remove reboot(8) (synonym for halt(8)); add shutdown(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 10:36:59 +02:00
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
404de594ff
fsync.2: ERRORS: add ENOSPC
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-24 09:44:48 +02:00
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
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
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
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
589883606d
memfd_create.2: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
4332849f41
memfd_create.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
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
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
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
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
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
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
11e8c314c3
mremap.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
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
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
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
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
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
f63588bd36
madvise.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-20 08:26:24 +02:00
069d2f9aec
open.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 22:09:25 +02:00
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
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
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
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
4c4fda8ac2
statfs.2: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-19 12:54:05 +02:00
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
ebab32e163
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:51:25 +02:00
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
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
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
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
3d5c9255d4
stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:10:57 +02:00
76e4954f4d
stat.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:10:28 +02:00
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
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
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
7680cb3eef
setns.2: SEE ALSO: add nsenter(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 12:09:14 +02:00
da874dc750
getrandom.2: tfix
...
Reported-by: Fabio Scotoni <fabio@esse.ch>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 16:59:06 +02:00
4b8c67d976
iconv.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, mtrace.1, pldd.1, sprof.1, time.1, _syscall.2, add_key.2, alloc_hugepages.2, arch_prctl.2, bpf.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_console.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kexec_load.2, keyctl.2, kill.2, link.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, open_by_handle_at.2, outb.2, perf_event_open.2, perfmonctl.2, personality.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readv.2, reboot.2, recv.2, recvmmsg.2, remap_file_pages.2, rename.2, request_key.2, restart_syscall.2, rt_sigqueueinfo.2, s390_pci_mmio_write.2, s390_runtime_instr.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, seccomp.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, sendmmsg.2, set_mempolicy.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigaltstack.2, signal.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, spu_create.2, spu_run.2, stat.2, statfs.2, statx.2, subpage_prot.2, swapon.2, symlink.2, sync.2, sync_file_range.2, syscall.2, syscalls.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timer_create.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, acos.3, acosh.3, adjtime.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, backtrace.3, basename.3, bindresvport.3, bsd_signal.3, bsearch.3, bswap.3, btree.3, byteorder.3, bzero.3, canonicalize_file_name.3, carg.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cfree.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, cmsg.3, confstr.3, copysign.3, cos.3, cosh.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, finite.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fopen.3, fopencookie.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, frexp.3, fseek.3, fseeko.3, ftime.3, fts.3, ftw.3, futimes.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getumask.3, getutent.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, initgroups.3, insque.3, intro.3, isalpha.3, isgreater.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, putgrent.3, putpwent.3, qsort.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, strcasecmp.3, strcat.3, strchr.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strftime.3, strptime.3, strsignal.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, unlocked_stdio.3, updwtmp.3, uselocale.3, usleep.3, wcrtomb.3, wcsdup.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctob.3, wcwidth.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console_codes.4, dsp56k.4, fuse.4, hd.4, hpsa.4, initrd.4, intro.4, loop.4, random.4, rtc.4, sd.4, sk98lin.4, st.4, wavelan.4, acct.5, core.5, elf.5, filesystems.5, host.conf.5, hosts.5, locale.5, nologin.5, proc.5, resolv.conf.5, rpc.5, slabinfo.5, utmp.5, aio.7, arp.7, bootparam.7, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cpuset.7, ddp.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, futex.7, inode.7, inotify.7, ip.7, ipv6.7, keyrings.7, locale.7, man-pages.7, man.7, math_error.7, mount_namespaces.7, mq_overview.7, namespaces.7, netdevice.7, netlink.7, packet.7, pipe.7, pkeys.7, pthreads.7, pty.7, raw.7, rtld-audit.7, rtnetlink.7, sched.7, session-keyring.7, signal.7, sock_diag.7, socket.7, spufs.7, suffixes.7, tcp.7, udp.7, udplite.7, unicode.7, units.7, unix.7, uri.7, user_namespaces.7, vdso.7, x25.7, xattr.7, iconvconfig.8, ld.so.8, ldconfig.8, sln.8: Update timestamps
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 12:44:56 +02:00
c0d3d8fe5c
getrlimit.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:33:02 +02:00
c87d084b87
getrlimit.2, mmap.2, malloc.3: RLIMIT_DATA affects mmap (2) since Linux 4.7
...
Starting with Linux kernel 4.5 and 84638335900f1995
(mm: rework virtual memory accounting) RLIMIT_DATA affects
mmap(2). With d977d56ce5b3e88 (mm: warn about VmData over
RLIMIT_DATA) only warnings are emmitted when going over the
specified RLIMIT_DATA in 4.5.
As of 4.7 and f4fcd55841fc9 (mm: enable RLIMIT_DATA by default
with workaround for valgrind) going over RLIMIT_DATA through
mmap(2) is forbidden.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:33:02 +02:00
d341ed5693
fcntl.2: Correct argument type for read-write hints
...
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:29:32 +02:00
dfea9e6262
fcntl.2: More fixes to Jens Axboe's text on read/write hints
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:29:26 +02:00
b9ef608731
fcntl.2: Various improvements to Jens Axboe's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
86b626e520
fcntl.2: Elaborate on the meaning of "write lifetime hints"
...
Cowritten-by: Jens Axboe <axboe@kernel.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
ccdfed50fc
fcntl.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
7b2316b859
fcntl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
c542a59fed
fcntl.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
580082a186
fcntl.2: Describe the set/get write hints commands that are added in Linux 4.13
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
ccf7d8ecb7
io_submit.2: Acknowledge possibility of short return
...
Note that the return value may be a value less than 'nr;`
if not all iocbs were queued at once.
Signed-off-by: Sage Weil <sage@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-14 14:41:31 +02:00
b2b2194236
fsync.2: tfix
...
man-pages version 4.13 as found on GitHub has an accidental deletion
introduced in 2021d0b3be
2017-09-14 14:33:36 +02:00
59e30f70a8
wait.2: POSIX.1-2008 TC1 clarifies treatment of 'si_pid' for waitid() WNOHANG
...
Reported-by: Ильдар Низамов <niya3@mail.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-14 12:35:29 +02:00
047013ac3e
socket.2: socket() uses the lowest available file descriptor
...
Reported-by: Yubin Ruan <ablacktshirt@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
2cf607f153
execve.2: SEE ALSO: add get_robust_list(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:12:38 +02:00
6e22a6063c
get_robust_list.2: Since Linux 2.6.28, robust futex lists also have an effect for execve(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:12:38 +02:00
30edf18762
get_robust_list.2: Clarify that "thread ID" means "kernel thread ID"
...
Prevent confused readers from thinking that we are talking about
POSIX thread IDs.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:12:38 +02:00
34821bdddc
get_robust_list.2: Detail the operation of robust futex lists
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:12:38 +02:00
ad5722b3e2
get_robust_list.2: SEE ALSO: add pthread_mutexattr_setrobust(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:12:38 +02:00
52428b024d
keyctl.2: Remove parentheses from the crypto API URL description
...
Those look unnecessary when rendered either as text or HTML.
* man2/keyctl.2 (.SH DESCRIPTION) <.TP .BR KEYCTL_DH_COMPUTE>:
Remove parentheses around "Kernel Crypto API Architecture".
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:29:18 +02:00
1a42b664f9
keyctl.2: mention keyctl_dh_compute(3) and keyctl_dh_compute_alloc (3)
...
These functions have been added in keyutils 1.5.10
(see commits v1.5.10~11 and v1.5.10~10).
* man2/keyctl.2 (.SH DESCRIPTION) <.TP .BR KEYCTL_DH_COMPUTE>:
Mention the keyctl_dh_compute/keyctl_dh_compute_alloc are
provided in keyutils library for the operation.
(.SH SEE ALSO): Add references to keyctl_dh_compute(3) and
keyctl_dh_compute_alloc(3).
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:20:16 +02:00
452308ea25
keyctl.2: srcfix: remove www.tmac inclusion
...
Commit man-pages-4.12-229-gdf81149 removed the only usage of .URL
macro (introduced in man-pages-4.12-228-ga02cbc7), so www.tmac is
not needed anymore.
* man2/keyctl.2 (.mso www.tmac): Remove it.
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:18:46 +02:00
5bbb004d32
unshare.2: Update pointer to in-kernel unshare documentation
...
Linux commit v4.12-rc1~137^2~33^2 converted unshare documentation
(previously resided in Documentation/unshare.txt) to ReStructured
format, along with relocating it to
Documentation/userspace-api/unshare.rst.
* man2/unshare.2 (.SH SEE ALSO): Amend pointer to
Documentation/unshare.txt with change introduced in Linux 4.14
(move to Documentation/userspace_api/unshare.rst).
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:51:54 +02:00
28d96036f2
prctl.2, seccomp.2: Update pointer to in-kernel seccomp documentation
...
Linux commit v4.13-rc1~34^2~40 converted seccomp documentation
(previously resided in Documentation/prctl/seccomp_filter.txt)
to ReStructured, along with relocating it to
Documentation/userspace-api/seccomp_filter.rst.
* man2/prctl.2 (.SH DESCRIPTION) <.TP .BR PR_SET_SECCOMP>: Amend
pointer to Documentation/prctl/seccomp_filter.txt with change
introduced in Linux 4.13 (move to
Documentation/userspace_api/seccomp_filter.rst).
* man2/seccomp.2 (.SH SEE ALSO): Likewise.
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:50:51 +02:00
a84a583004
prctl.2: Update pointer to in-kernel no_new_privs flag documentation
...
Linux commit v4.13-rc1~34^2~39 converted no_new_privs flag
documentation (previously resided in
Documentation/prctl/no_new_privs.txt) to ReStructured, along with
relocating it to
Documentation/userspace-api/no_new_privs.rst.
* man2/prctl.2 (.SH DESCRIPTION) <.TP .BR PR_SET_NO_NEW_PRIVS>:
Amend pointer to Documentation/prctl/no_new_privs.txt with
change introduced in Linux 4.13 (move to
Documentation/userspace-api/no_new_privs.rst).
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:50:10 +02:00
6744a5003b
prctl.2, ptrace.2: Update pointer to in-kernel Yama documentation
...
Linux commit v4.13-rc1~34^2~30 converted yama documentation
(previously resided in Documentation/security/Yama.txt) to
ReStructured, along with relocating it to
Documentation/amdin-guide/LSM/Yama.rst.
* man2/prctl.2 (.SH DESCRIPTION) <.TP .BR PR_SET_PTRACER>: Amend
pointer to Documentation/security/Yama.txt with change
introduced in Linux 4.13
(Documentation/admin-guide/LSM/Yama.rst).
* man2/ptrace.2 (.SS /proc/sys/kernel/yama/ptrace_scope):
Likewise.
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:46:47 +02:00
db8074da7f
add_key.2, request_key.2, keyrings.7: Update Linux documentation pointers
...
In 4.13 the release cycle, key management documentation has been
reformatted to ReStructured text and moved to a separate
"keys" directory.
Relevant kernel commits: v4.13-rc1~34^2~27, v4.13-rc1~34^2~25
* man2/add_key.2 (.SH SEE ALSO): Amend pointers to
Documentation/security/keys.txt and Documentation/keys-request-key.txt
with changes introduced in Linux 4.13 (Documentation/keys/core.rst and
Documentation/keys/request-key.rst).
* man2/request_key.2 (.SH SEE ALSO): Likewise.
* man7/keyrings.7 (.SH SEE ALSO): Likewise.
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:41:58 +02:00
4a19240db7
sysfs.2: Make it clearer near the start of the page that sysfs(2) is obsolete
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:17:17 +02:00
13752de138
sysfs.2: Add a pointer to sysfs(5) to help possibly confused readers
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:17:17 +02:00
7048a9fc8e
getrandom.2: SYNOPSIS: make return type of getrandom() 'ssize_t'
...
This accords with glibc headers and the Linux kernel source.
Reported-by: Fabio Scotoni <fabio@esse.ch>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 07:42:53 +02:00
2021d0b3be
fsync.2: Minor text reworking
...
Move the discussion of fsync() and metadata into a separate
paragraph to make the point more obvious.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 07:31:35 +02:00
296951cfd5
fsync.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 07:28:31 +02:00
e931e0355f
mprotect.2: Add warning about the use of printf() in the example code
...
Reported-by: Shrikant Giridhar <shrikantgiridhar@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-09 07:45:57 +02:00
bf27fd0a15
timer_create.2: Strengthen the warning about use of printf() in the example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-09 07:43:14 +02:00
994e9b46f5
timer_create.2: Update cross reference: signal(7) should be signal-safety(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-09 07:37:20 +02:00
6edadda685
request_key.2, statx.2, pthreads.7: Fix order of SEE ALSO entries
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 21:10:48 +02:00
d64b372593
add_key.2, backtrace.3, syslog.3: Fix misordered SEE ALSO entries
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 21:06:48 +02:00
3b3b8d5dcc
getdents.2, ioctl_fat.2, mkdir.2, process_vm_readv.2, get_phys_pages.3, nextup.3, operator.7: srcfix: fix unbalanced .nf/.fi pairs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 20:43:22 +02:00
d773899bf7
access.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 20:40:03 +02:00
a3847715fe
clock_getres.2, ctime.3, tgamma.3: srcfix: fix unbalanced .RS/.RE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 20:38:25 +02:00
e5efbe9106
ioctl_userfaultfd.2: Fix misordering of sections
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 18:05:06 +02:00
e89b82b758
ioctl_ns.2: Fix misordering of sections
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 18:04:14 +02:00
1172adfab5
ioctl_iflags.2: Fix misordering of sections
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 18:03:13 +02:00
21f685fd8f
request_key.2: wfix: /etc/request-keys.conf -> /etc/request-key.conf
...
Signed-off-by: Li Zhijian <lizhijian@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 09:36:44 +02:00
0e840b4234
keyctl.2: Minor fixes to Eugene's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 13:27:56 +02:00
54d5a1c72b
keyctl.2: Document the KEYCTL_RESTRICT_KEYRING operation
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 13:18:44 +02:00
8a351f8497
getrlimit.2: Note that RLIMIT_AS and RLIMIT_DATA are rounded down to system page size
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 04:06:51 +02:00
b50667ac6d
getrlimit.2: Mention unit for RLIMIT_DATA
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:48:39 +02:00
4a63f626b5
getrlimit.2: Mention unit used by RLIMIT_CORE and RLIMIT_FSIZE
...
It would have been obvious that these limits are in bytes, except that
"ulimit -a" in at least bash, dash and zsh says that they're in blocks.
This confused me, so I had to check the kernel source code.
My understanding is that they are indeed in bytes, so mention this
information in the man page.
Signed-off-by: Thiago Jung Bauermann <bauerman@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:45:56 +02:00
df81149955
keyctl.2: Minor fixes to Eugene's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:41:42 +02:00
a02cbc788b
keyctl.2: Document the ability to provide KDF parameters in KEYCTL_DH_COMPUTE
...
Acked-by: Stephan Müller <smueller@chronox.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:28:50 +02:00
e937944e81
keyctl.2: Mention ENOMEM in ERRORS
...
This one is not very specific, as memory allocations are scattered across
the code, so let's put some generic description here.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:24:42 +02:00
954be1b921
keyctl.2: Minor tweaks to Eugene's patch (mention old keys.txt file)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:18:48 +02:00
f17b3bd8ee
keyctl.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:17:52 +02:00
514c8256cc
keyctl.2: Update kernel documentation path reference
...
It has been changed in b68101a1e8f0263dbc7b8375d2a7c57c6216fb76
(Linux 4.13).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:16:46 +02:00
8a156aca74
keyctl.2: wfix: change "is" to "was" in error descriptions
...
Since half of items used "was" and another half used "is".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:13:53 +02:00
d754b76ddc
ioctl_tty.2: Elaborate a little on the rationale for TIOCGPTPEER
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-28 21:20:31 +02:00
e3f77df9dc
ipc.2: SEE ALSO: add svipc(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 20:48:00 +02:00
cf9c395834
ipc.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 20:47:45 +02:00
36454047ec
stat.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-24 12:58:47 +02:00
06ad9290b7
ioctl_getfsmap.2: Correct semantics of FMR_OF_LAST flag
...
The FMR_OF_LAST flag is applied to the last record in the returned
data set, which is not necessarily the last record in the
filesystem. Correct the documentation to reflect the actual
behavior of both getfsmap implementations.
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-24 00:32:44 +02:00
f211b01b0e
move_pages.2: Improve Otto Ebeling's description of the changed permission rules
...
The manual page should still document the historical behavior,
and the permission check should be phrased in terms of a
ptrace access mode check.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-22 01:44:46 +02:00
18997ae323
move_pages.2: Minor text reorganization
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-22 01:33:14 +02:00
b506c58da4
move_pages.2: Note permission changes that occurred in Linux 4.13
...
I recently reported a security bug to the kernel that caused a
change to be made to the move_pages syscall (kernel commit
197e7e521384a23b9e585178f3f11c9fa08274b9), the attached patch
updates the man page to match the new behavior.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-22 01:29:30 +02:00
ebbb532ea0
utime.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:30:48 +02:00
d22c843749
s390_pci_mmio_write.2, sched_setscheduler.2, select.2, select_tut.2, shmctl.2, stat.2, sysctl.2, syslog.2, time.2, ustat.2, utime.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:30:21 +02:00
da3d3314cf
rt_sigqueueinfo.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:27:32 +02:00
7ce52638ce
kill.2, listen.2, mremap.2, readv.2, recvmmsg.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:27:16 +02:00
c65b10e6b6
getsockopt.2, ioctl_fat.2, kexec_load.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:26:17 +02:00
168c21d4b4
getrlimit.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:25:03 +02:00
74e4ecffe4
getitimer.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:24:31 +02:00
9d158688d7
ipc.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:24:04 +02:00
b9c93deb3d
getgroups.2, getrlimit.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, semop.2, difftime.3, getpw.3, malloc_hook.3, mbrtowc.3, newlocale.3, offsetof.3, pthread_tryjoin_np.3, rand.3, rtnetlink.3, setbuf.3, strtol.3, fuse.4, feature_test_macros.7, pkeys.7: ffix: fix mismatched .EX/.EE tags
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 22:16:47 +02:00
d2fdb1e30a
memusage.1, time.1, ioctl_console.2, mmap.2, msync.2, perf_event_open.2, syslog.2, strptime.3, hd.4, sd.4: Use en-dash for ranges
...
Based on a patch by Bjarni Ingi Gislason.
Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:42:31 +02:00
ba4924aab6
perf_event_open.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:39:41 +02:00
5383b93b91
perf_event_open.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:36:29 +02:00
c788525612
getrlimit.2, signalfd.2, statfs.2, tee.2, dlopen.3, duplocale.3, ftw.3, get_nprocs.3, mbstowcs.3, posix_spawn.3, strftime.3, full.4, fanotify.7, inotify.7, ip.7, netdevice.7, rtld-audit.7, unix.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:02:23 +02:00
408731d435
intro.1, locale.1, ioctl_list.2, listxattr.2, memfd_create.2, nfsservctl.2, open_by_handle_at.2, perf_event_open.2, poll.2, process_vm_readv.2, ptrace.2, select.2, select_tut.2, semop.2, sendmmsg.2, shmget.2, sigaction.2, spu_run.2, umask.2, wait4.2, nan.3, setlocale.3, feature_test_macros.7, glob.7, posixoptions.7, rtld-audit.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
207050fa9e
_syscall.2, shmget.2, stat.2, syscall.2, sysctl.2, utimensat.2, wait.2, CPU_SET.3, a64l.3, alloca.3, atexit.3, basename.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, ccos.3, ccosh.3, cexp.3, cimag.3, clearenv.3, clog.3, conj.3, cosh.3, creal.3, csin.3, csinh.3, ctan.3, ctanh.3, difftime.3, div.3, dl_iterate_phdr.3, encrypt.3, envz_add.3, expm1.3, fenv.3, fmtmsg.3, fopen.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getcontext.3, getline.3, getpt.3, getpwnam.3, getsubopt.3, getttyent.3, getutent.3, hsearch.3, log1p.3, malloc_hook.3, malloc_info.3, mallopt.3, matherr.3, mbsinit.3, mempcpy.3, mtrace.3, nan.3, nl_langinfo.3, printf.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, sigvec.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
0a92ddef8b
_syscall.2: Remove redundant comment from EXAMPLE
...
A discussion of the nroff source of the manual
page isn't very useful...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
b8302363ed
execve.2, ioctl_console.2, ioctl_iflags.2, ioctl_ns.2, ioctl_userfaultfd.2, kcmp.2, kexec_load.2, keyctl.2, link.2, listxattr.2, membarrier.2, memfd_create.2, mmap.2, modify_ldt.2, mprotect.2, msgctl.2, nanosleep.2, open_by_handle_at.2, perf_event_open.2, poll.2, posix_fadvise.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, readdir.2, readv.2, recv.2, recvmmsg.2, request_key.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setscheduler.2, seccomp.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendmmsg.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sigaltstack.2, signal.2, sigwaitinfo.2, stat.2, statfs.2, statx.2, sync_file_range.2, syscall.2, sysctl.2, sysinfo.2, tee.2, timer_create.2, timer_settime.2, timerfd_create.2, unshare.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, aio_init.3, backtrace.3, basename.3, bswap.3, btree.3, clock_getcpuclockid.3, cmsg.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlinfo.3, dlopen.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, ether_aton.3, fgetgrent.3, fgetpwent.3, fmemopen.3, frexp.3, ftime.3, fts.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getmntent.3, getnameinfo.3, getnetent.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallinfo.3, malloc_info.3, mallopt.3, matherr.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, ntp_gettime.3, posix_openpt.3, printf.3, pthread_attr_init.3, pthread_attr_setschedparam.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_tryjoin_np.3, readdir.3, realpath.3, recno.3, regex.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, statvfs.3, strcat.3, strcpy.3, strftime.3, strtok.3, strtol.3, strverscmp.3, toupper.3, ttyslot.3, xdr.3, fuse.4, loop.4, rtc.4, st.4, acct.5, core.5, elf.5, slabinfo.5, aio.7, arp.7, capabilities.7, cgroup_namespaces.7, cgroups.7, ddp.7, fanotify.7, feature_test_macros.7, inode.7, inotify.7, ip.7, keyrings.7, locale.7, mount_namespaces.7, namespaces.7, netdevice.7, netlink.7, packet.7, pkeys.7, pthreads.7, sched.7, session-keyring.7, sock_diag.7, socket.7, spufs.7, udplite.7, unix.7, user_namespaces.7, vdso.7, x25.7, ld.so.8: Use consistent markup for code snippets
...
Change .nf/.fi to .EX/.EE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
7a34607716
clone.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:26 +02:00
e646a1bad9
ioctl_console.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, kcmp.2, kexec_load.2, keyctl.2, link.2, mmap.2, modify_ldt.2, msgctl.2, poll.2, query_module.2, quotactl.2, recv.2, recvmmsg.2, sched_setscheduler.2, seccomp.2, select.2, semctl.2, semop.2, send.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sysinfo.2, timer_create.2, timerfd_create.2, uname.2, unshare.2, userfaultfd.2, ustat.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, backtrace.3, bswap.3, btree.3, clock_getcpuclockid.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dlinfo.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, fmemopen.3, fopencookie.3, frexp.3, fts.3, ftw.3, getaddrinfo.3, getaddrinfo_a.3, getcontext.3, getgrouplist.3, getifaddrs.3, getipnodebyname.3, getnameinfo.3, getopt.3, getprotoent_r.3, getpwent_r.3, getrpcent.3, getservent_r.3, getttyent.3, getumask.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, inet.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallopt.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mtrace.3, newlocale.3, ntp_gettime.3, offsetof.3, posix_openpt.3, printf.3, pthread_setname_np.3, pthread_setschedparam.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, sigvec.3, stdarg.3, strcat.3, strcpy.3, strftime.3, strtol.3, toupper.3, ttyslot.3, fuse.4, loop.4, st.4, elf.5, cgroup_namespaces.7, cgroups.7, feature_test_macros.7, inode.7, inotify.7, keyrings.7, man-pages.7, math_error.7, mount_namespaces.7, mq_overview.7, pthreads.7, sched.7, session-keyring.7, udplite.7, unix.7, vdso.7: Use consistent markup for code snippets
...
The preferred form is
.PP/.IP
.in +4n
.EX
<code>
.EE
.in
.PP/.IP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:26 +02:00
b76974c1ec
locale.1, pldd.1, bpf.2, clone.2, copy_file_range.2, dup.2, execve.2, futex.2, get_kernel_syms.2, getdents.2, getrlimit.2, getunwind.2, init_module.2, ioctl_console.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:26 +02:00
c4b7e5ac34
add_key.2, alloc_hugepages.2, execve.2, fanotify_init.2, getrlimit.2, listxattr.2, mmap.2, shmget.2, malloc.3, random.4, st.4, bootparam.7, epoll.7, keyrings.7, pipe.7, xattr.7: Use non-breaking space for measurement units
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:10 +02:00
ee8655b59a
arch_prctl.2, ioctl_fideduperange.2, ioctl_getfsmap.2, kexec_load.2, madvise.2, mbind.2, mmap.2, mmap2.2, mprotect.2, perf_event_open.2, process_vm_readv.2, set_mempolicy.2, shmget.2, subpage_prot.2, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, regex.3, wavelan.4, filesystems.5, proc.5, bootparam.7, raw.7, tcp.7, units.7, ld.so.8: Add a non-breaking space between a number and a unit (prefix)
...
Based on a patch by Bjarni Ingi Gislason.
According to SI, ""The numerical value always precedes the unit,
and a space is always used to separate the unit from the number
[...] The only exceptions to this rule are for the unit symbols
for degree, minute, and second for plane angle."
Cowritten-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 12:12:59 +02:00
11ac5b5109
add_key.2, bpf.2, fcntl.2, futex.2, listxattr.2, perf_event_open.2, prctl.2, request_key.2, sigaltstack.2, __ppc_set_ppr_med.3, __ppc_yield.3, getw.3, setbuf.3, setjmp.3, lirc.4, core.5, securetty.5, inode.7, keyrings.7, process-keyring.7, user-keyring.7, ld.so.8: srcfix: use .PP instead of .P
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:13:44 +02:00
dd3568a147
getent.1, intro.1, time.1, _exit.2, alloc_hugepages.2, arch_prctl.2, clock_getres.2, getitimer.2, getrusage.2, intro.2, ioctl_console.2, ioctl_list.2, ioctl_tty.2, kill.2, madvise.2, mlock.2, mmap.2, mount.2, open.2, outb.2, perf_event_open.2, ptrace.2, quotactl.2, reboot.2, recv.2, remap_file_pages.2, select.2, semctl.2, send.2, set_tid_address.2, seteuid.2, shmop.2, statfs.2, times.2, truncate.2, uname.2, uselib.2, vm86.2, wait.2, a64l.3, aio_cancel.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, atexit.3, basename.3, bindresvport.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cexp.3, cfree.3, cimag.3, clog.3, conj.3, creal.3, ctime.3, des_crypt.3, dirfd.3, div.3, dlopen.3, envz_add.3, exit.3, fenv.3, flockfile.3, fmtmsg.3, fpclassify.3, fpurge.3, fseeko.3, ftime.3, ftok.3, ftw.3, getcontext.3, getcwd.3, getdate.3, getfsent.3, getgrent.3, getgrnam.3, gethostbyname.3, getipnodebyname.3, getlogin.3, getpwnam.3, getrpcent.3, getspnam.3, getutent.3, gsignal.3, hsearch.3, lockf.3, logb.3, login.3, lseek64.3, makecontext.3, malloc.3, malloc_hook.3, nan.3, nl_langinfo.3, openpty.3, posix_spawn.3, putenv.3, realpath.3, remainder.3, rint.3, rpc.3, rtime.3, scandir.3, setlogmask.3, shm_open.3, sigpause.3, statvfs.3, stdio_ext.3, strfmon.3, strftime.3, strptime.3, strtod.3, strtol.3, strtoul.3, swab.3, sysconf.3, syslog.3, tcgetpgrp.3, tempnam.3, termios.3, tmpfile.3, tmpnam.3, ttyslot.3, tzset.3, ualarm.3, usleep.3, wordexp.3, xcrypt.3, xdr.3, cciss.4, console_codes.4, full.4, hd.4, loop.4, mem.4, null.4, pts.4, ram.4, random.4, tty.4, ttyS.4, vcs.4, networks.5, nsswitch.conf.5, protocols.5, resolv.conf.5, slabinfo.5, termcap.5, ascii.7, boot.7, bootparam.7, charsets.7, icmp.7, inode.7, man.7, netdevice.7, posixoptions.7, ld.so.8: srcfix: use .PP instead of .LP
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:12:54 +02:00
51f5698d3c
capget.2, gettimeofday.2, nanosleep.2, process_vm_readv.2, readv.2, seccomp.2, semop.2, sigaction.2, sigwaitinfo.2, dbopen.3, dladdr.3, ether_aton.3, fenv.3, fgetgrent.3, fgetpwent.3, frexp.3, ftime.3, gamma.3, getaddrinfo.3, getaddrinfo_a.3, getgrent_r.3, getgrnam.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getmntent.3, getnetent.3, getprotoent.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getservent.3, getspnam.3, getutent.3, glob.3, hsearch.3, if_nameindex.3, inet.3, mq_receive.3, putgrent.3, putpwent.3, rand.3, sigqueue.3, strfromd.3, strptime.3, strtol.3, termios.3, timeradd.3, lp.4, tty.4, ip.7, ipv6.7, netdevice.7, raw.7, rtnetlink.7, units.7, zic.8: ffix: replace .sp by .PP
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:00:48 +02:00
bdd915e20f
_syscall.2, capget.2, ioprio_set.2, semop.2, send.2, ctime.3, dysize.3, fenv.3, fmtmsg.3, ftok.3, ftw.3, getaddrinfo.3, getgrent_r.3, gethostbyname.3, getopt.3, getpw.3, getpwent_r.3, getsubopt.3, getutent.3, glob.3, if_nameindex.3, inet.3, lseek64.3, malloc_hook.3, mbrtowc.3, mkstemp.3, mq_receive.3, mq_send.3, posix_spawn.3, putgrent.3, putpwent.3, qsort.3, raise.3, rand.3, rtime.3, setaliasent.3, setbuf.3, shm_open.3, significand.3, sigqueue.3, statvfs.3, strfromd.3, strptime.3, strtol.3, strtoul.3, termios.3, tgamma.3, timeradd.3, tsearch.3, tzset.3, updwtmp.3, usleep.3, wcstok.3, console_codes.4, hd.4, hpsa.4, mem.4, null.4, ram.4, sd.4, ttyS.4, filesystems.5, group.5, passwd.5, shells.5, termcap.5, ttytype.5, tzfile.5, utmp.5, ascii.7, bootparam.7, complex.7, cpuset.7, epoll.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-17 23:40:17 +02:00
ba39b288ab
fcntl.2, ioctl_tty.2, kcmp.2, prctl.2, semop.2, swapon.2, atof.3, atoi.3, bsearch.3, cfree.3, ctime.3, drand48.3, errno.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-17 13:41:27 +02:00
47f743f12e
chroot.2, clone.2, epoll_wait.2, execve.2, getgroups.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 23:18:50 +02:00
0ffeaeae10
capget.2, clock_getres.2, clock_nanosleep.2, epoll_ctl.2, epoll_wait.2, eventfd.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 11:17:26 +02:00
18ef2552b1
io_getevents.2, ioctl_fat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 11:09:48 +02:00
58c2a94b64
gettimeofday.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 11:02:09 +02:00
03bd54153c
getrusage.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 11:00:37 +02:00
20ae960c67
getrlimit.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 10:55:44 +02:00
04fd9d70a6
getpagesize.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 10:55:21 +02:00
Michael Kerrisk