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