X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-crash.1.txt;h=a8a2c9f4dfaaee1880c76617ea27f1a9f8bb3c37;hp=25483847d13b5886c4225540170f945ccda2af07;hb=6f7058c201395648796691f05e69ce285a185f08;hpb=4605890e0a926f1c88355051dcd6d8a8dd135c58 diff --git a/doc/man/lttng-crash.1.txt b/doc/man/lttng-crash.1.txt index 25483847d..a8a2c9f4d 100644 --- a/doc/man/lttng-crash.1.txt +++ b/doc/man/lttng-crash.1.txt @@ -1,6 +1,6 @@ lttng-crash(1) ============== -:revdate: 5 June 2018 +:revdate: 2 April 2020 NAME @@ -11,7 +11,7 @@ lttng-crash - Recover and view LTTng 2 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='PATH' | option:--viewer='VIEWER'] [option:-v | option:-vv | option:-vvv] 'SHMDIR' DESCRIPTION @@ -23,9 +23,23 @@ user applications, and user libraries. 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 ------- @@ -46,7 +60,8 @@ option:-e 'VIEWER', option:--viewer='VIEWER':: 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 @@ -79,4 +94,4 @@ man:lttng(1), man:lttng-sessiond(8), man:lttng-relayd(8), man:lttng-ust(3), -man:babeltrace(1) +man:babeltrace2(1)