Fault-Injection Process

The process of injecting a fault involves two phases:

1. Use the th_define(1M) command to create errdefs.

   Create errdefs by passing test definitions to the bofi driver, which stores the definitions so they can be accessed by using the th_manage(1M) command.

2. Create a workload, then use the th_manage command to activate and manage the errdef.

   The th_manage command is a user interface to the various ioctls that are recognized by the bofi harness driver. The th_manage command operates at the level of driver names and instances and includes these commands: get_handles to list access handles, start to activate errdefs, and stop to deactivate errdefs.

   The activation of an errdef results in qualifying data accesses to be faulted. The th_manage utility supports these commands: broadcast to provide the current state of the errdef and clear_errors to clear the errdef.

   See the th_define(1M) and th_manage(1M) man pages for more information.