fiu-ctrl - a script to remote control programs using libfiu
fiu-ctrl [options] PID [PID ...]
fiu-ctrl is a script to enable/disable failure points in running
programs that are using libfiu(3).
Programs are usually launched using fiu-run(1), which enables libfiu’s
remote control capabilities without the need to modify the program’s
For additional documentation, go to the project’s website at
Enable the given failure point name.
Use the given probability for the previous failure point. In
percent, defaults to 100, which means "always enabled". Must
come after the -e it affects.
Use the given number as the failnum for the previous failure
point. Must be != 0, defaults to 1. Must come after the -e it
Use the given number as the failinfo for the previous failure
point. Defaults to 0. Must come after the -e it affects.
-d Disable the given failure point name.
Set the default prefix for remote control over named pipes.
Defaults to "$TMPDIR/fiu-ctrl", or "/tmp/fiu-ctrl" if "$TMPDIR"
is not set, which is the usually correct for programs launched
The following command will tell the process running with PID 12345 to
enable the failure point posix/io/read with a 25% of probability to
fail, and the failure point libc/mm/malloc with a 5% of probability to
fiu-ctrl -e posix/io/read -p 25 -e libc/mm/malloc -p 5 12345
And the following will tell the same process to disable the previously
enabled failure point posix/io/read:
fiu-ctrl -d posix/io/read 12345
If you want to report bugs, or have any questions or comments, just let
me know at firstname.lastname@example.org. For more information about libfiu,
you can go to http://blitiri.com.ar/p/libfiu.