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)
