8 lttng-start - Start an LTTng recording session
14 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *start* [option::--all | option::--glob 'SESSION' | 'SESSION' ]
19 The `lttng start` command starts a recording session, that is, it
20 activates the LTTng tracers for:
22 With the 'SESSION' argument::
23 The recording session named 'SESSION'.
25 Without the 'SESSION' argument::
26 The current recording session (see man:lttng-concepts(7) to learn
27 more about the current recording session).
29 See man:lttng-concepts(7) to learn more about recording sessions.
31 The selected recording session must be inactive (stopped). A recording
32 session is inactive on creation (see man:lttng-create(1)).
34 A `start-session` trigger action can also start a recording session
35 (see man:lttng-add-trigger(1)).
37 See the ``<<examples,EXAMPLES>>'' section below for usage examples.
39 Stop an active recording session with the man:lttng-stop(1) command.
42 include::common-lttng-cmd-options-head.txt[]
45 include::common-lttng-cmd-help-options.txt[]
47 option:-a, option:--all::
50 option:-g, option:--glob::
51 Interpret SESSION as a globbing pattern.
53 include::common-lttng-cmd-after-options.txt[]
59 .Start the current recording session.
67 .Start a specific recording session.
71 $ lttng start my-session
77 See the option::--all option.
85 .Start all sessions with the suffix foo.
87 See the option::--glob option.
91 $ lttng start --glob '*foo'
96 include::common-footer.txt[]
102 man:lttng-add-trigger(1),
104 man:lttng-enable-event(1),
106 man:lttng-concepts(7)