1RTLA-TIMERLAT(1)                                              RTLA-TIMERLAT(1)
2
3
4

NAME

6       rtla-timerlat - Measures the operating system timer latency
7

SYNOPSIS

9       rtla timerlat [MODE] ...
10

DESCRIPTION

12       The  rtla  timerlat  tool  is an interface for the timerlat tracer. The
13       timerlat tracer dispatches a kernel thread per-cpu. These threads set a
14       periodic  timer  to  wake themselves up and go back to sleep. After the
15       wakeup, they collect and generate useful information for the  debugging
16       of operating system timer latency.
17
18       The  timerlat  tracer  outputs information in two ways. It periodically
19       prints the timer latency at the timer IRQ handler and the  Thread  han‐
20       dler. It also enable the trace of the most relevant information via os‐
21       noise: tracepoints.
22
23       The timerlat tracer outputs information in two  ways.  It  periodically
24       prints  the  timer latency at the timer IRQ handler and the Thread han‐
25       dler.  It also provides information for each  noise  via  the  osnoise:
26       tracepoints.   The rtla timerlat top mode displays a summary of the pe‐
27       riodic output from the timerlat tracer. The rtla hist  hist  mode  dis‐
28       plays a histogram of each tracer event occurrence. For further details,
29       please refer to the respective man page.
30

MODES

32       top
33          Prints the summary from timerlat tracer.
34
35       hist
36          Prints a histogram of timerlat samples.
37
38       If no MODE is given, the top mode is called, passing the arguments.
39

OPTIONS

41       -h, --help
42          Display the help text.
43
44       For other options, see the man page for the corresponding mode.
45

SEE ALSO

47       rtla-timerlat-top(1), rtla-timerlat-hist(1)
48
49       timerlat             tracer              documentation:              <‐
50       https://www.kernel.org/doc/html/latest/trace/timerlat-tracer.html>
51

AUTHOR

53       Written by Daniel Bristot de Oliveira <bristot@kernel.org>
54

REPORTING BUGS

56       Report     bugs     to     <linux-kernel@vger.kernel.org>     and    <‐
57       linux-trace-devel@vger.kernel.org>
58

LICENSE

60       rtla is Free Software licensed under the GNU GPLv2
61

COPYING

63       Copyright (C) 2021 Red Hat, Inc. Free use of this software  is  granted
64       under the terms of the GNU Public License (GPL).
65
66
67
68
69                                                              RTLA-TIMERLAT(1)