Michael Kerrisk
4dd85833c1
unshare.2: Document use of CLONE_THREAD, CLONE_SIGHAND, and CLONE_VM
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:01 -07:00
Michael Kerrisk
7e0e902b55
clone.2, getpid.2, credentials.7: Replace reference to namespaces(7) with pid_namespaces(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
f58fb24f16
clone.2, seteuid.2, setgid.2, setresuid.2, setreuid.2, setuid.2, unshare.2, capabilities.7, credentials.7: Change reference to namespaces(7) to user_namespaces(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
16fe718f99
setns.2: wfix
2014-09-13 20:15:59 -07:00
Michael Kerrisk
e57c3979fe
setns.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
ec66fbfff5
setns.2: Reorganize text on user namespaces
...
And add reference to user_namespaces(7).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
5c8d010b84
setns.2, unshare.2: Add reference to pid_namespaces(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
5c67baab4f
setns.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
7fc8e5ece2
setns.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
edc3c3b4c0
setns.2: Attempt to rejoin current user namespace gives EINVAL
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
365d292a3c
clone.2, unshare.2, namespaces.7: clone() and unshare() fail (EPERM) if caller's UID/GID are not mapped
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk
0076479cdd
seteuid.2, setgid.2, setresuid.2, setreuid.2, setuid.2: EINVAL can occur if UID/GID is not valid in caller's user namespace
...
Also add namespaces(7) under SEE ALSO.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk
4effb5bec3
getpid.2, mount.2, uname.2, proc.5, credentials.7, mq_overview.7, svipc.7: SEE ALSO: add namespaces(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
41096af101
clone.2, setns.2, unshare.2: SEE ALSO: add namespaces(7); remove proc(5)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
13009cfaa6
setns.2: Change page xref from proc(5) to namespaces(7)
2014-09-13 20:15:57 -07:00
Michael Kerrisk
663e3be88a
clone.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
ab5dd83f7a
clone.2: Standardize text on CLONE_NEW* flags and CAP_SYS_ADMIN
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
83d9e9b2bc
clone.2, namespaces.7: Move some CLONE_NEWUTS text from clone.2 to namespaces.7
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
9cc7ad66df
clone.2: Remove CLONE_NEWUTS text that is duplicated in namespaces(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
9d005472a8
clone.2, namespaces.7: Move some CLONE_NEWUSER text from clone.2 to namespaces.7
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
3dd2331ce7
clone.2: Reword discussion of CLONE_NEWNS, removing text also in namespaces(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
73680728d1
clone.2, namespaces.7: Move some CLONE_NEWNET text from clone.2 to namespaces.7
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
9343f8e7c3
clone.2, namespaces.7: Move some CLONE_NEWIPC text from clone.2 to namespaces.7
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
76f8f97395
unshare.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
36ec1f75e4
unshare.2: Clarify that unshare(CLONE_NEWUSER) does confer capabilities on the caller
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk
c79b7a8184
unshare.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
3d02560dbb
unshare.2: SEE ALSO: add proc(5)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
f919b6e410
unshare.2: Add an example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
e939d607ea
unshare.2: SEE ALSO: add unshare(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
2193656a7c
unshare.2: Add some details to CLONE_NEWPID description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Eric W. Biederman
37ee2d61e5
unshare.2: Add details to CLONE_NEWPID and CLONE_NEWUSER documentation
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
8f141c5e3c
unshare.2: Document CLONE_NEWPID
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
c2cd5a7fd9
unshare.2: Document CLONE_NEWUSER
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
eb359a0988
unshare.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
667f4c7891
unshare.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
040eaa70ed
clone.2: SEE ALSO: add proc(5)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
730e9c01cf
clone.2: Document behavior of clone(CLONE_NEWUSER | CLONE_NEWXXX)
...
Based on email exchanges with Eric Biederman
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
a0efdddb73
clone.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
fefbcba85c
clone.2: Note capability requirements for using CLONE_NEWUSER before Linux 3.8
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
4d2b3ed7c1
clone.2: Correct kernel version where CLONE_NEWUSER first appeared
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
642ce311ba
clone.2: Note that CLONE_NEWUSER needs CONFIG_USER_NS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
06b3045839
clone.2: Rework Eric's CLONE_NEWUSER patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
57ef8c39e7
clone.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Eric W. Biederman
70d21f174e
clone.2: Describe the user namespace (CLONE_NEWUSER)
...
Signed-off-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
7612b8a7e1
setns.2: setns() into a user namespace grants all capabilities in that namespace
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
3c98ab169f
setns.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
268a93cb30
setns.2: Specify kernel version on each CLONE_NEW* flag
...
And remove text on flags from VERSIONS.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
773f59eb02
setns.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
81714b4f86
setns.2: Rework discussion of restrictions on changing user namespace
...
After comments from Eric Biederman
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
21bfe3e933
setns.2: Clarify capabilities required for reassociating with a mount namespace
...
Based on comments from Eric Biederman.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
2a9f74a936
setns.2: SEE ALSO: Add unshare(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
f16c7698e2
setns.2: Clarify wording in CLONE_NEWPID discussion
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
49af76fed3
setns.2: Various fixes for text on PID, user, and mount namespace support
...
After comments from Eric Biederman
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
cd7e05aa16
setns.2: Fixes for text on PID, user, and mount namespace support
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Eric W. Biederman
99fd2fe3b5
setns.2: Document the PID, user, and mount namespace support
...
Document CLONE_NEWPID, CLONE_NEWUSER, and CLONE_NEWNS flags.
Signed-off-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk
eee740e3e4
getunwind.2: Fix description of return value
...
s/size of unwind table/size of the unwind data/
Reported-by: Yuri Kozlov <yuray@komyakino.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 19:13:33 -07:00
Michael Kerrisk
abd4248a0e
getunwind.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 19:08:17 -07:00
Michael Kerrisk
9cd6730cb9
flock.2: Don't mention "classical BSD" in discussion of fcntl()/flock interaction
...
The noninteraction of flock(2) and fcntl(2) locks does
not seem to be classical BSD semantics (at least, checking
the 4.4BSD sources suggest that the lock types do interact,
although there have been other systems also where fcntl()
and flock() locks do not interact). So, fix the text
discussing "classical BSD" lock semantics.
Reported-by: J. Bruce Fields <bfields@fieldses.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-10 07:56:59 -07:00
Michael Kerrisk
62c76ace78
memusage.1, memusagestat.1, connect.2, fcntl.2, poll.2, errno.3, rtnetlink.3, inotify.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-07 05:03:19 -07:00
Rusty Russell
d2e7d1bb58
poll.2, select.2: fix erroneous description of "available for write".
...
POSIX says: "POLLOUT Normal data may be written without
blocking.". This is "may" is misleading, see the POSIX
write page:
Write requests to a pipe or FIFO shall be handled in the
same way as a regular file with the following exceptions:
...
If the O_NONBLOCK flag is clear, a write request may cause
the thread to block, but on normal completion it shall
return nbyte.
...
When attempting to write to a file descriptor (other than a
pipe or FIFO) that supports non-blocking writes and cannot
accept the data immediately:
If the O_NONBLOCK flag is clear, write() shall block the
calling thread until the data can be accepted.
If the O_NONBLOCK flag is set, write() shall not block the
thread. If some data can be written without blocking the
thread, write() shall write what it can and return the
number of bytes written. Otherwise, it shall return -1 and
set errno to [EAGAIN].
The net result is that write() of more than 1 byte on a
socket, pipe or FIFO which is "ready" may block: write()
(unlike read!) will attempt to write the entire buffer and
only return a short write under exceptional circumstances.
Indeed, this is the behaviour we see in Linux:
897626152d
https://plus.google.com/103188246877163594460/posts/BkTGTMHDFgZ
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 19:36:03 +02:00
Christian von Roques
f36a14687b
open.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 19:07:04 +02:00
Michael Kerrisk
9af134cdeb
getrlimit.2, mmap.2, stat.2, unimplemented.2, dbopen.3, ecvt_r.3, fopen.3, fts.3, getcontext.3, qecvt.3, ip.7, ld.so.8: grfix: Add Oxford comma
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 17:57:07 +02:00
Michael Kerrisk
229c33a1d3
perf_event_open.2: srcfix: add FIXME
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 17:52:05 +02:00
Michael Haardt
977e3384e5
connect.2: Note that a new socket should be used if connect() fails
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 17:07:18 -05:00
Michael Kerrisk
bea08fec7e
adjtimex.2, bind.2, cacheflush.2, clone.2, fallocate.2, fanotify_init.2, fanotify_mark.2, flock.2, futex.2, getdents.2, getpriority.2, getrlimit.2, gettid.2, gettimeofday.2, ioprio_set.2, kexec_load.2, migrate_pages.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, msgop.2, nfsservctl.2, perf_event_open.2, pread.2, ptrace.2, recvmmsg.2, rename.2, restart_syscall.2, sched_setattr.2, send.2, shmop.2, shutdown.2, sigaction.2, signalfd.2, syscalls.2, timer_create.2, timerfd_create.2, tkill.2, vmsplice.2, wait.2, aio_init.3, confstr.3, exit.3, fmemopen.3, fopen.3, getaddrinfo.3, getauxval.3, getspnam.3, isalpha.3, isatty.3, mallinfo.3, malloc.3, mallopt.3, psignal.3, pthread_attr_setinheritsched.3, qecvt.3, queue.3, rtnetlink.3, strerror.3, strftime.3, toupper.3, towlower.3, towupper.3, initrd.4, locale.5, proc.5, bootparam.7, capabilities.7, ddp.7, fanotify.7, icmp.7, inotify.7, ip.7, ipv6.7, netdevice.7, netlink.7, path_resolution.7, rtld-audit.7, rtnetlink.7, sched.7, signal.7, socket.7, svipc.7, tcp.7, unix.7, ld.so.8: srcfix: Update FIXMEs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 16:47:44 -05:00
Michael Kerrisk
9bcc9e428c
fcntl.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 13:48:32 -05:00
Michael Kerrisk
37c240d14c
fcntl.2: One must define _GNU_SOURCE to get the F_OFD_* definitions
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 13:47:25 -05:00
Michael Kerrisk
9bbf6fbf5a
swapon.2: srcfix: add FIXME
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 11:29:26 -05:00
Michael Kerrisk
ef4f4031ca
Removed trailing white space at end of lines
2014-08-19 12:01:21 -05:00
Michael Kerrisk
8980a50087
access.2, bdflush.2, bind.2, brk.2, chmod.2, chown.2, clone.2, epoll_wait.2, execve.2, fsync.2, getgroups.2, gethostname.2, getpagesize.2, getpriority.2, getrlimit.2, ioperm.2, kexec_load.2, link.2, mkdir.2, mmap.2, msgop.2, perf_event_open.2, process_vm_readv.2, ptrace.2, readlink.2, readv.2, recv.2, rename.2, sched_setaffinity.2, select.2, send.2, seteuid.2, signal.2, sigwaitinfo.2, stat.2, symlink.2, sync.2, sync_file_range.2, sysinfo.2, timer_create.2, uname.2, unlink.2, utime.2, wait.2, abs.3, atoi.3, catopen.3, cerf.3, cexp2.3, clearenv.3, clog2.3, ctime.3, des_crypt.3, ecvt.3, fgetgrent.3, flockfile.3, fseeko.3, ftime.3, ftok.3, ftw.3, getauxval.3, getcwd.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, getline.3, getpass.3, getutent.3, glob.3, insque.3, lseek64.3, memmem.3, mkstemp.3, mktemp.3, on_exit.3, openpty.3, putenv.3, qecvt.3, realpath.3, remove.3, setbuf.3, sigpause.3, strftime.3, strptime.3, strstr.3, strtod.3, tzset.3, updwtmp.3, xcrypt.3, core.5, utmp.5, capabilities.7, charsets.7, environ.7, ipv6.7, man-pages.7, packet.7, vdso.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-19 11:55:41 -05:00
Michael Kerrisk
e1c083b606
getgroups.2: SEE ALSO: add group_member(3)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:20:49 -05:00
Michael Kerrisk
b9311895da
seteuid.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:51 -05:00
Michael Kerrisk
0e8cfea791
readv.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:51 -05:00
Michael Kerrisk
d8ae75789f
msgop.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:51 -05:00
Michael Kerrisk
ed86e39a63
getpagesize.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:50 -05:00
Michael Kerrisk
a82507ce75
execve.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:50 -05:00
Michael Kerrisk
47709e55b3
utime.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:49 -05:00
Michael Kerrisk
64e67357e2
sync.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:49 -05:00
Michael Kerrisk
7537792e3a
sync.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:49 -05:00
Michael Kerrisk
63f70e10fc
signal.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
30a63ffaeb
signal.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
1e95d1ba13
shmop.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
a4a6fd7459
send.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
565ee7678e
select.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
083e5b2f39
select.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
7e09b555e5
select.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
e6f84c8f8c
recv.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
5ef6332e7b
recv.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
abaa5fb051
ioperm.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
cf17af8246
clone.2: Remove ancient Linux libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
531bbb0fbe
sysinfo.2: Add VERSIONS section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
4bc6c6c982
sysinfo.2: Remove ancient libc details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
b81463d687
kexec_load.2: Add KEXEC_ARCH_68K to list of architectures for 'flags'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
0fe0cc46d5
kexec_load.2: Note limit of 16 for 'nr_segments'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
d0e37bbc4a
kexec_load.2: Reword description of 'flags' a little
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
7d14eaf1a1
kexec_load.2: Clarify the 'flags' bits that contain the architecture
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
029770dcd2
seteuid.2: Add "libc/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
63a1f6e183
sigwaitinfo.2: The raw sigtimedwait() system call has a fifth argument
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
93a3b5ca7b
getrlimit.2: Glibc's setrlimit() and getrlimit() are implemented using prlimit()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
7add6ac9a4
getrlimit.2: Describe the "large" resource limit bug on 32-bit platforms
...
See https://bugzilla.kernel.org/show_bug.cgi?id=5042 .
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
9bd519776f
getrlimit.2: srchfix: Add further details on prlimit() commits
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
4711f72291
getrlimit.2: Add cross reference to core(5) in discussion of RLIMIT_CORE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
23ab261583
symlink.2: Glibc falls back to symlink() on kernels that lack symlinkat()
2014-08-18 17:01:48 -05:00
Michael Kerrisk
d20e418098
unlink.2: Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:48 -05:00
Michael Kerrisk
cf81f364e8
access.2: Glibc falls back to using access() on kernels that lack faccessat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
c71a9ed732
link.2: Glibc falls back to link() on kernels that lack linkat()
...
Unless 'flags' contains AT_SYMLINK_FOLLOW.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
1e40dbf524
readlink.2: Glibc falls back to readlink() on kernels that lack readlinkat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
375ef2862f
chown.2: Glibc falls back to chown()/lchown() on kernels that lack fchownat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
782d622373
chmod.2: Glibc falls back to chmod() on kernels that don't support fchmodat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
f17342a5a3
mkdir.2: Glibc falls back to mkdir() on kernels that don't support mkdirat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
387ebb9cd5
rename.2: Glibc falls back to rename() when the kernel doesn't have renameat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
81428c3a09
epoll_wait.2: NOTES: describe raw epoll_pwait() system call differences
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
624ef27446
sync_file_range.2: NOTES: add "sync_file_range2()" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
8d0641ea0a
getpriority.2: Enhance discussion of kernel nice range versus user-space nice range
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
0ebe771f91
getpriority.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
95591ecace
getpriority.2: Move text describing nice range on other systems
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
361ec6881d
poll.2: Describe fifth argument (sigsetsize) of raw ppoll() system call
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
53a99749df
ptrace.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
f47eacb5c9
wait.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
8ac24680a1
uname.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
5780ef775e
sched_setaffinity.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
72896e8749
wait.2: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
dc9378209e
gethostname.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
e8796f63a0
clone.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
8f692313d1
access.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
32bd726426
readv.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
360b1b71de
poll.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
7582981b6f
brk.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
35c189fbd6
mmap.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
de76572d12
timer_create.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
c8c02fadd4
chmod.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:47 -05:00
Michael Kerrisk
68f611bdae
signalfd.2: Add "C library/kernel ABI differences" subheading under NOTES
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:46 -05:00
Michael Kerrisk
93e6560b29
eventfd.2: Change subheading to "C library/kernel ABI differences"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:46 -05:00
Michael Kerrisk
17ec2d2782
select.2: Change "Linux notes" subheading to "C library/kernel ABI differences"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:46 -05:00
Michael Kerrisk
0e42c515c9
process_vm_readv.2: Fix typo in example program
...
Reported-by: Ville Ylenius <ville@ylenius.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:46 -05:00
Michael Kerrisk
790ee6d628
perf_event_open.2: wfix
...
Reported-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-17 10:30:51 -05:00
Michael Kerrisk
5ab35ae520
perf_event_open.2: Tweaks to Vince Weaver's "document new comm_exec flag" patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-17 10:30:51 -05:00
Vince Weaver
49bc411c34
perf_event_open.2: Document new comm_exec flag
...
Linux 3.16 (more specifically, commit 82b897782d10fcc4 )
added support for differentiating between process renames
caused by exec versus those caused by other methods.
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-17 10:30:51 -05:00
Michael Kerrisk
3a058284b6
perf_event_open.2: Tweaks to Vince Weaver's patch "document new mmap2 record type"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-17 10:30:45 -05:00
Vince Weaver
9bfc542b93
perf_event_open.2: Document new mmap2 record type
...
Linux 3.16 (more specifically, commit a5a5ba72843dd05f9 )
enabled the enhanced mmap2 record support.
The interface was added in Linux 3.12 but disabled until
Linux 3.16.
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-17 10:30:38 -05:00
Vince Weaver
aea60aad0b
perf_event_open.2: Document PERF_SAMPLE_BRANCH_COND
...
Linux 3.16 (more specifically, commit bac52139f0b7ab31330 )
adds support for gathering PERF_SAMPLE_BRANCH_COND
conditional branch values when doing PERF_SAMPLE_BRANCH_STACK
sampling.
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-17 10:30:37 -05:00
Simon Paillard
31d7909822
open.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-15 20:23:35 +02:00
Simon Paillard
4213c13e85
readv.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-15 20:22:53 +02:00
Simon Paillard
237f3803eb
open_by_handle_at.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-15 20:22:38 +02:00
Mike Frysinger
0ce8e1cd4e
rename(2): ffix
...
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-15 20:03:34 +02:00
Adrian Bunk
c023a7f875
bdflush.2, fsync.2, sync.2, proc.5: Change "sync(1)" to "sync(8)"
...
This seems to be a remnant from the times when man-pages
shipped a sync(8).
Signed-off-by: Adrian Bunk <bunk@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-01 22:02:15 +02:00
Michael Kerrisk
a83923cafb
open.2: wfix
...
Reported-by: Rahul Bedarkar <rahulbedarkar89@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-01 21:57:51 +02:00
D. Barbier
c435eb91ad
sigaltstack.2: tfix
...
Fix typo introduced in 0c892e5
.
Denis
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-30 08:40:36 +02:00
Michael Kerrisk
e77c5c7431
recv.2: 'addrlen' should be NULL (not 0) if we don't need sender address
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-28 13:40:10 +02:00
Michael Kerrisk
b18ea63300
bind.2: Correct EINVAL error description
...
As pointed out by Ryan:
My application is trying to bind an IPV4 UDP socket to an
address. I've found that passing an invalid address length
to bind() causes bind to return EINVAL. According to the
bind(2) manpage, this should only occur when using unix
domain sockets (which I am not).
Reported-by: Ryan Hammonds <rhammonds@unicoi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-22 07:40:22 +02:00
David Prévot
cc2b44ebed
stat.2: nfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-22 07:17:07 +02:00
Vince Weaver
bc9d90b589
perf_event_open.2: Clarify PERF_SAMPLE_DATA_SRC usage
...
When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
you need to shift the masks before doing the compare.
Although the value you are checking (perf_mem_data_src) is
specified as a bitfield so this might all fall apart if trying
to access the field in a cross-endian way. The Power people
were working on this issue, not sure if they resolved it.
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-20 09:22:47 +02:00
Vince Weaver
02ca78a0c7
perf_event_open.2: Clarify PERF_SAMPLE_STACK_USER usage
...
This clarifies the PERF_SAMPLE_STACK_USER section.
I found these issue while implementing some code that uses
the option. The important change is fixing the name of the
sample_stack_user parameter, the rest is just some wording
fixes and minor clarifications.
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-20 09:22:47 +02:00
David Prévot
9fdb563ecd
fanotify_mark.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-13 10:29:57 +02:00
NeilBrown
c835f12b9b
epoll_ctl.2: minor clarification concerning when a WAKEUP event is "processed"
...
I guess it should be obvious, but it never hurts to be explicit.
When the epoll file descriptor is closed all events are assumed
to be "processed".
Also if the event is removed with EPOLL_CTL_DEL or the EPOLLWAKEUP
flag is removed with EPOLL_CTL_MOD the event will be "processed".
Signed-off-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-09 10:25:09 +02:00
Michael Kerrisk
cbe0e64447
Removed trailing white space at end of lines
2014-07-08 16:36:37 +02:00
Michael Kerrisk
c77eace5b1
iconv.1, ldd.1, connect.2, dup.2, epoll_ctl.2, eventfd.2, fallocate.2, fcntl.2, getitimer.2, inotify_add_watch.2, open.2, pipe.2, poll.2, sendmmsg.2, set_tid_address.2, shmop.2, signalfd.2, splice.2, syscalls.2, syslog.2, tee.2, vmsplice.2, ether_aton.3, mallopt.3, printf.3, profil.3, charmap.5, proc.5, epoll.7, inotify.7, libc.7, pipe.7, sched.7, socket.7, udplite.7, iconvconfig.8, ld.so.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:14:48 +02:00
Michael Kerrisk
d2b6be9a2d
fcntl.2: Suggest the use of real-time signals with F_NOTIFY
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 12:22:25 +02:00
Michael Kerrisk
1ce579fc39
fcntl.2: ERRORS: Document ENOTDIR error for F_NOTIFY
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 12:07:15 +02:00
Elie De Brauwer
4fe82a332b
pipe.2: PIPE_BUF is defined in limits.h
...
To make use of PIPE_BUF in an application one should include limits.h.
Adding a reference to this inclusion.
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:26 +02:00
Michael Kerrisk
8ab32b4785
epoll_ctl.2: BUGS: EPOLLWAKEUP is silently ignored without CAP_BLOCK_SUSPEND
...
If the caller does not have CAP_BLOCK_SUSPEND, then EPOLLWAKEUP
is silently ignored.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:18 +02:00
Michael Kerrisk
1bc86e8a0d
epoll_ctl.2: Minor tweaks to Neil Brown's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:11 +02:00
NeilBrown
573f05ef42
epoll_ctl.2: Document EPOLLWAKEUP
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:10 +02:00
Michael Kerrisk
6351139b47
set_tid_address.2: SEE ALSO: add gettid(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-06 09:15:06 +02:00
Michael Kerrisk
b5693a3854
set_tid_address.2: Use "thread" rather than "process" in DESCRIPTION
...
Reported-by: Rich Felker <dalias@libc.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-06 09:13:40 +02:00
Michael Kerrisk
b701f72de4
syscalls.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-06 09:11:03 +02:00
Michael Kerrisk
8be6f4e1cd
fcntl.2: Use proper page cross-references in F_NOTIFY discussion
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-05 08:54:58 +02:00
Michael Kerrisk
e2cfd90e5b
poll.2: The negate-fd-to-ignore technique does not work for file descriptor 0
...
See https://bugzilla.kernel.org/show_bug.cgi?id=79411
Reported-by: Nadav Har'El <nyh@math.technion.ac.il>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-03 08:17:14 +02:00
Michael Kerrisk
5c4d5f9715
fcntl.2: The return value for F_SETPIPE_SZ is the pipe capacity
...
Reported-by: Tomi Salminen <tlsalmin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-01 11:40:36 +02:00
Michael Kerrisk
417e4f5c50
getitimer.2: Rewrite a few pieces to clarify some details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-01 09:36:28 +02:00
Michael Kerrisk
422bb2b4ec
dup.2: Fix erroneous discussion regarding closing 'newfd' before calling dup2()
...
And propose a workaround if the caller cares about catching
close() time errors.
See http://stackoverflow.com/questions/23440216/race-condition-when-using-dup2#comment36888604_23444465
and http://austingroupbugs.net/view.php?id=411
Reported-by: Rich Felker <dalias@libc.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk
44505a6fdc
dup.2: Rework and enhance discussion of dup2()
...
In particular, note that dup2() performs the steps of closing
and reusing 'newfd' atomically.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk
7ecb725e10
dup.2: Add subhead for dup3()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk
7499e6bc8e
inotify_add_watch.2: Clarify that the target of a watch is an i-node
...
The target of a watch is an i-node, not a pathname. Clarify
the text to prevent the reader possibly misunderstanding
that establishing watches by two different links to the same
file might create different watch descriptors.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-28 07:38:40 +02:00
Michael Kerrisk
65558bedaa
connect.2: ERRORS: add EPROTOTYPE
...
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=708394
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-27 08:57:08 +02:00
Michael Kerrisk
2d2c6782ae
shmop.2: Explain SHMLBA in much more detail
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 11:40:54 +02:00
Michael Kerrisk
e530d422dc
syslog.2: Rewrite parts of the page, and import /proc/sys/kernel/printk
...
* Move /proc/sys/kernel/printk from proc(5) to this page,
and correct various details in the discussion of that file.
* Rewrite and correct various other details on the page.
* Clean out some crufty text.
* Miscellaneous minor fixes.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:35:21 +02:00
Michael Kerrisk
51c9e67e6b
syslog.2: Update SYSLOG_ACTION_CONSOLE_OFF + SYSLOG_ACTION_CONSOLE_ON description
...
Details changed in Linux 2.6.32
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:35:21 +02:00
Michael Kerrisk
ce26c69b15
syslog.2: srcfix: Update copyright
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:35:21 +02:00
Michael Kerrisk
f4775e5db1
syslog.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:35:21 +02:00
Michael Kerrisk
0e0901c18c
syslog.2: Minor wording/grammar fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:35:20 +02:00
Michael Kerrisk
e32652ca9f
syslog.2: Rework text describing loglevels
...
The kernel header file mentioned in the discussion of the KERN_*
constants has morphed and is no longer exported inside glibc.
And the definitions of the constants themselves changed subtly
with kernel commit 04d2c8c83d0e3ac5f78aeede51babb3236200112.
So, rewrite the description of the constants to be a bit more
abstract.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:35:20 +02:00
Michael Kerrisk
7fdbbd1ed4
syslog.2: Rework introductory paragraph
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:35:20 +02:00
Michael Kerrisk
56cb065052
vmsplice.2: Document EAGAIN error
...
See https://bugzilla.kernel.org/show_bug.cgi?id=48641
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-18 16:03:09 +02:00
Michael Kerrisk
b7224af900
tee.2: Document EAGAIN error
...
See https://bugzilla.kernel.org/show_bug.cgi?id=48641
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-18 16:02:55 +02:00
Michael Kerrisk
0655aa15d2
splice.2: Document EAGAIN error
...
See https://bugzilla.kernel.org/show_bug.cgi?id=48641
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-18 16:01:55 +02:00
Michael Kerrisk
eb9a0b2f75
intro.1, gettimeofday.2, mkdir.2, nice.2, setresuid.2, stime.2, adjtime.3, getttyent.3, proc.5: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-18 15:38:13 +02:00
Michael Kerrisk
6807fc6f8a
open.2: O_CLOEXEC is also one the flags not ignored when O_PATH is specified
...
Reported-by: Кирилл <kirillnow@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-18 12:12:56 +02:00
Carlos O'Donell
7b08c45b7d
syscalls.2: Add prlimit64(2)
...
While trying to reconcile the new features in glibc with the
documented entries in the linux kernel man pages I noticed that
glibc exports prlimit64 for use by 32-bit applications (as does
the linux kernel), but that prlimit64 was not defined in the
syscalls list or in the prlimit-related page.
This is not the complete fix for this, but I don't have the time
to explain why and when prlimit64 should be used (or how it should
be used safely). Therefore I'm just patching the syscalls.2 list
to show that prlimit64 exists and was added in 2.6.36 (verified
with git by checking out the tags before and after).
Unless you've purposely excluded prlimit64 to avoid telling users
about it because it's complicated, please apply.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-17 20:17:28 +02:00
Simon Paillard
d65250f528
shmget.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-17 07:32:00 +02:00
Simon Paillard
a1fa36afd2
:eventfd.2, fallocate.2, open.2, sendmmsg.2, signalfd.2, proc.5, sched.7, socket.7, udplite.7: spfix: "behaviour": use American spelling "behavior" instead
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-17 07:27:20 +02:00
Michael Kerrisk
91085d8525
Removed trailing white space at end of lines
2014-06-14 08:03:45 +02:00
Michael Kerrisk
ad5b45abe5
localedef.1, execve.2, fcntl.2, flock.2, lseek.2, open.2, open_by_handle_at.2, recvmmsg.2, sendmmsg.2, seteuid.2, setresuid.2, setreuid.2, setuid.2, statfs.2, syscalls.2, basename.3, catgets.3, getdate.3, getdirentries.3, getdtablesize.3, iconv.3, lockf.3, malloc_get_state.3, malloc_usable_size.3, matherr.3, mkdtemp.3, mkstemp.3, mq_close.3, mq_unlink.3, siginterrupt.3, system.3, locale.5, bootparam.7, environ.7, man-pages.7, signal.7, unicode.7, utf-8.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-13 17:15:44 +02:00
Michael Kerrisk
864eb97814
fcntl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-12 15:29:19 +02:00
NeilBrown
24c1b109f8
times.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-12 14:18:48 +02:00
Michael Kerrisk
85c984a114
remap_file_pages.2: Note that remap_file_pages() is deprecated
...
Reviewed-by: Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-12 11:43:10 +02:00
Michael Kerrisk
b665034d43
syscalls.2: Note that remap_file_pages() is deprecated
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-12 07:14:21 +02:00
Michael Kerrisk
795d8ab168
statfs.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 10:01:19 +02:00
Michael Kerrisk
cefc036246
statfs.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 10:00:53 +02:00
Michael Kerrisk
f0b613ec52
statfs.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 10:00:25 +02:00
Michael Kerrisk
2e35bf6ddd
statfs.2: Correct kernel version for "statfs() broken for pipe FDs" bug
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 22:26:45 +02:00
Michael Kerrisk
f28710c6a0
statfs.2: Move Cyril Hrubis's "statfs() broken for pipe FDs" patch to BUGS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 22:21:42 +02:00
Michael Kerrisk
ac6f74b9b4
statfs.2: Minor tweaks to Cyril Hrubis's "statfs() broken for pipe FDs" patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 22:17:06 +02:00
Cyril Hrubis
8519cf245f
statfs.2: fstatfs(2) was broken on file descriptors from pipe(2)
...
Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 22:14:11 +02:00
Cyril Hrubis
3c794803b4
statfs.2: Update MAGIC constants
...
Most of the updates are taken from /usr/include/linux/magic.h,
some were found by grepping the Linux source code.
Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 22:12:29 +02:00
Michael Kerrisk
29d3bdc482
seteuid.2, setresuid.2, setreuid.2, setuid.2: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:41:32 +02:00
Michael Kerrisk
76868835e7
fcntl.2: Add notes on F_SETLKW deadlock detection and its limitations
...
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk
241e02302d
fcntl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk
d2e429c1a8
fcntl.2: The kernel does not perform deadlock detection for OFD locks
...
See kernel commit 57b65325fe34ec4c917bc4e555144b4a94d9e1f7
And this mail thread:
http://thread.gmane.org/gmane.linux.file-systems/81318/focus=81327
From: Jeff Layton <jlayton <at> redhat.com>
Subject: [PATCH v5 13/14] locks: skip deadlock detection on FL_FILE_PVT locks
Date: 2014-01-09 14:19:46 GMT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk
d20d9d33ab
open.2: Rework and extend the discussion of open file descriptions
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk
22603b1d5c
lseek.2: Add reference to open(2) for discussion of file descriptors and OFDs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk
6451570257
fcntl.2: Under OFD locks add a reference to open(2) for explanation of OFDs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk
5879ccc0d3
fork.2: Add notes on inheritance of flock() and OFD locks across fork()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:49 +02:00
Michael Kerrisk
d068eb3b73
fcntl.2: Explain POSIX background to EACCES/EAGAIN error for F_GETLK
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
9c26bc8c20
fcntl.2: F_OFD_GETLK fails with EAGAIN when there is a lock conflict
...
For F_GETLK, POSIX allows EACCES or EAGAIN because different
implementations of traditional record locks returned one of
these errors, and portable applications had to handle either
possibility. However, that argument doesn't apply for OFD
locks, since Linux is the only implementation and it returns
EAGAIN.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
6024e7332f
fcntl.2: Describe how to check whether the kernel supports a particular command
...
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
102b34d811
fcntl.2: ERRORS: add EINVAL for invalid 'cmd'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
d9312ec7c0
fcntl.2: Minor wording improvement
...
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
9044058e60
fcntl.2: Add an explicit note that mandatory locking is not in POSIX
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
f5cdb4b0fc
fcntl.2: Make the warning that mandatory locks are unreliable more prominent
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
6799ba26c9
fcntl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
9acee57885
fcntl.2: Rewrite introductory paragraphs on mandatory locking
...
Make the structure more logical, and also explicitly mention
OFD locks.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
4b5c506a2c
fcntl.2: Add EINVAL error for OFD locks where 'l_pid' is not 0
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
c11b47b3b1
fcntl.2: CONFORMING TO: note that OFD locks are Linux-specific
...
But they make their way into the next POSIX release
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
97e03523e5
fcntl.2: Describe semantics for compatible and conflicting OFD locks
...
And describe how threads can use OFD locks to ensure
exclusive access to a file.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
1a93af040c
fcntl.2: Detail the limitations of traditional (process-associated) locks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
bfb147160f
fcntl.2: Minor fixes to introductory par on OFD locks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
38702b6ccc
fcntl.2: OFD locks are Linux-specific and available since Linux 3.15
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
99b5ab7933
fcntl.2: Tweaks and rewrites of pieces of Jeff Layton's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Jeff Layton
2d3e4b83a3
fcntl.2: Document open file description locks
...
As provided by the fcntl() operations F_OFD_SETLK,
F_OFD_SETLKW, and F_OFD_GETLK
Signed-off-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
7562b10e23
fcntl.2: Add para introducing advisory locks and noting existence of OFD locks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
86fbd8d849
fcntl.2: Minor change: move some NOTES text on record locking
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
15b4459067
fcntl.2: wfix + ffix: fine-tuning on NFSv4 client locking text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
70fd304581
fcntl.2: Add NOTES subhead for record locking and NFS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
da0d60febb
fcntl.2: nfsv4leasetime controls the "contact lost" interval for NFSv4
...
Jeff Layton:
The difference here is subtle. The gracetime is how long after a reboot
should knfsd allow clients to reclaim state (and deny the creation of
new locks and opens). The leasetime is how long the NFSv4 lease period
is. There is a relationship between the two that's illustrated in the
comments above write_gracetime:
/**
* write_gracetime - Set or report current NFSv4 grace period time
*
* As above, but sets the time of the NFSv4 grace period.
*
* Note this should never be set to less than the *previous*
* lease-period time, but we don't try to enforce this. (In the common
* case (a new boot), we don't know what the previous lease time was
* anyway.)
*/
The value you're interested in here is the nfsv4leasetime. If the
client doesn't renew its lease within that period, then it's subject to
the server giving up on it and dropping any state that it holds on that
clients' behalf.
Note that this is not a firm timeout. The server runs a job
periodically to clean out expired stateful objects, and it's likely
that there is some time (maybe even up to another whole lease period)
between when the timeout expires and the job actually runs. If the
client gets a RENEW in there within that window, its lease will be
renewed and its state preserved.
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Cowritten-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
af8713605a
fcntl.2: Refine discussion of locks when NFSv4 client loses contact with server
...
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
6ca357f965
fcntl.2: Note treatment of locks when an NFS client loses contact with the server
...
Based on text sent by Neil Brown.
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
9584daf7f3
fcntl.2: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:48 +02:00
Michael Kerrisk
cf118c620f
fcntl.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:47 +02:00
Michael Kerrisk
91ac17b2c7
fcntl.2: Reword discussion of mandatory lock bug a litte
...
Jeff Layton confirmed that the bug remains even in modern kernels.
Reviewed-by: Jeff Layton <jlayton@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:47 +02:00
Michael Kerrisk
05a0fb665a
flock.2: In some modern BSDs, fcntl() and flock() locks do interact
...
So, reword and extend the discussion of this topic in NOTES.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:33:38 +02:00
Michael Kerrisk
b1b70920af
flock.2: Move NOTES text describing implementation of flock()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:30:37 +02:00
Michael Kerrisk
e449654fdb
flock.2: Add more details on NFS, including Linux 2.6.37 changes
...
Also: move NOTES text describing interaction of fcntl()
and flock() locks.
Reviewed-by: NeilBrown <neilb@suse.de>
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:30:37 +02:00
Yuri Kozlov
f2f50fed25
fanotify_mark.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-08 21:16:39 +02:00
Yuri Kozlov
d1c05d0b78
send.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-08 21:16:06 +02:00
Rasmus Villemoes
f41d7fb3de
sendmmsg.2: Add reference to feature_test_macros(7)
...
Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 20:45:30 +02:00
Rasmus Villemoes
9c57aa4847
recvmmsg.2: Add reference to feature_test_macros(7)
...
Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 20:45:11 +02:00
Rasmus Villemoes
cdcdcf71c3
open_by_handle_at.2: Add reference to feature_test_macros(7)
...
Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 20:44:39 +02:00
Michael Kerrisk
adab861a92
execve.2: RLIMIT_NPROC is checked only if preceded by set*uid()
...
Reported-by: Vasiliy Kulikov <segoon@openwall.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 17:10:56 +02:00
Michael Kerrisk
8349023145
execve.2: Before kernel 2.6.0, RLIMIT_NPROC had no effect for set*uid()
...
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 17:10:56 +02:00