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