User Guide

5-26 Ampex 1308911-02
Model No.
Running Head
dst_getdrive_ex libdd2 API Functions
5.7 dst_getdrive_ex
NAME
dst_getdrive_ex() - get tape drive product information, configuration and extended
capabilities, and tape device driver version.
SYNOPSIS
#include <dd2.h>
int dst_getdrive_ex(int fd, dst_drive_ex_st *drive);
DESCRIPTION
dst_getdrive_ex() reports the following:
• Tape drive product information, configuration attributes and parameter settings, extended
capabilities, and buffer size.
• Tape device driver version, release date, and current functionality (latest changes or
added features).
There is usually no need to alter the default tape drive configuration. If the need does arise,
use the dst_setdrive() function.
dst_getdrive_ex() is available to all users.
PARAMETERS
fd The file descriptor returned by the open call.
*drive Pointer to a structure of type
dst_drive_ex_st.
USAGE
dst_getdrive_ex() uses the *drive 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.
• If the valid bit mask is different on return, it indicates that dst_getdrive_ex() could
not get all of the status requested.
Before calling dst_getdrive_ex(), initialize the
valid bit mask appropriately.