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
|
lttng-crash(1)
==============
:revdate: 14 June 2021
NAME
----
lttng-crash - Recover and read LTTng trace buffers in the event of a crash
SYNOPSIS
--------
[verse]
*lttng-crash* [option:--extract='DIR' | option:--viewer='READER'] [option:-verbose]... 'SHMDIR'
DESCRIPTION
-----------
include::common-intro.txt[]
The `lttng-crash` command-line tool recovers LTTng trace buffers in the
event of a system crash.
`lttng-crash` reads files within the directory 'SHMDIR' and does one
of:
Without the option:--extract option::
Launches a trace reader (see the option:--viewer option) to view the
recovered traces.
With the option:--extract='DIR' option::
Extracts the files as uncorrupted LTTng traces to the 'DIR'
directory.
'SHMDIR' is the directory specified as the argument of the
nloption:--shm-path option of the man:lttng-create(1) command used to
create the recording session for which to recover the traces.
OPTIONS
-------
option:-x 'DIR', option:--extract='DIR'::
Extract recovered traces to the directory 'DIR'; do :not: execute
any trace reader.
option:-v, option:--verbose::
Increase verbosity.
+
Specify this option up to three times to get more levels of verbosity.
option:-e 'READER', option:--viewer='READER'::
Use the trace reader 'READER' to read the trace buffers.
+
'READER' is the absolute path to the reader command to use, and it can
contain command arguments as well. `lttng-crash` passes the trace
directory paths to the 'READER' command as its last arguments.
+
Without this option, `lttng crash` uses man:babeltrace2(1) if it's
available. Otherwise, it tries to use man:babeltrace(1).
Program information
~~~~~~~~~~~~~~~~~~~
include::common-help-option.txt[]
option:-V, option:--version::
Show version and quit.
EXIT STATUS
-----------
*0*::
Success
*1*::
Error
*3*::
Fatal error
include::common-footer.txt[]
SEE ALSO
--------
man:babeltrace2(1),
man:lttng(1),
man:lttng-create(1)
|
