Return Codes and Status Values

Return Codes and Status Values

A zero return code in the ds_ret field signifies success. The possible nonzero return codes are summarized in Table 5-3 and are declared in sys/dsreq.h. Not all return codes are possible with every driver.

Return Codes From SCSI Operations
Constant Name Meaning
DSRT_DEVSCSI General failure from SCSI driver.
DSRT_MULT General software failure, typically a SCSI-bus request.
DSRT_CANCEL Operation cancelled in host adapter driver.
DSRT_REVCODE Software level mismatch, recompile application.
DSRT_AGAIN Try again, recoverable SCSI-bus error.
DSRT_HOST Failure reported by host adapter driver for the bus in use.
DSRT_NOSEL No unit responded to select.
DSRT_SHORT Incomplete transfer (not an error). See ds_datasent.
DSRT_OK Not returned at this time.
DSRT_SENSE Command returned with status; sense data successfully retrieved from SCSI host (see ds_sensesent).
DSRT_NOSENSE Command with status, error occurred while trying to get sense data from SCSI host.
DSRT_TIMEOUT Command did not complete in the time allowed by ds_timeout.
DSRT_LONG Data transfer overran bounds (ds_datalen).
DSRT_PROTO Miscellaneous protocol failure.
DSRT_EBSY Busy dropped unexpectedly; protocol error.
DSRT_REJECT Message rejected; protocol error.
DSRT_PARITY Parity error on SCSI bus; protocol error.
DSRT_MEMORY Memory error in system memory.
DSRT_CMDO Protocol error during command phase.
DSRT_STAI Protocol error during status phase.
DSRT_UNIMPL Command not implemented; protocol error.

Return Codes From SCSI Operations
Constant Name	Meaning
DSRT_DEVSCSI	General failure from SCSI driver.
DSRT_MULT	General software failure, typically a SCSI-bus request.
DSRT_CANCEL	Operation cancelled in host adapter driver.
DSRT_REVCODE	Software level mismatch, recompile application.
DSRT_AGAIN	Try again, recoverable SCSI-bus error.
DSRT_HOST	Failure reported by host adapter driver for the bus in use.
DSRT_NOSEL	No unit responded to select.
DSRT_SHORT	Incomplete transfer (not an error). See ds_datasent.
DSRT_OK	Not returned at this time.
DSRT_SENSE	Command returned with status; sense data successfully retrieved from SCSI host (see ds_sensesent).
DSRT_NOSENSE	Command with status, error occurred while trying to get sense data from SCSI host.
DSRT_TIMEOUT	Command did not complete in the time allowed by ds_timeout.
DSRT_LONG	Data transfer overran bounds (ds_datalen).
DSRT_PROTO	Miscellaneous protocol failure.
DSRT_EBSY	Busy dropped unexpectedly; protocol error.
DSRT_REJECT	Message rejected; protocol error.
DSRT_PARITY	Parity error on SCSI bus; protocol error.
DSRT_MEMORY	Memory error in system memory.
DSRT_CMDO	Protocol error during command phase.
DSRT_STAI	Protocol error during status phase.
DSRT_UNIMPL	Command not implemented; protocol error.

The possible SCSI status value in the ds_status field are summarized in Table 5-4.

SCSI Status Codes
Constant Name Meaning
STA_GOOD The target has successfully completed the SCSI command.
STA_CHECK An error or exception was detected. Sense was attempted if DSRQ_SENSE was specified.
STA_BUSY Command not attempted; addressed unit is busy.
STA_IGOOD Linked SCSI command completed.
STA_RESERV Command aborted because it tried to access a logical unit or an extent within a logical unit that reserves that type of access to another SCSI device.

SCSI Status Codes
Constant Name	Meaning
STA_GOOD	The target has successfully completed the SCSI command.
STA_CHECK	An error or exception was detected. Sense was attempted if DSRQ_SENSE was specified.
STA_BUSY	Command not attempted; addressed unit is busy.
STA_IGOOD	Linked SCSI command completed.
STA_RESERV	Command aborted because it tried to access a logical unit or an extent within a logical unit that reserves that type of access to another SCSI device.

The possible SCSI message byte values in the ds_msg field are summarized in Table 5-5.

SCSI Message Byte Values
Constant Name Meaning
MSG_COMPL Command complete.
MSG_XMSG Extended message (only byte returned).
MSG_SAVEP Initiator should save data pointers.
MSG_RESTP Initiator restore data pointers.
MSG_DISC Disconnect.
MSG_IERR Initiator detected error.
MSG_ABORT Abort.
MSG_REJECT Optional message rejected, not supported.
MSG_NOOP Empty message.
MSG_MPARITY Parity error during Message In phase.
MSG_LINK Linked command complete.
MSG_LINKF Linked command complete with flag.
MSG_BRESET Bus device reset.
MSG_IDENT Value 0x80, first of the 0x80-0xFF identifier messages.

SCSI Message Byte Values
Constant Name	Meaning
MSG_COMPL	Command complete.
MSG_XMSG	Extended message (only byte returned).
MSG_SAVEP	Initiator should save data pointers.
MSG_RESTP	Initiator restore data pointers.
MSG_DISC	Disconnect.
MSG_IERR	Initiator detected error.
MSG_ABORT	Abort.
MSG_REJECT	Optional message rejected, not supported.
MSG_NOOP	Empty message.
MSG_MPARITY	Parity error during Message In phase.
MSG_LINK	Linked command complete.
MSG_LINKF	Linked command complete with flag.
MSG_BRESET	Bus device reset.
MSG_IDENT	Value 0x80, first of the 0x80-0xFF identifier messages.