man7.org > Linux > man-pages

Linux/UNIX system programming training

lttng-crash(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | BUGS | RESOURCES | COPYRIGHTS | THANKS | AUTHORS | SEE ALSO | COLOPHON 

LTTNG-CRASH(1)                 LTTng Manual                LTTNG-CRASH(1)

NAME         top

       lttng-crash - Recover and view LTTng 2 trace buffers in the event
       of a crash

SYNOPSIS         top

       lttng-crash [--extract=PATH | --viewer=VIEWER] [-v | -vv | -vvv]

DESCRIPTION         top

       The Linux Trace Toolkit: next generation <https://lttng.org/> is
       an open source software package used for correlated tracing of the
       Linux kernel, 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
       LTTng trace buffers in the event of a system crash.

OPTIONS         top

       -x PATH, --extract=PATH
           Extract recovered traces to path PATH; do not execute the
           trace viewer.

       -v, --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).

       -e VIEWER, --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.

           Default: babeltrace.

   Program information
       -h, --help
           Show help.

       -V, --version
           Show version.

EXIT STATUS         top

       0
           Success

       1
           Error

       3
           Fatal error

BUGS         top

       If you encounter any issue or usability problem, please report it
       on the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-
       tools>.

RESOURCES         top

       •   LTTng project website <https://lttng.org>

       •   LTTng documentation <https://lttng.org/docs>

       •   Git repositories <http://git.lttng.org>

       •   GitHub organization <http://github.com/lttng>

       •   Continuous integration <http://ci.lttng.org/>

       •   Mailing list <http://lists.lttng.org> for support and
           development: lttng-dev@lists.lttng.org

       •   IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net

COPYRIGHTS         top

       This program is part of the LTTng-tools project.

       LTTng-tools is distributed under the GNU General Public License
       version 2 <http://www.gnu.org/licenses/old-
       licenses/gpl-2.0.en.html>. See the LICENSE
       <https://github.com/lttng/lttng-tools/blob/master/LICENSE> file
       for details.

THANKS         top

       Special thanks to Michel Dagenais and the DORSAL laboratory
       <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal
       for the LTTng journey.

       Also thanks to the Ericsson teams working on tracing which helped
       us greatly with detailed bug reports and unusual test cases.

AUTHORS         top

       LTTng-tools was originally written by Mathieu Desnoyers, Julien
       Desfossez, and David Goulet. More people have since contributed to
       it.

       LTTng-tools is currently maintained by Jérémie Galarneau
       <mailto:jeremie.galarneau@efficios.com>.

SEE ALSO         top

       lttng(1), lttng-sessiond(8), lttng-relayd(8), lttng-ust(3),
       babeltrace(1)

COLOPHON         top

       This page is part of the LTTng-Tools (    LTTng tools) project.
       Information about the project can be found at ⟨http://lttng.org/⟩.
       It is not known how to report bugs for this man page; if you know,
       please send a mail to man-pages@man7.org.  This page was obtained
       from the project's upstream Git repository
       ⟨git://git.lttng.org/lttng-tools.git⟩ on 2019-11-19.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2019-11-14.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

LTTng 2.12.0-pre                10/29/2018                 LTTNG-CRASH(1)

Pages that refer to this page: lttng(1),  lttng-create(1),  babeltrace2-source.ctf.fs(7),  lttng-relayd(8),  lttng-sessiond(8)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI