1 =================== 1 ===================
2 rtla-osnoise-hist 2 rtla-osnoise-hist
3 =================== 3 ===================
4 ---------------------------------------------- 4 ------------------------------------------------------
5 Display a histogram of the osnoise tracer samp 5 Display a histogram of the osnoise tracer samples
6 ---------------------------------------------- 6 ------------------------------------------------------
7 7
8 :Manual section: 1 8 :Manual section: 1
9 9
10 SYNOPSIS 10 SYNOPSIS
11 ======== 11 ========
12 **rtla osnoise hist** [*OPTIONS*] 12 **rtla osnoise hist** [*OPTIONS*]
13 13
14 DESCRIPTION 14 DESCRIPTION
15 =========== 15 ===========
16 .. include:: common_osnoise_description.rst 16 .. include:: common_osnoise_description.rst
17 17
18 The **rtla osnoise hist** tool collects all ** 18 The **rtla osnoise hist** tool collects all **osnoise:sample_threshold**
19 occurrence in a histogram, displaying the resu 19 occurrence in a histogram, displaying the results in a user-friendly way.
20 The tool also allows many configurations of th 20 The tool also allows many configurations of the *osnoise* tracer and the
21 collection of the tracer output. 21 collection of the tracer output.
22 22
23 OPTIONS 23 OPTIONS
24 ======= 24 =======
25 .. include:: common_osnoise_options.rst 25 .. include:: common_osnoise_options.rst
26 26
27 .. include:: common_hist_options.rst 27 .. include:: common_hist_options.rst
28 28
29 .. include:: common_options.rst 29 .. include:: common_options.rst
30 30
31 EXAMPLE 31 EXAMPLE
32 ======= 32 =======
33 In the example below, *osnoise* tracer threads 33 In the example below, *osnoise* tracer threads are set to run with real-time
34 priority *FIFO:1*, on CPUs *0-11*, for *900ms* 34 priority *FIFO:1*, on CPUs *0-11*, for *900ms* at each period (*1s* by
35 default). The reason for reducing the runtime 35 default). The reason for reducing the runtime is to avoid starving the
36 **rtla** tool. The tool is also set to run for 36 **rtla** tool. The tool is also set to run for *one minute*. The output
37 histogram is set to group outputs in buckets o 37 histogram is set to group outputs in buckets of *10us* and *25* entries::
38 38
39 [root@f34 ~/]# rtla osnoise hist -P F:1 -c 0 39 [root@f34 ~/]# rtla osnoise hist -P F:1 -c 0-11 -r 900000 -d 1M -b 10 -E 25
40 # RTLA osnoise histogram 40 # RTLA osnoise histogram
41 # Time unit is microseconds (us) 41 # Time unit is microseconds (us)
42 # Duration: 0 00:01:00 42 # Duration: 0 00:01:00
43 Index CPU-000 CPU-001 CPU-002 CPU-00 43 Index CPU-000 CPU-001 CPU-002 CPU-003 CPU-004 CPU-005 CPU-006 CPU-007 CPU-008 CPU-009 CPU-010 CPU-011
44 0 42982 46287 51779 5374 44 0 42982 46287 51779 53740 52024 44817 49898 36500 50408 50128 49523 52377
45 10 12224 8356 2912 87 45 10 12224 8356 2912 878 2667 10155 4573 18894 4214 4836 5708 2413
46 20 8 5 12 46 20 8 5 12 2 13 24 20 41 29 53 39 39
47 30 1 1 0 47 30 1 1 0 0 10 3 6 19 15 31 30 38
48 40 0 0 0 48 40 0 0 0 0 0 4 2 7 2 3 8 11
49 50 0 0 0 49 50 0 0 0 0 0 0 0 0 0 1 1 2
50 over: 0 0 0 50 over: 0 0 0 0 0 0 0 0 0 0 0 0
51 count: 55215 54649 54703 5462 51 count: 55215 54649 54703 54620 54714 55003 54499 55461 54668 55052 55309 54880
52 min: 0 0 0 52 min: 0 0 0 0 0 0 0 0 0 0 0 0
53 avg: 0 0 0 53 avg: 0 0 0 0 0 0 0 0 0 0 0 0
54 max: 30 30 20 2 54 max: 30 30 20 20 30 40 40 40 40 50 50 50
55 55
56 SEE ALSO 56 SEE ALSO
57 ======== 57 ========
58 **rtla-osnoise**\(1), **rtla-osnoise-top**\(1) 58 **rtla-osnoise**\(1), **rtla-osnoise-top**\(1)
59 59
60 *osnoise* tracer documentation: <https://www.k 60 *osnoise* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html>
61 61
62 AUTHOR 62 AUTHOR
63 ====== 63 ======
64 Written by Daniel Bristot de Oliveira <bristot@ 64 Written by Daniel Bristot de Oliveira <bristot@kernel.org>
65 65
66 .. include:: common_appendix.rst 66 .. 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.