1 **-c**, **--cpus** *cpu-list* 1 **-c**, **--cpus** *cpu-list*
2 2
3 Set the osnoise tracer to run the samp 3 Set the osnoise tracer to run the sample threads in the cpu-list.
4 4
5 **-H**, **--house-keeping** *cpu-list* 5 **-H**, **--house-keeping** *cpu-list*
6 6
7 Run rtla control threads only on the g 7 Run rtla control threads only on the given cpu-list.
8 8
9 **-d**, **--duration** *time[s|m|h|d]* 9 **-d**, **--duration** *time[s|m|h|d]*
10 10
11 Set the duration of the session. 11 Set the duration of the session.
12 12
13 **-D**, **--debug** 13 **-D**, **--debug**
14 14
15 Print debug info. 15 Print debug info.
16 16
17 **-e**, **--event** *sys:event* 17 **-e**, **--event** *sys:event*
18 18
19 Enable an event in the trace (**-t**) 19 Enable an event in the trace (**-t**) session. The argument can be a specific event, e.g., **-e** *sched:sched_switch*, or all events of a system group, e.g., **-e** *sched*. Multiple **-e** are allowed. It is only active when **-t** or **-a** are set.
20 20
21 **--filter** *<filter>* 21 **--filter** *<filter>*
22 22
23 Filter the previous **-e** *sys:event* 23 Filter the previous **-e** *sys:event* event with *<filter>*. For further information about event filtering see https://www.kernel.org/doc/html/latest/trace/events.html#event-filtering.
24 24
25 **--trigger** *<trigger>* 25 **--trigger** *<trigger>*
26 Enable a trace event trigger to the pr 26 Enable a trace event trigger to the previous **-e** *sys:event*.
27 If the *hist:* trigger is activated, t 27 If the *hist:* trigger is activated, the output histogram will be automatically saved to a file named *system_event_hist.txt*.
28 For example, the command: 28 For example, the command:
29 29
30 rtla <command> <mode> -t -e osnoise:ir 30 rtla <command> <mode> -t -e osnoise:irq_noise --trigger="hist:key=desc,duration/1000:sort=desc,duration/1000:vals=hitcount"
31 31
32 Will automatically save the content of 32 Will automatically save the content of the histogram associated to *osnoise:irq_noise* event in *osnoise_irq_noise_hist.txt*.
33 33
34 For further information about event tr 34 For further information about event trigger see https://www.kernel.org/doc/html/latest/trace/events.html#event-triggers.
35 35
36 **-P**, **--priority** *o:prio|r:prio|f:prio|d 36 **-P**, **--priority** *o:prio|r:prio|f:prio|d:runtime:period*
37 37
38 Set scheduling parameters to the osnoi 38 Set scheduling parameters to the osnoise tracer threads, the format to set the priority are:
39 39
40 - *o:prio* - use SCHED_OTHER with *pri 40 - *o:prio* - use SCHED_OTHER with *prio*;
41 - *r:prio* - use SCHED_RR with *prio*; 41 - *r:prio* - use SCHED_RR with *prio*;
42 - *f:prio* - use SCHED_FIFO with *prio 42 - *f:prio* - use SCHED_FIFO with *prio*;
43 - *d:runtime[us|ms|s]:period[us|ms|s]* 43 - *d:runtime[us|ms|s]:period[us|ms|s]* - use SCHED_DEADLINE with *runtime* and *period* in nanoseconds.
44 44
45 **-C**, **--cgroup**\[*=cgroup*] 45 **-C**, **--cgroup**\[*=cgroup*]
46 46
47 Set a *cgroup* to the tracer's threads 47 Set a *cgroup* to the tracer's threads. If the **-C** option is passed without arguments, the tracer's thread will inherit **rtla**'s *cgroup*. Otherwise, the threads will be placed on the *cgroup* passed to the option.
48 48
49 **--warm-up** *s* 49 **--warm-up** *s*
50 50
51 After starting the workload, let it ru 51 After starting the workload, let it run for *s* seconds before starting collecting the data, allowing the system to warm-up. Statistical data generated during warm-up is discarded.
52 52
53 **--trace-buffer-size** *kB* 53 **--trace-buffer-size** *kB*
54 Set the per-cpu trace buffer size in k 54 Set the per-cpu trace buffer size in kB for the tracing output.
55 55
56 **-h**, **--help** 56 **-h**, **--help**
57 57
58 Print help menu. 58 Print help menu.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.