doc/man/lttng-view.1.txt

   1 lttng-view(1)
   2 =============
   3 :revdate: 29 April 2021
   4
   5
   6 NAME
   7 ----
   8 lttng-view - Launch an LTTng trace reader
   9
  10
  11 SYNOPSIS
  12 --------
  13 [verse]
  14 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='READER']
  15       ['SESSION' | option:--trace-path='DIR']
  16
  17
  18 DESCRIPTION
  19 -----------
  20 The `lttng view` command launches an external trace reader to read the
  21 current traces of:
  22
  23 With the option:--session='SESSION' option::
  24     The tracing session named 'SESSION'.
  25
  26 With the option:--trace-path='DIR' option::
  27     The local file system directory 'DIR'.
  28
  29 Otherwise::
  30     The current tracing session (see man:concepts(1) to learn more about
  31     the current tracing session).
  32
  33 With the option:--session option or without the option:--trace-path
  34 option, the mode of the selected tracing session may :not: be network
  35 streaming or live.
  36
  37 By default, the `view` command attempts to launch man:babeltrace2(1) or,
  38 if it's not available, man:babeltrace(1). Override which trace reader to
  39 launch with the option:--viewer option.
  40
  41
  42 include::common-lttng-cmd-options-head.txt[]
  43
  44
  45 option:-t 'DIR', option:--trace-path='DIR'::
  46     Pass 'DIR' as the last argument of the trace reader command instead
  47     of the output directory of the selected tracing session.
  48
  49 option:-e 'READER', option:--viewer='READER'::
  50     Use the trace reader 'READER' to read the traces.
  51 +
  52 'READER' is the absolute path to the reader command to use, and it can
  53 contain command arguments as well. The `view` command passes the trace
  54 directory path to read to the 'READER' command as its last argument.
  55 +
  56 Without this option, the `view` command uses man:babeltrace2(1) if it's
  57 available. Otherwise, it tries to use man:babeltrace(1).
  58
  59
  60 include::common-lttng-cmd-help-options.txt[]
  61
  62
  63 include::common-lttng-cmd-after-options.txt[]
  64
  65
  66 include::common-footer.txt[]
  67
  68
  69 SEE ALSO
  70 --------
  71 man:babeltrace2(1),
  72 man:lttng(1)