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
Michael Kerrisk
f2ac23e758
fanotify.7: Add introductory sentence for explanation of fanotify_event_metadata
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
ad02dd1f87
fanotify.7: Add a subheading for reading events
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
75c3e3bd6b
fanotify.7: Move the text on event merging
...
Place it near the discussion of the events bit mask.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
2932564490
fanotify.7: Rework text on event bits a little
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
c9120323bf
fanotify.7: Rework and enhance text introducing read() and events
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
6c693f6de5
fanotify.7: Move text describing fanotify_mark()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
488cdd819c
fanotify.7: Move epoll/poll/select discussion to its own subsection
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
7fc5dd9466
fanotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:50 +02:00
Michael Kerrisk
be8ba5d879
fanotify.7: Rework text on close()
...
Closing the fanotify FD was discussed in two places.
Merge them into one location, and discard redundant text.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:44:40 +02:00
Michael Kerrisk
d3471a460b
fanotify.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk
88145b29e7
fanotify.7: Add some subheadings to structure the DESCRIPTION
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk
397ff1fd3f
fanotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk
02a18e0f7f
fanotify.7: Reword FAN_CLOSE_NOWRITE text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk
9d76d63060
fanotify.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk
8d2ee5c85d
fanotify.7: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:40 +02:00
Michael Kerrisk
815df19b29
fanotify.7: Declare handle_events() in example code as 'static'
...
To avoid warning "no previous prototype for..."
when compiling with "-Wmissing-prototypes"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:11 +02:00
Michael Kerrisk
b34cbc4530
fanotify.7: Change a comment in example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk
def5c668e8
fanotify.7: Merge two printf() calls
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk
48fd9fe08a
fanotify.7: Change a comment in example code
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:43:10 +02:00
Michael Kerrisk
8cc4f7a94e
fanotify.7: Remove unneeded close() calls
...
The fanotify file descriptor will be implicitly closed by process
termination, and in any case it was not closed explicitly in all
process termination paths.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 11:42:57 +02:00
Michael Kerrisk
f776794974
fanotify.7: Minor tweaks to example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 10:00:53 +02:00
Michael Kerrisk
ddb112c281
fanotify.7: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 09:49:19 +02:00
Michael Kerrisk
6d8c5d015d
fanotify.7: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 09:20:45 +02:00
Michael Kerrisk
d9b086d625
fanotify.7: Mention inotify(7) in opening paragraph
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 08:06:41 +02:00
Michael Kerrisk
7ea227bdde
fanotify.7: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 08:06:41 +02:00
Heinrich Schuchardt
f75d27e6b0
inotify.7: SEE ALSO: add fanotify(7)
...
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:57:41 +02:00
Heinrich Schuchardt
597aaea2f7
fanotify.7: New page providing overview of the fanotify API
...
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:55:05 +02:00
Stefan Puiu
a29edaeef6
packet.7: Status in PACKET_RX_RING is actually a bit mask
...
Stefan:
I'm playing with the PACKET_RX_RING option to packet sockets and I
noticed that the status field from the tpacket_hdr structures
inside the mmaped buffer is actually a bit mask. I'm testing with
4Gbps traffic rates and sometimes I get status=5. I'm using Ubuntu
12.04 with a 3.8.0-29 kernel, and at least from the code (I got it
using "sudo apt-get source linux-image-$(uname -r)") it seems the
5 means TP_STATUS_USER | TP_STATUS_LOSING. The 3.8.0 kernel code
has this line in tpacket_rcv():
/*
* LOSING will be reported till you read the stats,
* because it's COR - Clear On Read.
* Anyways, moving it for V1/V2 only as V3 doesn't need this
* at packet level.
*/
if (po->stats.tp_drops)
status |= TP_STATUS_LOSING;
Daniel:
Now to your question. It can easily be seen from the if_packet.h header
file http://lingrok.org/xref/linux-net-next/include/uapi/linux/if_packet.h#93
that TP_STATUS_* are individual bits that are set in tp_status field.
TP_STATUS_USER simply means a frame was received in the ring and is
ready for user space to be processed. If the field also indicates
TP_STATUS_LOSING then this means that there were packet drops in the
rx ring itself so a user knows it didn't get all traffic. This bit
is being reset on getsockopt() when querying PACKET_STATISTICS,
otherwise it stays. Drops occur when the ring buffer was not emptied
fast enough by user space (so no free slot with TP_STATUS_KERNEL), e.g.
due to high incoming traffic load. However, the current frame you're
reading that has TP_STATUS_USER|TP_STATUS_LOSING is fine by itself.
Acked-by: Daniel Borkmann <dborkman@redhat.com>
Acked-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-24 11:52:39 +02:00
Michael Kerrisk
ab80da6e17
packet.7: SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
...
Reported-by: Carsten Andrich <carsten.andrich@tu-ilmenau.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk
3d4d5a0635
packet.7: Minor tweak to Carsten Andrich's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk
896333c57e
packet.7: Minor fixes to Carsten Andrich's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Carsten Andrich
8c26e99bce
packet.7: PACKET_LOSS has inverse meaning
...
I stumbled upon an error in packet.7 regarding the meaning of the
PACKET_LOSS socket option. According to the current git version of
linux-man setting PACKET_LOSS causes malformed packets to *not* be
silently dropped.
However it is the other way round. If PACKET_LOSS is *not* set,
malformed packets will be marked TP_STATUS_WRONG_FORMAT and the
transmission process aborted, leaving untransmitted packets in
the ring. If it *is* set, malformed packets will be silently
skipped, their status set to TP_STATUS_AVAILABLE and the
transmission process continued with the following packet.
This behaviour can be clearly seen in net/packet/af_packet.c:
http://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/tree/net/packet/af_packet.c#n2300
The value accompanying TP_PACKET_LOSS translates into po->tp_loss:
http://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/tree/net/packet/af_packet.c#n3304
I inverted the meaning of PACKET_LOSS and clarified the
description in the attached patch.
Reviewed-by: Willem de Bruijn <willemb@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk
fe8b1358a6
Removed trailing white space at end of lines
2014-04-20 11:06:01 +02:00
Michael Kerrisk
84b349919b
madvise.2, msync.2, libc.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 11:05:32 +02:00
David Prévot
d2c3d8a829
inotify.7: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 07:49:54 +02:00
Michael Kerrisk
85dd46e89b
libc.7: srcfix: Reformat to use .UR/.UE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:50:42 +02:00
Michael Kerrisk
ba8b587366
libc.7: Add musl libc
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:50:41 +02:00
David Prévot
f360dbe83d
locale.7: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:25:18 +02:00
Michael Kerrisk
e8a700f9ae
capabilities.7: SEE ALSO: add capsh(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-09 15:27:32 +02:00
Michael Kerrisk
fa1d49a63c
Removed trailing white space at end of lines
2014-04-06 08:47:56 +02:00
Michael Kerrisk
b8dbf73de8
bdflush.2, fsync.2, mmap.2, open.2, perf_event_open.2, sync.2, syscall.2, fmemopen.3, getaddrinfo.3, getline.3, mq_notify.3, offsetof.3, aio.7, symlink.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:47:35 +02:00
Michael Kerrisk
e449e5f15a
inotify.7: Inotify does not report events for mmap(2) and msync(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
e226bed757
inotify.7: Inotify doesn't work for remote and pseudo filesystems
...
Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
fa51f4d941
inotify.7: Remind reader of the cookie value in discussion of rename events
...
Reported-by: Jan Kara <jack@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
6f1a495406
inotify.7: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
6b1cc2c9a4
inotify.7: Add paragraph on cache consistency checking
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
67898fdfd0
inotify.7: Reorganize "Limits and caveats"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
da977073d0
inotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
85e179c5c2
inotify.7: Add text on dealing with rename() events
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
a79d28b202
inotify.7: Minor reorganization
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
94d52c1529
inotify.7: Mention cache rebuilding to handle overflow events
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
264276c6b0
inotify.7: Move discussion of application cache to start of "Limitations"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
356911f692
inotify.7: Rewrite introductory section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
ff6e23973d
inotify.7: Add subheading for reading from inotify file descriptor
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
1a737afd5a
inotify.7: symlink(2) can generate IN_CREATE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
415f63be17
inotify.7: Add some examples of events generated by various system calls
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
Michael Kerrisk
ed17140040
symlink.7: Mention use of readlink(2) to read contents of a symlink
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk
7aa6eb89d4
symlink.7: Minor edits
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk
828b6e3dad
symlink.7: Add mtk copyright
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk
58be64a41a
symlink.7: f
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk
d33b6ed2d8
symlink.7: Add subsection on opening a symbolic link with O_PATH
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk
19d9c23c6a
symlink.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk
df63d3e84d
symlink.7: name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk
b01c936e4b
inotify.7: Note that IN_UNMOUNT will be followed by an IN_IGNORED event
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk
39f43968d7
inotify.7: Note that IN_DELETE_SELF will be followed by IN_IGNORED
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk
7a64793b93
inotify.7: Add examples of syscalls that trigger IN_CREAT
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk
b0e1ac43e0
inotify.7: Add examples of syscalls that trigger IN_ATTRIB
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk
79f8f40ccb
inotify.7: Minor wording change
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00