LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

inotify.7: Document IN_MASK_CREATE 

Add documentation for new flag IN_MASK_CREATE for inotify_add_watch()
which is used to only allow new watches to be created.

Information obtained from a patch I submitted to the linux kernel
https://marc.info/?l=linux-fsdevel&m=152775980422847&w=2

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Henry Wilson 2018-05-31 15:16:28 +00:00 committed by Michael Kerrisk
parent 29fa4cbc2e
commit 381b7a9111
1 changed files with 22 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
man7/inotify.7
View File

@ -347,7 +347,12 @@ If a watch instance already exists for the filesystem object corresponding to
.IR pathname ,
add (OR) the events in
.I mask
to the watch mask (instead of replacing the mask).
to the watch mask (instead of replacing the mask);
the error
.B EINVAL
results if
.B IN_MASK_CREATE
is also specified.
.TP
.B IN_ONESHOT
Monitor the filesystem object corresponding to
@ -366,6 +371,22 @@ results if
is not a directory.
Using this flag provides an application with a race-free way of
ensuring that the monitored object is a directory.
.TP
.BR IN_MASK_CREATE " (from Linux 4.18)"
Watch
.I pathname
only if it does not already have a watch associated with it;
the error
.B EEXIST
results if
.I pathname
already is being watched.
Using this flag provides an application with a way of ensuring
that new watches do not modify existing ones. This is useful
because multiple paths may refer to the same inode, and
multiple calls to
.B inotify_add_watch (2)
without this flag may clobber existing watch masks.
.RE
.PP
The following bits may be set in the