User Guide

Ampex 1308911-02 5-47
libdd2 API Functions dst_setdrive
5.15 dst_setdrive
NAME
dst_setdrive() - changes tape drive configuration parameters.
SYNOPSIS
#include <dd2.h>
int dst_setdrive(int fd, dst_drive_st *drive);
DESCRIPTION
dst_setdrive() changes the specified tape drive configuration parameters to the values
requested.
dst_setdrive() is available to all users.
PARAMETERS
fd The file descriptor returned by the open call.
*drive Pointer to a structure of type
dst_drive_st.
USAGE
dst_setdrive() uses the *drive structure for both input and output.
• On input, the valid bit mask indicates which members specify configuration parameter
changes for the drive.
• On successful return, the valid bit mask identifies the members for which changes
were made.
• If the valid bit mask is different on return, it indicates that dst_setdrive() could not
make all of the changes requested. To check the current configuration parameter settings,
use the dst_getdrive() function.
Before calling dst_setdrive(), initialize the appropriate *drive structure members with new
values for the configuration parameters you want to change, and set the
valid bit mask
accordingly.
typedef struct
{
u_int valid; /* Valid members - see defines above */
u_int config; /* Drive configuration attributes */