diff options
Diffstat (limited to 'man2/fanotify_init.2')
| -rw-r--r-- | man2/fanotify_init.2 | 36 |
1 files changed, 34 insertions, 2 deletions
diff --git a/man2/fanotify_init.2 b/man2/fanotify_init.2 index 9be15be51e..ece4ae6a6a 100644 --- a/man2/fanotify_init.2 +++ b/man2/fanotify_init.2 @@ -40,8 +40,8 @@ queue associated with the group. .PP The file descriptor is used in calls to .BR fanotify_mark (2) -to specify the files, directories, and mounts for which fanotify events -shall be created. +to specify the files, directories, mounts or filesystems for which fanotify +events shall be created. These events are received by reading from the file descriptor. Some events are only informative, indicating that a file has been accessed. Other events can be used to determine whether @@ -94,6 +94,36 @@ already contain their final content. This notification class might be used by malware detection programs, for example. .TP +.BR FAN_REPORT_FID " (since Linux 5.1)" +.\" commit a8b13aa20afb69161b5123b4f1acc7ea0a03d360 +This value allows the receipt of events which contain additional information +about the underlying object correlated to an event. +An additional structure encapsulates the information about the object and is +included alongside the generic event metadata structure. +The file descriptor that is used to represent the object correlated to an +event is instead substituted with a file handle. +It is intended for applications that may find the use of a file handle to +identify an object more suitable than a file descriptor. +Additionally, it may be used for applications that are interested in +directory entry events, such as +.BR FAN_CREATE , +.BR FAN_ATTRIB , +.BR FAN_MOVE +and +.BR FAN_DELETE +for example. +Note that the use of directory modification events are not supported when +monitoring a mount point. +The use of +.BR FAN_CLASS_CONTENT +or +.BR FAN_CLASS_PRE_CONTENT +is not permitted with this flag and will result in the error +.BR EINVAL . +See +.BR fanotify (7) +for additional information. +.TP .B FAN_CLASS_NOTIF This is the default value. It does not need to be specified. @@ -224,6 +254,8 @@ An invalid value was passed in or .IR event_f_flags . .B FAN_ALL_INIT_FLAGS +(deprecated since Linux kernel version 4.20) +.\" commit 23c9deeb3285d34fd243abb3d6b9f07db60c3cf4 defines all allowable bits for .IR flags . .TP |