lttng-crash(1)

1LTTNG-CRASH(1)                   LTTng Manual                   LTTNG-CRASH(1)
2
3
4

NAME

6       lttng-crash - Recover and read LTTng trace buffers in the event of a
7       crash
8

SYNOPSIS

10       lttng-crash [--extract=DIR | --viewer=READER] [-verbose]... SHMDIR
11

DESCRIPTION

13       The Linux Trace Toolkit: next generation <https://lttng.org/> is an
14       open-source software package used for correlated tracing of the Linux
15       kernel, user applications, and user libraries.
16
17       LTTng consists of Linux kernel modules (for Linux kernel tracing) and
18       dynamically loaded libraries (for user application and library
19       tracing).
20
21       The lttng-crash command-line tool recovers LTTng trace buffers in the
22       event of a system crash.
23
24       lttng-crash reads files within the directory SHMDIR and does one of:
25
26       Without the --extract option
27           Launches a trace reader (see the --viewer option) to view the
28           recovered traces.
29
30       With the --extract=DIR option
31           Extracts the files as uncorrupted LTTng traces to the DIR
32           directory.
33
34       SHMDIR is the directory specified as the argument of the --shm-path
35       option of the lttng-create(1) command used to create the recording
36       session for which to recover the traces.
37

OPTIONS

39       -x DIR, --extract=DIR
40           Extract recovered traces to the directory DIR; do NOT execute any
41           trace reader.
42
43       -v, --verbose
44           Increase verbosity.
45
46           Specify this option up to three times to get more levels of
47           verbosity.
48
49       -e READER, --viewer=READER
50           Use the trace reader READER to read the trace buffers.
51
52           READER is the absolute path to the reader command to use, and it
53           can contain command arguments as well.  lttng-crash passes the
54           trace directory paths to the READER command as its last arguments.
55
56           Without this option, lttng crash uses babeltrace2(1) if it’s
57           available. Otherwise, it tries to use babeltrace(1).
58
59   Program information
60       -h, --help
61           Show help.
62
63           This option attempts to launch /usr/bin/man to view this manual
64           page. Override the manual pager path with the LTTNG_MAN_BIN_PATH
65           environment variable.
66
67       --list-options
68           List available command options and quit.
69
70       -V, --version
71           Show version and quit.
72

EXIT STATUS

74       0
75           Success
76
77       1
78           Error
79
80       3
81           Fatal error
82

RESOURCES

84       •   LTTng project website <https://lttng.org>
85
86       •   LTTng documentation <https://lttng.org/docs>
87
88       •   LTTng bug tracker <https://bugs.lttng.org>
89
90       •   Git repositories <https://git.lttng.org>
91
92       •   GitHub organization <https://github.com/lttng>
93
94       •   Continuous integration <https://ci.lttng.org/>
95
96       •   Mailing list <https://lists.lttng.org/> for support and
97           development: lttng-dev@lists.lttng.org
98
99       •   IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
100

COPYRIGHT

102       This program is part of the LTTng-tools project.
103
104       LTTng-tools is distributed under the GNU General Public License
105       version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>.
106       See the LICENSE <https://github.com/lttng/lttng-
107       tools/blob/master/LICENSE> file for details.
108

THANKS

110       Special thanks to Michel Dagenais and the DORSAL laboratory
111       <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for
112       the LTTng journey.
113
114       Also thanks to the Ericsson teams working on tracing which helped us
115       greatly with detailed bug reports and unusual test cases.
116