Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

fiu-run(1) [debian man page]

fiu-run(1)						      General Commands Manual							fiu-run(1)

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  simu-
       lated 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)

Check Out this Related Man Page

run(1F) 							   FMLI Commands							   run(1F)

NAME

       run - run an executable

SYNOPSIS

       run [-s] [-e] [-n] [-t string] program

DESCRIPTION

       The run command runs program, using the PATH variable to find it. By default, when program has completed, the user is prompted (Press ENTER
       to continue:), before being returned to FMLI. The argument program is a system executable followed by its options (if any).

OPTIONS

       The following options are supported:

       -e	   If -e is specified, the user is prompted before returning to FMLI only if there is an error condition

       -n	   If -n is specified, the user is never prompted before returning to FMLI (useful for programs like vi, in which the user must do
		   some specific action to exit in the first place).

       -s	   The	-s option means "silent", implying that the screen does not have to be repainted when program has completed. The -s option
		   should only be used when program does not write to the terminal. In addition, when -s is used, program cannot  be  interrupted,
		   even if it recognizes interrupts.

       -tstring    If -t is specified, string is the name this process has in the pop-up menu generated by the frm-list command.

EXAMPLES

       Example 1 Sample Output of the run Command

       Here is a menu that uses run:

	 menu="Edit special System files"
	 name="Password file"
	 action=`run -e vi /etc/passwd`
	 name="Group file"
	 action=`run -e vi /etc/group`
	 name="My .profile"
	 action=`run -n vi $HOME/.profile`

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5)

SunOS 5.11							    7 Nov 2005								   run(1F)
Man Page