lttng-crash(1)

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

NAME

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

SYNOPSIS

10       lttng-crash [--extract=PATH | --viewer=VIEWER] [-v | -vv | -vvv]
11

DESCRIPTION

13       The Linux Trace Toolkit: next generation <http://lttng.org/> is an open
14       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 is used to recover and view LTTng
22       trace buffers in the event of a system crash.
23

OPTIONS

25       -x PATH, --extract=PATH
26           Extract recovered traces to path PATH; do not execute the trace
27           viewer.
28
29       -v, --verbose
30           Increase verbosity.
31
32           Three levels of verbosity are available, which are triggered by
33           appending additional v letters to the option (that is, -vv and
34           -vvv).
35
36       -e VIEWER, --viewer=VIEWER
37           Use trace viewer VIEWER to view the trace buffers.  VIEWER is the
38           absolute path to the viewer command to use, and it can contain
39           command arguments as well. The trace directory paths are passed to
40           the VIEWER command as its last arguments.
41
42           Default: babeltrace.
43
44   Program information
45       -h, --help
46           Show help.
47
48       -V, --version
49           Show version.
50

EXIT STATUS

52       0
53           Success
54
55       1
56           Error
57
58       3
59           Fatal error
60

BUGS

62       If you encounter any issue or usability problem, please report it on
63       the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-tools>.
64

RESOURCES

66       ·   LTTng project website <http://lttng.org>
67
68       ·   LTTng documentation <http://lttng.org/docs>
69
70       ·   Git repositories <http://git.lttng.org>
71
72       ·   GitHub organization <http://github.com/lttng>
73
74       ·   Continuous integration <http://ci.lttng.org/>
75
76       ·   Mailing list <http://lists.lttng.org> for support and development:
77           lttng-dev@lists.lttng.org
78
79       ·   IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
80

COPYRIGHTS

82       This program is part of the LTTng-tools project.
83
84       LTTng-tools is distributed under the GNU General Public License version
85       2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>. See the
86       LICENSE <https://github.com/lttng/lttng-tools/blob/master/LICENSE> file
87       for details.
88

THANKS

90       Special thanks to Michel Dagenais and the DORSAL laboratory
91       <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for
92       the LTTng journey.
93
94       Also thanks to the Ericsson teams working on tracing which helped us
95       greatly with detailed bug reports and unusual test cases.
96

AUTHORS

98       LTTng-tools was originally written by Mathieu Desnoyers, Julien
99       Desfossez, and David Goulet. More people have since contributed to it.
100
101       LTTng-tools is currently maintained by Jérémie Galarneau
102       <mailto:jeremie.galarneau@efficios.com>.
103