1**-c**, **--cpus** *cpu-list* 2 3 Set the osnoise tracer to run the sample threads in the cpu-list. 4 5**-H**, **--house-keeping** *cpu-list* 6 7 Run rtla control threads only on the given cpu-list. 8 9**-d**, **--duration** *time[s|m|h|d]* 10 11 Set the duration of the session. 12 13**-D**, **--debug** 14 15 Print debug info. 16 17**-e**, **--event** *sys:event* 18 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 21**--filter** *<filter>* 22 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 25**--trigger** *<trigger>* 26 Enable a trace event trigger to the previous **-e** *sys:event*. 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: 29 30 rtla <command> <mode> -t -e osnoise:irq_noise --trigger="hist:key=desc,duration/1000:sort=desc,duration/1000:vals=hitcount" 31 32 Will automatically save the content of the histogram associated to *osnoise:irq_noise* event in *osnoise_irq_noise_hist.txt*. 33 34 For further information about event trigger see https://www.kernel.org/doc/html/latest/trace/events.html#event-triggers. 35 36**-P**, **--priority** *o:prio|r:prio|f:prio|d:runtime:period* 37 38 Set scheduling parameters to the osnoise tracer threads, the format to set the priority are: 39 40 - *o:prio* - use SCHED_OTHER with *prio*; 41 - *r:prio* - use SCHED_RR with *prio*; 42 - *f:prio* - use SCHED_FIFO with *prio*; 43 - *d:runtime[us|ms|s]:period[us|ms|s]* - use SCHED_DEADLINE with *runtime* and *period* in nanoseconds. 44 45**-C**, **--cgroup**\[*=cgroup*] 46 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 49**--warm-up** *s* 50 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 53**--trace-buffer-size** *kB* 54 Set the per-cpu trace buffer size in kB for the tracing output. 55 56**--on-threshold** *action* 57 58 Defines an action to be executed when tracing is stopped on a latency threshold 59 specified by |threshold|. 60 61 Multiple --on-threshold actions may be specified, and they will be executed in 62 the order they are provided. If any action fails, subsequent actions in the list 63 will not be executed. 64 65 Supported actions are: 66 67 - *trace[,file=<filename>]* 68 69 Saves trace output, optionally taking a filename. Alternative to -t/--trace. 70 Note that nlike -t/--trace, specifying this multiple times will result in 71 the trace being saved multiple times. 72 73 - *signal,num=<sig>,pid=<pid>* 74 75 Sends signal to process. "parent" might be specified in place of pid to target 76 the parent process of rtla. 77 78 - *shell,command=<command>* 79 80 Execute shell command. 81 82 - *continue* 83 84 Continue tracing after actions are executed instead of stopping. 85 86 Example: 87 88 $ rtla |tool| |thresharg| 20 --on-threshold trace 89 --on-threshold shell,command="grep ipi_send |tracer|\_trace.txt" 90 --on-threshold signal,num=2,pid=parent 91 92 This will save a trace with the default filename "|tracer|\_trace.txt", print its 93 lines that contain the text "ipi_send" on standard output, and send signal 2 94 (SIGINT) to the parent process. 95 96 Performance Considerations: 97 98 |actionsperf| 99 100**--on-end** *action* 101 102 Defines an action to be executed at the end of tracing. 103 104 Multiple --on-end actions can be specified, and they will be executed in the order 105 they are provided. If any action fails, subsequent actions in the list will not be 106 executed. 107 108 See the documentation for **--on-threshold** for the list of supported actions, with 109 the exception that *continue* has no effect. 110 111 Example: 112 113 $ rtla |tool| -d 5s --on-end trace 114 115 This runs rtla with the default options, and saves trace output at the end. 116 117**-h**, **--help** 118 119 Print help menu. 120