3 :revdate: 21 April 2021
8 lttng-view - Launch an LTTng trace reader
14 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='READER']
15 ['SESSION' | option:--trace-path='DIR']
20 The `lttng view` command launches an external trace reader to read the
23 With the option:--session='SESSION' option::
24 The tracing session named 'SESSION'.
26 With the option:--trace-path='DIR' option::
27 The local file system directory 'DIR'.
30 The current tracing session (see man:lttng-create(1) and
31 man:lttng-set-session(1) to learn more about the current tracing
34 With the option:--session option or without the option:--trace-path
35 option, the mode of the selected tracing session may :not: be network
38 By default, the `view` command attempts to launch man:babeltrace2(1) or,
39 if it's not available, man:babeltrace(1). Override which trace reader to
40 launch with the option:--viewer option.
43 include::common-cmd-options-head.txt[]
46 option:-t 'DIR', option:--trace-path='DIR'::
47 Pass 'DIR' as the last argument of the trace reader command instead
48 of the output directory of the selected tracing session.
50 option:-e 'READER', option:--viewer='READER'::
51 Use the trace reader 'READER' to read the traces.
53 'READER' is the absolute path to the reader command to use, and it can
54 contain command arguments as well. The `view` command passes the trace
55 directory path to read to the 'READER' command as its last argument.
57 Without this option, the `view` command uses man:babeltrace2(1) if it's
58 available. Otherwise, it tries to use man:babeltrace(1).
61 include::common-cmd-help-options.txt[]
64 include::common-cmd-footer.txt[]