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

enable(1)							   User Commands							 enable(1)

NAME
enable, disable - enable/disable LP printers SYNOPSIS
/usr/bin/enable printer... /usr/bin/disable [-c | -W] [-r [reason]] printer... DESCRIPTION
The enable command activates printers, enabling them to print requests submitted by the lp command. enable must be run on the printer server. The disable command deactivates printers, disabling them from printing requests submitted by the lp command. By default, any requests that are currently printing on printer are reprinted in their entirety either on printer or another member of the same class of printers. The disable command must be run on the print server. Use lpstat -p to check the status of printers. Generally, enable and disable are run on the print server to control local print queues. Under some configurations, they can also be run on client systems when IPP is being used to communicate between client and server. OPTIONS
The following options are supported for use with disable: -c Cancels any requests that are currently printing on printer. This option cannot be used with the -W option. If the printer is remote, the -c option is silently ignored. -W Waits until the request currently being printed is finished before disabling printer. This option cannot be used with the -c option. If the printer is remote, the -W option is silently ignored. -r [reason] Assigns a reason for the disabling of the printer(s). This reason applies to all printers specified. This reason is reported by lpstat -p. Enclose reason in quotes if it contains blanks. The default reason is unknown reason for the existing printer, and "new printer" for a printer added to the system but not yet enabled. OPERANDS
The following operand is supported for both enable and disable: printer The name of the printer to be enabled or disabled. Specify printer using atomic or URI-style (scheme://endpoint) names. See printers.conf(4) regarding the naming conventions for destinations. EXIT STATUS
The following exit values are returned: 0 Successful completion. non-zero An error occurred. FILES
/etc/printers.conf System printer configuration database $HOME/.printers User-configurable printer database ou=printers LDAP version of /etc/printers.conf printers.conf.byname NIS version of /etc/printers.conf printers.org_dir NIS+ version of /etc/printers.conf ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWlp-cmds | +-----------------------------+-----------------------------+ |Interface Stability |Obsolete | +-----------------------------+-----------------------------+ |CSI |Enabled | +-----------------------------+-----------------------------+ SEE ALSO
lp(1), lpstat(1), printers.conf(4), attributes(5) NOTES
When IPP is in use, the user is prompted for a passphsrase if the remote print service is configured to require authentication. SunOS 5.11 5 Jun 2006 enable(1)
Man Page

Featured Tech Videos