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
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
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
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
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
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
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
cbe0e64447
Removed trailing white space at end of lines
2014-07-08 16:36:37 +02:00
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
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
f070e9543a
inotify.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-01 08:16:49 +02:00
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
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
264545c62e
inotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-28 07:49:06 +02:00
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
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
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
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
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
2ef6778bce
Removed trailing white space at end of lines
2014-05-28 16:00:50 +02:00
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
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
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
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
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
d2c3d8a829
inotify.7: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 07:49:54 +02:00
fa1d49a63c
Removed trailing white space at end of lines
2014-04-06 08:47:56 +02:00
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
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
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
6f1a495406
inotify.7: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
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
67898fdfd0
inotify.7: Reorganize "Limits and caveats"
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
da977073d0
inotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
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
a79d28b202
inotify.7: Minor reorganization
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
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
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
356911f692
inotify.7: Rewrite introductory section
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:18:58 +02:00
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
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
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
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
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
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
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
79f8f40ccb
inotify.7: Minor wording change
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
f54a125572
inotify.7: Add some examples of syscalls that trigger IN_MODIFY
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
f23fc716d5
inotify.7: Minor list reformatting
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
49b07b8f8b
inotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk