User Guide

Ampex 1308911-02 5-59
libdd2 API Functions dst_status
5.19 dst_status
NAME
dst_status() - Get information on tape drive and tape cartridge.
SYNOPSIS
#include <dd2.h>
int dst_status(int fd, dst_status_st *stat);
DESCRIPTION
dst_status() returns current information on the tape drive and the tape cartridge. This
includes:
• Tape Drive - block size, state, position, results of last I/O operation, and number of bytes
in data buffer.
• Tape Cartridge - format and remaining capacity of current partition.
PARAMETERS
fd The file descriptor returned by the open call.
*stat Pointer to a structure of type
dst_status_st.
USAGE
dst_status() uses the *stat structure for both input and output.
• On input, the valid bit mask specifies which members to get information for.
• On successful return, the valid bit mask indicates which members are reporting current
status retrieved from the drive.
• If the valid bit mask is different on return, it indicates that dst_status() could not get
all of the status requested.
Before calling dst_status(), initialize the
valid bit mask appropriately.