0001 **-c**, **--cpus** *cpu-list*
0002
0003 Set the osnoise tracer to run the sample threads in the cpu-list.
0004
0005 **-d**, **--duration** *time[s|m|h|d]*
0006
0007 Set the duration of the session.
0008
0009 **-D**, **--debug**
0010
0011 Print debug info.
0012
0013 **-t**, **--trace**\[*=file*]
0014
0015 Save the stopped trace to [*file|osnoise_trace.txt*].
0016
0017 **-e**, **--event** *sys:event*
0018
0019 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.
0020
0021 **--filter** *<filter>*
0022
0023 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.
0024
0025 **--trigger** *<trigger>*
0026 Enable a trace event trigger to the previous **-e** *sys:event*.
0027 If the *hist:* trigger is activated, the output histogram will be automatically saved to a file named *system_event_hist.txt*.
0028 For example, the command:
0029
0030 rtla <command> <mode> -t -e osnoise:irq_noise --trigger="hist:key=desc,duration/1000:sort=desc,duration/1000:vals=hitcount"
0031
0032 Will automatically save the content of the histogram associated to *osnoise:irq_noise* event in *osnoise_irq_noise_hist.txt*.
0033
0034 For further information about event trigger see https://www.kernel.org/doc/html/latest/trace/events.html#event-triggers.
0035
0036 **-P**, **--priority** *o:prio|r:prio|f:prio|d:runtime:period*
0037
0038 Set scheduling parameters to the osnoise tracer threads, the format to set the priority are:
0039
0040 - *o:prio* - use SCHED_OTHER with *prio*;
0041 - *r:prio* - use SCHED_RR with *prio*;
0042 - *f:prio* - use SCHED_FIFO with *prio*;
0043 - *d:runtime[us|ms|s]:period[us|ms|s]* - use SCHED_DEADLINE with *runtime* and *period* in nanoseconds.
0044
0045 **-h**, **--help**
0046
0047 Print help menu.
