doc/man/lttng-crash.1.txt

   1 lttng-crash(1)
   2 ==============
   3 :revdate: 5 June 2018
   4
   5
   6 NAME
   7 ----
   8 lttng-crash - Recover and view LTTng 2 trace buffers in the event of a crash
   9
  10
  11 SYNOPSIS
  12 --------
  13 [verse]
  14 *lttng-crash* [option:--extract='PATH' | option:--viewer='VIEWER'] [option:-v | option:-vv | option:-vvv]
  15
  16
  17 DESCRIPTION
  18 -----------
  19 The https://lttng.org/[_Linux Trace Toolkit: next generation_] is an open
  20 source software package used for correlated tracing of the Linux kernel,
  21 user applications, and user libraries.
  22
  23 LTTng consists of Linux kernel modules (for Linux kernel tracing) and
  24 dynamically loaded libraries (for user application and library tracing).
  25
  26 The _`lttng-crash`_ command-line tool is used to recover and view
  27 LTTng trace buffers in the event of a system crash.
  28
  29
  30 OPTIONS
  31 -------
  32 option:-x 'PATH', option:--extract='PATH'::
  33     Extract recovered traces to path 'PATH'; do not execute the trace
  34     viewer.
  35
  36 option:-v, option:--verbose::
  37     Increase verbosity.
  38 +
  39 Three levels of verbosity are available, which are triggered by
  40 appending additional `v` letters to the option
  41 (that is, `-vv` and `-vvv`).
  42
  43 option:-e 'VIEWER', option:--viewer='VIEWER'::
  44     Use trace viewer 'VIEWER' to view the trace buffers. 'VIEWER' is the
  45     absolute path to the viewer command to use, and it can contain
  46     command arguments as well. The trace directory paths are passed to
  47     the 'VIEWER' command as its last arguments.
  48 +
  49 Default: `babeltrace`.
  50
  51
  52 Program information
  53 ~~~~~~~~~~~~~~~~~~~
  54 option:-h, option:--help::
  55     Show help.
  56
  57 option:-V, option:--version::
  58     Show version.
  59
  60
  61 EXIT STATUS
  62 -----------
  63 *0*::
  64     Success
  65
  66 *1*::
  67     Error
  68
  69 *3*::
  70     Fatal error
  71
  72
  73 include::common-footer.txt[]
  74
  75
  76 SEE ALSO
  77 --------
  78 man:lttng(1),
  79 man:lttng-sessiond(8),
  80 man:lttng-relayd(8),
  81 man:lttng-ust(3),
  82 man:babeltrace(1)