DeathHandler

by vmarkovtsev

vmarkovtsev / DeathHandler

SIGSEGV handler which prints the debug stack trace for C/C++ projects on Linux. It is configurable a...

134 Stars 28 Forks Last release: Not found 32 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

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.

Example

test.cc: ~~~~{.cc}

include "death_handler.h"

int main() { Debug::DeathHandler dh; int* p = NULL; *p = 0; return 0; } ~~~~

g++ -g death_handler.cc test.cc -ldl -o test
./test

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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.