Manipulating Tarantool core dumps | Tarantool
Reference Tooling tt CLI utility Commands Manipulating Tarantool core dumps

Manipulating Tarantool core dumps

tt coredump COMMAND [ARGUMENT]

tt coredump provides commands for manipulating Tarantool core dumps.


tt coredump does not support macOS.

pack Pack a Tarantool core dump and supporting data into a tar.gz archive
unpack Unpack a Tarantool core dump archive
inspect Inspect a Tarantool core dump directory with the GNU debugger (gdb)

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.

tt coredump pack packs the given core dump together with files and data that can help the crash investigation. This includes:

  • Tarantool executable
  • Tarantool version information
  • OS information
  • Shared libraries

tt coredump inspect requires gdb installed on the host. The directory being inspected must have the same structure as the core dump archive created by tt coredump pack.

  • Pack a tar.gz file with a Tarantool core dump and supporting data:

    tt coredump pack name.core
  • Unpack a tar.gz archive packed by tt coredump pack:

    tt coredump unpack tarantool-core-dump.tar.gz
  • Inspect the unpacked core dump with gdb:

    tt coredump inspect tarantool-core-dump
Found what you were looking for?