1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
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)
|
