User Guide

Ampex 1308911-02 5-35
libdd2 API Functions dst_getparam
5.9 dst_getparam
NAME
dst_getparam() - get tape drive data block size, tape device driver debug level, and device
special file interface parameter settings.
SYNOPSIS
#include <dd2.h>
int dst_getparam(int fd, dst_param_st *parms);
DESCRIPTION
dst_getparam() reports the current tape drive block size, debug level, and device special file
interface parameter settings. The interface parameters specify default behavior for the tape
drive. They are set on each call according to the device special file selected.
For information about the tape cartridge in the drive or the results of the last I/O operation, use
the dst_status() function. To change any of the interface parameters, use the dst_setparam()
function.
dst_getparam() is available to all users.
PARAMETERS
fd The file descriptor returned by the open call.
*parms Pointer to a structure of type
dst_param_st.
USAGE
dst_getparam() uses the *parms structure for both input and output.
• On input, the valid bit mask specifies which members to get information for.
• On return, the valid bit mask indicates which members are reporting current status
retrieved from the drive or tape device driver.
• If the valid bit mask is different on return, it indicates dst_getparam() could not get
all of the status requested.
Before calling dst_getparam(), initialize the
valid bit mask appropriately.
typedef struct dst_param
{