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
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
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
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
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
f070e9543a
inotify.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-01 08:16:49 +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
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
Michael Kerrisk
2ef6778bce
Removed trailing white space at end of lines
2014-05-28 16:00:50 +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
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
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
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
fa1d49a63c
Removed trailing white space at end of lines
2014-04-06 08:47:56 +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
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