[prev in list] [next in list] [prev in thread] [next in thread] 

List:       linux-man
Subject:    Re: [PATCH] proc.5: document fdinfo format for timerfd
From:       "Michael Kerrisk (man-opages)" <mtk.manpages () gmail ! com>
Date:       2018-08-18 8:06:03
Message-ID: a485c83e-64ce-a9ff-a342-e58ad3d46039 () gmail ! com
[Download RAW message or body]

Hello Lukas,

On 06/01/2018 12:26 AM, Lucas Werkmeister wrote:
> Extended information for timerfd file descriptors in /proc/[pid]/fdinfo
> was added in commit af9c4957cf21 ("timerfd: Implement show_fdinfo
> method", 2014-07-16), to support checkpoint/restore for such file
> descriptors (see also the TFD_IOC_SET_TICKS ioctl which is documented in
> timerfd_create.2).

Nice patch! Applied.

Thank you,

Michael

> Signed-off-by: Lucas Werkmeister <mail@lucaswerkmeister.de>
> ---
>   man5/proc.5 | 45 +++++++++++++++++++++++++++++++++++++++++++++
>   1 file changed, 45 insertions(+)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 55f3232a9..ae805d8eb 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -932,6 +932,51 @@ The mask of events that are ignored for this mark
>   .IP
>   For details on these fields, see
>   .BR fanotify_mark (2).
> +.IP
> +For timerfd file descriptors (see
> +.BR timerfd (2)),
> +we see (since Linux 3.17)
> +the following fields:
> +.IP
> +.in +4n
> +.EX
> +pos:    0
> +flags:  02004002
> +mnt_id: 13
> +clockid: 0
> +ticks: 0
> +settime flags: 03
> +it_value: (7695568592, 640020877)
> +it_interval: (0, 0)
> +.EE
> +.in
> +.IP
> +.I clockid
> +is the numeric value of the clock constant used to mark the progress of the timer
> +(in this example, 0 is
> +.BR CLOCK_REALTIME ).
> +.I ticks
> +is the number of timer expirations that have occurred,
> +i.e. the value that
> +.BR read (2)
> +on it would return.
> +.I settime flags
> +lists the flags with which the timerfd was last armed (see
> +.BR timerfd_settime (2)),
> +in octal
> +(in this example, both
> +.B TFD_TIMER_ABSTIME
> +and
> +.B TFD_TIMER_CANCEL_ON_SET
> +are set).
> +.I it_value
> +contains the amount of time until the timer will next expire, and
> +.I it_interval
> +contains the interval of the timer,
> +both in seconds and nanoseconds,
> +i.e. the values that
> +.BR timerfd_gettime (2)
> +on this file descriptor would return.
>   .TP
>   .IR /proc/[pid]/gid_map " (since Linux 3.5)"
>   See
> 
[prev in list] [next in list] [prev in thread] [next in thread]