scsi_worm(7) UNIX System V(SCSI Drivers) scsi_worm(7)
NAME
scsi_worm - sw01 SCSI WORM Target Driver
DESCRIPTION
sw01 is an SDI compliant WORM (Write Once Read Many) target driver that
provides access to one or more WORM drives. Each drive must be attached
to a SCSI Bus that is controlled by a SCSI Device Interface (SDI)
compliant Host Adapter driver; see, for example, scsiadaptec(7).
Access to the particular drive is accomplished via the sw01 device nodes
located in /dev/[r]worm. Each device node identifies a particular drive
based on the SCSI ID assigned to that drive. The binding between a
device node and a WORM drive is as follows:
/dev/[r]worm/wm0 WORM drive with lowest SCSI ID
/dev/[r]worm/wm1 WORM drive with next to lowest SCSI ID
and so on through /dev/[r]worm/wm7.
A WORM drive uses removable media that is divided into consecutively
numbered, fixed-size sectors that may be accessed in any order, similar
to a hard disk. Most of the standard tools for reading and writing to
and from a hard disk, such as such as dd(1) or read(2), work with a WORM
drive. However, keep in mind that for WORM drives each sector can be
written to only once. This characteristic causes problems if a WORM
device is mounted [mount(1M)] without using the Read-Only flag.
ioctl Calls
sw01 supports several ioctl functions [see ioctl(2) in the Programmer's
Reference Manual] which are accessed via the ioctl system call. Many of
the supported ioctls provide a convenient method for sending one of the
preselected SCSI commands directly to the drive. SCSI commands not
explicitly supported by sw01 can be sent to the drive via the pass-
through facility provided by the SDI Host Adapter driver. Refer to
scsi(7) for details.
The following ioctls are defined and required by the SDI interface.
BGETTYPE Returns the type of peripheral bus (for example,
scsi) used and the name of this driver (for
example, sw01).
BGETDEV Returns the major and minor number of the pass-
through device for the WORM drive. See, for
example, scsiadaptec(7) for details.
SDIRESERVE Sends a SCSI Reserve command to the drive.
SDIRELEASE Sends a SCSI Release command to the drive.
10/89 Page 1
scsi_worm(7) UNIX System V(SCSI Drivers) scsi_worm(7)
The following ioctls cause the appropriate Group-0 SCSI command to be
sent to the device. These commands are defined by the SCSI Bus
specification and should also be described in the SCSI Interface section
of the reference manual supplied with your WORM drive.
WTESTUNIT Sends a Test Unit Ready command to the device.
WREZERO Sends a Rezero Device command to the device.
WSEEK Sends a Seek command to the device.
WINQUIR Sends an Inquiry command to the device and
returns the resulting data back to the caller.
WSTARTUNIT Sends a Start Unit command to the device.
WSTOPUNIT Sends a Stop Unit command to the device.
WPREVMV Sends a Prevent Media Removal command to the
device.
WALLOMV Sends an Allow Media Removal command to the
device.
The following ioctls cause the appropriate Group-1 SCSI command to be
sent to the device. The Group-1 SCSI commands are defined by the SCSI
Bus specification and should be described in the SCSI Interface section
of the reference manual supplied with your WORM drive.
WREADCAPA Sends a Read Capacity command to the device and
returns the data sent by the drive.
WVERIFY Sends a Verify command to the device.
The following ioctls cause the appropriate Group-6 SCSI command to be
sent to the drive. Group-6 SCSI commands are vendor specific and should
be described in the SCSI Interface section of the reference manual
supplied with your drive. Since the format of these SCSI commands is
vendor specific, these ioctls are supported only by products compatible
with the Toshiba D070 .
WSTNCHECK Sends a Stand-By Check command to the device.
WLOADCART Sends a Load Cartridge command to the device.
WUNLOADCA Sends an Unload Cartridge command to the device.
WREADCB Sends a Read Control Block command to the device.
The following ioctls cause the appropriate Group-7 SCSI command to be
sent to the drive. Group-7 SCSI commands are vendor specific and should
be described in the SCSI Interface section of the reference manual
Page 2 10/89
scsi_worm(7) UNIX System V(SCSI Drivers) scsi_worm(7)
supplied with your drive. Since the format of these SCSI commands is
vendor specific, these ioctls are supported only by products compatible
with the Toshiba D070.
WCHECK Sends a Check command to the device.
WCCHECK Sends a Contrary Check command to the device.
The following ioctls are also supported the sw01 driver.
BGETSUBDEVS Returns the number of sub-devices supported by
this driver (for example, 1).
WERRMSGON Enables the sw01 related system error messages.
WERRMSGOFF Disables the sw01 related system error messages.
FILES
/usr/include/sys/sw01.h
/etc/conf/pack.d/sw01/space.c
/dev/[r]worm/wm[0-7]
/usr/include/sys/scsi.h
/usr/include/sys/sdi.h
/usr/include/sys/sdiedt.h
SEE ALSO
scsiadaptec(7), scsicdrom(7), scsidisk(7), scsidpt(7), scsitape(7),
scsiwd7000(7)
ioctl(2) in the Programme's Reference Manual
Programmer's Guide: SCSI Driver Interface (SDI)
10/89 Page 3