... > > > > + /* > > > > + * Unlike legacy fanotify events (open/access/close), dirent events > > > > + * for subdir entries (mkdir/rmdir) will be reported regardless if > > > > + * user requested FAN_ONDIR, but the FAN_ONDIR flag itself will only > > > > + * be reported if the user asked for it. > > > > + */ > > > > if (event_mask & FS_ISDIR && > > > > + !(event_mask & ALL_FSNOTIFY_DIRENT_EVENTS) && > > > > > > I disagree with this. It just seems inconsistent for dirent events for > > > directories to get reported without FAN_ONDIR. I understand there's not > > > great use for not reporting directory dirent events but it's not like > > > adding FAN_ONDIR to the mark mask is that big deal for userspace. And it > > > makes the API more consistent. You could possibly remind the reader in the > > > manpage that FAN_ONDIR is required to get all dirent events. > > > > I see your point. > > I have no problem with requiring FAN_ONDIR for mkdir events. > > I believe the strongest argument should be which way is easier > > to document/understand. > > > > Matthew, if you agree that it looks easier to document Jan's proposal, > > please go a head with this and we will see how man page looks like > > before making the final decision. > > To be fair, for the sake of clarity and consistency with the existing API I do > believe it would make it easier for the API consumer to comprehend what Jan has > suggested. Simple, in order to receive any events of type dirent, one must > supply FAN_ONDIR as part of their mark mask. > But that was not the suggestion. The debate is whether or not user needs to specify (for example) FAN_ONDIR|FAN_CREATE in order to get mkdir events. The three of us understanding FAN_ONDIR intuitively different is what makes me unease. The purpose of my alternative suggestion was to dis-disambiguate which inode each flag refers to. It should be clear that FAN_DIRENT_ISDIR does not refer to the modified directry but to the created/deleted/renamed subdir. We will avoid making a change of behavior making FAN_ONDIR an out flag. Thanks, Amir.
