3 :revdate: 6 November 2019
7 lttng-clear - Clear a tracing session
13 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *clear* [option:--all | 'SESSION']
18 The `lttng clear` command clears one or more tracing sessions.
20 If no options are specified, the current tracing session is cleared
21 (see man:lttng-create(1) for more information about the current
24 If 'SESSION' is specified, the existing tracing session named 'SESSION'
27 If the option:--all option is used, *all* the tracing sessions, as listed
28 in the output of `lttng list`, are cleared.
30 Clearing a tracing session deletes the contents of the tracing buffers and
31 all local or streamed trace data.
33 If a session is configured in snapshot mode, only the tracing buffers are cleared.
35 If at least one rotation occurred, only the tracing buffers and the current
36 trace chunks are cleared. Previous trace chunks are not cleared.
38 Note that a lttng-relayd daemon can be configured to disallow clear operations
39 using LTTNG_RELAYD_DISALLOW_CLEAR. Clear commands performed on a streaming
40 session utilizing such lttng-relayd daemon will fail.
42 include::common-cmd-options-head.txt[]
45 option:-a, option:--all::
46 Clear all tracing sessions.
48 include::common-cmd-help-options.txt[]
51 include::common-cmd-footer.txt[]
57 man:lttng-set-session(1),