README.md

DeathKnell

The Death functionality allows final callbacks when fatal signal errors or g3log fatal events are received.

Examples of fatal signal errors are:

• SIGSEGV
• SIGABRT
• SIGFPE
• SIGILL
• SIGTERM Ref: [g3log ksignals]

Examples of g3log fatal events are

• LOG(FATAL) --> FATAL logging event
• CHECK(<expression == false>) --> FATAL contract event

DeathKnell is an extension to the fatal handling provided by [g3log]. The extension makes is significantly easier to unit test fatal event handling.

The API is available in the [Death.h] header file. API usage is best read in the [unit tests].

Requirements

1. g3log
2. g3sinks
3. FileIO

Build and Install

Example of installation

cd DeathKnell
cd 3rdparty
unzip gtest-1.7.0.zip
cd ..
mkdir build
cd build
cmake ..
make -j

Executing the unit tests

./UnitTestRunneer

Installing

sudo make install

Alternative on Debian systems

make package
sudo dpkg -i DeathKnell-<package_version>Linux.deb