1 =================== 1 ===================
2 rtla-osnoise-top 2 rtla-osnoise-top
3 =================== 3 ===================
4 ---------------------------------------------- 4 -----------------------------------------------
5 Display a summary of the operating system nois 5 Display a summary of the operating system noise
6 ---------------------------------------------- 6 -----------------------------------------------
7 7
8 :Manual section: 1 8 :Manual section: 1
9 9
10 SYNOPSIS 10 SYNOPSIS
11 ======== 11 ========
12 **rtla osnoise top** [*OPTIONS*] 12 **rtla osnoise top** [*OPTIONS*]
13 13
14 DESCRIPTION 14 DESCRIPTION
15 =========== 15 ===========
16 .. include:: common_osnoise_description.rst 16 .. include:: common_osnoise_description.rst
17 17
18 **rtla osnoise top** collects the periodic sum 18 **rtla osnoise top** collects the periodic summary from the *osnoise* tracer,
19 including the counters of the occurrence of th 19 including the counters of the occurrence of the interference source,
20 displaying the results in a user-friendly form 20 displaying the results in a user-friendly format.
21 21
22 The tool also allows many configurations of th 22 The tool also allows many configurations of the *osnoise* tracer and the
23 collection of the tracer output. 23 collection of the tracer output.
24 24
25 OPTIONS 25 OPTIONS
26 ======= 26 =======
27 .. include:: common_osnoise_options.rst 27 .. include:: common_osnoise_options.rst
28 28
29 .. include:: common_top_options.rst 29 .. include:: common_top_options.rst
30 30
31 .. include:: common_options.rst 31 .. include:: common_options.rst
32 32
33 EXAMPLE 33 EXAMPLE
34 ======= 34 =======
35 In the example below, the **rtla osnoise top** 35 In the example below, the **rtla osnoise top** tool is set to run with a
36 real-time priority *FIFO:1*, on CPUs *0-3*, fo 36 real-time priority *FIFO:1*, on CPUs *0-3*, for *900ms* at each period
37 (*1s* by default). The reason for reducing the 37 (*1s* by default). The reason for reducing the runtime is to avoid starving
38 the rtla tool. The tool is also set to run for 38 the rtla tool. The tool is also set to run for *one minute* and to display
39 a summary of the report at the end of the sess 39 a summary of the report at the end of the session::
40 40
41 [root@f34 ~]# rtla osnoise top -P F:1 -c 0-3 41 [root@f34 ~]# rtla osnoise top -P F:1 -c 0-3 -r 900000 -d 1M -q
42 Oper 42 Operating System Noise
43 duration: 0 00:01:00 | time is in us 43 duration: 0 00:01:00 | time is in us
44 CPU Period Runtime Noise % CPU 44 CPU Period Runtime Noise % CPU Aval Max Noise Max Single HW NMI IRQ Softirq Thread
45 0 #59 53100000 304896 99. 45 0 #59 53100000 304896 99.42580 6978 56 549 0 53111 1590 13
46 1 #59 53100000 338339 99. 46 1 #59 53100000 338339 99.36282 8092 24 399 0 53130 1448 31
47 2 #59 53100000 290842 99. 47 2 #59 53100000 290842 99.45227 6582 39 855 0 53110 1406 12
48 3 #59 53100000 204935 99. 48 3 #59 53100000 204935 99.61405 6251 33 290 0 53156 1460 12
49 49
50 SEE ALSO 50 SEE ALSO
51 ======== 51 ========
52 52
53 **rtla-osnoise**\(1), **rtla-osnoise-hist**\(1 53 **rtla-osnoise**\(1), **rtla-osnoise-hist**\(1)
54 54
55 Osnoise tracer documentation: <https://www.ker 55 Osnoise tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html>
56 56
57 AUTHOR 57 AUTHOR
58 ====== 58 ======
59 Written by Daniel Bristot de Oliveira <bristot@ 59 Written by Daniel Bristot de Oliveira <bristot@kernel.org>
60 60
61 .. include:: common_appendix.rst 61 .. 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.