fanotify: Document mount namespace events
PATCH v2 1/1 fanotify: Document mount namespace events
Used to subscribe for notifications for when mounts are attached/detached from a mount namespace.
---
Changes since v1:
- Add RVB
- Add reference to statx() unique mnt_id (Jan)
- Fix description of MARK_MNTNS path (Miklos)
man/man2/fanotify_init.2 | 20 ++++++++++++++++++ man/man2/fanotify_mark.2 | 35 +++++++++++++++++++++++++++++++- man/man7/fanotify.7 | 44 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 98 insertions(+), 1 deletion(-)
man/man2/fanotify_init.2 +20 -0
@@ -330,6 +330,26 @@ that the directory entry is referring to. This is a synonym for .RB ( FAN_REPORT_DFID_NAME | FAN_REPORT_FID | FAN_REPORT_TARGET_FID ). .TP +.BR FAN_REPORT_MNT " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +This value allows the receipt of events which contain additional information +about the underlying mount correlated to an event. +An additional record of type +.B FAN_EVENT_INFO_TYPE_MNT +encapsulates the information about the mount and is included alongside the +generic event metadata structure. +The use of +.BR FAN_CLASS_CONTENT , +.BR FAN_CLASS_PRE_CONTENT, +or any of the +.B FAN_REPORT_DFID_NAME_TARGET +flags along with this flag is not permitted +and will result in the error +.BR EINVAL . +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_REPORT_PIDFD " (since Linux 5.15 and 5.10.220)" .\" commit af579beb666aefb17e9a335c12c788c92932baf1 Events for fanotify groups initialized with this flag will contain
man/man2/fanotify_mark.2 +34 -1
@@ -67,7 +67,8 @@ contains all marks for filesystems are removed from the group. Otherwise, all marks for directories and files are removed. No flag other than, and at most one of, the flags -.B FAN_MARK_MOUNT +.BR FAN_MARK_MNTNS , +.BR FAN_MARK_MOUNT , or .B FAN_MARK_FILESYSTEM can be used in conjunction with
@@ -99,6 +100,20 @@ If the filesystem object to be marked is not a directory, the error .B ENOTDIR shall be raised. .TP +.BR FAN_MARK_MNTNS " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Mark the mount namespace specified by +.IR pathname . +If the +.I pathname +is not a path that represents a mount namespace (e.g. +.BR /proc/ pid /ns/mnt ), +the call fails with the error +.BR EINVAL . +An fanotify group that is initialized with flag +.B FAN_REPORT_MNT +is required. +.TP .B FAN_MARK_MOUNT Mark the mount specified by .IR pathname .
@@ -395,6 +410,24 @@ Create an event when a marked file or directory itself has been moved. An fanotify group that identifies filesystem objects by file handles is required. .TP +.BR FAN_MNT_ATTACH ", " FAN_MNT_DETACH " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Create an event when a mount was attached to or detached from a marked mount namespace. +An attempt to set this flag on an inode, mount or filesystem mark +will result in the error +.BR EINVAL . +An fanotify group that is initialized with flag +.B FAN_REPORT_MNT +and the mark flag +.B FAN_MARK_MNTNS +are required. +An additional information record of type +.B FAN_EVENT_INFO_TYPE_MNT +is returned with the event. +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_FS_ERROR " (since Linux 5.16, 5.15.154, and 5.10.220)" .\" commit 9709bd548f11a092d124698118013f66e1740f9b Create an event when a filesystem error
man/man7/fanotify.7 +44 -0
68 lines not on this page · raw message
Signature · 1 line
2.34.1
Quoted 8 lines · Amir Goldstein
Used to subscribe for notifications for when mounts are attached/detached from a mount namespace.
Cc Jan Kara <[email protected]>Cc Miklos Szeredi <[email protected]>Reviewed-by Christian Brauner <[email protected]>Signed-off-by Amir Goldstein <[email protected]>
Thanks,
Miklos
Quoted 7 lines · Amir Goldstein
Used to subscribe for notifications for when mounts are attached/detached from a mount namespace.
Cc Jan Kara <[email protected]>Cc Miklos Szeredi <[email protected]>Reviewed-by Christian Brauner <[email protected]>Signed-off-by Amir Goldstein <[email protected]>
Looks good. Feel free to add:
Honza
Quoted 182 lines
---
Changes since v1:
- Add RVB
- Add reference tostatx()uniquemnt_id(Jan)
- Fix description ofMARK_MNTNSpath (Miklos)man/man2/fanotify_init.2 | 20 ++++++++++++++++++ man/man2/fanotify_mark.2 | 35 +++++++++++++++++++++++++++++++- man/man7/fanotify.7 | 44 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 98 insertions(+), 1 deletion(-)man/man2/fanotify_init.2 +20
-0@@ -330,6 +330,26 @@ that the directory entry is referring to. This is a synonym for .RB ( FAN_REPORT_DFID_NAME | FAN_REPORT_FID | FAN_REPORT_TARGET_FID ). .TP +.BR FAN_REPORT_MNT " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +This value allows the receipt of events which contain additional information +about the underlying mount correlated to an event. +An additional record of type +.B FAN_EVENT_INFO_TYPE_MNT +encapsulates the information about the mount and is included alongside the +generic event metadata structure. +The use of +.BR FAN_CLASS_CONTENT , +.BR FAN_CLASS_PRE_CONTENT, +or any of the +.B FAN_REPORT_DFID_NAME_TARGET +flags along with this flag is not permitted +and will result in the error +.BR EINVAL . +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_REPORT_PIDFD " (since Linux 5.15 and 5.10.220)" .\" commit af579beb666aefb17e9a335c12c788c92932baf1 Events for fanotify groups initialized with this flag will containman/man2/fanotify_mark.2 +34
-1@@ -67,7 +67,8 @@ contains all marks for filesystems are removed from the group. Otherwise, all marks for directories and files are removed. No flag other than, and at most one of, the flags -.B FAN_MARK_MOUNT +.BR FAN_MARK_MNTNS , +.BR FAN_MARK_MOUNT , or .B FAN_MARK_FILESYSTEM can be used in conjunction with@@ -99,6 +100,20 @@ If the filesystem object to be marked is not a directory, the error .B ENOTDIR shall be raised. .TP +.BR FAN_MARK_MNTNS " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Mark the mount namespace specified by +.IR pathname . +If the +.I pathname +is not a path that represents a mount namespace (e.g. +.BR /proc/ pid /ns/mnt ), +the call fails with the error +.BR EINVAL . +An fanotify group that is initialized with flag +.B FAN_REPORT_MNT +is required. +.TP .B FAN_MARK_MOUNT Mark the mount specified by .IR pathname .@@ -395,6 +410,24 @@ Create an event when a marked file or directory itself has been moved. An fanotify group that identifies filesystem objects by file handles is required. .TP +.BR FAN_MNT_ATTACH ", " FAN_MNT_DETACH " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Create an event when a mount was attached to or detached from a marked mount namespace. +An attempt to set this flag on an inode, mount or filesystem mark +will result in the error +.BR EINVAL . +An fanotify group that is initialized with flag +.B FAN_REPORT_MNT +and the mark flag +.B FAN_MARK_MNTNS +are required. +An additional information record of type +.B FAN_EVENT_INFO_TYPE_MNT +is returned with the event. +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_FS_ERROR " (since Linux 5.16, 5.15.154, and 5.10.220)" .\" commit 9709bd548f11a092d124698118013f66e1740f9b Create an event when a filesystem errorman/man7/fanotify.7 +44
-0@@ -228,6 +228,23 @@ struct fanotify_event_info_pidfd { .EE .in .P +In cases where an fanotify group is initialized with +.BR FAN_REPORT_MNT , +event listeners should expect to receive the below +information record object alongside the generic +.I fanotify_event_metadata +structure within the read buffer. +This structure is defined as follows: +.P +.in +4n +.EX +struct fanotify_event_info_mnt { + struct fanotify_event_info_header hdr; + __u64 mnt_id; +}; +.EE +.in +.P In case of a .B FAN_FS_ERROR event,@@ -442,6 +459,12 @@ A file or directory that was opened read-only .RB ( O_RDONLY ) was closed. .TP +.BR FAN_MNT_ATTACH +A mount was attached to mount namespace. +.TP +.BR FAN_MNT_DETACH +A mount was detached from mount namespace. +.TP .B FAN_FS_ERROR A filesystem error was detected. .TP@@ -540,6 +563,7 @@ The value of this field can be set to one of the following: .BR FAN_EVENT_INFO_TYPE_FID , .BR FAN_EVENT_INFO_TYPE_DFID , .BR FAN_EVENT_INFO_TYPE_DFID_NAME , +.BR FAN_EVENT_INFO_TYPE_MNT , .BR FAN_EVENT_INFO_TYPE_ERROR , .BR FAN_EVENT_INFO_TYPE_RANGE , or@@ -727,6 +751,26 @@ in case of a terminated process, the value will be .BR \-ESRCH . .P The fields of the +.I fanotify_event_info_mnt +structure are as follows: +.TP +.I .hdr +This is a structure of type +.IR fanotify_event_info_header . +The +.I .info_type +field is set to +.BR FAN_EVENT_INFO_TYPE_MNT . +.TP +.I .mnt_id +Identifies the mount associated with the event. +It is a 64bit unique mount id as the one returned by +.BR statx (2) +with the +.BR STATX_MNT_ID_UNIQUE +flag. +.P +The fields of the .I fanotify_event_info_error structure are as follows: .TPSignature · 1 line
2.34.1
Signature · 2 lines
Jan Kara <[email protected]> SUSE Labs, CR
Alejandro Colomar
maintainerHi Amir,
Quoted 30 lines · Amir Goldstein
Used to subscribe for notifications for when mounts are attached/detached from a mount namespace.
Cc Jan Kara <[email protected]>Cc Miklos Szeredi <[email protected]>Reviewed-by Christian Brauner <[email protected]>Signed-off-by Amir Goldstein <[email protected]>---
Changes since v1:
- Add RVB
- Add reference tostatx()uniquemnt_id(Jan)
- Fix description ofMARK_MNTNSpath (Miklos)man/man2/fanotify_init.2 | 20 ++++++++++++++++++ man/man2/fanotify_mark.2 | 35 +++++++++++++++++++++++++++++++- man/man7/fanotify.7 | 44 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 98 insertions(+), 1 deletion(-)man/man2/fanotify_init.2 +3
-0@@ -330,6 +330,26 @@ that the directory entry is referring to. This is a synonym for .RB ( FAN_REPORT_DFID_NAME | FAN_REPORT_FID | FAN_REPORT_TARGET_FID ). .TP +.BR FAN_REPORT_MNT " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +This value allows the receipt of events which contain additional information
man/man2/fanotify_init.2 that the directory entry is referring to. · line 345
Quoted 10 lines
man/man2/fanotify_init.2 +10
-0+about the underlying mount correlated to an event. +An additional record of type +.B FAN_EVENT_INFO_TYPE_MNT +encapsulates the information about the mount and is included alongside the +generic event metadata structure. +The use of +.BR FAN_CLASS_CONTENT , +.BR FAN_CLASS_PRE_CONTENT, +or any of the +.B FAN_REPORT_DFID_NAME_TARGET
What do you mean by any of the flags? Is _NAME_ a placeholder? If so, the placeholder should be in italics:
.BI FOO_ placeholder _BAR
Quoted 26 lines
man/man2/fanotify_init.2 +7
-0+flags along with this flag is not permitted +and will result in the error +.BR EINVAL . +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_REPORT_PIDFD " (since Linux 5.15 and 5.10.220)" .\" commit af579beb666aefb17e9a335c12c788c92932baf1 Events for fanotify groups initialized with this flag will containman/man2/fanotify_mark.2 +2
-1@@ -67,7 +67,8 @@ contains all marks for filesystems are removed from the group. Otherwise, all marks for directories and files are removed. No flag other than, and at most one of, the flags -.B FAN_MARK_MOUNT +.BR FAN_MARK_MNTNS , +.BR FAN_MARK_MOUNT , or .B FAN_MARK_FILESYSTEM can be used in conjunction with@@ -99,6 +100,20 @@ If the filesystem object to be marked is not a directory, the error .B ENOTDIR
man/man2/fanotify_mark.2 If the filesystem object to be marked is not a directory, the error · line 110
Quoted 10 lines
man/man2/fanotify_mark.2 +8
-0shall be raised. .TP +.BR FAN_MARK_MNTNS " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Mark the mount namespace specified by +.IR pathname . +If the +.I pathname +is not a path that represents a mount namespace (e.g. +.BR /proc/ pid /ns/mnt ),
Paths should be in italics, not bold.
.IR /proc/ pid /ns/mnt ),
man/man2/fanotify_mark.2 If the filesystem object to be marked is not a directory, the error · line 113
Quoted 3 lines
man/man2/fanotify_mark.2 +3
-0+the call fails with the error +.BR EINVAL . +An fanotify group that is initialized with flag
The fanotify group must have been initialized previously, I assume. If so, I think we should say s/is/have been/. Or maybe s/is/was/.
man/man2/fanotify_mark.2 Create an event when a marked file or directory itself has been moved. · line 413
Quoted 11 lines
man/man2/fanotify_mark.2 +4
-0+.B FAN_REPORT_MNT +is required. +.TP .B FAN_MARK_MOUNT Mark the mount specified by .IR pathname .@@ -395,6 +410,24 @@ Create an event when a marked file or directory itself has been moved. An fanotify group that identifies filesystem objects by file handles is required. .TP +.BR FAN_MNT_ATTACH ", " FAN_MNT_DETACH " (since Linux 6.14)"
Let's use two separate tags. We can do like sched_setattr(2):
SCHED_FLAG_UTIL_CLAMP_MIN SCHED_FLAG_UTIL_CLAMP_MAX (both since Linux 5.3)
These flags indicate that the sched_util_min or sched_util_max fields, respectively, are present, representing the expected minimum and maximum uti‐ lization of the thread.
The utilization attributes provide the scheduler with boundaries within which it should schedule the thread, potentially informing its decisions regard‐ ing task placement and frequency selection.
This would be coded as:
.TP .B FAN_MNT_ATTACH .TQ .BR FAN_MNT_DETACH " (both since Linux 6.14)"
man/man2/fanotify_mark.2 Create an event when a marked file or directory itself has been moved. · line 415
Quoted 2 lines
man/man2/fanotify_mark.2 +2
-0+.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Create an event when a mount was attached to or detached from a marked mount namespace.
Please don't go past 80 columns in source code. Here, I'd break after 'event', for example, and maybe also before 'marked'.
man/man2/fanotify_mark.2 Create an event when a marked file or directory itself has been moved. · line 416
Quoted 1 line
man/man2/fanotify_mark.2 +1
-0+An attempt to set this flag on an inode, mount or filesystem mark
If I'm reading this correctly, I think you should add a comma after 'mount'.
Quoted 22 lines
man/man2/fanotify_mark.2 +14
-0+will result in the error +.BR EINVAL . +An fanotify group that is initialized with flag +.B FAN_REPORT_MNT +and the mark flag +.B FAN_MARK_MNTNS +are required. +An additional information record of type +.B FAN_EVENT_INFO_TYPE_MNT +is returned with the event. +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_FS_ERROR " (since Linux 5.16, 5.15.154, and 5.10.220)" .\" commit 9709bd548f11a092d124698118013f66e1740f9b Create an event when a filesystem errorman/man7/fanotify.7 +0
-0
man/man7/fanotify.7 struct fanotify_event_info_pidfd { · line 234
Quoted 7 lines
man/man7/fanotify.7 +4
-0@@ -228,6 +228,23 @@ struct fanotify_event_info_pidfd { .EE .in .P +In cases where an fanotify group is initialized with +.BR FAN_REPORT_MNT , +event listeners should expect to receive the below +information record object alongside the generic
I'd break the sentence after 'receive' and before 'alongside'.
Quoted 45 lines
man/man7/fanotify.7 +24
-0+.I fanotify_event_metadata +structure within the read buffer. +This structure is defined as follows: +.P +.in +4n +.EX +struct fanotify_event_info_mnt { + struct fanotify_event_info_header hdr; + __u64 mnt_id; +}; +.EE +.in +.P In case of a .B FAN_FS_ERROR event,@@ -442,6 +459,12 @@ A file or directory that was opened read-only .RB ( O_RDONLY ) was closed. .TP +.BR FAN_MNT_ATTACH +A mount was attached to mount namespace. +.TP +.BR FAN_MNT_DETACH +A mount was detached from mount namespace. +.TP .B FAN_FS_ERROR A filesystem error was detected. .TP@@ -540,6 +563,7 @@ The value of this field can be set to one of the following: .BR FAN_EVENT_INFO_TYPE_FID , .BR FAN_EVENT_INFO_TYPE_DFID , .BR FAN_EVENT_INFO_TYPE_DFID_NAME , +.BR FAN_EVENT_INFO_TYPE_MNT , .BR FAN_EVENT_INFO_TYPE_ERROR , .BR FAN_EVENT_INFO_TYPE_RANGE , or@@ -727,6 +751,26 @@ in case of a terminated process, the value will be .BR \-ESRCH . .P The fields of the +.I fanotify_event_info_mnt +structure are as follows: +.TP +.I .hdr
man/man7/fanotify.7 in case of a terminated process, the value will be · line 767
Quoted 10 lines
man/man7/fanotify.7 +10
-0+This is a structure of type +.IR fanotify_event_info_header . +The +.I .info_type +field is set to +.BR FAN_EVENT_INFO_TYPE_MNT . +.TP +.I .mnt_id +Identifies the mount associated with the event. +It is a 64bit unique mount id as the one returned by
s/64bit/64-bit/
man/man7/fanotify.7 in case of a terminated process, the value will be · line 770
Quoted 3 lines
man/man7/fanotify.7 +3
-0+.BR statx (2) +with the +.BR STATX_MNT_ID_UNIQUE
s/BR/B/
man/man7/fanotify.7 in case of a terminated process, the value will be · line 776
Quoted 6 lines
man/man7/fanotify.7 +3
-0+flag. +.P +The fields of the .I fanotify_event_info_error structure are as follows: .TP
Have a lovely night!
Alex
Signature · 3 lines
<https://www.alejandro-colomar.es/> <https://www.alejandro-colomar.es:8443/> <http://www.alejandro-colomar.es:8080/>
Quoted 23 lines · Alejandro Colomar
Hi Amir,
Quoted 19 lines · Amir Goldstein
Used to subscribe for notifications for when mounts are attached/detached from a mount namespace.
Cc Jan Kara <[email protected]>Cc Miklos Szeredi <[email protected]>Reviewed-by Christian Brauner <[email protected]>Signed-off-by Amir Goldstein <[email protected]>---
Changes since v1:
- Add RVB
- Add reference tostatx()uniquemnt_id(Jan)
- Fix description ofMARK_MNTNSpath (Miklos)man/man2/fanotify_init.2 | 20 ++++++++++++++++++ man/man2/fanotify_mark.2 | 35 +++++++++++++++++++++++++++++++- man/man7/fanotify.7 | 44 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 98 insertions(+), 1 deletion(-)
Quoted 7 lines
man/man2/fanotify_init.2 that the directory entry is referring to. · line 331
Quoted 7 lines
man/man2/fanotify_init.2 +0
-0@@ -330,6 +330,26 @@ that the directory entry is referring to. This is a synonym for .RB ( FAN_REPORT_DFID_NAME | FAN_REPORT_FID | FAN_REPORT_TARGET_FID ).
See here
Quoted 18 lines
Quoted 4 lines
man/man2/fanotify_init.2 +3
-0.TP +.BR FAN_REPORT_MNT " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +This value allows the receipt of events which contain additional informationman/man2/fanotify_init.2 that the directory entry is referring to. · line 345
Quoted 10 lines
man/man2/fanotify_init.2 +10
-0+about the underlying mount correlated to an event. +An additional record of type +.B FAN_EVENT_INFO_TYPE_MNT +encapsulates the information about the mount and is included alongside the +generic event metadata structure. +The use of +.BR FAN_CLASS_CONTENT , +.BR FAN_CLASS_PRE_CONTENT, +or any of the +.B FAN_REPORT_DFID_NAME_TARGETWhat do you mean by any of the flags? Is _NAME_ a placeholder? If so, the placeholder should be in italics:
Quoted 1 line
.BI
FOO_placeholder_BAR
FAN_REPORT_DFID_NAME_TARGET is a macro for combination of flags (see above)
None of those flags are allowed together with FAN_REPORT_MNT
Quoted 184 lines
Quoted 27 lines
man/man2/fanotify_init.2 +7
-0+flags along with this flag is not permitted +and will result in the error +.BR EINVAL . +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_REPORT_PIDFD " (since Linux 5.15 and 5.10.220)" .\" commit af579beb666aefb17e9a335c12c788c92932baf1 Events for fanotify groups initialized with this flag will containman/man2/fanotify_mark.2 +2
-1@@ -67,7 +67,8 @@ contains all marks for filesystems are removed from the group. Otherwise, all marks for directories and files are removed. No flag other than, and at most one of, the flags -.B FAN_MARK_MOUNT +.BR FAN_MARK_MNTNS , +.BR FAN_MARK_MOUNT , or .B FAN_MARK_FILESYSTEM can be used in conjunction with@@ -99,6 +100,20 @@ If the filesystem object to be marked is not a directory, the error .B ENOTDIRman/man2/fanotify_mark.2 If the filesystem object to be marked is not a directory, the error · line 110
Quoted 10 lines
man/man2/fanotify_mark.2 +8
-0shall be raised. .TP +.BR FAN_MARK_MNTNS " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Mark the mount namespace specified by +.IR pathname . +If the +.I pathname +is not a path that represents a mount namespace (e.g. +.BR /proc/ pid /ns/mnt ),Paths should be in italics, not bold.
.IR /proc/ pid /ns/mnt ),man/man2/fanotify_mark.2 If the filesystem object to be marked is not a directory, the error · line 113
Quoted 3 lines
man/man2/fanotify_mark.2 +3
-0+the call fails with the error +.BR EINVAL . +An fanotify group that is initialized with flagThe fanotify group must have been initialized previously, I assume. If so, I think we should say s/is/have been/. Or maybe s/is/was/.
man/man2/fanotify_mark.2 Create an event when a marked file or directory itself has been moved. · line 413
Quoted 11 lines
man/man2/fanotify_mark.2 +4
-0+.B FAN_REPORT_MNT +is required. +.TP .B FAN_MARK_MOUNT Mark the mount specified by .IR pathname .@@ -395,6 +410,24 @@ Create an event when a marked file or directory itself has been moved. An fanotify group that identifies filesystem objects by file handles is required. .TP +.BR FAN_MNT_ATTACH ", " FAN_MNT_DETACH " (since Linux 6.14)"Let's use two separate tags. We can do like
sched_setattr(2):
SCHED_FLAG_UTIL_CLAMP_MINSCHED_FLAG_UTIL_CLAMP_MAX(both since Linux 5.3)
These flags indicate that thesched_util_minorsched_util_maxfields, respectively, are present, representing the expected minimum and maximum uti‐ lization of the thread.The utilization attributes provide the scheduler with boundaries within which it should schedule the thread, potentially informing its decisions regard‐ ing task placement and frequency selection.
This would be coded as:
.TP .B FAN_MNT_ATTACH .TQ .BR FAN_MNT_DETACH " (both since Linux 6.14)"man/man2/fanotify_mark.2 Create an event when a marked file or directory itself has been moved. · line 415
Quoted 2 lines
man/man2/fanotify_mark.2 +2
-0+.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +Create an event when a mount was attached to or detached from a marked mount namespace.Please don't go past 80 columns in source code. Here, I'd break after 'event', for example, and maybe also before 'marked'.
man/man2/fanotify_mark.2 Create an event when a marked file or directory itself has been moved. · line 416
Quoted 1 line
man/man2/fanotify_mark.2 +1
-0+An attempt to set this flag on an inode, mount or filesystem markIf I'm reading this correctly, I think you should add a comma after 'mount'.
Quoted 22 lines
man/man2/fanotify_mark.2 +14
-0+will result in the error +.BR EINVAL . +An fanotify group that is initialized with flag +.B FAN_REPORT_MNT +and the mark flag +.B FAN_MARK_MNTNS +are required. +An additional information record of type +.B FAN_EVENT_INFO_TYPE_MNT +is returned with the event. +See +.BR fanotify (7) +for additional details. +.TP .BR FAN_FS_ERROR " (since Linux 5.16, 5.15.154, and 5.10.220)" .\" commit 9709bd548f11a092d124698118013f66e1740f9b Create an event when a filesystem errorman/man7/fanotify.7 +0
-0man/man7/fanotify.7 struct fanotify_event_info_pidfd { · line 234
Quoted 7 lines
man/man7/fanotify.7 +4
-0@@ -228,6 +228,23 @@ struct fanotify_event_info_pidfd { .EE .in .P +In cases where an fanotify group is initialized with +.BR FAN_REPORT_MNT , +event listeners should expect to receive the below +information record object alongside the genericI'd break the sentence after 'receive' and before 'alongside'.
Quoted 45 lines
man/man7/fanotify.7 +24
-0+.I fanotify_event_metadata +structure within the read buffer. +This structure is defined as follows: +.P +.in +4n +.EX +struct fanotify_event_info_mnt { + struct fanotify_event_info_header hdr; + __u64 mnt_id; +}; +.EE +.in +.P In case of a .B FAN_FS_ERROR event,@@ -442,6 +459,12 @@ A file or directory that was opened read-only .RB ( O_RDONLY ) was closed. .TP +.BR FAN_MNT_ATTACH +A mount was attached to mount namespace. +.TP +.BR FAN_MNT_DETACH +A mount was detached from mount namespace. +.TP .B FAN_FS_ERROR A filesystem error was detected. .TP@@ -540,6 +563,7 @@ The value of this field can be set to one of the following: .BR FAN_EVENT_INFO_TYPE_FID , .BR FAN_EVENT_INFO_TYPE_DFID , .BR FAN_EVENT_INFO_TYPE_DFID_NAME , +.BR FAN_EVENT_INFO_TYPE_MNT , .BR FAN_EVENT_INFO_TYPE_ERROR , .BR FAN_EVENT_INFO_TYPE_RANGE , or@@ -727,6 +751,26 @@ in case of a terminated process, the value will be .BR \-ESRCH . .P The fields of the +.I fanotify_event_info_mnt +structure are as follows: +.TP +.I .hdrman/man7/fanotify.7 in case of a terminated process, the value will be · line 767
Quoted 10 lines
man/man7/fanotify.7 +10
-0+This is a structure of type +.IR fanotify_event_info_header . +The +.I .info_type +field is set to +.BR FAN_EVENT_INFO_TYPE_MNT . +.TP +.I .mnt_id +Identifies the mount associated with the event. +It is a 64bit unique mount id as the one returned bys/64bit/64-bit/
Quoted 6 lines
man/man7/fanotify.7 in case of a terminated process, the value will be · line 770
Quoted 3 lines
man/man7/fanotify.7 +3
-0+.BR statx (2) +with the +.BR STATX_MNT_ID_UNIQUEs/BR/B/
Fixed all.
Let me know if you are happy with my clarification on FAN_REPORT_DFID_NAME_TARGET
and I will post v3.
Thanks,
Amir.
Alejandro Colomar
maintainerHi Amir,
Quoted 28 lines · Amir Goldstein
Quoted 7 lines
man/man2/fanotify_init.2 that the directory entry is referring to. · line 331
Quoted 7 lines
man/man2/fanotify_init.2 +0
-0@@ -330,6 +330,26 @@ that the directory entry is referring to. This is a synonym for .RB ( FAN_REPORT_DFID_NAME | FAN_REPORT_FID | FAN_REPORT_TARGET_FID ).See here
Quoted 18 lines
Quoted 4 lines
man/man2/fanotify_init.2 +3
-0.TP +.BR FAN_REPORT_MNT " (since Linux 6.14)" +.\" commit 0f46d81f2bce970b1c562aa3c944a271bbec2729 +This value allows the receipt of events which contain additional informationman/man2/fanotify_init.2 that the directory entry is referring to. · line 345
Quoted 10 lines
man/man2/fanotify_init.2 +10
-0+about the underlying mount correlated to an event. +An additional record of type +.B FAN_EVENT_INFO_TYPE_MNT +encapsulates the information about the mount and is included alongside the +generic event metadata structure. +The use of +.BR FAN_CLASS_CONTENT , +.BR FAN_CLASS_PRE_CONTENT, +or any of the +.B FAN_REPORT_DFID_NAME_TARGETWhat do you mean by any of the flags? Is _NAME_ a placeholder? If so, the placeholder should be in italics:
Quoted 4 lines
Quoted 1 line
.BI
FOO_placeholder_BAR
FAN_REPORT_DFID_NAME_TARGETis a macro for combination of flags (see above)
Makes sense.
Quoted 11 lines
None of those flags are allowed together with
FAN_REPORT_MNTQuoted 2 lines
s/BR/B/
Fixed all.
Let me know if you are happy with my clarification on
FAN_REPORT_DFID_NAME_TARGET
Yep, please go ahead. Thanks!
Have a lovely night!
Alex
Quoted 5 lines
and I will post v3.
Thanks,
Amir.
Signature · 3 lines
<https://www.alejandro-colomar.es/> <https://www.alejandro-colomar.es:8443/> <http://www.alejandro-colomar.es:8080/>