3 :revdate: 18 January 2018
8 lttng-destroy - Destroy an LTTng tracing session
14 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *destroy* [option:--no-wait] [option:--all | 'SESSION']
19 The `lttng destroy` command destroys one or more tracing sessions.
21 If no options are specified, the current tracing session is destroyed
22 (see man:lttng-create(1) for more information about the current
25 If 'SESSION' is specified, the existing tracing session named 'SESSION'
26 is destroyed. `lttng list` outputs all the existing tracing sessions
27 (see man:lttng-list(1)).
29 If the option:--all option is used, *all* the tracing sessions, as listed
30 in the output of `lttng list`, are destroyed.
32 Destroying a tracing session stops any tracing running within the
33 latter. By default, the implicit man:lttng-stop(1) command invoked by
34 the `lttng destroy` command ensures that the tracing session's trace
35 data is valid before returning. With the option:--no-wait option, the
36 man:lttng-stop(1) command finishes immediately, hence a local trace
37 might not be valid when the command is done. In this case, there is no
38 way to know when the trace becomes valid.
40 Destroying a tracing session does not destroy the recorded trace data,
41 if any; it frees resources acquired by the session daemon and tracer
42 side, making sure to flush all trace data.
45 include::common-cmd-options-head.txt[]
48 option:-a, option:--all::
49 Destroy all tracing sessions.
51 option:-n, option:--no-wait::
52 Do not ensure that the chosen tracing session's trace data is valid
53 before returning to the prompt.
56 include::common-cmd-help-options.txt[]
59 include::common-cmd-footer.txt[]
65 man:lttng-set-session(1),