Error Conditions for USB Tape Client Device Driver

In addition to the listed errors, the ioctl, open, read, and write subroutines for USB tape device are unsuccessful in the following circumstances:

Reliability and serviceability information

The following errors are returned from the tape devices:

Medium, hardware, and unsuccessful command errors from the preceding list must be logged every time they occur. The ABORTED COMMAND error might be recoverable, but the error is logged if recovery fails. For the RECOVERED ERROR and recovered ABORTED COMMAND error types, thresholds are maintained; when they are exceeded, an error is logged. The thresholds are then cleared.

/* Bulk transfer cmd and status blocks */
typedef struct mstor_cbw {
    uint32_t cbw_signature;     /* Always "USBC" little endian */
    uint32_t cbw_tag;           /* Command identification  */
    fld32_t cbw_dlen;           /* Data length  */
    uchar cbw_flags;            /* Indicates data in or data out */
    uchar cbw_lun;              /* Logical unit number, 0-15  */
    uchar cbw_cblen;            /* Significant bytes of the cmd blk */
    uchar cbw_cb[16];           /* Command block itself  */
    uchar cbw_rsvd;
} mstor_cbw_t;
 
/* For error logging */
struct usbtape_err_rec {
    struct err_rec0 log;
    uint cmd_error;
    mstor_cbw_t cbw;
    char sense_data[168];
    uint dd1;                    /* reserved for dd use */
    uint dd2;                    /* reserved for dd use */
    uint dd3;                    /* reserved for dd use */
    uint dd4;                    /* reserved for dd use */
    uint dd5;                    /* reserved for dd use */
    uint dd6;                    /* reserved for dd use */
    uint dd7;                    /* reserved for dd use */
    uint dd8;                    /* reserved for dd use */
};
 
LABEL:          SC_TAPE_ERRx
IDENTIFIER:     xxxxxxxx
Date/Time:       Thu Mar 12 05:20:27 CDT 2009
Sequence Number: 3829
Machine Id:      0000097AD400
Node Id:         sitar04
Class:           H
Type:            PERM
Resource Name:   rmt0
Resource Class:  tape
Resource Type:   0806500c
Location:         
 
Description
Probable Causes
Failure Causes
 
       Recommended Actions
 
Detail Data
 
SENSE DATA
1111 1111 2222 2222 3333 3333 4444 4444 5566 7788 8888 8888 8888 8888 8888 8888 
8888 8899 aaaa kkaa aaaa aaaa aaaa aaaa ccqq aaaa aaaa aaaa aaaa aaaa aaaa aaaa 
aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa 
aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa 
aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa aaaa bbbb bbbb cccc cccc dddd dddd
 
 
Data Representation Legend
--------------------------
   cmd_error              1    Command Error Value 
(cmd_error values can be negative which are logged as 2's complement. 
  For these USB specific error values refer below or /usr/include/sys/usbdi.h.
  For error values which are positive Please refer to /usr/include/sys/errno.h file for error description)
 
Bulk transfer Command and Status Blocks
   cbw_signature          2    Always .USBC. in ASCII – “5553 4243”
   cbw_tag                3    Command Identification
   cbw_dlen               4    Data Length
   cbw_flags              5    Indicates Data IN or OUT
   cbw_lun                6    LUN Id
   cbw_cblen              7    CDB (Command Descriptor Bytes) length
   cbw_cb                 8    CDB
   cbw_rsvd               9    Reserved
 
Sense data
   Sense data             a
   Sense key              k          
   ASC                    c
   ASCQ                   q
   Read Transfer Count    b   In bytes
   Write Transfer Count   c   In bytes
   Location               d   Device Driver log location

Error record values for tape device errors

The following table lists the fields that are defined in the error record template for tape device errors:

Error record values for tape device media errors

The following table lists the fields that are defined in the error record template for tape device media errors:

The Detail_Data field contains the command type, device and adapter status, and the request-sense information from the particular device in error. The Detail_Data field is contained in the err_rec structure. This structure is defined in the /usr/include/sys/errids.h file.

Error record values for tape or hardware aborted command errors

The following fields in the err_hdr structure are defined in the /usr/include/sys/erec.h file for hardware errors and aborted command errors:

The Detail_Data field contains the command type, device and adapter status, and the request-sense information from the particular device in error. The Detail_Data field is contained in the err_rec structure. This structure is defined in the /usr/include/sys/errids.h file. The usbtape_err_rec structure describes information that is contained in the Detail_Data field.

Error record values for tape-recovered error threshold exceeded

The following fields are defined in the err_hdr structure that are defined in the /usr/include/sys/erec.h file for recovered errors that have exceeded the threshold counter:

The Detail_Data field contains the command type, device and adapter status, and the request-sense information from the particular device in error. This field is contained in the err_rec structure. The err_rec structure is defined in the /usr/include/sys/errids.h file. The Detail_Data field also specifies the error type of the threshold exceeded. The usbtape_err_rec structure describes information contained in the Detail_Data field.

Error record values for tape USB adapter-detected errors

The following fields in the err_hdr structure are defined in the /usr/include/sys/erec.h file for adapter-detected errors:

The Detail_Data field contains the command type and adapter status. This field is contained in the err_rec structure that is defined by the /usr/include/sys/err_rec.h file. Request-sense information is not available with this type of error. The usbtape_err_rec structure describes information contained in the Detail_Data field.

Error record values for tape drive cleaning errors

Some tape drives return errors when they need cleaning. Errors that occur when the drive needs cleaning are grouped under this class.

The Detail_Data field contains the command type and adapter status, and also the request-sense information from the particular device in error. This field is contained in the err_rec structure that is defined by the /usr/include/sys/errids.h file. The usbtape_err_rec structure describes information contained in the Detail_Data field.

Error record values for unknown errors

Errors that occur for unknown reasons are grouped in this class. Data-protect errors fall into this class. These errors, which are detected by the tape device driver, are never seen at the tape drive.

The err_hdr structure for unknown errors describes the following fields:

The Detail_Data field contains the command type and adapter status, and the request-sense information from the particular device in error. The Detail_Data field is contained in the err_rec structure. This field is contained in the /usr/include/sys/errids.h file. The usbtape_err_rec structure describes information that is contained in the Detail_Data field.

Refer to the SCSI specification for the applicable device for the format of the particular request-sense information.