[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    scsi_probe(9F) manual page Table of Contents

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).

Arguments

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 may 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 .

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_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. If waitfunc is SLEEP_FUNC, then this routine may only be called from user-level code. Otherwise, it may be called from either user or interrupt level.

Example


    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)

Notes

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


Table of Contents