Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
6. Standards, Environment, and Macros (Man Pages Section 5)
NAME samst - Driver for SCSI media changers and optical drives SYNOPSIS samst@target,lun:a AVAILABILITY SUNWsamfs DESCRIPTION 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 com- mand. 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 ini- tialization 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 sup- port the requested ioctl function. ENXIO During opening, the device did not exist. FILES /kernel/drv/samst.conf driver configuration file /dev/samst/cntnun raw files where: cn controller n tn SCSI target id n (0-6) un 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 = 0x<a> (<ASC name>), ASCQ = 0x<b>, FRU = 0x<c> 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 condi- tion. 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 0x<n> 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 nor- mally. 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 Sun QFS or SAM-QFS is installed, the existing samst.conf file is copied to samst.conf.MMDDYY for reference and backup purposes.