Re: [PATCH 2/4] fanotify_mark.2: Clarification about FAN_EVENT_ON_CHILD and new events

["Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>]

Hello Amir,

On 4/20/20 8:42 PM, Amir Goldstein wrote:
> Some of the new event types that were added in v5.1 along with init flag
> FAN_REPORT_FID are not eligable for reporting to a directory watching
> with FAN_EVENT_ON_CHILD.
> 
> Document the events that cannot be generated on children of a watching
> parent.
> 
> Signed-off-by: Amir Goldstein <amir73il@gmail.com>
> Reviewed-by: Jan Kara <jack@suse.cz>
> Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org>

Thanks. Patch applied.

Cheers,

Michael

> ---
>  man2/fanotify_mark.2 | 15 ++++++++++++++-
>  1 file changed, 14 insertions(+), 1 deletion(-)
> 
> diff --git a/man2/fanotify_mark.2 b/man2/fanotify_mark.2
> index 687e20f4a..7fbcd5e36 100644
> --- a/man2/fanotify_mark.2
> +++ b/man2/fanotify_mark.2
> @@ -314,8 +314,21 @@ Events for the immediate children of marked directories shall be created.
>  The flag has no effect when marking mounts and filesystems.
>  Note that events are not generated for children of the subdirectories
>  of marked directories.
> +More specifically, the directory entry modification events
> +.BR FAN_CREATE ,
> +.BR FAN_DELETE ,
> +.BR FAN_MOVED_FROM
> +and
> +.BR FAN_MOVED_TO
> +are not generated for any entry modifications performed inside subdirectories
> +of marked directories.
> +Note that the events
> +.BR FAN_DELETE_SELF
> +and
> +.BR FAN_MOVE_SELF
> +are not generated for children of marked directories.
>  To monitor complete directory trees it is necessary to mark the relevant
> -mount.
> +mount or filesystem.
>  .PP
>  The following composed values are defined:
>  .TP
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/