LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / inotify_add_watch.2

diff --git a/original/man2/inotify_add_watch.2 b/original/man2/inotify_add_watch.2
index c696603..6d91ffa 100644 (file)
--- a/original/man2/inotify_add_watch.2
+++ b/original/man2/inotify_add_watch.2
@@ -25,7 +25,7 @@
 .\" 2005-07-19 Robert Love <rlove@rlove.org> - initial version
 .\" 2006-02-07 mtk, various changes
 .\"
-.TH INOTIFY_ADD_WATCH 2 2010-10-20 "Linux" "Linux Programmer's Manual"
+.TH INOTIFY_ADD_WATCH 2 2014-07-08 "Linux" "Linux Programmer's Manual"
 .SH NAME
 inotify_add_watch \- add a watch to an initialized inotify instance
 .SH SYNOPSIS
@@ -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
@@ -80,7 +78,7 @@ the object for which the event occurred.
 On success,
 .BR inotify_add_watch ()
 returns a nonnegative watch descriptor.
-On error \-1 is returned and
+On error, \-1 is returned and
 .I errno
 is set appropriately.
 .SH ERRORS
@@ -100,6 +98,10 @@ The given event mask contains no valid events; or
 .I fd
 is not an inotify file descriptor.
 .TP
+.B ENAMETOOLONG
+.I pathname
+is too long.
+.TP
 .B ENOENT
 A directory component in
 .I pathname
@@ -119,3 +121,12 @@ This system call is Linux-specific.
 .BR inotify_init (2),
 .BR inotify_rm_watch (2),
 .BR inotify (7)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.