7 lttng-stop - Stop LTTng tracers
13 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *stop* [option:--no-wait] ['SESSION']
18 The `lttng stop` command stops the various LTTng tracers for a given
19 active tracing session.
21 Stopping the LTTng tracers has the effect that all enabled event rules
22 within enabled channels cannot make event sources _emit_ trace events
25 A tracing session with no running tracers is said to be _inactive_.
26 Inactive tracing sessions can be set active using the
27 man:lttng-start(1) command.
29 If 'SESSION' is omitted, the LTTng tracers are stopped for the current
30 tracing session (see man:lttng-create(1) for more information
31 about the current tracing session). Otherwise, they are stopped for the
32 existing tracing session named 'SESSION'. `lttng list`
33 outputs all the existing tracing sessions (see man:lttng-list(1)).
35 By default, the `lttng stop` command ensures that the tracing session's
36 trace data is valid before returning to the prompt. With the
37 option:--no-wait option, the command finishes immediately, hence a local
38 trace might not be valid when the command is done. In this case, there
39 is no way to know when the trace becomes valid.
42 include::common-cmd-options-head.txt[]
45 option:-n, option:--no-wait::
46 Do not ensure that the chosen tracing session's trace data is valid
47 before returning to the prompt.
50 include::common-cmd-help-options.txt[]
53 include::common-cmd-footer.txt[]