lttng-destroy(1)
================
:revdate: 18 January 2018


NAME
----
lttng-destroy - Destroy an LTTng tracing session


SYNOPSIS
--------
[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *destroy* [option:--no-wait] [option:--all | 'SESSION']


DESCRIPTION
-----------
The `lttng destroy` command destroys one or more tracing sessions.

If no options are specified, the current tracing session is destroyed
(see man:lttng-create(1) for more information about the current
tracing session).

If 'SESSION' is specified, the existing tracing session named 'SESSION'
is destroyed. `lttng list` outputs all the existing tracing sessions
(see man:lttng-list(1)).

If the option:--all option is used, *all* the tracing sessions, as listed
in the output of `lttng list`, are destroyed.

Destroying a tracing session stops any tracing running within the
latter. By default, the implicit man:lttng-stop(1) command invoked by
the `lttng destroy` command ensures that the tracing session's trace
data is valid before returning. With the option:--no-wait option, the
man:lttng-stop(1) command finishes immediately, hence a local trace
might not be valid when the command is done. In this case, there is no
way to know when the trace becomes valid.

Destroying a tracing session does not destroy the recorded trace data,
if any; it frees resources acquired by the session daemon and tracer
side, making sure to flush all trace data.

If at least one rotation occurred during the chosen tracing session's
lifetime (see man:lttng-rotate(1) and man:lttng-enable-rotation(1)), and
without the option:--no-wait option, all the tracing session's output
directory's subdirectories are considered trace chunk archives once the
command returns: it is safe to read them, modify them, move them, or
remove them.


include::common-cmd-options-head.txt[]


option:-a, option:--all::
    Destroy all tracing sessions.

option:-n, option:--no-wait::
    Do not ensure that the chosen tracing session's trace data is valid
    before returning to the prompt.


include::common-cmd-help-options.txt[]


include::common-cmd-footer.txt[]


SEE ALSO
--------
man:lttng-create(1),
man:lttng-set-session(1),
man:lttng(1)
