Rechercher une page de manuel

Chercher une autre page de manuel:

fiu-run

Langue: en

Version: 337554 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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

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

You can enable any number of failure points by using -e repeatedly.

EXAMPLES

The following will run the fortune(1) program simulating faults in all the POSIX I/O functions with a 10% probability, and in malloc() 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 -e posix/io/* -p 10 -e libc/mm/malloc -p 5 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.
César :
Tu mets d'abord un tiers de curaçao. Fait attention, un tout petit
tiers. Bon. Maintenant, un tiers de citron. Un peu plus gros. Bon.
Ensuite un BON tiers de Picon. Regarde la couleur. Regarde comme c'est
joli. Et à la fin un GRAND tiers d'eau. Voilà.
Marius :
Dans un verre, il n'y a que trois tiers.
César :
Mais imbécile, ça dépend de la grosseur des tiers !...
-+- Marcel Pagnol, Marius -+-