scsi_extended_sense(9s) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

scsi_extended_sense(9s)

scsi_extended_sense(9S) Kernel & Driver Data Structuresscsi_extended_sense(9S)

NAME
       scsi_extended_sense - SCSI extended sense structure

SYNOPSIS
       #include <sys/scsi/scsi.h>

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI).

DESCRIPTION
       The scsi_extended_sense structure for error codes 0x70 (current errors)
       and  0x71  (deferred  errors) is returned on a successful REQUEST SENSE
       command. SCSI-2 compliant targets are required to return at  least  the
       first  18  bytes  of this structure. This structure is part of scsi_de‐
       vice(9S) structure.

STRUCTURE MEMBERS
         uchar_t  es_valid   :1;     /* Sense data is valid */
         uchar_t  es_class   :3;     /* Error Class- fixed at 0x7 */
         uchar_t  es_code    :4;     /* Vendor Unique error code */
         uchar_t  es_segnum;         /* Segment number: for COPY cmd only */
         uchar_t  es_filmk   :1;     /* File Mark Detected */
         uchar_t  es_eom     :1;     /* End of Media */
         uchar_t  es_ili     :1;     /* Incorrect Length Indicator */
         uchar_t  es_key     :4;     /* Sense key */
         uchar_t  es_info_1;         /* Information byte 1 */
         uchar_t  es_info_2;         /* Information byte 2 */
         uchar_t  es_info_3;         /* Information byte 3 */
         uchar_t  es_info_4;         /* Information byte 4 */
         uchar_t  es_add_len;        /* Number of additional bytes */
         uchar_t  es_cmd_info[4];    /* Command specific information */
         uchar_t  es_add_code;       /* Additional Sense Code */
         uchar_t  es_qual_code;      /* Additional Sense Code Qualifier */
         uchar_t  es_fru_code;       /* Field Replaceable Unit Code */
         uchar_t  es_skey_specific[3]; /* Sense Key Specific information */



       es_valid, if set, indicates that the information field  contains  valid
       information.


       es_class should be 0x7.


       es_code is either 0x0 or 0x1.


       es_segnum  contains the number of the current segment descriptor if the
       REQUEST SENSE command is in response to a COPY, COMPARE, and  COPY  AND
       VERIFY command.


       es_filmk,  if  set,  indicates that the current command had read a file
       mark or set mark (sequential access devices only).


       es_eom, if set, indicates that an end-of-medium condition  exists  (se‐
       quential access and printer devices only).


       es_ili,  if  set, indicates that the requested logical block length did
       not match the logical block length of the data on the medium.


       es_key indicates generic information describing an error  or  exception
       condition. The following sense keys are defined:

       KEY_NO_SENSE

           Indicates that there is no specific sense key information to be re‐
           ported.


       KEY_RECOVERABLE_ERROR

           Indicates  that  the  last command completed successfully with some
           recovery action performed by the target.


       KEY_NOT_READY

           Indicates that the logical unit addressed cannot be accessed.


       KEY_MEDIUM_ERROR

           Indicates that the command terminated with  a  non-recovered  error
           condition  that  was  probably caused by a flaw on the medium or an
           error in the recorded data.


       KEY_HARDWARE_ERROR

           Indicates that the target detected a non-recoverable hardware fail‐
           ure while performing the command or during a self test.


       KEY_ILLEGAL_REQUEST

           Indicates that there was an illegal parameter in the CDB or in  the
           additional parameters supplied as data for some commands.


       KEY_UNIT_ATTENTION

           Indicates  that the removable medium might have been changed or the
           target has been reset.


       KEY_WRITE_PROTECT/KEY_DATA_PROTECT

           Indicates that a command that reads or writes the  medium  was  at‐
           tempted on a block that is protected from this operation.


       KEY_BLANK_CHECK

           Indicates  that  a  write-once device or a sequential access device
           encountered blank medium or format-defined  end-of-data  indication
           while reading or a write-once device encountered a non-blank medium
           while writing.


       KEY_VENDOR_UNIQUE

           This  sense  key  is available for reporting vendor-specific condi‐
           tions.


       KEY_COPY_ABORTED

           Indicates that a COPY, COMPARE, and COPY  AND  VERIFY  command  was
           aborted.


       KEY_ABORTED_COMMAND

           Indicates that the target aborted the command.


       KEY_EQUAL

           Indicates  that  a SEARCH  DATA command has satisfied an equal com‐
           parison.


       KEY_VOLUME_OVERFLOW

           Indicates that a buffered peripheral device has reached the end-of-
           partition and data might remain in the buffer  that  has  not  been
           written to the medium.


       KEY_MISCOMPARE

           Indicates that the source data did not match the data read from the
           medium.


       KEY_RESERVE

           Indicates that the target is currently reserved by a different ini‐
           tiator.



       es_info_{1,2,3,4} is device-type or command specific.


       es_add_len indicates the number of additional sense bytes to follow.


       es_cmd_info  contains  information that depends on the command that was
       executed.


       es_add_code (ASC) indicates further information related to the error or
       exception condition reported in the sense key field.


       es_qual_code (ASCQ) indicates detailed information related to the addi‐
       tional sense code.


       es_fru_code (FRU) indicates a device-specific mechanism  to  unit  that
       has failed.


       es_skey_specific  is  defined  when the value of the sense-key specific
       valid bit (bit 7) is 1. This field is reserved for sense keys  not  de‐
       fined above.

SEE ALSO
       scsi_device(9S)


       ANSI Small Computer System Interface-2 (SCSI-2)


       Writing Device Drivers in Oracle Solaris 11.4

Oracle Solaris 11.4               30 Aug 1995          scsi_extended_sense(9S)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3