When executing an I/O request many things may go wrong. The reason of error can be reported in the CCB status with great detail. Examples of use are spread throughout this document. For completeness here is the summary of recommended responses for the typical error conditions:
CAM_RESRC_UNAVAIL - some resource is temporarily unavailable and the SIM driver cannot generate an event when it will become available. An example of this resource would be some intra-controller hardware resource for which the controller does not generate an interrupt when it becomes available.
CAM_UNCOR_PARITY - unrecovered parity error occurred
CAM_DATA_RUN_ERR - data overrun or unexpected data phase (going in other direction than specified in CAM_DIR_MASK) or odd transfer length for wide transfer
CAM_SEL_TIMEOUT - selection timeout occurred (target does not respond)
CAM_CMD_TIMEOUT - command timeout occurred (the timeout function ran)
CAM_SCSI_STATUS_ERROR - the device returned error
CAM_AUTOSENSE_FAIL - the device returned error and the REQUEST SENSE COMMAND failed
CAM_MSG_REJECT_REC - MESSAGE REJECT message was received
CAM_SCSI_BUS_RESET - received SCSI bus reset
CAM_REQ_CMP_ERR - “impossible” SCSI phase occurred or something else as weird or just a generic error if further detail is not available
CAM_UNEXP_BUSFREE - unexpected disconnect occurred
CAM_BDR_SENT - BUS DEVICE RESET message was sent to the target
CAM_UNREC_HBA_ERROR - unrecoverable Host Bus Adapter Error
CAM_REQ_TOO_BIG - the request was too large for this controller
CAM_REQUEUE_REQ - this request should be re-queued to preserve transaction ordering. This typically occurs when the SIM recognizes an error that should freeze the queue and must place other queued requests for the target at the sim level back into the XPT queue. Typical cases of such errors are selection timeouts, command timeouts and other like conditions. In such cases the troublesome command returns the status indicating the error, the and the other commands which have not be sent to the bus yet get re-queued.
CAM_LUN_INVALID - the LUN ID in the request is not supported by the SCSI controller
CAM_TID_INVALID - the target ID in the request is not supported by the SCSI controller
All FreeBSD documents are available for download at https://download.freebsd.org/ftp/doc/
Questions that are not answered by the
documentation may be
sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.