User Guide

Ampex 1308911-02 5-1
libdd2 API Functions Introduction
Section 5
libdd2 API Functions
5.1 Introduction
This section contains the manual pages for the libdd2 API functions. All information in the
section was accurate at the time of publication, but is subject to change without notice. For the
latest information on the libdd2 API functions, see the Release Notes for your version of the
tape drive software.
5.2 DST API Overview
The libdd2 C-Library functions provide access to the DD-2 interface of the DST/DIS tape
device driver. This interface supports a large set of operations that afford program control of
all salient tape and drive operations.
5.2.1 libdd2 Functions Summary
dst_clrlog() Clear tape drive error and operational statistics.
dst_convpos() Convert tape position from structure to token or vica versa.
dst_format() Format a DD-2 tape.
dst_getdrive() Get tape drive product information, configuration and capabilities,
and tape device driver version.
dst_getdrive_ex() Get tape drive product information, configuration and extended
capabilities, and tape device driver version.
dst_getlog() Get tape drive error, operational, service, and diagnostic statistics.
dst_getparam() Get tape drive data block size, tape device driver debug level, and
device special file interface parameter settings.
dst_getpos() Get current position.
dst_getstate() Get tape drive current state.
dst_gettrace() Get a firmware trace log from the tape drive.
dst_reset() Reset the tape drive.