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
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
Michael Kerrisk
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
Michael Kerrisk
f23fc716d5
inotify.7: Minor list reformatting
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk
49b07b8f8b
inotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 22:11:07 +02:00
Michael Kerrisk
64aa9bcb39
inotify.7: Minor clarification
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 20:59:35 +02:00
Michael Kerrisk
70f70c9d40
inotify.7: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 20:59:31 +02:00
Michael Kerrisk
f08cdf85df
inotify.7: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-30 10:30:27 +02:00
Michael Kerrisk
a15ead5e9f
inotify.7: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-29 22:07:16 +01:00
Michael Kerrisk
7b5151b7f0
inotify.7: BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
...
A silent change as a result of the fanotify work in kernel 2.6.36.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-29 22:06:48 +01:00
Michael Kerrisk
dede00fed9
inotify.7: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:41:17 +01:00
Michael Kerrisk
f20fc09276
inotify.7: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:33:47 +01:00
Michael Kerrisk
c577b95c7b
inotify.7: ffix: Reformat events list
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:33:14 +01:00
Michael Kerrisk
4a1e4cca21
inotify.7: Moving an object to another filesystem generates IN_DELETE_SELF
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 15:25:24 +01:00
Michael Kerrisk
22129aa9f5
inotify.7: srcfix: Note commit that fixed the "coalescing" bug
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 13:43:58 +01:00
Michael Kerrisk
2f48204194
inotify.7: Directory renames may invalidate multiple paths cached by application
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 06:45:17 +01:00
Michael Kerrisk
031de15217
inotify.7: Further describe the race when adding a watch to a new subtree
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-27 06:43:09 +01:00
Michael Kerrisk
3f3698d8a7
inotify.7: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:41:00 +01:00