1 ================ 1 ================
2 rtla-timerlat 2 rtla-timerlat
3 ================ 3 ================
4 ------------------------------------------- 4 -------------------------------------------
5 Measures the operating system timer latency 5 Measures the operating system timer latency
6 ------------------------------------------- 6 -------------------------------------------
7 7
8 :Manual section: 1 8 :Manual section: 1
9 9
10 SYNOPSIS 10 SYNOPSIS
11 ======== 11 ========
12 **rtla timerlat** [*MODE*] ... 12 **rtla timerlat** [*MODE*] ...
13 13
14 DESCRIPTION 14 DESCRIPTION
15 =========== 15 ===========
16 16
17 .. include:: common_timerlat_description.rst 17 .. include:: common_timerlat_description.rst
18 18
19 The *timerlat* tracer outputs information in t 19 The *timerlat* tracer outputs information in two ways. It periodically
20 prints the timer latency at the timer *IRQ* ha 20 prints the timer latency at the timer *IRQ* handler and the *Thread* handler.
21 It also provides information for each noise vi 21 It also provides information for each noise via the **osnoise:** tracepoints.
22 The **rtla timerlat top** mode displays a summ 22 The **rtla timerlat top** mode displays a summary of the periodic output
23 from the *timerlat* tracer. The **rtla hist hi 23 from the *timerlat* tracer. The **rtla hist hist** mode displays a histogram
24 of each tracer event occurrence. For further d 24 of each tracer event occurrence. For further details, please refer to the
25 respective man page. 25 respective man page.
26 26
27 MODES 27 MODES
28 ===== 28 =====
29 **top** 29 **top**
30 30
31 Prints the summary from *timerlat* tra 31 Prints the summary from *timerlat* tracer.
32 32
33 **hist** 33 **hist**
34 34
35 Prints a histogram of timerlat samples 35 Prints a histogram of timerlat samples.
36 36
37 If no *MODE* is given, the top mode is called, 37 If no *MODE* is given, the top mode is called, passing the arguments.
38 38
39 OPTIONS 39 OPTIONS
40 ======= 40 =======
41 **-h**, **--help** 41 **-h**, **--help**
42 42
43 Display the help text. 43 Display the help text.
44 44
45 For other options, see the man page for the co 45 For other options, see the man page for the corresponding mode.
46 46
47 SEE ALSO 47 SEE ALSO
48 ======== 48 ========
49 **rtla-timerlat-top**\(1), **rtla-timerlat-his 49 **rtla-timerlat-top**\(1), **rtla-timerlat-hist**\(1)
50 50
51 *timerlat* tracer documentation: <https://www. 51 *timerlat* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/timerlat-tracer.html>
52 52
53 AUTHOR 53 AUTHOR
54 ====== 54 ======
55 Written by Daniel Bristot de Oliveira <bristot@ 55 Written by Daniel Bristot de Oliveira <bristot@kernel.org>
56 56
57 .. include:: common_appendix.rst 57 .. include:: common_appendix.rst
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.