opensolaris man page for th_manage

th_manage(1M)						  System Administration 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)

SunOS 5.11							    4 Jan 2001							     th_manage(1M)