Commit | Line | Data |
---|---|---|
79e094df PP |
1 | lttng-view(1) |
2 | ============= | |
484b2a0c | 3 | :revdate: 21 April 2021 |
79e094df PP |
4 | |
5 | ||
6 | NAME | |
7 | ---- | |
484b2a0c | 8 | lttng-view - Launch an LTTng trace reader |
79e094df PP |
9 | |
10 | ||
11 | SYNOPSIS | |
12 | -------- | |
13 | [verse] | |
484b2a0c PP |
14 | *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='READER'] |
15 | ['SESSION' | option:--trace-path='DIR'] | |
79e094df PP |
16 | |
17 | ||
18 | DESCRIPTION | |
19 | ----------- | |
484b2a0c PP |
20 | The `lttng view` command launches an external trace reader to read the |
21 | current traces of: | |
79e094df | 22 | |
484b2a0c PP |
23 | With the option:--session='SESSION' option:: |
24 | The tracing session named 'SESSION'. | |
79e094df | 25 | |
484b2a0c PP |
26 | With the option:--trace-path='DIR' option:: |
27 | The local file system directory 'DIR'. | |
79e094df | 28 | |
484b2a0c PP |
29 | Otherwise:: |
30 | The current tracing session (see man:lttng-create(1) and | |
31 | man:lttng-set-session(1) to learn more about the current tracing | |
32 | session). | |
33 | ||
34 | With the option:--session option or without the option:--trace-path | |
35 | option, the mode of the selected tracing session may :not: be network | |
36 | streaming or live. | |
37 | ||
38 | By default, the `view` command attempts to launch man:babeltrace2(1) or, | |
39 | if it's not available, man:babeltrace(1). Override which trace reader to | |
40 | launch with the option:--viewer option. | |
79e094df PP |
41 | |
42 | ||
43 | include::common-cmd-options-head.txt[] | |
44 | ||
45 | ||
484b2a0c PP |
46 | option:-t 'DIR', option:--trace-path='DIR':: |
47 | Pass 'DIR' as the last argument of the trace reader command instead | |
48 | of the output directory of the selected tracing session. | |
79e094df | 49 | |
484b2a0c PP |
50 | option:-e 'READER', option:--viewer='READER':: |
51 | Use the trace reader 'READER' to read the traces. | |
52 | + | |
53 | 'READER' is the absolute path to the reader command to use, and it can | |
54 | contain command arguments as well. The `view` command passes the trace | |
55 | directory path to read to the 'READER' command as its last argument. | |
56 | + | |
57 | Without this option, the `view` command uses man:babeltrace2(1) if it's | |
58 | available. Otherwise, it tries to use man:babeltrace(1). | |
79e094df PP |
59 | |
60 | ||
61 | include::common-cmd-help-options.txt[] | |
62 | ||
63 | ||
64 | include::common-cmd-footer.txt[] | |
65 | ||
66 | ||
67 | SEE ALSO | |
68 | -------- | |
484b2a0c | 69 | man:babeltrace2(1), |
7c1a4458 | 70 | man:lttng(1) |