TH_MANAGE(1M) Maintenance Commands TH_MANAGE(1M)


NAME


th_manage - manage the fault injection test harness

SYNOPSIS


th_manage name instance command


th_manage path command


DESCRIPTION


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(1M).


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_errdefs


SEE ALSO


th_define(1M)


January 4, 2001 TH_MANAGE(1M)