162306a36Sopenharmony_ci=================== 262306a36Sopenharmony_cirtla-osnoise-hist 362306a36Sopenharmony_ci=================== 462306a36Sopenharmony_ci------------------------------------------------------ 562306a36Sopenharmony_ciDisplay a histogram of the osnoise tracer samples 662306a36Sopenharmony_ci------------------------------------------------------ 762306a36Sopenharmony_ci 862306a36Sopenharmony_ci:Manual section: 1 962306a36Sopenharmony_ci 1062306a36Sopenharmony_ciSYNOPSIS 1162306a36Sopenharmony_ci======== 1262306a36Sopenharmony_ci**rtla osnoise hist** [*OPTIONS*] 1362306a36Sopenharmony_ci 1462306a36Sopenharmony_ciDESCRIPTION 1562306a36Sopenharmony_ci=========== 1662306a36Sopenharmony_ci.. include:: common_osnoise_description.rst 1762306a36Sopenharmony_ci 1862306a36Sopenharmony_ciThe **rtla osnoise hist** tool collects all **osnoise:sample_threshold** 1962306a36Sopenharmony_cioccurrence in a histogram, displaying the results in a user-friendly way. 2062306a36Sopenharmony_ciThe tool also allows many configurations of the *osnoise* tracer and the 2162306a36Sopenharmony_cicollection of the tracer output. 2262306a36Sopenharmony_ci 2362306a36Sopenharmony_ciOPTIONS 2462306a36Sopenharmony_ci======= 2562306a36Sopenharmony_ci.. include:: common_osnoise_options.rst 2662306a36Sopenharmony_ci 2762306a36Sopenharmony_ci.. include:: common_hist_options.rst 2862306a36Sopenharmony_ci 2962306a36Sopenharmony_ci.. include:: common_options.rst 3062306a36Sopenharmony_ci 3162306a36Sopenharmony_ciEXAMPLE 3262306a36Sopenharmony_ci======= 3362306a36Sopenharmony_ciIn the example below, *osnoise* tracer threads are set to run with real-time 3462306a36Sopenharmony_cipriority *FIFO:1*, on CPUs *0-11*, for *900ms* at each period (*1s* by 3562306a36Sopenharmony_cidefault). The reason for reducing the runtime is to avoid starving the 3662306a36Sopenharmony_ci**rtla** tool. The tool is also set to run for *one minute*. The output 3762306a36Sopenharmony_cihistogram is set to group outputs in buckets of *10us* and *25* entries:: 3862306a36Sopenharmony_ci 3962306a36Sopenharmony_ci [root@f34 ~/]# rtla osnoise hist -P F:1 -c 0-11 -r 900000 -d 1M -b 10 -E 25 4062306a36Sopenharmony_ci # RTLA osnoise histogram 4162306a36Sopenharmony_ci # Time unit is microseconds (us) 4262306a36Sopenharmony_ci # Duration: 0 00:01:00 4362306a36Sopenharmony_ci 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 4462306a36Sopenharmony_ci 0 42982 46287 51779 53740 52024 44817 49898 36500 50408 50128 49523 52377 4562306a36Sopenharmony_ci 10 12224 8356 2912 878 2667 10155 4573 18894 4214 4836 5708 2413 4662306a36Sopenharmony_ci 20 8 5 12 2 13 24 20 41 29 53 39 39 4762306a36Sopenharmony_ci 30 1 1 0 0 10 3 6 19 15 31 30 38 4862306a36Sopenharmony_ci 40 0 0 0 0 0 4 2 7 2 3 8 11 4962306a36Sopenharmony_ci 50 0 0 0 0 0 0 0 0 0 1 1 2 5062306a36Sopenharmony_ci over: 0 0 0 0 0 0 0 0 0 0 0 0 5162306a36Sopenharmony_ci count: 55215 54649 54703 54620 54714 55003 54499 55461 54668 55052 55309 54880 5262306a36Sopenharmony_ci min: 0 0 0 0 0 0 0 0 0 0 0 0 5362306a36Sopenharmony_ci avg: 0 0 0 0 0 0 0 0 0 0 0 0 5462306a36Sopenharmony_ci max: 30 30 20 20 30 40 40 40 40 50 50 50 5562306a36Sopenharmony_ci 5662306a36Sopenharmony_ciSEE ALSO 5762306a36Sopenharmony_ci======== 5862306a36Sopenharmony_ci**rtla-osnoise**\(1), **rtla-osnoise-top**\(1) 5962306a36Sopenharmony_ci 6062306a36Sopenharmony_ci*osnoise* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html> 6162306a36Sopenharmony_ci 6262306a36Sopenharmony_ciAUTHOR 6362306a36Sopenharmony_ci====== 6462306a36Sopenharmony_ciWritten by Daniel Bristot de Oliveira <bristot@kernel.org> 6562306a36Sopenharmony_ci 6662306a36Sopenharmony_ci.. include:: common_appendix.rst 67