User Guide

Ampex 1308911-02 5-17
libdd2 API Functions dst_format
dst_volid_t volid; /* Volume ID */
u_int asize; /* Partition A size in phys blks */
u_char acount; /* Partition A count */
u_int bsize; /* Partition B size in phys blks */
u_char bcount; /* Partition B count */
dst_fmt_layout_en layout; /* System zone layout */
u_int sz_size; /* System zone size (0 on input means use
* default size for installed tape) */
u_int spacing; /* Number of phys blks between sys zones
* (0 on input means use default spacing) */
u_char lastzone; /* Last system zone ID (read only) */
u_int lastptsz; /* Last part. sz in phys blks (read only) */
u_short lastptid; /* Last partition ID (read only) */
dst_tape_sz_en tapesize; /* Tape size (read only) */
dst_tape_type_en tapetype; /* Tape type (read only) */
} dst_format_st;
STRUCTURE MEMBERS
The members of the dst_format_st structure are defined below.
This structure type is used by both dst_format() and dst_status(). Information that pertains
only to dst_status() is identified as such. All other information is common to both functions.
flags Set to zero; no options currently supported on input. On return, indicates
whether the
lastptsz member is valid.
type Format type. Must be one of the following:
DstFmtFull - full format (preformat)
DstFmtPart - partial format, Group A only
DstFmtInit - initialized, no preformat.
volid Byte array containing the volume ID. The volume ID is intended to
uniquely identify the medium and is written to the VFI area on the tape.
This is an arbitrary 6-byte value. Each byte can be any value, except all
6 bytes cannot be binary zero.
On input, you can specify the volume ID in one of two ways:
• You can supply six or fewer printable ASCII characters. If you
supply fewer than six characters, the function left-justifies your input
string and pads the right part of the volume ID with ASCII spaces.
• You can supply a 12-digit hexadecimal number prefixed by 0x. This
number can be any value that is not all zeroes. The function does not
pad your input; you must supply all 12 digits.