bionic (1) fiu-run.1.gz

NAME

       fiu-run - a script to launch programs using libfiu

SYNOPSIS

       fiu-run [options] program [program arguments]

DESCRIPTION

       fiu-run  is  a  script to make it easier to launch programs using libfiu(3). It can enable failure points
       and start libfiu's remote control capabilities before starting to execute the program, avoiding the  need
       to write a special launcher to inject failures.

       It  is  specially  useful  when  used to inject failures in the POSIX/libc functions, because it does not
       require any program modifications.

       After launching programs with fiu-run, fiu-ctrl(1) can be used to enable and disable their failure points
       at runtme.

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

       -x     Use the POSIX libfiu preload library, allows simulate failures in the POSIX and C standard library
              functions.

       -f ctrlpath
              Enable  remote  control  over named pipes with the given path as base name, the process id will be
              appended (defaults to "$TMPDIR/fiu-ctrl", or "/tmp/fiu-ctrl" if "$TMPDIR" is not set). Set  to  ""
              to disable remote control over named pipes.

       -l path
              Path  where  to find the libfiu preload libraries. Defaults to the path where they were installed,
              so it is usually correct.

       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.

       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 will run the fortune(1) program simulating faults in read() with 5% probability (note that
       the -x parameter is required in this case to enable failure points in the POSIX and libc functions):

              fiu-run -x -c "enable_random name=posix/io/rw/read,probability=0.05" fortune

       By running it multiple times you will see that sometimes it works, but most of the time you get different
       errors, resulting from the simulated failures.

SEE ALSO

       libfiu(3), fiu-ctrl(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-run(1)