lttng-crash(1)
==============
-:revdate: 5 June 2018
+:revdate: 2 April 2020
NAME
SYNOPSIS
--------
[verse]
-*lttng-crash* [option:--extract='PATH' | option:--viewer='VIEWER'] [option:-v | option:-vv | option:-vvv]
+*lttng-crash* [option:--extract='PATH' | option:--viewer='VIEWER'] [option:-v | option:-vv | option:-vvv] 'SHMDIR'
DESCRIPTION
LTTng consists of Linux kernel modules (for Linux kernel tracing) and
dynamically loaded libraries (for user application and library tracing).
-The _`lttng-crash`_ command-line tool is used to recover and view
+The `lttng-crash` command-line tool is used to recover and view
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 option::
+ Extracts them as uncorrupted LTTng traces on the file system.
+
+'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 tracing session for which to recover the traces.
+
OPTIONS
-------
command arguments as well. The trace directory paths are passed to
the 'VIEWER' command as its last arguments.
+
-Default: `babeltrace`.
+Without this option, `lttng crash` uses man:babeltrace2(1) if it's
+available. Otherwise, it tries to use man:babeltrace(1).
Program information
man:lttng-sessiond(8),
man:lttng-relayd(8),
man:lttng-ust(3),
-man:babeltrace(1)
+man:babeltrace2(1)