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