On 5/31/18 5:16 PM, henry.wilson@xxxxxxxxxxx wrote: > From: Henry Wilson <henry.wilson@xxxxxxxxxxx> > > Added documentation for new flag IN_MASK_CREATE for inotify_add_watch() > which is used to only allow new watches to be created. Thanks, Henry. Patch applied (sorry for the delay). Cheers, Michael > Information obtained from a patch I submitted to the linux kernel > https://marc.info/?l=linux-fsdevel&m=152775980422847&w=2 > --- > man7/inotify.7 | 23 ++++++++++++++++++++++- > 1 file changed, 22 insertions(+), 1 deletion(-) > > diff --git a/man7/inotify.7 b/man7/inotify.7 > index 85c05a9bc..873bc27bc 100644 > --- a/man7/inotify.7 > +++ b/man7/inotify.7 > @@ -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 > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
