samst(7)

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.