summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2014-06-28 07:38:40 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2014-06-28 07:38:40 +0200
commit7499e6bc8ec1318463533c2cb680dbd9379d7583 (patch)
treed3359b16c3580844e06556e288b239284051fcdb
parent425ad621fc635d20953a3c9e2af97990ff4d10e0 (diff)
inotify_add_watch.2: Clarify that the target of a watch is an i-node
The target of a watch is an i-node, not a pathname. Clarify the text to prevent the reader possibly misunderstanding that establishing watches by two different links to the same file might create different watch descriptors. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man2/inotify_add_watch.214
1 files changed, 6 insertions, 8 deletions
diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2
index 8c50b4042..d35df05bb 100644
--- a/man2/inotify_add_watch.2
+++ b/man2/inotify_add_watch.2
@@ -54,16 +54,14 @@ for a description of the bits that can be set in
A successful call to
.BR inotify_add_watch ()
-returns the unique watch descriptor associated with
-.I pathname
-for this inotify instance.
-If
-.I pathname
+returns a unique watch descriptor for this inotify instance,
+for the filesystem object that corresponds to
+.IR pathname .
+If the filesystem object
was not previously being watched by this inotify instance,
then the watch descriptor is newly allocated.
-If
-.I pathname
-was already being watched, then the descriptor
+If the filesystem object was already being watched
+(perhaps via a different link to the same object), then the descriptor
for the existing watch is returned.
The watch descriptor is returned by later