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>

diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt
index ddc531a74d04970810485e2cd5c2d4ba1cb74435..eb8a10e22f7c7ade01554922d8480b4feedfe60d 100644 (file)
--- 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