proc.5: Document fanotify /proc/PID/fdinfo entries

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

1 files changed, 56 insertions, 0 deletions

diff --git a/man5/proc.5 b/man5/proc.5
index e2096499e5..4af62dd7cd 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -763,6 +763,62 @@ file is exposed as a file handle, via three hexadecimal fields:
 .IR fhandle-type ,
 and
 .IR f_handle .
+
+For fanotify file descriptors (see
+.BR fanotify (7)),
+we see (since Linux 3.8)
+the following fields:
+
+.in +4n
+.nf
+pos:	0
+flags:	02
+mnt_id:	11
+fanotify flags:0 event-flags:88002
+fanotify ino:19264f sdev:800001 mflags:0 mask:1 ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_handle:4f261900a82dfd73
+.fi
+.in
+
+The fourth line displays information defined when the fanotify group
+was created via
+.BR fanotify_init (2):
+.RS
+.TP
+.I flags
+The
+.I flags
+argument given to
+.BR fanotify_init (2)
+(expressed in hexadecimal).
+.TP
+.I event-flags
+The
+.I event_f_flags
+argument given to
+.BR fanotify_init (2)
+(expressed in hexadecimal).
+.RE
+.IP
+Each additional line shown in the file contains information
+about one of the marks in the fanotify group.
+Most of these fields are as for inotify, except:
+.RS
+.TP
+.I mflags
+The flags associated with the mark
+(expressed in hexadecimal).
+.TP
+.I mask
+The events mask for this mark
+(expressed in hexadecimal).
+.TP
+.I ignored_mask
+The mask of events that are ignored for this mark
+(expressed in hexadecimal).
+.RE
+.IP
+For details on these fields, see
+.BR fanotify_mark (2).
 .TP
 .IR /proc/[pid]/io " (since kernel 2.6.20)"
 .\" commit 7c3ab7381e79dfc7db14a67c6f4f3285664e1ec2