X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-crash.1.txt;h=dd8c6c701761305fc0095f04ec11e2fa06854f07;hb=26f0c7794376456fcb5b13d4eae91c0ccf0dfe66;hp=f67a881353a7cf80e278214d7579d33a7274c1d4;hpb=32357a9aba8ff33b71b46ec05b285171b97b9e55;p=lttng-tools.git

diff --git a/doc/man/lttng-crash.1.txt b/doc/man/lttng-crash.1.txt
index f67a88135..dd8c6c701 100644
--- a/doc/man/lttng-crash.1.txt
+++ b/doc/man/lttng-crash.1.txt
@@ -1,50 +1,59 @@
 lttng-crash(1)
 ==============
-:revdate: 2 April 2020
+:revdate: 3 May 2021
 
 
 NAME
 ----
-lttng-crash - Recover and view LTTng 2 trace buffers in the event of a crash
+lttng-crash - Recover and read LTTng trace buffers in the event of a crash
 
 
 SYNOPSIS
 --------
 [verse]
-*lttng-crash* [option:--extract='PATH' | option:--viewer='VIEWER'] [option:-v | option:-vv | option:-vvv]
+*lttng-crash* [option:--extract='DIR' | option:--viewer='READER'] [option:-verbose]... 'SHMDIR'
 
 
 DESCRIPTION
 -----------
-The https://lttng.org/[_Linux Trace Toolkit: next generation_] is an open
-source software package used for correlated tracing of the Linux kernel,
-user applications, and user libraries.
+include::common-intro.txt[]
 
-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 recovers LTTng trace buffers in the
+event of a system crash.
 
-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='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 tracing session for which to recover the traces.
 
 
 OPTIONS
 -------
-option:-x 'PATH', option:--extract='PATH'::
-    Extract recovered traces to path 'PATH'; do not execute the trace
-    viewer.
+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.
 +
-Three levels of verbosity are available, which are triggered by
-appending additional `v` letters to the option
-(that is, `-vv` and `-vvv`).
-
-option:-e 'VIEWER', option:--viewer='VIEWER'::
-    Use trace viewer 'VIEWER' to view the trace buffers. 'VIEWER' is the
-    absolute path to the viewer command to use, and it can contain
-    command arguments as well. The trace directory paths are passed to
-    the 'VIEWER' command as its last arguments.
+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).
@@ -52,11 +61,10 @@ available. Otherwise, it tries to use man:babeltrace(1).
 
 Program information
 ~~~~~~~~~~~~~~~~~~~
-option:-h, option:--help::
-    Show help.
+include::common-help-option.txt[]
 
 option:-V, option:--version::
-    Show version.
+    Show version and quit.
 
 
 EXIT STATUS
@@ -76,8 +84,6 @@ include::common-footer.txt[]
 
 SEE ALSO
 --------
+man:babeltrace2(1),
 man:lttng(1),
-man:lttng-sessiond(8),
-man:lttng-relayd(8),
-man:lttng-ust(3),
-man:babeltrace2(1)
+man:lttng-create(1)