fiu-ctrl

Langue: en

Version: 332196 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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.