summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2014-07-08 14:20:54 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2014-07-08 14:27:44 +0200
commite95b1911c454bc04c17e3d75e283a759caf4f24b (patch)
treec4cb8574ae2a5ac8e64c24200ed600de57270f8f
parentd2b6be9a2dbd6b33b005a61dcb02baa91806f098 (diff)
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>
-rw-r--r--man7/inotify.720
1 files changed, 13 insertions, 7 deletions
diff --git a/man7/inotify.7 b/man7/inotify.7
index 576034a45..93dacc6a9 100644
--- a/man7/inotify.7
+++ b/man7/inotify.7
@@ -222,7 +222,7 @@ File opened for writing was closed.
.BR IN_CLOSE_NOWRITE " (*)"
File not opened for writing was closed.
.TP
-.BR IN_CREATE " (*)"
+.BR IN_CREATE " (+)"
File/directory created in watched directory (e.g.,
.BR open (2)
.BR O_CREAT ,
@@ -232,7 +232,7 @@ File/directory created in watched directory (e.g.,
.BR bind (2)
on a UNIX domain socket).
.TP
-.BR IN_DELETE " (*)"
+.BR IN_DELETE " (+)"
File/directory deleted from watched directory.
.TP
.B IN_DELETE_SELF
@@ -254,11 +254,11 @@ File was modified (e.g.,
.B IN_MOVE_SELF
Watched file/directory was itself moved.
.TP
-.BR IN_MOVED_FROM " (*)"
+.BR IN_MOVED_FROM " (+)"
Generated for the directory containing the old filename
when a file is renamed.
.TP
-.BR IN_MOVED_TO " (*)"
+.BR IN_MOVED_TO " (+)"
Generated for the directory containing the new filename
when a file is renamed.
.TP
@@ -266,9 +266,15 @@ when a file is renamed.
File was opened.
.RE
.PP
-When monitoring a directory,
-the events marked with an asterisk (*) above can occur for
-files in the directory, in which case the
+When monitoring a directory:
+.IP * 3
+the events marked above with an asterisk (*) can occur both
+for the directory itself and for objects inside the directory; and
+.IP *
+the events marked with a plus sign (+) occur only for objects
+inside the directory (not for the directory itself).
+.PP
+When events are generated for objects inside a watched directory, the
.I name
field in the returned
.I inotify_event