Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ssd(7) — SunOS 5.4

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

format(1M)

ioctl(2)

lseek(2)

read(2)

write(2)

driver.conf(4)

cdio(7)

dkio(7)

esp(7)

isp(7)

ssd(7)

NAME

ssd − driver for SPARC Storage Array disk devices

SYNOPSIS

ssd@port,target:partition

DESCRIPTION

This driver handles disks in the SPARC Storage Array. 

The SPARC Storage Array disk aray device.  It houses thirty SCSI disks controlled by six internal SCSI controllers. The SCSI controllers are controlled by a central processor on the SAPRC Storage Array.  The SPARC Storage Array also includes non-volatile RAM for the caching of disk data.  The Sparc Storage Array interfaces to a host system via a Fibre Channel Interface.  The Fibre Channel interface to the Host system is through an SBus card called a SOC card.  Each SOC card supports two Fibre channel connections. 

The The SPARC Storage Array currently supports fixed media 1Gb disk drives.  The specific type of each disk in the SPARC Storage Array is determined by issuing a SCSI inquiry command and reading the volume label stored on block 0 of the drive.  The volume label describes the disk geometry and partitioning; it must be present or the disk cannot be mounted by the system. 

The block-files access the disk using the system’s normal buffering mechanism and are read and written without regard to physical disk records.  There is also a “raw” interface that provides for direct transmission between the disk and the user’s read or write buffer.  A single read or write call usually results in one I/O operation; raw I/O is therefore considerably more efficient when many bytes are transmitted.  The names of the block files are found in /dev/dsk; the names of the raw files are found in /dev/rdsk. 

I/O requests (such as lseek(2)) to the SCSI disk must have an offset that is a multiple of 512 bytes (DEV_BSIZE), or the driver returns an EINVAL error.  If the transfer length is not a multiple of 512 bytes, the transfer count is rounded up by the driver. 

Partition 0 is normally used for the root file system on a disk, partition 1 as a paging area (for example, swap), and partition 2 for backing up the entire disk.  Partition 2 normally maps the entire disk and may also be used as the mount point for secondary disks in the system.  The rest of the disk is normally partition 6.  For the primary disk, the user file system is located here. 

Ioctls

Refer to dkio(7). 

ERRORS

EACCES Permission denied. 

EBUSY The partition was opened exclusively by another thread. 

EFAULT The argument was a bad address. 

EINVAL Invalid argument. 

EIO   An I/O error occurred. 

ENOTTY This indicates that the device does not support the requested ioctl function. 

ENXIO During opening, the device did not exist. 

EROFS The device is a read-only device. 

FILES

ssd.conf driver configuration file

/dev/dsk/cntndnsn
block files

/dev/rdsk/cntndnsn
raw files

where:

cn SOC Port n

tn SCSI controller within the SPARC Storage Array n (0-6)

dn SCSI target n (0-7)

sn partition n (0-7)

SEE ALSO

format(1M), ioctl(2), lseek(2), read(2), write(2), driver.conf(4), cdio(7), dkio(7), esp(7), isp(7)

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

SunOS 5.4  —  Last change: 19 Oct 1994

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026