TH_MANAGE(8) Maintenance Commands and Procedures TH_MANAGE(8)
NAME
th_manage - manage the fault injection test harness
SYNOPSIS
th_manage name instance command th_manage path commandDESCRIPTION
th_manage applies the action specified by
command to the instance
specified by
instance of the driver specified by
name (or the driver
instance specified by
path). The driver instance must be running
fault injection specifications (errdefs) defined by
th_define(8).
th_manage supports several commands that operate on the driver
instance specified by
name and
instance (or
path). The commands are:
broadcast Awaken all
th_define processes, causing them to
display their current status and exit if the errdef
is now defunct (that is, if
count,
failcount, and
acc_chk are all zero).
clear_acc_chk Awaken all
th_define processes. If
count and
failcount are already zero, then set
acc_chk to
zero, so that
th_define exits once it has displayed
its status.
clear_errdefs Awaken all
th_define processes.
count,
failcount and
acc_chk are all set to zero so that all
th_define commands exit once they have displayed
their status.
clear_errors Awaken all
th_define processes. If
count is already
zero, set
failcount and
acc_chk to zero, so that
th_define exits once it has displayed its status.
get_handles List all the access handles.
start Begin or resume execution of all errdefs.
stop Suspend all errdefs for this
name and
instance (or
path).EXAMPLES
Example 1: Useful Commands
To begin the tests, enter:
# th_manage foo 0 start To check the status of the errdefs, enter:
# th_manage foo 0 broadcast This causes each
th_define process to print out its current status.
If the driver has reported a fatal error, you can take the driver
offline using
libdevice, clear the error condition by entering:
# th_manage foo 0 clear_acc_chk or
# th_manage foo 0 clear_errors and bring the driver online again using
libdevice.
To terminate testing, enter:
# th_manage foo 0 clear_errdefsSEE ALSO
th_define(8) January 4, 2001 TH_MANAGE(8)
