Linux Certif

Toute la documentation sur la certification Linux LPI

fiu-ctrl

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.