Manipulating Tarantool core dumps
$ tt coredump COMMAND [COMMAND_OPTION ...]
tt coredump
provides commands for manipulating Tarantool core dumps.
To be able to investigate Tarantool crashes, make sure that core dumps are enabled on the host. Here is the instruction on enabling core dumps on Unix systems.
COMMAND
is one of the following:
Important
tt coredump
is not supported on macOS.
$ tt coredump pack COREDUMP_FILE
Pack a Tarantool core dump and supporting data into a tar.gz
archive.
It includes:
- the Tarantool executable
- Tarantool version information
- OS information
- shared libraries
- the GNU debugger with extensions.
Pack a tar.gz
file with a Tarantool core dump and supporting data:
$ tt coredump pack name.core
$ tt coredump unpack ARCHIVE
Unpack a Tarantool core dump archive created with tt coredump pack
into a new directory:
$ tt coredump unpack tarantool-core-dump.tar.gz
$ tt coredump inspect [ARCHIVE|DIRECTORY] [-s]
Inspect a Tarantool core dump with the GNU debugger (gdb
).
The command argument can be either an archive file produced with tt coredump pack
or directory where such an archive is extracted.
Inspect the core dump archive with gdb
:
$ tt coredump inspect tarantool-core-dump.tar.gz
Inspect the unpacked core dump directory with gdb
:
$ tt coredump inspect tarantool-core-dump
-
-s
¶
Applicable to:
inspect
Specify the location of Tarantool sources.