inotify_add_watch.2: Note errors that can occur for IN_MASK_CREATE

Note EEXIST error that occurs when requesting a watch on a path
which is already watched with IN_MASK_CREATE.

Note EINVAL error also occurs when requesting a watch specifying
both IN_MASK_CREATE and IN_MASK_ADD.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2
index e9ba038ebbe273dc6835b5a795ddc780d7370ab5..4a69610e0709ed0eae47b88dc551c01c6ddd20f6 100644 (file)
--- a/man2/inotify_add_watch.2
+++ b/man2/inotify_add_watch.2
@@ -95,6 +95,12 @@ points outside of the process's accessible address space.
 .TP
 .B EINVAL
 The given event mask contains no valid events; or
+.I mask
+contains both
+.B IN_MASK_ADD
+and
+.B IN_MASK_CREATE
+; or
 .I fd
 is not an inotify file descriptor.
 .TP
@@ -121,6 +127,15 @@ contains
 and
 .I pathname
 is not a directory.
+.TP
+.B EEXIST
+.I mask
+contains
+.B IN_MASK_CREATE
+and
+.I pathname
+refers to a file already being watched by the same 
+.I fd
 .SH VERSIONS
 Inotify was merged into the 2.6.13 Linux kernel.
 .SH CONFORMING TO