NAME

scsi − configuration files for SCSI target drivers

DESCRIPTION

The architecture of the Solaris SCSI subsystem distinguishes two types of device drivers: SCSI target drivers, and SCSI host adapter drivers.  Target drivers like sd(7) and st(7) manage the device on the other end of the SCSI bus. Host adapter drivers manage the SCSI bus on behalf of all the devices that share it. 

Drivers for host adapters provide a common set of interfaces for target drivers.  These interfaces comprise the Sun Common SCSI Architecture (SCSA) which are documented as part of the Solaris DDI/DKI.  See scsi_ifgetcap(9F), scsi_pktalloc(9F), and scsi_transport(9F) for further details of these, and associated routines. 

Target drivers for SCSI devices should use a driver configuration file to enable them to be recognised by the system. 

Configuration files for SCSI target drivers should identify the host adapter driver implicitly using the class keyword to remove any dependency on the particular host adapter involved. 

All host adapter drivers of class scsi recognise the following properties:

target Integer-valued SCSI target identifier that this driver will claim. 

lun Integer-valued SCSI logical unit number (LUN) that this driver will claim. 

All SCSI target drivers must provide target and lun properties.  These properties are used to construct the address part of the device name under /devices. 

EXAMPLES

Here is a configuration file for a SCSI target driver called toaster.conf. 

#
# Copyright (c) 1992, by Sun Microsystems, Inc.
#
#ident  "@(#)toaster.conf1.2     92/05/12 SMI"
 name="toaster" class="scsi" target=4 lun=0;

SEE ALSO

driver.conf(4), sd(7), st(7), scsi_ifgetcap(9F), scsi_pktalloc(9F), scsi_transport(9F)

SunOS 5.1 Writing Device Drivers

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

NOTES

You need to ensure that the target and lun values claimed by your target driver do not conflict with existing target drivers on the system.  For example, if the target is a direct access device, the standard sd.conf file will usually make sd claim it before any other driver has a chance to probe it. 

SunOS 5.1/SPARC  —  Last change: 28 Sep 1992