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 , .IR pathname ,
add (OR) the events in add (OR) the events in
.I mask .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 .TP
.B IN_ONESHOT .B IN_ONESHOT
Monitor the filesystem object corresponding to Monitor the filesystem object corresponding to
@ -366,6 +371,22 @@ results if
is not a directory. is not a directory.
Using this flag provides an application with a race-free way of Using this flag provides an application with a race-free way of
ensuring that the monitored object is a directory. 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 .RE
.PP .PP
The following bits may be set in the The following bits may be set in the