event-rule: introduce event rule syscall

[lttng-tools.git] / doc / man / lttng-view.1.txt

lttng-view(1)
=============
:revdate: 28 November 2016


NAME
----
lttng-view - View the traces of an LTTng tracing session


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


DESCRIPTION
-----------
The `lttng view` command launches an external trace viewer to view the
current trace of a tracing session.

If 'SESSION' is omitted, the viewer is launched for the current tracing
session (see man:lttng-create(1) for more information
about the current tracing session). Otherwise, it is launched for the
existing tracing session named 'SESSION'. `lttng list`
outputs all the existing tracing sessions (see man:lttng-list(1)).

By default, the man:babeltrace2(1) trace viewer is launched. If it is
not found on the system, the man:babeltrace(1) trace viewer is
used.
Another trace viewer command can be specified using the
option:--viewer option.

By default, the trace path of the chosen tracing session is given
as the first positional argument to the trace viewer. This path can
be overridden using the option:--trace-path option.


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


option:-t 'PATH', option:--trace-path='PATH'::
    View trace at path 'PATH' instead of using the chosen tracing
    session's trace path.

option:-e 'CMD', option:--viewer='CMD'::
    Use 'CMD' as the trace viewer.


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


include::common-cmd-footer.txt[]


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