LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
14,569 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

5350 Commits

Author SHA1 Message Date
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