fiu-run - Online in the Cloud

This is the command fiu-run that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

PROGRAM:

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.

Use fiu-run online using onworks.net services



Latest Linux & Windows online programs