User Guide

Ampex 1308911-02 5-25

libdd2 API Functions dst_getdrive

** No terminating NULs are guaranteed, so use counts

with any string ops!

typedef struct

{

char vendor[8]; /* DST tape drive vendor name */

char product[16]; /* DST tape drive product name */

char rcfver[4]; /* RCF firmware version */

char tcfver[4]; /* TCF firmware version */

char pcfver[4]; /* PCF firmware version */

char systemrev[8]; /* System revision number */

char serialnum[4]; /* System serial number */

char mfgid[16]; /* Manufacturer's ID */

u_char transport; /* Transport type */

char ibsboard[20]; /* IBS board info */

char sbcboard[20]; /* SBC board info */

char eccboard[20]; /* ECC board info */

char eqltboard[20]; /* EQ/TL board info */

char astctlboard[20]; /* AST/CTL board info */

char mdaboard[20]; /* Servo MDA board info */

} dst_tdver_st;

capability A bit mask of tape drive capabilities (see the dstio.h file for details).

bufsize Tape drive data buffer size in bytes.

RETURN VALUES

The return value is DST_SUCCESS (0) or DST_FAILURE (-1). See paragraph 5.2 for

information on

errno failure messages and associated DST result codes.

EXAMPLE

The following is an example of how to call the dst_getdrive() function:

** get drive configuration

d2_drive.valid = DST_CFG_VALID;

if (dst_getdrive(fd, &d2_drive))

{

perror ("dst_getdrive() failed");

exit (1);

}

printf("getdrive config: 0x%x ...\n", d2_drive.config);