File: README.md

package info (click to toggle)
libfiu 1.2-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 768 kB
  • sloc: ansic: 2,633; python: 973; makefile: 599; sh: 309
file content (44 lines) | stat: -rw-r--r-- 1,580 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

# libfiu - Fault injection in userspace

[libfiu](https://blitiri.com.ar/p/libfiu) is a C library for fault injection.

It provides functions to mark "points of failure" inside your code (the *core
API*), and functions to enable/disable the failure of those points (the
*control API*). It's in the public domain, see the LICENSE file for more
information.

The *core API* is used inside the code wanting to perform fault injection on.
The *control API* is used inside the testing code, in order to control the
injection of failures.

Python bindings are available in the `bindings/` directory.

[![Gitlab CI status](https://gitlab.com/albertito/libfiu/badges/master/pipeline.svg)](https://gitlab.com/albertito/libfiu/pipelines)


## Documentation

You can find the user guide in the `doc/` directory, and a manpage in the
`libfiu/` directory. The manpage will be installed along the library.

Python bindings have embedded documentation, although it's not as complete.


## Building and installing

Running `make` (or `gmake`) should be enough for building, and `make install`
for installing. By default it installs into `/usr/local/`, but you can provide
an alternative prefix by running `make PREFIX=/my/prefix install`.

To build the Python 3 bindings, use `make python3`, to install them you can run
`make python3_install`.


## Where to report bugs

If you want to report bugs, or have any questions or comments, just let me
know at `albertito@blitiri.com.ar`. For more information about the library, you
can go to the [libfiu home page](https://blitiri.com.ar/p/libfiu).