Michael Kerrisk
006ac5f09d
sigaltstack.2: Reword BUGS text to be a little clearer
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk
c854094fc0
sigaltstack.2: Add use os sigaction() to example code
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk
93c33be846
sigaltstack.2: Add explicit error handling to example code
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk
55f780fe47
sigaltstack.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk
eff26dcec6
sigaltstack.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk
cfdc176b44
sigaltstack.2: Document SS_AUTODISARM flag added in Linux 4.7
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-08 08:36:50 +01:00
Michael Kerrisk
946924bd33
capget.2: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 21:20:40 +01:00
Michael Kerrisk
c0f82ec111
capget.2: wfix: consistently use "VFS capabilities"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 21:20:40 +01:00
Michael Kerrisk
c350d86d00
capget.2: Clarify discussion of kernels that have no VFS capability support
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 13:58:18 +01:00
Michael Kerrisk
fb89201a9b
capget.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 13:45:26 +01:00
Elliot Hughes
0e1a31ea79
recvmmsg.2, sendmmsg.2: Type fixes in SYNOPSIS
...
[mtk: The raw system calls use "unsigned int", but the glibc
wrappers have "int" for the 'flags' argument.]
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-02 07:49:07 +01:00
Michael Kerrisk
74f254908f
mmap.2: SEE ALSO: add ftruncate(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-31 08:24:13 +01:00
Michael Kerrisk
c19250adee
mmap.2: Add explicit text noting that 'length' must be greater than 0
...
Currently, this detail is hidden in ERRORS. Make it clear in
the main text.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-31 08:21:43 +01:00
G. Branden Robinson
9ab7f611ed
Replace Latin abbreviation "cf.".
...
People seem to be using "cf." ("confere"), which means "compare",
to mean "see" instead, for which the Latin abbreviation would be
"q.v." ("quod vide" -> "which see").
In some cases "cf." might actually be the correct term but it's
still not clear what specific aspects of a function/system call
one is supposed to be comparing.
I left one use in place in hope of obtaining clarification,
because it looks like it might be useful there, if contextualized.
Migrate these uses to English and add them to the list of
abbreviations to be avoided.
If the patch to vfork(2) is not accepted, then the cf. still needs
an \& after it because it is at the end of the line but not the
end of a sentence.
Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 17:39:33 +02:00
G. Branden Robinson
9b13f7700e
connect.2, ioprio_set.2, dbopen.3, group.5, fifo.7: tfix
...
Fix nonstandard usage.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:41:59 +02:00
G. Branden Robinson
fedb2ff513
open.2: tfix
...
This one crept in during the first bit of the "will fail" -> "fails"
migration.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:34:09 +02:00
Michael Kerrisk
26cd31fd4a
access.2, delete_module.2, eventfd.2, fallocate.2, fcntl.2, getrandom.2, init_module.2, open.2, seccomp.2, timerfd_create.2, openpty.3, pthread_spin_lock.3, shm_open.3, tempnam.3, fifo.7, keyrings.7, pid_namespaces.7, sched.7, thread-keyring.7: wfix (will fail --> fail/fails)
...
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:55:10 +02:00
Michael Kerrisk
cdcc4450a0
getrlimit.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:43:11 +02:00
Michael Kerrisk
a23d8efafc
capget.2, fanotify_init.2, fcntl.2, ioctl_tty.2, madvise.2, mbind.2, prctl.2, sched_setaffinity.2, hash.3, isgreater.3, posix_fallocate.3, sigvec.3, full.4, sd.4, wavelan.4, core.5, host.conf.5, epoll.7, signal.7, unix.7, user_namespaces.7: wfix (will fail --> fail/fails)
...
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:36:57 +02:00
Michael Kerrisk
6e2767983c
reboot.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 12:28:54 +02:00
Michael Kerrisk
9e4be7e9fc
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 12:28:06 +02:00
Michael Kerrisk
5bc53d81f0
times.2: Language fix-up: clarify that "tasks" means "work"
...
See https://bugzilla.kernel.org/show_bug.cgi?id=197183
Reported-by: Victor Porton <porton@narod.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 11:05:34 +02:00
Michael Kerrisk
90c85e6189
times.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:56:53 +02:00
Michael Kerrisk
6f34a82c42
clone.2: Add a reference to new veth(4) page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Michael Kerrisk
133ca6caab
stat.2: Use lstat() instead of stat()
...
It's more logical to use lstat() in the example code,
since one can then experiment with sybolic links, and
also the S_IFLNK case can also occur.
Reported-by: Richard Knutsson <richard.knutsson@abelko.se>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 20:04:26 +02:00
Michael Kerrisk
9dc4485584
ioctl_userfaultfd.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 10:40:01 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Prakash Sangappa
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
2551f80148
clone.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
Michael Kerrisk
e5f3df4833
clone.2: Remove a redundant paragraph
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
Michael Kerrisk
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
Michael Kerrisk
4ba17a6deb
clone.2: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 08:45:32 +02:00
Michael Kerrisk
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
Michael Kerrisk
1874193ebf
clone.2: Add NOTES heading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-17 22:17:26 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
35bf8cb47f
clone.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-17 14:47:11 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
63345f2229
getrlimit.2: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 15:35:47 +02:00
Yubin Ruan
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
Michael Kerrisk
b739c378ff
shmop.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 23:36:56 +02:00
Michael Kerrisk
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
Michael Kerrisk
3ddb841ebb
sigaction.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:48:40 +02:00
Michael Kerrisk
7276186d6c
sigaction.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:48:40 +02:00
Michael Kerrisk
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
Michael Kerrisk
cc158fa3ac
sigreturn.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 14:30:05 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Jakub Wilk
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
Michael Kerrisk
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
Michael Kerrisk
3b53a603c4
flock.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 15:28:30 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
b0ea1ea30d
prctl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 14:25:47 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
NeilBrown
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
ca20a8a5c8
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
Michael Kerrisk
431161696a
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
8abf3239a1
keyctl.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:33:03 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
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
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
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
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
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
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
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
c0d3d8fe5c
getrlimit.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:33:02 +02:00
Jonas Grabber
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
ccdfed50fc
fcntl.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
Michael Kerrisk
7b2316b859
fcntl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
Michael Kerrisk
c542a59fed
fcntl.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:27:43 +02:00
Jens Axboe
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
Sage Weil
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
Tej Chajed
b2b2194236
fsync.2: tfix
...
man-pages version 4.13 as found on GitHub has an accidental deletion
introduced in 2021d0b3be
. Here's a patch
to add it back.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-14 14:33:36 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Eugene Syromyatnikov
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
Eugene Syromyatnikov
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
Eugene Syromyatnikov
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