3 :revdate: 29 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:concepts(1) to learn more about
31 the current tracing session).
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
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.
42 include::common-cmd-options-head.txt[]
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.
49 option:-e 'READER', option:--viewer='READER'::
50 Use the trace reader 'READER' to read the traces.
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.
56 Without this option, the `view` command uses man:babeltrace2(1) if it's
57 available. Otherwise, it tries to use man:babeltrace(1).
60 include::common-cmd-help-options.txt[]
63 include::common-cmd-footer.txt[]