Commit Graph

2166 Commits

Author SHA1 Message Date
Michael Kerrisk cda377d2bc namespaces.7: Clarify use of 'single line' case when writing userns map files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk e2eb61370e namespaces.7: Note rules regarding capabilities and nested namespaces
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk 9a80f81d04 namespaces.7: Clarify explanation of nested user namespaces
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk 6be09bd882 namespaces.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk fd4eb520d6 namespaces.7: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk aa49742066 namespaces.7: Mapping files are empty when a user namespace is first created
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk b87dd2afb0 namespaces.7: User namespace ID mappings can be defined via any member process's map
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk b2e73e0ce8 namespaces.7: Clarify max # of bytes that can be written to a user namespace map
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk 3fe8d14797 namespaces.7: Describe semantics of set-user/group-ID programs in a user namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:59 -07:00
Michael Kerrisk e420879421 namespaces.7: Rewrite EPERM rules for writing to user namespace map file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 1879c18c63 namespaces.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk d70ee6ff45 namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 6155c4554f namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 4d2d9a106f namespaces.7: Add further EINVAL cases for writes to userspace map files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 8e5924c0a9 namespaces.7: Clarify a detail in permissions for writing to user namespace map files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk cfc50babe7 namespaces.7: Violating rules for writing to user namespace map file yields EPERM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk ed0ce71a31 namespaces.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 76f89cbea4 namespaces.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk d3c16a98d1 namespaces.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 147a0c9098 namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk b680649a5c namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 291e9237d7 namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 029ae9e3f5 namespaces.7: SEE ALSO: add switch_root(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk c0004fb480 namespaces.7: Clarify details of sending signals to init from ancestor PID namespaces
After email from Eric Biederman

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk b16d757dfd namespaces.7: When a PID namespace terminates, the other processes get SIGKILL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk fc49d2ac6b namespaces.7: Repair discussion of signals that can be sent to pidns init process
From outside a PID namespace, only the SIGKILL and SIGSTOP
signals can be sent to the init process.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 3c96796395 namespaces.7: Fixes to text on forking a process into a PID namespace with no "init"
Based on comments from Eric Biederman

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk bcf8010e24 namespaces.7: Trying to add a new process to a PID namespace with no "init" fails
If the PID namespace init process has terminated, then
setns() on a previously opened /proc/PID/ns/pid file
will succeed, but the subsequent fork() will fail with
ENOMEM.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk ed94b9b881 namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 53d63b8925 namespaces.7: Document effect of PID namespaces when passing credentials over a socket
PIDs passed via UNIX domain sockets are translated according to
the receiving process's namespace.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 86499a6b26 namespaces.7: SEE ALSO: Add nsenter(1), unshare(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 3c7103af43 namespaces.7: Remove text on "equivalence" between clone() and fork()+unshare()
The text probably doesn't help the readers understanding much,
and it's not quite accurate in the case of PID namespaces.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 84c35715ba namespaces.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk ca29156707 namespaces.7: Explain why unshare() and setns() do not change caller's PID namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk e13b53a611 namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk e17d07c17b namespaces.7: Note treatment of PID namespace "init" process with respect to signals
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 33a3c1b8ec namespaces.7: Repair discussion of termination of "init" in PID namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 110026abe4 namespaces.7: Document PID namespace case where getppid() can return 0
getppid() can return 0 if parent is in a different namespace.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 7091f8f392 namespaces.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:58 -07:00
Michael Kerrisk 37d12157fd namespaces.7: Note exception to permissions needed when writing to uid_map/gid_lmap
Quoting mail with Eric Biederman:

>>> So, by the way, I added this sentence to the page:
>>>
>>>         In   order   to   write   to   the   /proc/[pid]/uid_map
>>>         (/proc/[pid]/gid_map) file,  a  process  must  have  the
>>>         CAP_SETUID (CAP_SETGID) capability in the user namespace
>>>         of the process pid.
>>>
>>> Is that correct?
>>
>> Yes.
>>
>>> But, there appear to be more rules than this governing whether a
>>> process can write to the file (i.e., various other -EPERM cases). What
>>> are the rules?
>>
>> In general you must also have CAP_SETUID (CAP_SETGID) in the parent user
>> namespace as well.  The one exception to that is if you are mapping
>> your current uid and gid.
>
> Can you clarify what you mean by "mapping your own UID and GID" please
> (i.e., who is "you" in that sentence).

At the time of clone() or unshare() that creates a new user namespace,
the kuid and the kgid of the process does not change.

setuid and setgid fail before any mappings are set up.

Therefore the caller is allowed to map any single uid to the uid of the
caller in the parent user namespace.  Likewise the caller is allowed to
map any single gid to the gid of the caller in the parent user

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 2a4cbd77a1 namespaces.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 857c57e70d namespaces.7: Document some disallowed cases for CLONE_NEWPID + CLONE_VM
Based on text from Eric Biederman

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk e7d2eab5d3 namespaces.7: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 027a0716d7 namespaces.7: Note that creation of most namespaces requires CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk a122e26793 namespaces.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 7a30282c0d namespaces.7: srcfix: Add Eric Biederman to copyright holders
The pieces on uid_map, gd_map and CLONE_NEWUSER were
originally drafted (in other pages) by Eric Biederman.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 9387987bbb namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk f2752f9088 namespaces.7: Add 'ls -l' example of /proc/PID/ns
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -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 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 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 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 b81acb1504 proc.5, namespaces.7: Move /proc/[pid]/{gid_map,uid_map} text from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk cf8bfe6d2a proc.5, namespaces.7: Move /proc/[pid]/mountstat text from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 4716a1dd65 proc.5, namespaces.7: Move /proc/[pid]/mountstats from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 357002ecdf proc.5, namespaces.7: Move /proc/[pid]/mounts from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 020357e8e4 namespaces.7: New page providing overview of Linux namespaces
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk a7d96776a1 capabilities.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 5bea231de3 capabilities.7: Document CAP_SETUID and CAP_SETGID for user namespace mappings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk c67d3814e7 capabilities.7: Since Linux 3.8, user namespaces no longer require CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Yuri Kozlov 08063d8f94 inotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 19:16:25 -07:00
Yuri Kozlov 9dcdfde411 inotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 19:15:50 -07:00
David Prévot 03c4a471ba ip.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 19:06:18 -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
Sorin Dumitru eb67122e5f packet.7: Fix include file
It looks like most of the socket options from this man pages
are not defined in <netpacket/packet.h>. They are defined in
<linux/if_packet.h> so we should include that one.

Note from mtk: it looks like <netpacket/packet.h> was based
on some ancient version of <linux/if_packet.h> that has not
been updated. Since linux/if_packet.h is under the "uapi" tree
the proposed patch seems the bext fix.

Signed-off-by: Sorin Dumitru <sdumitru@ixiacom.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 19:22:39 +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 858bbaaacb inotify.7: IN_CLOSE_WRITE occurs only for files (not monitored directory)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-29 19:15:38 +02:00
Michael Kerrisk f279ad490b inotify.7: IN_ACCESS occurs only for files inside directories
IN_ACCESS does not occur for monitored directory.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-29 19:11:35 +02:00
Michael Kerrisk e06fc20c37 inotify.7: IN_MODIFY is generated for files only (not monitored directories)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-29 19:06:26 +02:00
Michael Kerrisk 7465ffa6bb inotify.7: IN_OPEN and IN_CLOSE_NOWRITE can also occur for directories
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-29 18:58:33 +02: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 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 c81cea2caa capabilities.7: Add CAP_AUDIT_READ
CAP_AUDIT_READ is new in Linux 3.16.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:14:16 -05:00
Michael Kerrisk 97155fe548 packet.7: Remove ancient Linux libc details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:50 -05:00
Michael Kerrisk 8bdd902a95 ipv6.7: Remove ancient Linux libc details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:50 -05:00
Michael Kerrisk 1740dfa195 environ.7: Remove ancient Linux libc details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:50 -05:00
Michael Kerrisk 3a8bef11e0 man-pages.7: Add description of "C library/kernel ABI differences" subsection
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:46 -05:00
Michael Kerrisk 9042e249e4 man-pages.7: Rework text describing sections (stylistic improvements)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:46 -05:00
Michael Kerrisk 54a820120b vdso.7: Note kernel version that exports new i386 symbols (Linux 3.15)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:46 -05:00
Mike Frysinger 1b294717cc vdso.7: Add new i386 vdso symbols in Linux 3.15
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-18 17:01:38 -05:00
David Prévot 348f3b9d30 charsets.7: Tidy up list
Remove German from main list, to be consistent with earlier
removal of Dutch and French (in commit a8ed5f7430).

Acked-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-15 20:07:12 +02:00
Yuri Kozlov 79a022a606 capabilities.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-01 21:59:25 +02:00
Michael Kerrisk 8ee1a15c1b cpuset.7: tfix
Reported-by: Paul Jackson <pj@usa.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-30 11:49:19 +02:00
Yuri Kozlov a0fc2d2b9c capabilities.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-30 08:40:01 +02:00
Michael Kerrisk 3da9115905 inotify.7: Mention use of timeout when reading IN_MOVED_TO after IN_MOVED_FROM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-21 07:33:17 +02:00
Michael Kerrisk 003798c744 inotify.7: Note that insertion of IN_MOVED_FROM+IN_MOVED_TO pair is not atomic
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-21 07:30:21 +02:00
Michael Kerrisk 18d92a146c inotify.7: Note that IN_ONLY_DIR can be used to avoid races
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-20 09:22:47 +02:00
Yuri Kozlov 8a5fa4e63c cp1251.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-13 10:29:30 +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 e95b1911c4 inotify.7: Clarify with events are generated for watched directories
Really, with respect to watched directories, events fall into
three classes (not two, as was shown):

* Events that can be generated only for the watched directory.
* Events that can be generated only for objects that are inside
  the watched directory.
* Events that can be generated both for the watched directory
  and for objects inside the directory.

So, mark these three classes more clearly in the list of inotify
events.
dd

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 14:27:44 +02:00
Michael Kerrisk 640a438d9b pipe.7: Clarify that since 2.6.35, 65535 bytes is the default pipe capacity
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 14:33:38 +02:00
Elie De Brauwer 91d4de6683 pipe.7: Add reference that the pipe capacity can be changed.
In fcntl(2) F_SETPIPE_SZ, F_GETPIPE_SZ and /proc/sys/fs/pipe-max-size are
defined, however pipe(7) still defines the pipe capacity as being a static
entity. Adding a reference to fcntl(2).

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:31 +02:00
Michael Kerrisk d3695ae2c7 epoll.7: Minor tweaks to Neil Brown's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:15 +02:00
NeilBrown 6db5acce0e epoll.7: Document EPOLLWAKEUP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:12 +02:00
Michael Kerrisk f070e9543a inotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-01 08:16:49 +02:00
Michael Kerrisk 2eaa5bec3c libc.7: Clarify man-pages policy on documenting C libraries other tahn glibc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk 738dea653b libc.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk a59ac1b5a5 libc.7: Use absolute dates in discussion of libc vs glibc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk dcaff23c32 inotify.7: Clarify IN_ONESHOT explanation
Make it clearer that the target of monitoring is an i-node,
not a pathname.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:48:45 +02:00
Michael Kerrisk 7747b84b82 inotify.7: Clarify description of IN_EXCL_UNLINK
Clarify the text a little, in particular making it clearer
that the target of a watch is an i-node (not a pathname).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-28 07:52:48 +02:00
Michael Kerrisk 264545c62e inotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-28 07:49:06 +02:00
Michael Kerrisk 425ad621fc inotify.7: Make comment on 'mask' field more accurate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-27 15:59:23 +02:00
Michael Kerrisk 492d9973f4 unicode.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:09:28 +02:00
Michael Kerrisk 57e792311a utf-8.7: Minor formatting fixes
There's no need really to boldface names of standards and
character sets.

Reported-by: Marko Myllynen <myllynen@redhat.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:08:09 +02:00
Michael Kerrisk f2cf1fbfe5 unicode.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:01:18 +02:00
Michael Kerrisk beecf99ef7 unicode.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:00:03 +02:00
Michael Kerrisk 183520673b unicode.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 11:59:35 +02:00
Michael Kerrisk 9423e95b07 unicode.7: Minor formatting fixes
There's no need really to boldface names of standards and
character sets.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 11:58:39 +02:00
Michael Kerrisk 2bbf2299df inotify.7: The watch descriptor reuse bug may be hard to hit in practice
Explain the circumstances in detail, indicating that the
bug may be very unlikely to occur in practice.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 10:19:54 +02:00
Michael Kerrisk e530e367e2 inotify.7: Add further detail to the watch descriptor reuse bug
As well as inotify_rm_watch(), file deletion and unmounting a
filesystem can also cause a watch descriptor to be deleted.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 09:43:46 +02:00
Michael Kerrisk 975d7f3751 inotify.7: Minor fixes to Heinrich Schuchardt's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 09:41:32 +02:00
Heinrich Schuchardt ec976a53a3 inotify.7: BUGS: Note possible bug triggered by watch descriptor reuse
Watch descriptor IDs are returned by inotify_add_watch().
When calling inotify_rm_watch() an IN_IGNORE is placed on the
inotify queue pointing to the ID of the removed watch.

inotify_add_watchi() should not return a watch descriptor ID for
which events are still on the queue but should return an
unused ID.

Unfortunately, the existing Kernel code does not provide such a
guarantee.

Actually, in rare cases watch descriptor IDs are returned by
inotify_add_watch() for which events are still on the inotify
queue.

See https://bugzilla.kernel.org/show_bug.cgi?id=77111

Cowritten-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-23 09:09:27 +02:00
Yuri Kozlov 76eac093e3 cpuset.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-21 07:54:17 +02:00
Yuri Kozlov de396db503 cpuset.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-18 21:14:42 +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
Yuri Kozlov b545063112 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 19:43:06 +02:00
Yuri Kozlov 6cecebf175 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 19:42:34 +02:00
Marko Myllynen 9be7476d64 charsets.7: Reword ISO 2022 status slightly
Make its current popularity a bit more ambiguous.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-11 11:29:23 +02:00
Marko Myllynen 83f218d9d1 charsets.7: List CJK encodings in the order of C, J, K
Zero changes to the content, Unicode is now listed as the
last one.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 21:53:15 +02:00
Marko Myllynen 79172100b6 unicode.7: Update to reflect past developments
The unicode(7) page will look more modern with few small changes:

- drop old BUGS section, editors cope with UTF-8 ok these days,
  and perhaps the state-of-the-art is better described elsewhere
  anyway than in a man page
- drop old suggestion about avoiding combined characters
- refer to LANANA for Linux zone, add registry file reference
- drop a reference to an inactive/dead mailing list
- update some reference URLs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 16:51:19 +02:00
Marko Myllynen c664680afc utf-8.7: Drop an old comment about UTF-8 replacing ISO 8859
And add locale(1) under SEE ALSO.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-10 16:51:11 +02:00
Michael Kerrisk 3f205b20d7 environ.7: SEE ALSO: add env(1), printenv(1), ld.so(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-09 21:28:38 +02:00
Michael Kerrisk 79745892b6 charsets.7: Drop unneeded text on UTF-8 for Biblical Hebrew
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-06 06:37:46 +02:00
Michael Kerrisk 42d940faf8 charsets.7: Minor tweaks
And restore a piece about Biblical Hebrew that was
inadvertently deleted by Marko Myllynen's patch.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-05 20:18:02 +02:00
Marko Myllynen a8ed5f7430 charsets.7: Update to reflect past developments
Rewrite the introduction to make Unicode's prominence more obvious.
Reformulate parts of the text to reflect current Unicode world.
Minor clarification for ASCII/ISO sections, some other minor fixes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-05 13:46:36 +02:00
Marko Myllynen 66aa761533 locale.7: Add some SEE ALSO references
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-04 20:54:56 +02:00
Michael Kerrisk ffe8d0b14c bootparam.7: Minor tweaks to Petr Gajdos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-29 08:17:06 +02:00
Petr Gajdos 1c13782791 bootparam.7: Describe 'rootflags' and 'rootdelay' kernel parameters
Patch based on text from Documentation/kernel-parameters.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-29 08:00:22 +02:00
Michael Kerrisk 1c4b22fb91 man-pages.7: Note that .TH 'date' field is nowadays automatically updated by scripts
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk 8efc0168ad signal.7: Clarify text describing EINTR semantics for socket interfaces
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk 9c0381af73 signal.7: srcfix: Add FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk 88fb4f09f4 signal.7: Describe EINTR semantics for recvmmsg(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 21:22:47 +02:00
Michael Kerrisk bf2633795c credentials.7: Minor layout fixes to make list format more consistent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 17:05:43 +02:00
Michael Kerrisk 2ef6778bce Removed trailing white space at end of lines 2014-05-28 16:00:50 +02:00
Michael Kerrisk 8660ef9f1d locale.1, adjtimex.2, clone.2, fork.2, getrlimit.2, remap_file_pages.2, set_mempolicy.2, swapon.2, a64l.3, adjtime.3, argz_add.3, bstring.3, envz_add.3, fpathconf.3, fseek.3, gcvt.3, getaddrinfo_a.3, getauxval.3, getnameinfo.3, getrpcent.3, getrpcport.3, getspnam.3, getutent.3, inet.3, inet_net_pton.3, key_setsecret.3, makecontext.3, makedev.3, malloc_trim.3, mq_getattr.3, newlocale.3, nl_langinfo.3, perror.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigqueue.3, rcmd.3, re_comp.3, resolver.3, rexec.3, rtime.3, scandir.3, setlocale.3, setnetgrent.3, sigvec.3, tsearch.3, core.5, proc.5, charsets.7, locale.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 15:42:25 +02:00
Marko Myllynen 0eb0bdd201 locale.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:50:04 +02:00
Michael Kerrisk 60d02efc1d charsets.7: Remove ancient paragraph on charsets supported in glibc 2.3.2
That test is rather ancient, and probably of little use.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:43:12 +02:00
Michael Kerrisk 5b3318fbc9 charsets.7: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 11:42:47 +02:00
Michael Kerrisk 37aef8b24f charsets.7: Remove crufty statement that Romanian may be switching to ISO 8859-16
It certainly seems like that change happened some time ago.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 10:35:26 +02:00
Michael Kerrisk 11e751cbec charsets.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 10:03:43 +02:00
Michael Kerrisk 56a4e1ad7e cpuset.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 09:43:56 +02:00
Michael Kerrisk 39728c234e charsets.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-28 09:42:46 +02:00
Michael Kerrisk b331e0d0b7 locale.7: Clarify that LOCPATH is used by setlocale(3) and newlocale(3)
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Marko Myllynen 859476f7a9 locale.7: further details of LOCPATH
Helpful for three purposes, 1) shows the expected naming scheme,
2) shows where to point LOCPATH to, and 3) gives an idea to the
attentive how to use a more generic, location independent
directory with location dependent, more specific ones.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:11 +02:00
Heinrich Schuchardt 7a8110f6af inotify.7: munmap() does not generate inotify events
mmap() and msync() were already described as not leading to
inotify events. This patch adds munmap(). I created and executed
a test to verify this.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-26 10:16:05 +02:00
Michael Kerrisk 2483209a9c inotify.7: Minor changes to Heinrich Schuechardt's example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 23:07:08 +02:00
Heinrich Schuchardt ecd96f7c0e inotify.7: Add example program
This example of the usage of the inotify API shows the
usage of inotify_init1(2) and inotify_add_watch(2) as well
as polling and reading from the inotify file descriptor.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 22:42:29 +02:00
Michael Kerrisk 9fb49a3a80 locale.7: Tweaks to Marko Myllynen's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:42:20 +02:00
Marko Myllynen cd2b4f6efd locale.7: Document LOCPATH
Example from https://sourceware.org/glibc/wiki/Locales

