3 :revdate: 21 April 2021
8 lttng-start - Start an LTTng tracing session
14 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *start* ['SESSION']
19 The `lttng start` command starts a tracing session, that is, it
20 activates the LTTng tracers for:
22 With the 'SESSION' argument::
23 The tracing session named 'SESSION'.
25 Without the 'SESSION' argument::
26 The current tracing session (see man:lttng-create(1) and
27 man:lttng-set-session(1) to learn more about the current tracing
30 The selected tracing session must be inactive (stopped). A tracing
31 session is inactive on creation (see man:lttng-create(1)).
33 An active tracing session is an implicit recording event rule condition
34 (see man:lttng-enable-event(1)). In other words, a recording event rule
35 cannot match an event when its tracing session is inactive.
37 A `start-session` trigger action can also start a tracing session
38 (see man:lttng-add-trigger(1)).
40 Stop an active tracing session with the man:lttng-stop(1) command.
43 include::common-cmd-options-head.txt[]
46 include::common-cmd-help-options.txt[]
49 include::common-cmd-footer.txt[]
55 man:lttng-add-trigger(1),
57 man:lttng-enable-event(1),