docs: update documentation about /proc/<pid>/fdinfo/<fd> fanotify output
authorCyrill Gorcunov <>
Tue, 18 Dec 2012 00:05:18 +0000 (16:05 -0800)
committerLinus Torvalds <>
Tue, 18 Dec 2012 01:15:28 +0000 (17:15 -0800)
Signed-off-by: Cyrill Gorcunov <>
Cc: Pavel Emelyanov <>
Cc: Oleg Nesterov <>
Cc: Andrey Vagin <>
Cc: Al Viro <>
Cc: Alexey Dobriyan <>
Cc: James Bottomley <>
Cc: "Aneesh Kumar K.V" <>
Cc: Alexey Dobriyan <>
Cc: Matthew Helsley <>
Cc: "J. Bruce Fields" <>
Cc: "Aneesh Kumar K.V" <>
Cc: Tvrtko Ursulin <>
Signed-off-by: Andrew Morton <>
Signed-off-by: Linus Torvalds <>

index bcc27c97efbb5af3b2c478fbcd2ca97c7d1045db..fd8d0d594fc7c9fd6bd1a5baa107968a9c9fab01 100644 (file)
@@ -1698,21 +1698,27 @@ pair provide additional information particular to the objects they represent.
        If the kernel is built without exportfs support the file handle won't be
        printed out.
-       For fanotify files the format is
-       pos:    0
-       flags:  02
-       fanotify ino:2 sdev:800013 mask:1 ignored_mask:40000000 fhandle-bytes:8 fhandle-type:1 f_handle:0200000000000000
+       If there is no inotify mark attached yet the 'inotify' line will be omitted.
-       or
+       For fanotify files the format is
        pos:    0
        flags:  02
-       fanotify mnt_id:13 mask:1 ignored_mask:40000000
-       where 'ino', 'sdev' are target inode and device, 'mnt_id' is the mount
-       point identifier, 'mask' is the events mask used and 'ignored_mask' is
-       the mask of events which are to be ignored. All in hex format.
+       fanotify flags:10 event-flags:0
+       fanotify mnt_id:12 mflags:40 mask:38 ignored_mask:40000003
+       fanotify ino:4f969 sdev:800013 mflags:0 mask:3b ignored_mask:40000000 fhandle-bytes:8 fhandle-type:1 f_handle:69f90400c275b5b4
+       where fanotify 'flags' and 'event-flags' are values used in fanotify_init
+       call, 'mnt_id' is the mount point identifier, 'mflags' is the value of
+       flags associated with mark which are tracked separately from events
+       mask. 'ino', 'sdev' are target inode and device, 'mask' is the events
+       mask and 'ignored_mask' is the mask of events which are to be ignored.
+       All in hex format. Incorporation of 'mflags', 'mask' and 'ignored_mask'
+       does provide information about flags and mask used in fanotify_mark
+       call [see fsnotify manpage for details].
+       While the first three lines are mandatory and always printed, the rest is
+       optional and may be omitted if no marks created yet.