adsl(7)


adsl -- Adaptec PCI SCSI host adapter subsystem

Description

The Adaptec PCI host adapter driver provides a Storage Device Interface (SDI)-compliant interface to any Adaptec Host Adapters based on the Adaptec AIC-7800 family of SCSI controller chips. These devices include AHA-2940/2942, AHA-3940/3942, and AHA-2940W/2942W as well as any motherboard implementations using the AIC-7870 or the AIC-7850 SCSI chips.

The Adaptec PCI host adapter driver enables SDI-compliant target drivers (such as sd01 and st01) to communicate on the SCSI bus with target controllers and logical units. This allows normal access to mass-storage devices using standard system interfaces and filesystems.

You can access the SCSI bus subsystem directly by using the driver's pass-through interface. This allows the user to issue sb control blocks directly to a SCSI target device. To find the appropriate pass-through device to use for a particular target device, the user should open(2) the character special file for the device in question and then issue the B_GETDEV ioctl (see ioctl(2)). The device value returned should then be used to create a character special file which, when opened, can be used for pass-through (SDI_SEND) ioctl.

The Adaptec PCI host adapter driver honors the command timeout values as specified in the scb structure; see the scb(D4sdi) manual page. A software watchdog timer enforces the processing time limit. When the watchdog timer detects a job that has exceeded its processing time limit, it attempts to abort the job with a SCSI Job Abort Message. The driver also enforces a time limit on the abort process, thereby ensuring that jobs that ``time out'' are reported to the sending SDI Target Driver whether or not the abort succeeds.

ioctl calls

adsl supports all of the SDI pass-through ioctl(2) commands documented on the sdi(7) manual page.


NOTE: Exercise extreme caution when using the pass-through interface. It is possible to interfere with normal system I/O and cause hangs if pass-through is used to an active device. Pass-through should only be used to a device that is otherwise quiescent.

Files

/usr/include/sys/scsi.h

/usr/include/sys/sdi.h

/usr/include/sys/sdi_edt.h

/usr/include/sys/sdi_comm.h

/etc/conf/pack.d/adsl/space.c

References

adsa(7), adsc(7), adse(7), adss(7), ioctl(2), scb(D4sdi), sc01(7), sd01(7), sdi(7), st01(7), sw01(7)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.