3 :revdate: 21 April 2021
8 lttng-stop - Stop an LTTng tracing session
14 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *stop* [option:--no-wait] ['SESSION']
19 The `lttng stop` command stops a tracing session, that is, it
20 deactivates 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 active (started; see
31 man:lttng-start(1)). A tracing session is inactive on creation (see
34 An active tracing session is an implicit recording event rule condition
35 (see man:lttng-enable-event(1)). In other words, a recording event rule
36 cannot match an event when its tracing session is inactive.
38 A `stop-session` trigger action can also stop a tracing session (see
39 man:lttng-add-trigger(1)).
41 Start an inactive tracing session with the man:lttng-start(1) command.
43 By default, the `stop` command ensures that the trace data of the
44 selected tracing session is valid before it exits. Make the command exit
45 immediately with the option:--no-wait option. In this case, however, the
46 traces(s) might not be valid when the command exits, and there's no way
47 to know when it/they becomes valid.
49 If LTTng archived the current trace chunk (see man:lttng-rotate(1) and
50 man:lttng-enable-rotation(1)) of the selected tracing session at least
51 once during its lifetime, the `stop` command renames the current trace
52 chunk subdirectory and prints the renamed path. Although it's safe to
53 read the content of this renamed subdirectory while the tracing session
54 remains inactive, it's :not: a trace chunk archive: you need to destroy
55 the tracing session with man:lttng-destroy(1) or perform a rotation with
56 man:lttng-rotate(1) to archive it.
59 include::common-cmd-options-head.txt[]
62 option:-n, option:--no-wait::
63 Do :not: ensure that the trace data of the selected tracing session
64 is valid before exiting.
67 include::common-cmd-help-options.txt[]
70 include::common-cmd-footer.txt[]
76 man:lttng-add-trigger(1),
78 man:lttng-enable-event(1),