User Guide

5-8 Ampex 1308911-02
Model No.
Running Head
DST API Overview libdd2 API Functions
ENOSPC Read attempted at EOD.
ETIME A timeout occurred on a SCSI command.
ENODEV The DST device is not properly connected to the host system.
• If the write operation could not be completed, this call sets errno to a value that may
include one of the following.
EIO Hardware fault or position undefined at start of operation.
EINVAL Current device data block size attribute does not match the actual data
block size of the current file section, or the current device interface
cannot use the data block size of the current file section.
ENOSPC No space left on device.
ETIME A timeout occurred on a SCSI command.
ENODEV The DST device is not properly connected to the host system.
The limited number of error definitions in the
<sys/errno.h> file requires mapping of
multiple DST drive errors onto single values. Because of this overloading, the libdd2 API
provides the dst_status() function to supply additional error information beyond that provided
by the
errno variable.
The
results member of the dst_status_st structure reports the results the of the last
I/O operation. Each result consists of a DST result code, a result class and a printable message
describing the result. The following listing summarizes the result codes that can be reported;
see the
dstio.h header file for definitions and descriptions.
DstCodeBadBlockWr Bad block written
DstCodeBadMedFmt Invalid tape format detected
DstCodeBadMedType Cartridge not supported based on coding holes
DstCodeBecomingRdy Unit in process of becoming ready
DstCodeBigFMcount Big FM count (3 bytes only)
DstCodeBOMPosErr BOM encountered unexpectedly
DstCodeBOP BOM/BOP detected
DstCodeCleanCart Cleaning cartridge is in the transport
DstCodeCmdPhaseErr Command phase error
DstCodeCmdSeqErr Command sequence error (received in wrong order)
DstCodeCopyInErr Copy in error
DstCodeCopyOutErr Copy out error
DstCodeCorruptFmt Medium tape format corrupted
DstCodeDatPhaseErr Data phase error
DstCodeDevIsInUse Device is in use by another user process
DstCodeDriveIsBusy Drive is busy