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

       -c command
              Run the given libfiu remote control command before executing the program (see below
              for reference).

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

       Remote  control  commands  are  of  the form "command param1=value1,param2=value2".  Valid
       commands are:

       'enable name=NAME'
              Enables the NAME failure point unconditionally.

       'enable_random name=NAME,probability=P'
              Enables the NAME failure point with a probability of P.

       'disable name=NAME'
              Disables the NAME failure point.

       All of the enable* commands can also optionally  take  failnum  and  failinfo  parameters,
       analogous to the ones taken by the C functions.

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 -c 'enable_random name=posix/io/*,probability=0.25' \
                       -c 'enable_random name=libc/mm/*,probability=0.05' 12345

       And  the  following  will  tell the same process to disable the previously enabled failure
       point posix/io/read:

              fiu-ctrl -c 'disable name=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)