lttng-view(1)
=============
:revdate: 14 June 2021


NAME
----
lttng-view - Launch an LTTng trace reader


SYNOPSIS
--------
[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='READER']
      ['SESSION' | option:--trace-path='DIR']


DESCRIPTION
-----------
The `lttng view` command launches an external trace reader to read the
current traces of:

With the option:--session='SESSION' option::
    The recording session named 'SESSION'.

With the option:--trace-path='DIR' option::
    The local file system directory 'DIR'.

Otherwise::
    The current recording session (see man:concepts(1) to learn more
    about the current recording session).

With the option:--session option or without the option:--trace-path
option, the mode of the selected recording session may :not: be network
streaming or live.

By default, the `view` command attempts to launch man:babeltrace2(1) or,
if it's not available, man:babeltrace(1). Override which trace reader to
launch with the option:--viewer option.

See the ``<<examples,EXAMPLES>>'' section below for usage examples.


include::common-lttng-cmd-options-head.txt[]


option:-t 'DIR', option:--trace-path='DIR'::
    Pass 'DIR' as the last argument of the trace reader command instead
    of the output directory of the selected recording session.

option:-e 'READER', option:--viewer='READER'::
    Use the trace reader 'READER' to read the traces.
+
'READER' is the absolute path to the reader command to use, and it can
contain command arguments as well. The `view` command passes the trace
directory path to read to the 'READER' command as its last argument.
+
Without this option, the `view` command uses man:babeltrace2(1) if it's
available. Otherwise, it tries to use man:babeltrace(1).


include::common-lttng-cmd-help-options.txt[]


include::common-lttng-cmd-after-options.txt[]


[[examples]]
EXAMPLES
--------
.Read the traces of the current recording session with Babeltrace.
====
[role="term"]
----
$ lttng view
----
====

.Read the traces of a specific recording session with a custom trace reader.
====
See the option:--viewer option.

[role="term"]
----
$ lttng view --viewer='/usr/bin/my-reader -zK --details=3' \
             my-session
----
====


include::common-footer.txt[]


SEE ALSO
--------
man:babeltrace2(1),
man:lttng(1)
