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
 .\"
 .\" 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
 .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 ()
 
 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.
 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
 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 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
 .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
 .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
 .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)
 .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/.