SIGSEGV handler which prints the debug stack trace for C/C++ projects on Linux. It is configurable and rather robust.
Switch branches/tags
Nothing to show
Failed to load latest commit information.
Doxyfile Updated readme Mar 7, 2016 Removed unused include Mar 7, 2016
death_handler.h Enabled printing in a callback Mar 7, 2016 Fix line number tests Mar 7, 2016

DeathHandler class installs SEGFAULT, SIGABRT and SIGFPE signal handlers to print a nice stack trace and (if requested) generate a core dump. In DeathHandler's constructor, signal handlers are installed through sigaction(). If your program encounters a segmentation fault, the call stack is unwinded with backtrace(), converted into function names with line numbers via addr2line (fork() + execlp()). Addresses from shared libraries are also converted thanks to dladdr(). All C++ symbols are demangled. Printed stack trace includes the faulty thread id obtained with pthread_self() and each line contains the process id to distinguish several stack traces printed by different processes at the same time.

The code works primarily on Linux and tested on x86_64 and ARM with glibc. Besides, there is a partial support of MacOSX (addr2line -> atos is not implemented).

Since backtrace() uses malloc() and the heap my be corrupted by the time it is called, malloc() and free() have to be overridden. On Linux, it is done via a simple symbol overload; on MacOSX, malloc_default_zone() approach is taken because overloading does not work out of the box.


#include "death_handler.h"

int main() {
  Debug::DeathHandler dh;
  int* p = NULL;
  *p = 0;
  return 0;
g++ -g -ldl -o test

This project is released under the Simplified BSD License. Copyright 2012 Samsung R&D Institute Russia, 2016 Moscow Institute of Physics and Technology.