개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

scsi_probe(9f)

scsi_probe(9F)                 Kernel Functions                 scsi_probe(9F)



NAME
       scsi_probe - utility for probing a scsi device

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

       int scsi_probe(struct scsi_device *devp, int (*waitfunc);

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI).

PARAMETERS
       devp        Pointer to a scsi_device(9S) structure


       waitfunc    NULL_FUNC or SLEEP_FUNC


DESCRIPTION
       scsi_probe() determines whether a target/lun is present and sets up the
       scsi_device structure with inquiry data.


       scsi_probe() uses the SCSI  Inquiry  command  to  test  if  the  device
       exists.   It   can   retry  the  Inquiry  command  as  appropriate.  If
       scsi_probe() is successful, it will allocate space for the scsi_inquiry
       structure   and  assign  the  address  to  the  sd_inq  member  of  the
       scsi_device(9S)  structure.  scsi_probe()  will  then  fill   in   this
       scsi_inquiry(9S) structure and return SCSIPROBE_EXISTS. If scsi_probe()
       is unsuccessful, it returns SCSIPROBE_NOMEM in spite of callback set to
       SLEEP_FUNC.


       scsi_unprobe(9F) is used to undo the effect of scsi_probe().


       If the target is a non-CCS device, SCSIPROBE_NONCCS will be returned.


       waitfunc indicates what the allocator routines should do when resources
       are not available; the valid values are:

       NULL_FUNC     Do not wait  for  resources.  Return  SCSIPROBE_NOMEM  or
                     SCSIPROBE_FAILURE


       SLEEP_FUNC    Wait indefinitely for resources.


RETURN VALUES
       scsi_probe() returns:

       SCSIPROBE_BUSY        Device exists but is currently busy.


       SCSIPROBE_EXISTS      Device exists and inquiry data is valid.


       SCSIPROBE_FAILURE     Polled command failure.


       SCSIPROBE_NOMEM       No space available for structures.


       SCSIPROBE_NOMEM_CB    No  space  available  for structures but callback
                             request has been queued.


       SCSIPROBE_NONCCS      Device exists but inquiry data is not valid.


       SCSIPROBE_NORESP      Device does not respond to an INQUIRY.


CONTEXT
       scsi_probe() is normally called from the target driver's  probe(9E)  or
       attach(9E) routine. In any case, this routine should not be called from
       interrupt context, because it can sleep waiting for memory to be  allo‐
       cated.

EXAMPLES
       Example 1  Using scsi_probe()


             switch (scsi_probe(devp, NULL_FUNC)) {
             default:
             case SCSIPROBE_NORESP:
             case SCSIPROBE_NONCCS:
             case SCSIPROBE_NOMEM:
             case SCSIPROBE_FAILURE:
             case SCSIPROBE_BUSY:
                     break;
             case SCSIPROBE_EXISTS:
                     switch (devp->sd_inq->inq_dtype) {
                     case DTYPE_DIRECT:
                             rval = DDI_PROBE_SUCCESS;
                             break;
                     case DTYPE_RODIRECT:
                             rval = DDI_PROBE_SUCCESS;
                             break;
                     case DTYPE_NOTPRESENT:
                     default:
                             break;
                     }
             }
             scsi_unprobe(devp);


SEE ALSO
       attach(9E),      probe(9E),      scsi_slave(9F),      scsi_unprobe(9F),
       scsi_unslave(9F), scsi_device(9S), scsi_inquiry(9S)


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


       Writing Device Drivers in Oracle Solaris 11.4

NOTES
       A waitfunc function other than NULL_FUNC or SLEEP_FUNC is not supported
       and may have unexpected results.



Oracle Solaris 11.4               26 Feb 2002                   scsi_probe(9F)