fiu-ctrl(1) [debian man page]

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

NAME

       fiu-ctrl - a script to remote control programs using libfiu

SYNOPSIS

       fiu-ctrl [options] PID [PID ...]

DESCRIPTION

       fiu-ctrl is a script to enable/disable failure points in running programs that are using libfiu(3).

       Programs are usually launched using fiu-run(1), which enables libfiu's remote control capabilities without the need to modify the program's
       code.

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

       -f ctrlpath
	      Set the default prefix for remote control over named pipes. Defaults to "$TMPDIR/fiu-ctrl", or "/tmp/fiu-ctrl" if "$TMPDIR"  is  not
	      set, which is the usually correct for programs launched using fiu-run(1).

       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.

       'disable name=NAME'
	      Disables the NAME failure point.

       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  command will tell the process running with PID 12345 to enable the failure point posix/io/read with a 25% of probability to
       fail, and the failure point libc/mm/malloc with a 5% of probability to fail:

	      fiu-ctrl -c 'enable_random name=posix/io/*,probability=0.25' 
		       -c 'enable_random name=libc/mm/*,probability=0.05' 12345

       And the following will tell the same process to disable the previously enabled failure point posix/io/read:

	      fiu-ctrl -c 'disable name=posix/io/read' 12345

SEE ALSO

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

term::ansi::ctrl::unix(3tcl)					 Terminal control				      term::ansi::ctrl::unix(3tcl)

__________________________________________________________________________________________________________________________________________________

NAME

       term::ansi::ctrl::unix - Control operations and queries

SYNOPSIS

       package require Tcl  8.4

       package require term::ansi::ctrl::unix  ?0.1.1?

       ::term::ansi::ctrl::unix::import ?ns? ?arg...?

       ::term::ansi::ctrl::unix::raw

       ::term::ansi::ctrl::unix::raw

       ::term::ansi::ctrl::unix::columns

       ::term::ansi::ctrl::unix::rows

_________________________________________________________________

DESCRIPTION

       WARNING:  This  package	is  unix-specific  and depends on the availability of two unix system commands for terminal control, i.e. stty and
       tput, both of which have to be found in the $PATH. If any of these two commands is missing the loading of the package will fail.

       The package provides commands to switch the standard input of the current process between raw and cooked input modes, and to query the size
       of terminals, i.e. the available number of columns and lines.

API

   INTROSPECTION
       ::term::ansi::ctrl::unix::import ?ns? ?arg...?
	      This  command imports some or all attribute commands into the namespace ns. This is by default the namespace ctrl. Note that this is
	      relative namespace name, placing the imported command into a child of the current namespace. By default all commands  are  imported,
	      this can howver be restricted by listing the names of the wanted commands after the namespace argument.

   OPERATIONS
       ::term::ansi::ctrl::unix::raw
	      This command switches the standard input of the current process to raw input mode. This means that from then on all characters typed
	      by the user are immediately reported to the application instead of waiting in the OS buffer until the Enter/Return key is received.

       ::term::ansi::ctrl::unix::raw
	      This command switches the standard input of the current process to cooked input mode. This means that from then  on  all	characters
	      typed by the user are kept in OS buffers for editing until the Enter/Return key is received.

       ::term::ansi::ctrl::unix::columns
	      This command queries the terminal connected to the standard input for the number of columns available for display.

       ::term::ansi::ctrl::unix::rows
	      This command queries the terminal connected to the standard input for the number of rows (aka lines) available for display.

BUGS, IDEAS, FEEDBACK
       This  document, and the package it describes, will undoubtedly contain bugs and other problems.	Please report such in the category term of
       the Tcllib SF Trackers [http://sourceforge.net/tracker/?group_id=12883].  Please also report any ideas for enhancements you  may  have  for
       either package and/or documentation.

KEYWORDS

       ansi, columns, control, cooked, input mode, lines, raw, rows, terminal

CATEGORY

       Terminal control

COPYRIGHT

       Copyright (c) 2006-2011 Andreas Kupries <andreas_kupries@users.sourceforge.net>

term								       0.1.1					      term::ansi::ctrl::unix(3tcl)