te
Copyright (c) 2002, Sun Microsystems, Inc.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
scsi_probe - utility for probing a scsi device

#include <sys/scsi/scsi.h>



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

illumos DDI specific (illumos DDI). devp waitfunc 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

SLEEP_FUNC scsi_probe() returns: SCSIPROBE_BUSY SCSIPROBE_EXISTS SCSIPROBE_FAILURE SCSIPROBE_NOMEM SCSIPROBE_NOMEM_CB SCSIPROBE_NONCCS SCSIPROBE_NORESP 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 allocated. 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);

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

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