After modifying a locale, make sure it compiles, and install it to a
temporary directory for testing:

  unset LC_ALL
  LOCALE=fi_FI
  export I18NPATH=$HOME/locale-test/
  export LOCPATH=$HOME/locale-test/
  mkdir -p $LOCPATH
  localedef --no-archive -f localedata/charmaps/UTF-8 -i localedata/locales/$LOCALE $I18NPATH/$LOCALE.UTF-8
  LC_TIME=$LOCALE.UTF-8 locale -ck LC_TIME
  LC_TIME=$LOCALE.UTF-8 locale -ck date_fmt
  LC_TIME=$LOCALE.UTF-8 date
  LC_CTYPE=$LOCALE.UTF-8 iconv -f UTF-8 -t ASCII//TRANSLIT < translit-test-input.txt
  LC_COLLATE=$LOCALE.UTF-8 sort < sorting-test-input.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:36:13 +02:00
Michael Kerrisk d099bdc501 locale.7: Add further details on various categories
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-24 20:28:25 +02:00
Heinrich Schuchardt 864eccb901 fanotify.7: fanotify_read should use aligned buffer
Michael Kerrisk pointed me to alignment issues which may
arise when reading misaligned integers.

On some systems integer values can only be read if they are
correctly aligned. Other system have a lower performance when
reading from or writing to misaligned memory positions.

