.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.TH INOTIFY 7 2008-11-18 "Linux" "Linux Programmer's Manual"
+.\" FIXME 2.6.36 adds IN_EXCL_UNLINK
+.\"
+.TH INOTIFY 7 2010-09-27 "Linux" "Linux Programmer's Manual"
.SH NAME
inotify \- monitoring file system events
.SH DESCRIPTION
.BR ioctl (2)
returns the number of bytes available to read from an
inotify file descriptor.
-
+.SS Limitations and caveats
Inotify monitoring of directories is not recursive:
to monitor subdirectories under a directory,
additional watches must be created.
+This can take a significant amount time for large directory trees.
+
+The inotify API provides no information about the user or process that
+triggered the inotify event.
+
+Note that the event queue can overflow.
+In this case, events are lost.
+Robust applications should handle the possibility of
+lost events gracefully.
+
+The inotify API identifies affected files by filename.
+However, by the time an application processes an inotify event,
+the filename may already have been deleted or renamed.
+
+If monitoring an entire directory subtree,
+and a new subdirectory is created in that tree,
+be aware that by the time you create a watch for the new subdirectory,
+new files may already have been created in the subdirectory.
+Therefore, you may want to scan the contents of the subdirectory
+immediately after adding the watch.
.SH "BUGS"
In kernels before 2.6.16, the
.B IN_ONESHOT