Data Structures for Drivers                   scsiarqstatus(9S)



NAME
     scsiarqstatus - SCSI auto request sense structure

SYNOPSIS
     #include 


INTERFACE LEVEL
     Solaris DI specific (Solaris DI)

DESCRIPTION
     When   auto   request   sense   has   been   enabled   using
     scsiifsetcap(9F)  and  the  "auto-rqsense"  capability, the
     target driver must allocate a status area in the SCSI packet
     structure   for   the  auto  request  sense  structure  (see
     scsipkt(9S)).  In the event of a check condition, the tran-
     sport  layer automatically executes a request sense command.
     This check ensures that the request sense  information  does
     not  get lost. The auto request sense structure supplies the
     SCSI status of the original command, the transport  informa-
     tion  pertaining  to  the  request  sense  command,  and the
     request sense data.

STRUCTURE MEMBERS
       struct scsistatus       stsstatus;          /* SCSI status */
       struct scsistatus       stsrqpktstatus;    /* SCSI status of
                                                        request sense cmd */
       uchart                  stsrqpktreason;    /* reason completion */
       uchart                  stsrqpktresid;     /* residue */
       uintt                   stsrqpktstate;     /* state of command */
       uintt                   stsrqpktstatistics;/* statistics */
       struct scsiextendedsense stssensedata;      /* actual sense data */



     stsstatus is the SCSI status of the  original  command.  If
     the  status indicates a check condition, the transport layer
     might have performed an auto request sense command.


     stsrqpktstatus is the SCSI status  of  the  request  sense
     command.  stsrqpktreason  is  the completion reason of the
     request sense command. If the reason is not CMDCMPLT,  then
     the request sense command did not complete normally.


     stsrqpktresid is the residual count of the  data  transfer
     and  indicates  the  number of data bytes that have not been
     transferred.  The  auto  request  sense   command   requests
     SENSELENGTH bytes.





SunOS 5.11          Last change: 30 Sep 1996                    1






Data Structures for Drivers                   scsiarqstatus(9S)



     stsrqpktstate has bit positions representing the five most
     important statuses that a  SCSI command can go obtain.


     stsrqpktstatistics maintains transport-related  statistics
     of the request sense command.


     stssensedata contains the actual sense data if the  request
     sense command completed normally.

SEE ALSO
     scsiifgetcap(9F),                        scsiinitpkt(9F),
     scsiextendedsense(9S), scsipkt(9S)


     Writing Device Drivers






































SunOS 5.11          Last change: 30 Sep 1996                    2