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 4e3cd81..6d91ffa 100644 (file)
--- a/original/man2/inotify_add_watch.2
+++ b/original/man2/inotify_add_watch.2
@@ -1,8 +1,7 @@
-.\" man2/inotify_add_watch.2 - inotify_add_watch man page
-.\"
 .\" Copyright (C) 2005 Robert Love
 .\" and Copyright, 2006 Michael Kerrisk
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
@@ -19,14 +18,14 @@
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
 .\" 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
@@ -55,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
@@ -74,14 +71,14 @@ These reads fetch
 .I inotify_event
 structures (see
 .BR inotify (7))
-indicating file system events;
+indicating filesystem events;
 the watch descriptor inside this structure identifies
 the object for which the event occurred.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 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
@@ -101,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
@@ -114,9 +115,18 @@ The user limit on the total number of inotify watches was reached or the
 kernel failed to allocate a needed resource.
 .SH VERSIONS
 Inotify was merged into the 2.6.13 Linux kernel.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 This system call is Linux-specific.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .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/.