docs: Procfs -- Document timerfd output

Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org>
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: Michael Kerrisk <mtk.manpages@gmail.com>
Cc: Andrey Vagin <avagin@openvz.org>
Cc: Pavel Emelyanov <xemul@parallels.com>
Cc: Vladimir Davydov <vdavydov@parallels.com>
Link: http://lkml.kernel.org/r/20140715215703.199905126@openvz.org
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>

1 files changed, 19 insertions, 0 deletions

diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt
index ddc531a74d04..eb8a10e22f7c 100644
--- a/Documentation/filesystems/proc.txt
+++ b/Documentation/filesystems/proc.txt
@@ -1743,6 +1743,25 @@ pair provide additional information particular to the objects they represent.
         While the first three lines are mandatory and always printed, the rest is
         optional and may be omitted if no marks created yet.
 
+        Timerfd files
+        ~~~~~~~~~~~~~
+
+        pos:    0
+        flags:  02
+        mnt_id: 9
+        clockid: 0
+        ticks: 0
+        settime flags: 01
+        it_value: (0, 49406829)
+        it_interval: (1, 0)
+
+        where 'clockid' is the clock type and 'ticks' is the number of the timer expirations
+        that have occurred [see timerfd_create(2) for details]. 'settime flags' are
+        flags in octal form been used to setup the timer [see timerfd_settime(2) for
+        details]. 'it_value' is remaining time until the timer exiration.
+        'it_interval' is the interval for the timer. Note the timer might be set up
+        with TIMER_ABSTIME option which will be shown in 'settime flags', but 'it_value'
+        still exhibits timer's remaining time.
 
 ------------------------------------------------------------------------------
 Configuring procfs