aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2016-03-08 19:40:04 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2016-03-08 20:07:32 +0100
commit4e77145cca1992b8383f38a8f0460b5c9e5c175b (patch)
treea7d8009bb7ae3b1c2585642b9b62c3e650900301
parent58a80cd4f00b2efd343b2602364752e788aa7efe (diff)
downloadman-pages-4e77145cca1992b8383f38a8f0460b5c9e5c175b.tar.gz
proc.5: Document inotify /proc/PID/fdinfo entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man5/proc.553
1 files changed, 40 insertions, 13 deletions
diff --git a/man5/proc.5 b/man5/proc.5
index a0890fd108..e2096499e5 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -723,19 +723,46 @@ and
.BR SIGQUIT ;
see
.BR signal (7).)
-.\" FIXME
-.\" Certain file types include additional info; see
-.\" Documentation/filesystems/proc.txt
-.\"
-.\" Especially interesting is this:
-.\"
-.\" commit ab49bdecc3ebb46ab661f5f05d5c5ea9606406c6
-.\" Author: Cyrill Gorcunov <gorcunov@openvz.org>
-.\" Date: Mon Dec 17 16:05:06 2012 -0800
-.\"
-.\" Basically, the /proc/PID/fdinfo/ entry for an inotify FD
-.\" includes the file handles for all watched FDs
-.\"
+
+For inotify file descriptors (see
+.BR inotify (7)),
+we see (since Linux 3.8)
+the following fields:
+
+.in +4n
+.nf
+pos: 0
+flags: 00
+mnt_id: 11
+inotify wd:2 ino:7ef82a sdev:800001 mask:800afff ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_handle:2af87e00220ffd73
+inotify wd:1 ino:192627 sdev:800001 mask:800afff ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_handle:27261900802dfd73
+.fi
+.in
+
+Each of the lines beginning with "inotify" displays information about
+one file or directory that is being monitored.
+The fields in this line are as follows:
+.RS
+.TP
+.I wd
+A watch descriptor number (in decimal).
+.TP
+.I ino
+The inode number of the target file (in hexadecimal).
+.TP
+.I sdev
+The ID of the device where the target file resides (in hexadecimal).
+.TP
+.I mask
+The mask of events being monitored for the target file (in hexadecimal).
+.RE
+.IP
+If the kernel was built with exportfs support, the path to the target
+file is exposed as a file handle, via three hexadecimal fields:
+.IR fhandle-bytes ,
+.IR fhandle-type ,
+and
+.IR f_handle .
.TP
.IR /proc/[pid]/io " (since kernel 2.6.20)"
.\" commit 7c3ab7381e79dfc7db14a67c6f4f3285664e1ec2