Therefore, the buffer used to call read(2) for a fanotify
file descriptor should have the same alignment as
struct fanotify_event_metadata.

Due to the casting to char* inside the macros
FAN_EVENT_OK and FAN_EVENT_NEXT we can use any
data structure for the buffer.

With the patch an array of struct fanotify_event_metadata is
used as buffer which seems a natural choice to ensure proper
alignment.

It should be remembered that the offset between events is given
by field event_len and iterating over the array may not be
allowable in future. Instead the macros should be used.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:49:30 +02:00
Michael Kerrisk b8f84ce202 capabilities.7: CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 5f94327cf5 capabilities.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk eb64a9cb28 capabilities.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 1a3b63f7a0 capabilities.7: CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 838ad419e2 capabilities.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-22 08:23:26 +02:00
Michael Kerrisk 0da5e58ad2 Removed trailing white space at end of lines 2014-05-21 13:16:14 +02:00
Michael Kerrisk 3d15531307 chown.2, fcntl.2, futex.2, recvmmsg.2, sched_setscheduler.2, semget.2, shmget.2, malloc.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_setaffinity_np.3, strcpy.3, capabilities.7, cpuset.7, credentials.7, pthreads.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 13:15:30 +02:00
Michael Kerrisk 1aa556aba3 fanotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 12:47:54 +02:00
Michael Kerrisk 7c0f0ce0f0 fanotify.7: Minor wording changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 12:45:21 +02:00
Heinrich Schuchardt 3c36e6351a fanotify.7: Document FAN_EVENT_METADATA_LEN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-21 12:40:35 +02:00
Michael Kerrisk 98f7d53c92 fanotify.7: Fix description of FAN_EVENT_NEXT()
FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
pointer to the next metadata structure. In addition, generally
rework the description to be a bit clearer and more detailed.

Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
2014-05-21 08:59:04 +02:00
Michael Kerrisk 3eba8ff1f2 socket.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:32:33 +02:00
Michael Kerrisk 91edd9ad79 socket.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:32:23 +02:00
Michael Kerrisk 35ceb3e029 socket.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:31:58 +02:00
Michael Kerrisk 0e90cc471c ddp.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-19 09:14:46 +02:00
Michael Kerrisk e100191686 fanotify.7: Minor improvements to Heinrich Schuchardt's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-15 05:40:12 +02:00
Michael Kerrisk 1c61252673 fanotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-15 05:40:12 +02:00
Heinrich Schuchardt f96adfdc9f fanotify.7: BUGS: error events can be lost when reading from fanotify FD
Reviewed-by: Jan Kara <jack@suse.cz>
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-15 05:28:56 +02:00
Michael Kerrisk 283d0deff2 credentials.7: Mention sched_getattr() as a place where credentials are checked
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 21:20:10 +02:00
Michael Kerrisk 25ac81736e pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_setaffinity_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_yield.3, pthreads.7: Change references to "sched_setscheduler(2)" to "sched(7)"
Change consistent with the fact that the scheduling overview
page is now sched(7) not sched_setscheduler(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 21:19:59 +02:00
Michael Kerrisk edf9eec6be cpuset.7: SEE ALSO: add sched(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk f96787ab34 capabilities.7: Mention sched_setattr(2) under CAP_SYS_NICE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk dc365816e8 sched.7: Update timestamp after review
SCHED_DEADLINE content has been reviewed by Peter and Juri

Reviewed-by: Juri Lelli <juri.lelli@gmail.com>
Reviewed-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk 7bd7f43e80 sched.7: Minor fixes after review by Juri Lelli
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:29 +02:00
Michael Kerrisk 9cc1fa25fc sched.7: Add lots of details on SCHED_DEADLINE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 0756f58ff1 sched.7: Tweak ASCII art
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 91c98da6b4 sched.7: ffix and other minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Peter Zijlstra 7a0d183807 sched.7: Document SCHED_DEADLINE
Raw text from Peter Zijlstra

Cowritten-by: Juri Lelli <juri.lelli@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 0c055c7506 sched.7: Document sched_rt_period_us and sched_rt_runtime_us /proc files
And rework and relocate the text on dealing with runaway
real-time processes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 1608b67143 sched.7: sched_setattr(2) can also be used to set 'nice' value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 759e1210fc sched.7: Don't mention sched_setscheduler(2) in discussions of setting policies
In a couple of places, sched_setscheduler(2) is mentioned as the
way of setting policies. But now there is sched_setattr(2) as
well, rewrite the text in a more generic way.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 4c2eb0c23f sched.7: Mention sched_setattr(2) in list of APIs that can change policies
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 080a7c57de sched.7: Minor fix to page cross reference
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 2e868ccc47 sched.7: Remove mention of sched_setscheduler() when talking about sched_priority
There are nowadays multiple ways to set sched_priority (and
in fact there always were, since we also had sched_setparam(2)).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk 77dab50a68 sched.7: Rework summary text describing sched_setattr(2) and sched_getattr(2)
Note that these APIs are a superset of sched_setscheduler(2)
and sched_getscheduler(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-14 20:45:28 +02:00
Michael Kerrisk f7a858b447 sched.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 10:10:06 +02:00
Michael Kerrisk 961df2a80e sched.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 09:17:41 +02:00
Michael Kerrisk 1154a064e4 sched.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 09:05:08 +02:00
Michael Kerrisk 9ec47534aa sched.7: Remove crufty text relating to sched_setscheduler()
All of the removed text is in sched_setscheduler(2) and
should have been trimmed from this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 09:04:03 +02:00
Michael Kerrisk 2a8866c4ac sched.7: Minor fix: remove some crufty text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:59 +02:00
Michael Kerrisk d630434e64 sched.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:59 +02:00
Michael Kerrisk 458689edcf sched.7: SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:59 +02:00
Michael Kerrisk 3d1ee4971b delete_module.2, perf_event_open.2, sched_setscheduler.2, shmctl.2, gai.conf.5, resolv.conf.5, fanotify.7, man-pages.7: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-12 08:44:56 +02:00
Michael Kerrisk d50ee7fb40 man-pages.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-11 08:51:42 +02:00
Michael Kerrisk 91f5e870ab sched.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-10 16:27:15 +02:00
Michael Kerrisk 5813ff929b sched.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-10 07:23:15 +02:00
Michael Kerrisk 005eaa8f76 sched.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-10 07:22:47 +02:00
Michael Kerrisk b963d0e33b sched.7: SEE ALSO: Mention more files in Documentation/scheduler/ directory
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 15:21:59 +02:00
Michael Kerrisk 726663fd9d bind.2, connect.2, create_module.2, delete_module.2, execve.2, get_robust_list.2, getpriority.2, getrusage.2, init_module.2, link.2, listen.2, mbind.2, open.2, poll.2, query_module.2, readlink.2, recv.2, remap_file_pages.2, sched_setaffinity.2, semop.2, send.2, stat.2, stime.2, syscall.2, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, remquo.3, rtime.3, sched_getcpu.3, stpcpy.3, stpncpy.3, strcasecmp.3, system.3, fd.4, proc.5, ip.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:31:12 +02:00
Michael Kerrisk e39a52dbba ip.7: BUGS: ephemeral port range exhaustion is diagnosed inconsistently
Different system calls use different 'errno' values to diagnose
exhaustion of the ephemeral port range.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 630459c88b ip.7: Remove BUGS text on glibc failing to declare in_pktinfo
That was long ago....

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk bd8838ad29 ip.7: Note some more details about assignment of ephemeral ports
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 509c1c26f0 ip.7: Note cases where an ephemeral port is used
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk bb180c6283 ip.7: Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 33964ed992 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 99a230468c ip.7: Minor clarification for IP_TRANSPARENT
Based on an old email exchange with Balazs Scheidler.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:53 +02:00
Michael Kerrisk 59dc509c55 elf.5, services.5, bootparam.7, glob.7: Minor wording fix ("E.g." ==> "For example")
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:15:37 +02:00
Michael Kerrisk ffb30e75da Removed trailing white space at end of lines 2014-05-08 11:04:30 +02:00
Michael Kerrisk d6fa0283d3 fallocate.2, open_by_handle_at.2, rename.2, syscalls.2, termios.3, inotify.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:03:36 +02:00
Michael Kerrisk 89613d5046 fanotify.7: Add mtk to copyright
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 10:24:22 +02:00
Michael Kerrisk ce87be978f fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 21:59:08 +02:00
Michael Kerrisk a4cd12a95f fanotify.7: Add some details on event_f_flags
Note the use of fanotify_mark() 'event_f_flags' to control
the file status flags for the file descriptors returned via
'fanotify_event_metadata.fd'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 3253bbc3d4 fanotify.7: Clarify details of buffer size for read() and 'event_len' field
* Using large buffer sizes for read(2) is orthogonal to the
  discussion of variable-length event structures.
* Move the discussion of the read() return value to follow
  discussion of what the read() actually returns in its buffer.
* Related rewordings.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 4a57583f50 fanotify.7: Minor wording and formatting fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 3302241970 fanotify.7: Minor tweaks to Heinrich's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Heinrich Schuchardt a662500625 fanotify.7: Adjust description of the fanotify queue
Update as per http://www.spinics.net/lists/linux-man/msg05624.html
where Jan Kara proposed to clarify the deletion of events from the
fanotify queue and the occurrence of ENOENT when writing to the
fanotify file descriptor.

Reviewed-by: Jan Kara <jack@suse.cz>
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Simon Paillard b4112efb58 execve.2, getuid.2, stat.2, termios.3, ttyslot.3, glob.7: ffix: UNIX V6 or V7: use nonbreaking space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
Michael Kerrisk 5e443a5f9e fanotify.7: tfix
Reported-by: Jan Kara <jack@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-06 06:55:26 +02:00
Michael Kerrisk 1b24e2ee0e fanotify_init.2, fanotify_mark.2, fanotify.7: srcfix: rewrap long source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-05 11:48:44 +02:00
Michael Kerrisk 77bba7b589 fanotify.7: spfix
Reported-by: Silvan Jegen <s.jegen@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-05 11:38:07 +02:00
Michael Kerrisk e0ec3e201e mdoc.samples.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-02 08:05:13 +02:00
Michael Kerrisk bfff73cb7a fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:35:54 +02:00
Michael Kerrisk b16695a316 sched.7: Add a subsection listing all APIs.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:00:07 +02:00
Michael Kerrisk 720a5280de sched.7: SEE ALSO: add a few more APIs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:00:07 +02:00
Michael Kerrisk 59c06be3f6 sched.7: New page providing an overview of the scheduling APIs
Most of this content derives from sched_setscheduler(2). In
preparation for adding a sched_setattr(2) page, it makes
sense to isolate out this general content to a separate
page that is referred to by the other scheduling pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 15:00:07 +02:00
Michael Kerrisk 17e5494f9b packet.7: Minor fixes to Carsten's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 14:05:37 +02:00
Carsten Andrich 43f5be18ff packet.7: Improve sockopt documentation for packet sockets
Acked-by: Neil Horman <nhorman@tuxdriver.com>
Signed-off-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 13:57:47 +02:00
Simon Paillard ab2b391acb libc.7: tfix: missing comma
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-29 06:59:51 +02:00
Michael Kerrisk 2b9b829d52 time.1, get_kernel_syms.2, getitimer.2, open.2, perf_event_open.2, wait.2, alloca.3, bcmp.3, catopen.3, fputwc.3, iconv.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, mbsinit.3, putwchar.3, rcmd.3, rexec.3, sigqueue.3, strverscmp.3, wctrans.3, wctype.3, wcwidth.3, console_codes.4, initrd.4, st.4, elf.5, nss.5, ip.7, netdevice.7, path_resolution.7, socket.7, udp.7, ld.so.8: grfix: s/Otherwise /Otherwise, /
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 10:15:47 +02:00
Michael Kerrisk 0554d3f77a fanotify.7: Add comment to example code noting that queue overflow is ignored
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 20:07:02 +02:00
Heinrich Schuchardt 3b483820b9 fanotify.7: Remove redundant mentioning of bugs
A bug mentioned in fanotify_mark(2) need not be repeated in
fanotify(7) again.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 19:57:11 +02:00
Michael Kerrisk c8cc8bd2cb fanotify.7: Remove ppoll() and poll() from list of primary APIs
poll() and ppoll() are not among the primary calls in the API
(and anyway, select(), pselect(), and epoll were not mentioned).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 14:43:46 +02:00
Michael Kerrisk 5f6231f293 fanotify.7: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:10:32 +02:00
Michael Kerrisk 370359a7c6 fanotify.7: Add some whitespace to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:58:21 +02:00
Michael Kerrisk e1ca5880d4 fanotify.7: Add some comments to example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:57:29 +02:00
Michael Kerrisk 616fce491b fanotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:55:32 +02:00
Michael Kerrisk 3d4433fe17 fanotify.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:46:40 +02:00
Michael Kerrisk c00ff2dc16 fanotify.7: Add subheading for /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:46:16 +02:00
Michael Kerrisk 679a078389 fanotify.7: Remove a sentence from ETXTBSY description
No file descriptor is actually created...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:51 +02:00
Michael Kerrisk 68bcc008cc fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:51 +02:00
Michael Kerrisk 72b9aa964c fanotify.7: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:51 +02:00
Michael Kerrisk 49894a5a8f fanotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk d7d24d40ec fanotify.7: Add sentence introducing fanotify_response fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk f897ec112f fanotify.7: Minor rewording of FAN_CLOSE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00