Check for pending notification on notification channel activity
[lttng-tools.git] / doc / man / lttng-destroy.1.txt
CommitLineData
7bf169bd
PP
1lttng-destroy(1)
2===============
3
4
5NAME
6----
7lttng-destroy - Destroy an LTTng tracing session
8
9
10SYNOPSIS
11--------
12[verse]
d0d2c3e4 13*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *destroy* [option:--no-wait] [option:--all | 'SESSION']
7bf169bd
PP
14
15
16DESCRIPTION
17-----------
18The `lttng destroy` command destroys one or more tracing sessions.
19
20If no options are specified, the current tracing session is destroyed
7c1a4458 21(see man:lttng-create(1) for more information about the current
7bf169bd
PP
22tracing session).
23
24If 'SESSION' is specified, the existing tracing session named 'SESSION'
25is destroyed. `lttng list` outputs all the existing tracing sessions
7c1a4458 26(see man:lttng-list(1)).
7bf169bd
PP
27
28If the option:--all option is used, *all* the tracing sessions, as listed
29in the output of `lttng list`, are destroyed.
30
d0d2c3e4
PP
31Destroying a tracing session stops any tracing running within the
32latter. By default, the implicit man:lttng-stop(1) command invoked by
33the `lttng destroy` command ensures that the tracing session's trace
34data is valid before returning. With the option:--no-wait option, the
35man:lttng-stop(1) command finishes immediately, hence a local trace
36might not be valid when the command is done. In this case, there is no
37way to know when the trace becomes valid.
7bf169bd
PP
38
39Destroying a tracing session does not destroy the recorded trace data,
40if any; it frees resources acquired by the session daemon and tracer
41side, making sure to flush all trace data.
42
43
44include::common-cmd-options-head.txt[]
45
46
47option:-a, option:--all::
48 Destroy all tracing sessions.
49
d0d2c3e4
PP
50option:-n, option:--no-wait::
51 Do not ensure that the chosen tracing session's trace data is valid
52 before returning to the prompt.
53
7bf169bd
PP
54
55include::common-cmd-help-options.txt[]
56
57
58include::common-cmd-footer.txt[]
59
60
61SEE ALSO
62--------
7c1a4458
PP
63man:lttng-create(1),
64man:lttng-set-session(1),
65man:lttng(1)
This page took 0.031413 seconds and 5 git commands to generate.