aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAmir Goldstein <amir73il@gmail.com>2020-04-20 21:42:57 +0300
committerMichael Kerrisk <mtk.manpages@gmail.com>2020-04-20 21:21:49 +0200
commit1f20a8803255df69a9b53d0bbd9ae4d99483a2a9 (patch)
tree927f65020c9b4ecadb80d20163428711aef7b5ab
parentd71c9b4a5c6fbc7164007b52dba1de410d018292 (diff)
downloadman-pages-1f20a8803255df69a9b53d0bbd9ae4d99483a2a9.tar.gz
fanotify_mark.2: Clarification about FAN_EVENT_ON_CHILD and new events
Some of the new event types that were added in v5.1 along with init flag FAN_REPORT_FID are not eligible 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> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man2/fanotify_mark.215
1 files changed, 14 insertions, 1 deletions
diff --git a/man2/fanotify_mark.2 b/man2/fanotify_mark.2
index 687e20f4af..7fbcd5e361 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