fiu-ctrl(1)

NAME

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 code.

For additional documentation, go to the project's website at http://blitiri.com.ar/p/libfiu.

-e fpname: Enable the given failure point name.
-p prob: 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.
-u failnum: Use the given number as the failnum for the previous failure point. Must be != 0, defaults to 1. Must come after the -e it affects.
-i failinfo: 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.
-f ctrlpath: 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 using fiu-run(1).

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 fail:: 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 albertito@blitiri.com.ar. For more information about libfiu, you can go to http://blitiri.com.ar/p/libfiu.