doc/man/lttng-clear.1.txt

   1 lttng-clear(1)
   2 ===============
   3
   4
   5 NAME
   6 ----
   7 lttng-clear - Clear an LTTng tracing session
   8
   9
  10 SYNOPSIS
  11 --------
  12 [verse]
  13 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *clear* [option:--all | 'SESSION']
  14
  15
  16 DESCRIPTION
  17 -----------
  18 The `lttng clear` command clears one or more tracing sessions.
  19
  20 If no options are specified, the current tracing session is cleared
  21 (see man:lttng-create(1) for more information about the current
  22 tracing session).
  23
  24 If 'SESSION' is specified, the existing tracing session named 'SESSION'
  25 is cleared.
  26
  27 If the option:--all option is used, *all* the tracing sessions, as listed
  28 in the output of `lttng list`, are cleared.
  29
  30 Clearing a tracing session removes all tracing data from the tracing buffers and
  31 remove all local or streamed trace data.
  32
  33 If a session is configured in snapshot mode only the tracing buffers are cleared.
  34
  35 If at least one rotation occurred, only the tracing buffers and the current
  36 trace chunk is cleared. Previous trace chunks are not cleared.
  37
  38 include::common-cmd-options-head.txt[]
  39
  40
  41 option:-a, option:--all::
  42     Clear all tracing sessions.
  43
  44 include::common-cmd-help-options.txt[]
  45
  46
  47 include::common-cmd-footer.txt[]
  48
  49
  50 SEE ALSO
  51 --------
  52 man:lttng-rotate(1),
  53 man:lttng-set-session(1),
  54 man:lttng(1)