X-Git-Url: http://git.osdn.net/view?p=linuxjm%2FLDP_man-pages.git;a=blobdiff_plain;f=original%2Fman2%2Finotify_add_watch.2;h=6d91ffa1e94860781fad828efeba8485b6c3da45;hp=4e3cd81d2c450ca9f49814e8934631c73d2e077c;hb=4ea6bb24817f6f049d6bbc90ecd77a869876f9b0;hpb=8fbe23d0114c8804c4cfb5b6c57f3ca09c8fee1d
diff --git a/original/man2/inotify_add_watch.2 b/original/man2/inotify_add_watch.2
index 4e3cd81d..6d91ffa1 100644
--- 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
+.\" .
+.\" %%%LICENSE_END
.\"
.\" 2005-07-19 Robert Love - 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/.