busTRACE This WEB page comes from the busTRACE 9.0 User's Manual. (Table of Contents)

Previous Topic Next Topic
 

When you choose the Simulate a check condition option, from within busFAULT, you will receive a display similar to the following:

Fault Settings

CDBs to fail

You can configure busFAULT to only fail those Command Descriptor Blocks (CDBs) that you specify.

SRB status to return

You specify exactly which SrbStatus to return in the SCSI_REQUEST_BLOCK structure. The available return codes are:

  • SRB_STATUS_ABORTED
  • SRB_STATUS_ABORT_FAILED
  • SRB_STATUS_ERROR
  • SRB_STATUS_BUSY
  • SRB_STATUS_INVALID_REQUEST
  • SRB_STATUS_INVALID_PATH_ID
  • SRB_STATUS_NO_DEVICE
  • SRB_STATUS_TIMEOUT
  • SRB_STATUS_SELECTION_TIMEOUT
  • SRB_STATUS_COMMAND_TIMEOUT
  • SRB_STATUS_MESSAGE_REJECTED
  • SRB_STATUS_BUS_RESET
  • SRB_STATUS_PARITY_ERROR
  • SRB_STATUS_REQUEST_SENSE_FAILED
  • SRB_STATUS_NO_HBA
  • SRB_STATUS_UNEXPECTED_BUS_FREE
  • SRB_STATUS_PHASE_SEQUENCE_FAILURE
  • SRB_STATUS_BAD_SRB_BLOCK_LENGTH
  • SRB_STATUS_REQUEST_FLUSHED
  • SRB_STATUS_INVALID_LUN
  • SRB_STATUS_INVALID_TARGET_ID
  • SRB_STATUS_BAD_FUNCTION
  • SRB_STATUS_ERROR_RECOVERY
  • SRB_STATUS_NOT_POWERED
  • SRB_STATUS_LINK_DOWN

Please refer to Microsoft's Windows Driver Kit (WDK) for details on SCSI_REQUEST_BLOCK structures and the SrbStatus value.

Fault Frequency

You can specify how many I/Os to fail before busFAULT will stop failing CDBs on the selected device. If you select the Unlimited option, busFAULT will fail every CDB request it is configured to fail until you click on the Clear Device Fault button.

If you place a checkmark on the Random Failures option, you can configure busFAULT to generate a fault at random times. You can adjust the frequency of the random fault by adjusting the Random Frequency setting that appears.

Set Device Fault

Once you have configured which CDBs to fail, the SRB Status to return, and the number of I/O requests to fail, you simply click on the Set Device Fault button. When you do, busFAULT is immediately activated on that device and any matching CDBs sent to that device object will fail with the specified settings. You can force busFAULT to stop generating faults for the device by selecting the Clear Device Fault button.

Whenever a simulated fault is active, on any device, a red error indicator will flash in the upper right of the display. This is a visual cue, regardless of which device is selected, that busFAULT is currently active on one or more devices.

See Also