NAME

samst - Driver for SCSI media changers and optical drives

SYNOPSIS

samst@ target , lun : a

AVAILABILITY

SUNWsamfs

DESCRIPTION

The samst target driver is obsolete, use the sgen target driver for library control.

This driver handles embedded SCSI-2 and CCS-compatible SCSI media changers, optical drives, CD-ROM drives and non-motion I∕O for tape drives

The type of device is determined using the SCSI inquiry command.

The only I∕O supported for optical devices is raw. samst supports 512-, 1024-, 2048-, and 4096-byte sector sizes for optical media. The names of the raw files are found in ∕dev∕samst.

"Special handling during open"

If O_NDELAY or O_NONBLOCK is specified on the open, then the device does not have to be in the ready state for the open to succeed. This allows the opening of a device for initialization or to check the media type.

ERRORS

EACCES

Permission denied.

EBUSY

The device 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.

FILES

∕kernel∕drv∕samst.conf

driver configuration file

∕dev∕samst∕c n t n u n

raw files

where:

c n

controller n

t n

SCSI target id n (0-6)

u n

SCSI LUN n (0-7)

SEE ALSO

samdev(1M).

driver.conf(4).

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

DIAGNOSTICS

Error for command 'command name'	Error Level: Fatal
Requested Block n, Error  Block: m 
Sense Key: sense key name
Vendor 'vendor name': ASC = 0xa (ASC name), ASCQ = 0xb, FRU = 0xc

The command indicated by command name failed. The Requested Block is the block where the transfer started and the Error Block is the block that caused the error. Sense Key, ASC, and ASCQ information is returned by the target in response to a request sense command.

Check Condition on REQUEST SENSE

A REQUEST SENSE command completed with a check condition. The original command will be retried a number of times.

Not enough sense information

The request sense data was less than expected.

Request Sense couldn't get sense data

The REQUEST SENSE command did not transfer any data.

Reservation Conflict

The drive was reserved by another initiator.

SCSI transport failed: reason 'xxxx' : {retrying|giving up} 

The host adapter has failed to transport a command to the target for the reason stated. The driver will either retry the command or, ultimately, give up.

Unhandled Sense Key n

The REQUEST SENSE data included an invalid sense key.

Unit not Ready. Additional sense code 0xn

The drive is not ready.

device busy too long

The drive returned busy during a number of retries.

incomplete read∕write - retrying∕giving up

There was a residue after the command completed normally.

logical unit not ready

The unit is not ready.

NOTES

This driver can accept removable media devices that identify themselves as "direct access" by setting the variable samst_direct to a nonzero value. You can do this using the set command in the ∕etc∕system file (see system (4)).

Whenever a new version of StorageTek QFS or Oracle HSM is installed, the existing samst.conf file is copied to samst.conf.MMDDYY for reference and backup purposes.