th_manage

- manage the fault injection test harness

Synopsis

th_managenameinstancecommand

th_managepathcommand

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_defineprocesses. 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_managefoo0start

To check the status of the errdefs, enter:

#th_managefoo0broadcast

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: