libfaults

libfaults is library that can generate a fault injection for system calls.

See Getting Started on how to get started with libfaults.

See Configuration on how to configure libfaults.

Alternative, take a look at libfiu.

Tested platforms

• Fedora 28+
• RHEL 7.x/8.x

Compiling the source

libfaults requires

• gcc
• cmake
• make

dnf install gcc cmake make

Alternative clang can be used.

Release build

The following commands will install libfaults in the /usr/local hierarchy and run the default configuration.

git clone https://github.com/jesperpedersen/libfaults.git
cd libfaults
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..
make
sudo make install
LD_PRELOAD=/usr/local/lib/libfaults.so <your_application>

Debug build

The following commands will create a DEBUG version of libfaults.

git clone https://github.com/jesperpedersen/libfaults.git
cd libfaults
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
make
cd src
LD_PRELOAD=libfaults.so <your_application>

Remember to set the log_level configuration option to debug5.

Contributing

Contributions to libfaults are managed on GitHub.com

• Ask a question
• Raise an issue
• Feature request
• Code submission

Contributions are most welcome !

License

BSD-3-Clause