lttng-view: make babeltrace2 the default viewer
[lttng-tools.git] / doc / man / lttng-view.1.txt
CommitLineData
79e094df
PP
1lttng-view(1)
2=============
4605890e 3:revdate: 28 November 2016
79e094df
PP
4
5
6NAME
7----
8lttng-view - View the traces of an LTTng tracing session
9
10
11SYNOPSIS
12--------
13[verse]
ce19b9ed 14*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='CMD'] [option:--trace-path='PATH' | 'SESSION']
79e094df
PP
15
16
17DESCRIPTION
18-----------
19The `lttng view` command launches an external trace viewer to view the
20current trace of a tracing session.
21
22If 'SESSION' is omitted, the viewer is launched for the current tracing
7c1a4458 23session (see man:lttng-create(1) for more information
79e094df
PP
24about the current tracing session). Otherwise, it is launched for the
25existing tracing session named 'SESSION'. `lttng list`
7c1a4458 26outputs all the existing tracing sessions (see man:lttng-list(1)).
79e094df 27
3cd887b3
JG
28By default, the man:babeltrace2(1) trace viewer is launched. If it is
29not found on the system, the man:babeltrace(1) trace viewer is
30used.
79e094df
PP
31Another trace viewer command can be specified using the
32option:--viewer option.
33
34By default, the trace path of the chosen tracing session is given
35as the first positional argument to the trace viewer. This path can
36be overridden using the option:--trace-path option.
37
38
39include::common-cmd-options-head.txt[]
40
41
59b19c3c 42option:-t 'PATH', option:--trace-path='PATH'::
79e094df
PP
43 View trace at path 'PATH' instead of using the chosen tracing
44 session's trace path.
45
59b19c3c 46option:-e 'CMD', option:--viewer='CMD'::
79e094df
PP
47 Use 'CMD' as the trace viewer.
48
49
50include::common-cmd-help-options.txt[]
51
52
53include::common-cmd-footer.txt[]
54
55
56SEE ALSO
57--------
7c1a4458 58man:lttng(1)
This page took 0.042067 seconds and 4 git commands to generate.