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)