User Guide

Ampex 1308911-02 5-67
libdd2 API Functions dst_weof
RETURN VALUES
The return value is DST_SUCCESS (0) or DST_FAILURE (-1). See “DST API Overview” on
page 5-1 for information on
errno failure messages and associated DST result codes.
1. If the tape installed is write protected, an
errno of EROFs (30) is returned and the
DST result code is set to
DstCodeWriteProt.
2. If a negative count is specified, an
errno of EINVAL (22) is returned and the DST
result code is set to
DstCodeNegativeFMCount.
3. SCSI only allows up to Oxffffff (16777215) filemarks to be written at a time. If the count
exceeds this value, an
errno of EINVAL (22) is returned and the DST result code is
set to
DstCodeBigFMCount.
4. When the
DST_ZERO_ON_EW interface parameter is not set and the user attempts to write
a filemark after early warning (EW) has been encountered, dst_weof() returns -1 and sets
errno to ENOSPC (28) to signify that the user should stop using the current partition
since it is close to full; this will occur regardless of whether the filemark is written
successfully. If the filemark is not written successfully,
errno will be set to EIO (5).
When
DST_ZERO_ON_EW is set, dst_weof() returns zero for a successfully written
filemark and -1 with
errno set to EIO (5) on failure.
SEE ALSO
dst_api_intro(), dst_weof_ex(), dd2_weof_tape