NAME
fiu-ctrl - a script to remote control programs using libfiu
SYNOPSIS
fiu-ctrl [options] PID [PID ...]
DESCRIPTION
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.
OPTIONS
-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).
EXAMPLES
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
SEE ALSO
libfiu(3), fiu-run(1).
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 libfiu,
you can go to http://blitiri.com.ar/p/libfiu.
16/Jun/2009 fiu-ctrl(1)