Michael Kerrisk
431e43bc6a
getgid.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
ab97e9ed82
fsync.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
9b612e3c77
fork.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
c84d3aa375
open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
5a3b5c1d0a
_exit.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
c95f9f2c02
execve.2: Reword text on POSIX and #!
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
ce1ff0f696
execve.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
aee3265e69
dup.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
d1969970b6
connect.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
11aac2586b
close.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
310ea74bc1
clock_nanosleep.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
75ee6a0726
clock_getres.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
b5b4580849
chdir.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
04b63f4856
bind.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
6378aaf0aa
alarm.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:03 +02:00
Michael Kerrisk
fe472573ff
accept.2: Add mention of POSIX.1-2008 regarding EAGAIN vs EWOULDBLOCK
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:02 +02:00
Michael Kerrisk
9db8624bc8
accept.2: CONFORMING TO: add POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:02 +02:00
Michael Kerrisk
2d7dbb05a5
accept.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:02 +02:00
Michael Kerrisk
f1461fe180
mmap.2: Describe mmap()/munmap() argument requirements for huge-page mappings
...
Acked-by: David Rientjes <rientjes@google.com>
Reported-by: David Rientjes <rientjes@google.com>
Reported-by: Mike Kravetz <mike.kravetz@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 08:56:27 +02:00
Michael Kerrisk
0f319769bc
mmap.2: Move discussion of timestamps to NOTES
...
A straight move; no changes to the content.
This content is better placed in NOTES.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 08:56:23 +02:00
Michael Kerrisk
0e824bcb97
mmap.2: Note that 'length' need not be a page-size multiple for munmap()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 08:49:54 +02:00
Michael Kerrisk
ca90e95aa3
mmap.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 08:49:54 +02:00
Michael Kerrisk
8cc4d07100
Removed trailing white space at end of lines
2015-07-23 16:15:22 +02:00
Michael Kerrisk
5722c835ab
intro.1, locale.1, _exit.2, access.2, bpf.2, brk.2, capget.2, chmod.2, chroot.2, clock_getres.2, clone.2, eventfd.2, fallocate.2, fork.2, getgroups.2, gethostname.2, getpid.2, getpriority.2, getrlimit.2, getrusage.2, gettid.2, iopl.2, ioprio_set.2, killpg.2, mlock.2, mprotect.2, perf_event_open.2, poll.2, posix_fadvise.2, pread.2, ptrace.2, read.2, readv.2, recv.2, rename.2, sched_setaffinity.2, sched_setattr.2, seccomp.2, select.2, send.2, seteuid.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaltstack.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, stat.2, timer_create.2, uname.2, utimensat.2, wait.2, wait4.2, write.2, MB_LEN_MAX.3, __ppc_get_timebase.3, clearenv.3, dl_iterate_phdr.3, error.3, fexecve.3, fpurge.3, fread.3, fts.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getgrent_r.3, gethostbyname.3, getifaddrs.3, getnameinfo.3, getnetent_r.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent_r.3, getrpcent.3, getrpcent_r.3, getrpcport.3, getservent.3, getservent_r.3, gsignal.3, key_setsecret.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, memcpy.3, mq_notify.3, mq_open.3, perror.3, profil.3, psignal.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_detach.3, pthread_getattr_np.3, pthread_join.3, pthread_setname_np.3, pthread_tryjoin_np.3, putgrent.3, rcmd.3, rpc.3, rpmatch.3, sem_close.3, sem_open.3, setaliasent.3, shm_open.3, sigqueue.3, strfmon.3, xcrypt.3, xdr.3, console_codes.4, null.4, core.5, host.conf.5, hosts.equiv.5, locale.5, repertoiremap.5, locale.7, man-pages.7, pty.7, rtld-audit.7, sched.7, vdso.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 16:12:28 +02:00
Michael Kerrisk
fcd1bee32a
bpf.2: Improvements after comments from Daniel Borkmann
...
Reported-by: Daniel Borkmann <daniel@iogearbox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:27 +02:00
Michael Kerrisk
00eaa6aaae
seccomp.2: SEE ALSO: add bpf(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:27 +02:00
Michael Kerrisk
953d26734e
bpf.2: Fixes after comments by Daniel Borkmann
...
Reported-by: Daniel Borkmann <daniel@iogearbox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:27 +02:00
Michael Kerrisk
b87d8ba6f2
bpf.2: Improvements after comments from Alexei Starovoitov
...
Reported-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:27 +02:00
Michael Kerrisk
46a4949bd7
bpf.2: Improvements after comments by Alexei Starovoitov
...
Reported-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:27 +02:00
Michael Kerrisk
dc079fa280
bpf.2: Minor tweaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:27 +02:00
Michael Kerrisk
4fba111eca
bpf.2: Improvements after comments from Alexei Starovoitov
...
Reported-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
8440f77124
bpf.2: Impreovements aftercomments from Daniel Borkmann
...
Reported-by: Daniel Borkmann <daniel@iogearbox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
ce5db3fcfc
bpf.2: Improvements after comments from Daniel Borkmann and Alexei Starovoitov
...
Reported-by: Daniel Borkmann <daniel@iogearbox.net>
Reported-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
f774ddf14d
bpf.2: Improvements after comments from Alexei Starovoitov
...
Plus various other improvements of my own.
Reported-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
61baa4ff4e
bpf.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
5415d504d7
bpf.2: Improvements after comments from Alexei Starovoitov
...
Reported-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
9ab033619e
bpf.2: Improvements from Alexei Starovoitov
...
Reported-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
cc42e9b82f
bpf.2: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
54513c009c
bpf.2: Use cBPF/eBPF consistently in the text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
896388c88a
bpf.2: Minor fixes
...
Reported-by: Daniel Borkmann <daniel@iogearbox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
842ee0100d
bpf.2: Various reworking + added FIXMEs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
8dbf8f2d83
bpf.2: Add CONFORMING TO section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
5f920e1059
bpf.2: Add VERSIONS section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
79e2beef82
bpf.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
16152abbda
bpf.2: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
5988a65928
bpf.2: wfix (multiple)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
1148d9343f
bpf.2: ffix (multiple)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
9a5215bfad
bpf.2: srcfix: wrap source lines at sentence breaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Alexei Starovoitov
cc7ac21d25
bpf.2: New page documenting bpf(2)
...
Signed-off-by: Alexei Starovoitov <ast@plumgrid.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 15:37:26 +02:00
Michael Kerrisk
9dbfb3b839
sched_setaffinity.2: Improvements after comments by Florian Weimer
...
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 14:36:54 +02:00
Michael Kerrisk
dde6d764a3
sched_setaffinity.2: Rework text about dealing with systems with more than 1024 CPUs
...
After comments from Florian Weimer, who pointed out various
confusions in the earlier text.
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 14:36:54 +02:00
Michael Kerrisk
abbbace718
sched_setaffinity.2: Explain how to deal with 1024-CPU limitation of glibc's cpu_set_t type
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 14:36:53 +02:00
Julian Orth
c3529e3b3a
sched_setattr.2: Remove a const attribute
...
The attr argument of sched_setattr was documented as const but the
kernel will modify the size field of this struct if it contains an
invalid value. See the documentation of the size field for details.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 09:38:36 +02:00
Vince Weaver
e38fb93eea
perf_event_open.2: Exclude_host/exclude_guest clarification
...
This patch relates to the exclude_host and exclude_guest bits added
by the following commit:
exclude_host, exclude_guest; Linux 3.2
commit a240f76165e6255384d4bdb8139895fac7988799
Author: Joerg Roedel <joerg.roedel@amd.com>
Date: Wed Oct 5 14:01:16 2011 +0200
perf, core: Introduce attrs to count in either host or guest mode
The updated manpage text clarifies that the "exclude_host" and
"exclude_guest" perf_event_open() attr bits only apply in the
context of a KVM environment and are currently x86 only.
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Acked-by: Joerg Roedel <jroedel@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 20:51:26 +02:00
Vince Weaver
f5281dfdd8
perf_event_open.2: Document PERF_SAMPLE_REGS_INTR
...
This patch relates to the addition of PERF_SAMPLE_REGS_INTR
support added in the following commit:
perf_sample_regs_intr; Linux 3.19
commit 60e2364e60e86e81bc6377f49779779e6120977f
Author: Stephane Eranian <eranian@google.com>
perf: Add ability to sample machine state on interrupt
The primary difference between PERF_SAMPLE_REGS_INTR and the
existing PERF_SAMPLE_REGS_USER is that the new support will
return kernel register values. Also if precise_ip is
set higher than 0 then the PEBS register state will be returned
rather than the saved interrupt state.
This patch incorporates feedback from Stephane Eranian and
Andi Kleen.
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 20:45:19 +02:00
Michael Kerrisk
4607213d6b
mprotect.2: Note ENOMEM error that can occur when we reach limit on maximum VMAs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:18:26 +02:00
Michael Kerrisk
c0b897882c
mmap.2: ERRORS: point out that ENOMEM can occur even for munmap()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:13:00 +02:00
Michael Kerrisk
74309bedf2
mmap.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:09:12 +02:00
Michael Kerrisk
911f1c7ace
mmap.2: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:08:19 +02:00
Michael Kerrisk
88b001ffe8
mmap.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-22 09:04:55 +02:00
Michael Kerrisk
555c445244
mlock.2: Document another ENOME error case
...
ENOMEM can occur if locking/unlocking in the middle of a region
would increase the number of VMAs beyond the system limit (64k).
Reported-by: Mehdi Aqadjani Memar <m.aqadjanimemar@student.vu.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 20:47:17 +02:00
Michael Kerrisk
bb2f758044
fallocate.2: Since Linux 4.2, ext4 supports FALLOC_FL_INSERT_RANGE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 08:38:07 +02:00
Michael Kerrisk
fe56ce1c5f
seccomp.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-13 14:06:24 +02:00
Michael Kerrisk
81f3ee482d
uselib.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-10 20:00:22 +02:00
Michael Kerrisk
ccc357f7c6
fcntl.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-03 12:40:48 +02:00
Michael Kerrisk
3c5ab7703e
seccomp.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-03 12:40:48 +02:00
Michael Kerrisk
85fbef7408
prctl.2, seccomp.2: Clarify that SECCOMP_SET_MODE_STRICT disallows exit_group(2)
...
These days, glibc implements _exit() as a wrapper around
exit_group(2). (When seccomp was originally introduced, this was
not the case.) Give the reader a clue that, despite what glibc is
doing, what SECCOMP_SET_MODE_STRICT permits is the true _exit(2)
system call, and not exit_group(2).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-03 12:40:16 +02:00
Michael Kerrisk
7a79bb301a
seccomp.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-30 13:29:23 +02:00
Michael Kerrisk
e9855ef2f7
seccomp.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-30 13:29:00 +02:00
Michael Kerrisk
65cfc71220
seccomp.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-30 13:28:10 +02:00
Michael Kerrisk
29218e62cc
truncate.2: ERRORS: ftruncate() can fail if the file descriptor is not writable
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-30 11:57:40 +02:00
Michael Kerrisk
d726280aaf
sched_setaffinity.2: Mention the use of the 'isolcpus' kernel boot option
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-26 11:07:43 +02:00
Michael Kerrisk
b0ce4533dc
getpriority.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-26 11:07:43 +02:00
Tobias Stoeckmann
4621e4e772
setsid.2: tfix
...
it -> its
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-18 08:43:56 +02:00
Michael Kerrisk
ba9aa794c8
chroot.2: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-16 13:20:47 +02:00
Stephan Mueller
3c4dfb62a5
socket.2: Update documentation reference for AF_ALG
...
Signed-off-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-16 10:07:00 +02:00
Jann Horn
614e269a80
chroot.2: chroot() is not intended for security; document attack
...
It is unfortunate that this discourages this use of chroot(2)
without pointing out alternative solutions - for example,
OpenSSH and vsftpd both still rely on chroot(2) for security.
Bind mounts should theoretically be usable as a replacement, but
currently, they have a similar problem (CVE-2015-2925) that hasn't
been fixed in ~6 months, so I'd rather not add it to the manpage
as a solution before a fix lands.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-16 10:00:14 +02:00
Jann Horn
7353fc544c
listxattr.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 20:16:16 +02:00
Michael Kerrisk
c93b25f996
gettid.2: s/getpid()/gettid()/
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 19:01:14 +02:00
Julian Orth
c838fc75c7
capget.2: Clarify that hdrp->pid==0 is equivalent gettid() not getpid()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:58:24 +02:00
Michael Kerrisk
4a8f718576
gettid.2: Note that for a thread group leader, gettid() == getpid()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:56:24 +02:00
Michael Kerrisk
29c4533cd3
_exit.2: Open stdio frames are not flushed, temporary files are deleted
...
Many years ago, text was added to the page saying that it is
implementation-dependent whether stdio streams are flushed and
whether temporary are removed. In part, this change appears to
be because POSIX.1-2001 added text related to this point.
However, that seems to have been an error in POSIX, and the
text was subsequently removed for POSIX.1-2008. See
https://collaboration.opengroup.org/austin/interps/documents/9984/AI-085.txt
Austin Group Interpretation reference 1003.1-2001 #085
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-10 12:55:49 +02:00
Michael Kerrisk
1290b94b1c
llseek.2: tfix
...
Reported-by: Namhyung Kim <namhyung@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-27 10:16:59 +02:00
Michael Kerrisk
728aff57dd
fcntl.2: OFD locks are proposed for inclusion in the next POSIX revision
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:38:09 +02:00
Zeng Linggang
47f06c7567
utimensat.2: ATTRIBUTES: Note functions that are thread-safe
...
After research, We think utimensat() and futimens() are thread-safe.
But, there are not markings of utimensat() and futimens() in glibc
document.
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:13:32 +02:00
Zeng Linggang
288c1a09dd
eventfd.2: ATTRIBUTES: Note function that is thread-safe
...
After research, We think eventfd() is thread-safe. But, there
is not marking of eventfd() in glibc document.
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:12:43 +02:00
Zeng Linggang
546e17cef9
clock_getres.2: ATTRIBUTES: Note functions that are thread-safe
...
After research, We think clock_getres(), clock_gettime() and
clock_settime() are thread-safe. But, there are not markings of
clock_getres(), clock_gettime() and clock_settime() in glibc document.
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-20 16:12:36 +02:00
Michael Kerrisk
7626d2ce34
prctl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-19 09:51:24 +02:00
Michael Kerrisk
6b693d86d3
write.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 15:42:10 +02:00
Michal Hocko
bbebbb6d56
mmap2: Clarify MAP_POPULATE
...
David Rientjes has noticed that MAP_POPULATE wording might promise
much more than the kernel actually provides and intend to provide.
The primary usage of the flag is to pre-fault the range. There is
no guarantee that no major faults will happen later on. The pages
might have been reclaimed by the time the process tries to access
them.
Reviewed-by: Eric B Munson <emunson@akamai.com>
Signed-off-by: Michal Hocko <mhocko@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-14 15:34:06 +02:00
Michal Hocko
7e3786bcdc
mmap.2: Clarify MAP_LOCKED semantics
...
MAP_LOCKED had a subtly different semantic from mmap(2)+mlock(2)
since it has been introduced.
mlock(2) fails if the memory range cannot get populated to
guarantee that no future major faults will happen on the range.
mmap(MAP_LOCKED) on the other hand silently succeeds even if
the range was populated only partially.
Fixing this subtle difference in the kernel is rather awkward
because the memory population happens after mm locks have been
dropped and so the cleanup before returning failure (munlock)
could operate on something else than the originally mapped area.
E.g. speculative userspace page fault handler catching SEGV and
doing mmap(fault_addr, MAP_FIXED|MAP_LOCKED) might discard portion
of a racing mmap and lead to lost data. Although it is not clear
whether such a usage would be valid, mmap page doesn't explicitly
describe requirements for threaded applications so we cannot
exclude this possibility.
This patch makes the semantic of MAP_LOCKED explicit and suggests
using mmap + mlock as the only way to guarantee no later major
page faults.
Reviewed-by: Eric B Munson <emunson@akamai.com>
Signed-off-by: Michal Hocko <mhocko@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-14 15:31:11 +02:00
Zeng Linggang
8d53768435
sigaltstack.2: ATTRIBUTES: Note function that is thread-safe
...
The marking matches glibc marking.
The marking of functions in glibc is:
- sigaltstack: MT-Safe
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 17:15:43 +02:00
Zeng Linggang
47e94221ff
getrusage.2: ATTRIBUTES: Note function that is thread-safe
...
The marking matches glibc marking.
The marking of functions in glibc is:
- getrusage: MT-Safe
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 17:15:11 +02:00
Zeng Linggang
57ba9747f4
getrlimit.2: ATTRIBUTES: Note functions that are thread-safe
...
After research, We think prlimit() is thread-safe. But, there
is not marking of prlimit() in glibc document.
getrlimit() and setrlimit() match glibc markings.
- getrlimit: MT-Safe
- setrlimit: MT-Safe
- prlimit: MT-Safe
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 17:15:06 +02:00
Michael Kerrisk
d3b019c1b0
send.2: Expand on subtleties of MSG_NOSIGNAL versus ignoring SIGPIPE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 13:21:44 +02:00
Michael Kerrisk
19aecb7eb0
send.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 13:21:44 +02:00
Michael Kerrisk
630b4cac33
recv.2, send.2: Explain some subtleties of MSG_DONTWAIT versus O_NONBLOCK
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 13:21:44 +02:00
Michael Kerrisk
b6c261c4db
iopl.2: Remove some historical libc5 and glibc 1 details
...
These details are ancient, and long ago ceased to be relevant.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 21:11:17 +02:00
Michael Kerrisk
55bd9495b2
ptrace.2: PTRACE_O_TRACEEXIT clarification
...
Reported-by: Vegard Nossum <vegard.nossum@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 12:43:48 +02:00
Michael Kerrisk
77548009f5
pread.2, read.2, readv.2, sendfile.2, write.2: Clarify that Linux limits transfers to a maximum of 0x7ffff000 bytes
...
See https://bugs.debian.org/629994 and
https://bugs.debian.org/630029 .
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 07:07:21 +02:00
Michael Kerrisk
9a12dd5031
pread.2: Rewrite RETURN VALUE section
...
(Also drop the text on pwrite() returning zero; that seems bogus.)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 07:07:21 +02:00
Michael Kerrisk
7b0d1eaa6d
readv.2: Remove BUGS heading
...
The text on mixinf I/O syscalls and stdio is a general point
of behavior. It's not a bug as such.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 07:03:02 +02:00
Michael Kerrisk
0b4ac98897
execve.2: srcfix: Add FIXME
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 12:14:54 +02:00
Michael Kerrisk
9f629381c9
open.2, read.2, write.2: Clarify that O_NONBLOCK is a no-op for regular files and block devices
...
Reported-by: Mike Hayward <hayward@loup.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 12:03:43 +02:00
Michael Kerrisk
eee5da1663
read.2: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 11:39:38 +02:00
Michael Kerrisk
403b78f89e
open.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 11:30:00 +02:00
Michael Kerrisk
02906043a4
ioprio_set.2: Document meaning of ioprio==0
...
Reported-by: Jens Axboe <axboe@fb.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 10:09:05 +02:00
Michael Kerrisk
a311ffd05b
ioprio_set.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 09:39:49 +02:00
Michael Kerrisk
8ebf2cfb42
ioprio_set.2: Minor fix: change 'hda' to 'sda' in examples
...
These days, we're more likely to see 'sd' than 'hd' disk devices.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 09:32:42 +02:00
Michael Kerrisk
7e5d08eb08
ioprio_set.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 09:31:25 +02:00
Michael Kerrisk
4965810a6b
ioprio_set.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 09:26:41 +02:00
Michael Kerrisk
eb24aedc69
execve.2: Elaborate on envp/argv as NULL behavior
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 09:10:19 +02:00
Michael Kerrisk
097547580e
execve.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-11 09:10:09 +02:00
Michael Kerrisk
ef5a2800f7
seccomp.2: srcfix
...
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-08 16:13:42 +02:00
Michael Kerrisk
cc5ba920e1
getrandom.2: srcfix
...
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-08 16:13:02 +02:00
Michael Kerrisk
0722a578ed
_exit.2, access.2, brk.2, chmod.2, clone.2, epoll_wait.2, eventfd.2, fork.2, getgroups.2, gethostname.2, getpid.2, getpriority.2, killpg.2, mmap.2, poll.2, posix_fadvise.2, pread.2, ptrace.2, readv.2, sched_setaffinity.2, select.2, seteuid.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaction.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, stat.2, timer_create.2, uname.2, wait.2, wait4.2, mq_notify.3, mq_open.3, sigqueue.3, man-pages.7: Remove "ABI" from "C library/kernel ABI differences" subheadings
...
The "ABI" doesn't really convey anything significant in
the title. These subsections are about describing differences
between the kernel and (g)libc interfaces.
Reported-by: Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-08 13:10:04 +02:00
Michael Kerrisk
8d0418afd0
access.2: tfix + wfix
...
Reported-by: Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-08 11:54:36 +02:00
Michael Kerrisk
86dbf1bbb1
rename.2: srcfix: add Linux kernel commit for RENAME_WHITEOUT
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 13:49:05 +02:00
Michael Kerrisk
2236e65b29
sched_setaffinity.2: Add an example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 10:37:37 +02:00
Michael Kerrisk
d35b5dd343
rename.2: Note that RENAME_NOREPLACE can't be employed with RENAME_EXCHANGE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 10:36:39 +02:00
Michael Kerrisk
0ebe7b93fc
rename.2: Document RENAME_WHITEOUT
...
Heavily based on text by Miklos Szeredi.
Cowritten-by: Miklos Szeredi <miklos@szeredi.hu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 10:36:38 +02:00
Michael Kerrisk
de332fe886
rename.2: Minor text reworking for EINVAL errors
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 10:36:38 +02:00
Michael Kerrisk
c9c7821b89
rename.2: Place list of renameat() flags in alphabetical order
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 10:36:38 +02:00
Michael Kerrisk
ec9a2be0f9
fallocate.2: Tweaks to Namjae Jeon's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 10:24:32 +02:00
Namjae Jeon
7da70a01c7
fallocate.2: Document FALLOC_FL_INSERT_RANGE
...
Signed-off-by: Namjae Jeon <namjae.jeon@samsung.com>
Signed-off-by: Ashish Sangwan <a.sangwan@samsung.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 09:14:47 +02:00
Michael Kerrisk
5ffdc2fda9
Removed trailing white space at end of lines
2015-05-07 08:30:26 +02:00
Michael Kerrisk
67d2c6873c
add_key.2, chown.2, epoll_ctl.2, epoll_wait.2, execve.2, fcntl.2, get_mempolicy.2, getxattr.2, ioctl.2, keyctl.2, listxattr.2, mkdir.2, mknod.2, mmap.2, msync.2, nfsservctl.2, open.2, prctl.2, removexattr.2, request_key.2, sendfile.2, set_mempolicy.2, setxattr.2, shmget.2, shutdown.2, sigaction.2, syslog.2, truncate.2, umask.2, CPU_SET.3, atexit.3, bsearch.3, cmsg.3, err.3, gethostid.3, getmntent.3, getopt.3, iconv_close.3, inet_ntop.3, longjmp.3, lsearch.3, mcheck.3, on_exit.3, putpwent.3, regex.3, resolver.3, setbuf.3, setjmp.3, setlocale.3, setlogmask.3, sleep.3, strsignal.3, sysconf.3, undocumented.3, tty_ioctl.4, proc.5, resolv.conf.5, tzfile.5, aio.7, bootparam.7, capabilities.7, fanotify.7, inotify.7, ip.7, packet.7, pthreads.7, raw.7, signal.7, socket.7, unix.7, ld.so.8, nscd.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 08:26:32 +02:00
Brice Goglin
856778162b
get_mempolicy.2, set_mempolicy: Policy is per thread, not per process
...
set/get_mempolicy manpages say that the memory allocation
policy is per process while reading the code and testing shows
that it's actually per thread. Here's a quick fix, which may
need to be improved to better explain that we're allocating
in the context of a thread within a process address space.
Signed-off-by: Brice Goglin <Brice.Goglin@inria.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 20:37:34 +02:00
Michael Kerrisk
320f8a8ec9
open.2: BUGS: O_CREAT | O_DIRECTORY succeeds if pathname does not exist
...
See http://www.openwall.com/lists/oss-security/2014/11/26/10
and http://thread.gmane.org/gmane.linux.file-systems/90997
Subject: O_CREAT|O_DIRECTORY on nonexisting file with ext4
not posix-compliant
Newsgroups: gmane.linux.file-systems
Date: 2014-12-15 17:39:09 GMT
and https://lkml.org/lkml/2005/9/23/80
Subject: [PATCH] open: O_DIRECTORY and O_CREAT together should fail
From: Miklos Szeredi <>
Date: Fri, 23 Sep 2005 16:45:04 +0200
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 18:31:49 +02:00
Michael Kerrisk
70b53bc047
stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 17:58:39 +02:00
Michael Kerrisk
97d5b76276
open.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 17:57:32 +02:00
Michael Kerrisk
6ca52c17a9
shmget.2: Document SHM_HUGE_2MB, SHM_HUGE_1GB, and SHM_HUGE_SHIFT
...
Reported-by: Andi Kleen <andi@firstfloor.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 17:41:21 +02:00
Michael Kerrisk
5d2038b6a8
mmap.2: Document MAP_HUGE_2MB, MAP_HUGE_1GB, and MAP_HUGE_SHIFT
...
Reported-by: Andi Kleen <andi@firstfloor.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 17:41:21 +02:00
Michael Kerrisk
d3c203f1a2
keyctl.2: srcfix: add FIXMES
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 09:44:03 +02:00
Michael Kerrisk
3739cdd4f8
prctl.2: Note that "parent" for purposes of PR_SET_DEATHSIG is a *thread*
...
See https://bugzilla.kernel.org/show_bug.cgi?id=43300
Reported-by: David Wilcox <davidvsthegiant@gmail.com>
Reported-by: Filipe Brandenburger <filbranden@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 18:00:26 +02:00
Gleb Fotengauer-Malinovskiy
4a38acf273
sendfile.2: tfix
...
Signed-off-by: Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 18:00:26 +02:00
Michael Kerrisk
3f4ed032f4
sendfile.2: RETURN VALUE: note the possibility of "short sends"
...
See https://bugzilla.kernel.org/show_bug.cgi?id=97491
Reported-by: Gregor Jasny <igjasny@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 16:03:55 +02:00
Michael Kerrisk
2a342fcf75
sendfile.2: Note that sendfile does not support O_APPEND for 'out_fd'
...
See https://bugzilla.kernel.org/show_bug.cgi?id=82841
Reported-by: Jason Newton <nevion@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 16:03:55 +02:00
Michael Kerrisk
a27867c25e
sendfile.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 16:03:55 +02:00
Michael Kerrisk
9e8a61e6ac
sendfile.2: Clarify text on 'out_fd' and regular files in Linux 2.4
...
See https://bugzilla.kernel.org/show_bug.cgi?id=86001
Reported-by: Askar Safin <safinaskar@mail.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 12:01:40 +02:00
Michael Kerrisk
15784e0ada
unshare.2: Give the reader a hint that unshare() works on processes or threads
...
See https://bugzilla.kernel.org/show_bug.cgi?id=59281
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 12:01:40 +02:00
Michael Kerrisk
8ef021ea00
clone.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 12:01:40 +02:00
Michael Kerrisk
72e8bdae36
mmap.2: Remove text that implies that munmap() syncs MAP_SHARED mapping to file
...
The existing text in this page:
MAP_SHARED Share this mapping. Updates to the mapping
are visible to other processes that map this
file, and are carried through to the underly‐
ing file. The file may not actually be
updated until msync(2) or munmap() is called.
implies that munmap() will sync the mapping to the underlying
file. POSIX doesn't require this, and some light reading of the
code and some light testing (fsync() after munmap() of a large
file) also indicates that Linux doesn't do this.
See also this mail thread:
Subject: munmap, msync: synchronization
Newsgroups: gmane.linux.man
Date: 2014-04-20 10:28:40 GMT
http://thread.gmane.org/gmane.linux.man/5548
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 20:04:33 +02:00
Michael Kerrisk
80691a91ce
mmap.2: Minor reworking of RETURN VALUE text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 16:43:25 +02:00
Michael Kerrisk
71c4b4b389
nfsservctl.2: Note that nfsservctl() was replaced by files in nfsd filesystem
...
Reported-by: J. Bruce Fields <bfields@fieldses.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 13:57:42 +02:00
Michael Kerrisk
caf997afa0
fcntl.2: Note an F_SETSIG corner case
...
Reported-by: Vegard Nossum <vegard.nossum@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 13:48:39 +02:00
Michael Kerrisk
9a06730f49
fcntl.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 13:08:51 +02:00
Michael Kerrisk
94e66ffdb0
ptrace.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 13:08:24 +02:00
Michael Kerrisk
6f7b566c55
fcntl.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 13:07:18 +02:00
Michael Kerrisk
b1f91dc142
sigaction.2: Refer the reader to fcntl(2) F_SETSIG for further details on si_fd
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 13:05:18 +02:00