Mihir Mehta
4f4b395de2
pread.2: wfix
...
Fix a typographical error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-06-21 19:27:54 +02:00
Michael Kerrisk
be914947a7
select.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-06-12 06:01:32 +02:00
Michael Kerrisk
4c974cbac6
select.2: BUGS: the use of value-result arguments is a design bug
...
The use of value-result arguments is a design bug that is
not suffered by poll(2).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-06-01 09:08:28 +02:00
Michael Kerrisk
8b5bbcfabc
open.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-31 21:34:32 +02:00
Lucas Werkmeister
71b12d0a57
open.2: Document ENXIO for sockets
...
Linux returns ENXIO when attempting to open() a UNIX domain socket.
Kernel-wise, I believe this happens in fs/inode.c [1], where a constant
`no_open` function returning -ENXIO is registered as the default open()
handler for inodes in inode_init_always(), and is not specialized in
nit_special_inode() as it is for other types.
Seen in the systemd v238 source code [2].
[1]: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/fs/inode.c?h=v4.16
[2]: https://github.com/systemd/systemd/blob/v238/src/core/execute.c#L412
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-31 21:34:32 +02:00
Michael Kerrisk
6a4c997189
pkey_alloc.2: Switch to glibc prototype in SYNOPSIS
...
In the kernel, the type of the arguments to pkey_alloc() is
"unsigned long" and that's what the page documented until now.
Now that glibc support is added for pkey_alloc(), switch to the
glibc prototype, which uses "unsigned int".
Reported-by: Szabolcs Nagy <szabolcs.nagy@arm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-31 21:34:32 +02:00
Jakub Wilk
f9d9ad2163
setns.2: tfix
...
Remove duplicated word.
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-31 07:58:06 +02:00
Michael Kerrisk
dd08fccaae
prctl.2: Add kernel version for PR_GET_SPECULATION_CTRL + PR_SET_SPECULATION_CTRL
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-28 13:52:41 +02:00
Michael Kerrisk
a01c1cbcc3
prctl.2: Various fixups to Konrad Rzeszutek Wilk's text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-28 13:50:07 +02:00
Michael Kerrisk
2feab5d3b1
prctl.2: Minor fixups
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-28 12:57:30 +02:00
Michael Kerrisk
ac3756bc53
prctl.2: srcfix: rewrap source lines
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-28 12:57:30 +02:00
Michael Kerrisk
e36dfb8186
prctl.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-28 12:57:30 +02:00
Konrad Rzeszutek Wilk
e23acd79f9
prctl.2: Document PR_SET_SPECULATION_CTRL and PR_GET_SPECULATION_CTRL
...
Signed-off-by: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-28 11:59:26 +02:00
Goldwyn Rodrigues
ebf120124b
write.2: Partial direct I/O writes
...
Direct writes can perform partial writes because large writes
can be broken into smaller chunks by the block layer. Part of
the I/O submitted can fail and the failure is returned to write
as an error in the return value. However, part of the write can
be successful which means that data at the offset is inconsistent.
Signed-off-by: Goldwyn Rodrigues <rgoldwyn@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-28 11:34:34 +02:00
Michael Kerrisk
e795580f53
select.2: Note that select() and pselect() are not affected by O_NONBLOCK
...
Reported-by: Robin Kuzmin <kuzmin.robin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 11:01:16 +02:00
Michael Kerrisk
15e68be637
poll.2: Note that poll() and ppoll() are not affected by O_NONBLOCK
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 11:00:04 +02:00
Michael Kerrisk
3897a3f89f
open.2: Clarify a special use case of O_NONBLOCK for devices
...
The wording is a little confusing, suggesting that this is
the primary use of O_NONBLOCK. Fix that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 10:56:16 +02:00
Michael Kerrisk
f2a110725b
open.2: Clarify that O_NONBLOCK has no effect on poll/epoll/select
...
Reported-by: Robin Kuzmin <kuzmin.robin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 10:25:53 +02:00
Michael Kerrisk
b0972b3b05
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 10:14:49 +02:00
Michael Kerrisk
2ac1d1e3e7
sigsuspend.2: Clarify that sigsuspend() suspends the calling *thread*
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 09:58:07 +02:00
Michael Kerrisk
603a9fa5b6
sched_setparam.2: Clarify that scheduling parameters are per-thread (not per-process)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 09:54:31 +02:00
Michael Kerrisk
5fbfa7335f
setns.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 09:48:40 +02:00
Michael Kerrisk
56d898aaa5
gettid.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-18 09:42:51 +02:00
Michael Kerrisk
ac79419503
setns.2: Note capability requirements for changing network, IPC, or UTS namespace
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 23:04:02 +02:00
Michael Kerrisk
b4e192495b
setns.2: Note capability requirements for changing cgroup namespace
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 23:01:33 +02:00
Michael Kerrisk
a5633e6b2d
setns.2: Note capability requirements for changing PID namespace
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 23:01:15 +02:00
Michael Kerrisk
98929c3141
setns.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 22:55:42 +02:00
Michael Kerrisk
c6b1b95b9e
setns.2: Minor text reorganization
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 22:47:31 +02:00
Michael Kerrisk
0ecd580494
setns.2: Relocate PID-namespace-specific details
...
No content changes.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 22:39:22 +02:00
Michael Kerrisk
2e4a22de93
setns.2: ffix: add some paragraph breaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 22:35:33 +02:00
Michael Kerrisk
8e23f12b17
setns.2: Some logical text restructuring
...
Add subsection headings and use hanging list for details
of specific namespace types.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 22:34:07 +02:00
Michael Kerrisk
6f91075e49
setns.2: Minor wording fix
...
A process doesn't have a capability in a mount namespace, but
rather in the user namespace that owns the mount namespace.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-16 21:53:27 +02:00
Michael Kerrisk
4eae8eb731
clock_getres.2: CLOCK_MONOTONIC_RAW does not count while the system is suspended
...
Reported-by: Jens Thoms Toerring <jt@toerring.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-13 20:19:40 +02:00
Michael Kerrisk
f224d2bc9e
clock_getres.2: CLOCK_MONOTONIC does not count while the system is suspended
...
Reported-by: Jens Thoms Toerring <jt@toerring.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-13 20:15:32 +02:00
Michael Kerrisk
7d882a4a2a
clock_getres.2: On Linux CLOCK_MONOTONIC counts time that the system has run since boot
...
Reported-by: Jens Thoms Toerring <jt@toerring.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-13 20:12:59 +02:00
Michael Kerrisk
bccacb94dd
gettimeofday.2, clock_getres.2: ERRORS: EINVAL can occur if new real time is less than monotonic clock
...
Attempts (settimeofday(), clcok_settime(CLOCK_REALTIME)) to set
the real time clock to a value less than the current value of the
CLOCK_MONOTONIC clock result in EINVAL.
In the kernel source file kernel/time/timekeeping.c::do_settimeofday64(),
there is this check:
if (timespec64_compare(&tk->wall_to_monotonic, &ts_delta) > 0) {
ret = -EINVAL;
goto out;
}
It appears that the check was added in Linux 4.3:
commit e1d7ba8735551ed79c7a0463a042353574b96da3
Author: Wang YanQing <udknight@gmail.com>
Date: Tue Jun 23 18:38:54 2015 +0800
time: Always make sure wall_to_monotonic isn't positive
Reported-by: Jens Thoms Toerring <jt@toerring.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-13 16:21:03 +02:00
Michael Kerrisk
018c296c7e
gettimeofday.2: ERRORS: add EINVAL for noncanonical 'tv' argument to settimeofday()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-13 16:21:00 +02:00
Michael Kerrisk
9a82d4d95e
gettimeofday.2: Minor rewording of settimeofday() EINVAL error for timezone
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-13 16:20:56 +02:00
Michael Kerrisk
9f23d9477c
clock_getres.2: ERRORS: add EINVAL error for noncanonical clock_settime() value
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-13 16:20:42 +02:00
Paul Millar
12507e51a4
inotify_add_watch.2: Add IN_ONLYDIR based error
...
I noticed that it was undocumented how inotify_add_watch(2)
behaves if IN_ONLYDIR is specified and the target is not a
directory.
I've included a patch that adds ENOTDIR as an additional error in
the inotify_add_watch(2) man page.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-06 10:09:56 +02:00
Andrew Price
abd34f349d
open.2: Remove O_DIRECT-related quotation
...
Remove a section that adds no benefit to the discussion of O_DIRECT.
Signed-off-by: Andrew Price <andy@andrewprice.me.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-06 09:29:46 +02:00
Michael Kerrisk
5424697152
s390_guarded_storage.2: Add license
...
Eugene is amenable to use of the Verbatim license, so
let's use that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 15:13:28 +02:00
Michael Kerrisk
9c30debb40
s390_guarded_storage.2: srcfix: rewrap long source lines
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:55:59 +02:00
Michael Kerrisk
a7091d1326
s390_guarded_storage.2: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:55:59 +02:00
Michael Kerrisk
6e5ba56745
s390_guarded_storage.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:55:59 +02:00
Eugene Syromyatnikov
e21ddd0138
s390_guarded_storage.2: New page documenting s390_guarded_storage(2) s390-specific system call
...
* man2/s390_guarded_storage.2: New file.
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:55:29 +02:00
Michael Kerrisk
605e9d077b
syscalls.2: Add s390_guarded_storage(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:54:07 +02:00
Michael Kerrisk
3475e312ad
s390_sthyi.2: Minor wording fix to Eugene's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:54:07 +02:00
Eugene Syromyatnikov
b2c7f822c6
s390_sthyi.2: Some minor additions
...
* man2/s390_sthyi.2
(.SH DESCRIPTION): Document the size of the resp_buffer when
function_code is 0.
(.SH NOTES): Document various aspects of the current
implementation (the lifted requirement for the response buffer
alignment, the presence of in-kernel cache), add description
for the documentation URL.
Coauthored-by: Heiko Carstens <heiko.carstens@de.ibm.com>
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:54:07 +02:00
Michael Kerrisk
03b3fa4a74
s390_runtime_instr.2: Minor tweaks to Eugene's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-02 14:54:07 +02:00