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>
This commit is contained in:
Michael Kerrisk 2014-06-28 07:38:40 +02:00
parent 425ad621fc
commit 7499e6bc8e
1 changed files with 6 additions and 8 deletions

View File

@ -54,16 +54,14 @@ for a description of the bits that can be set in
A successful call to A successful call to
.BR inotify_add_watch () .BR inotify_add_watch ()
returns the unique watch descriptor associated with returns a unique watch descriptor for this inotify instance,
.I pathname for the filesystem object that corresponds to
for this inotify instance. .IR pathname .
If If the filesystem object
.I pathname
was not previously being watched by this inotify instance, was not previously being watched by this inotify instance,
then the watch descriptor is newly allocated. then the watch descriptor is newly allocated.
If If the filesystem object was already being watched
.I pathname (perhaps via a different link to the same object), then the descriptor
was already being watched, then the descriptor
for the existing watch is returned. for the existing watch is returned.
The watch descriptor is returned by later The watch descriptor is returned by later