User Guide

Ampex 1308911-02 5-19
libdd2 API Functions dst_format
DstWaste - Does not allocate partitions across system zones. Instead,
allocates each partition with exactly the specified size, wasting any
space between the end of the partition and the system zone if there’s not
enough room for another partition before the system zone. If there is not
enough space for a full partition between the last system zone and EOT,
the remaining space is not used.
DstAlternate - Puts a system zone between every partition and no
system zones inside of any partition. If there is not enough space for a
full partition between the last system zone and EOT, the remaining
space is not used.
DstNoZones - Formats the tape without system zones.
DstDisFmt - (Read Only) Indicates a DIS formatted tape is loaded in
the drive.
sz_size System zone size in physical blocks; valid only if the layout member
is not
DstNoZones. If zero, dst_format() uses the default system zone
size matching the cartridge size of the loaded tape. The defaults are the
same as the minimum allowed values and are given by the
DST_MIN_SMALL_SZSIZE, DST_MIN_MEDIUM_SZSIZE, and
DST_MIN_LARGE_SZSIZE symbolic constants in the dstioctl.h
header file.
spacing Number of physical blocks between system zones; valid only if the
layout member is not DstAlternate. Must be zero or at least
DST_MIN_SYSTEM_ZONE_SPACING. If zero, dst_format() uses the
default system zone spacing matching the cartridge size of the loaded
tape. The defaults are given by the
DST_DEF_SMALL_SZSP,
DST_DEF_MEDIUM_SZSP, and DST_DEF_LARGE_SZSP symbolic
constants in the
dstioctl.h header file.
lastzone (Read Only) Specifies the ID of the last system zone on the tape. System
zones are numbered starting with zero. Only valid for fully preformatted
tapes.
lastptsz (Read Only) Specifies the size of the last partition on the tape.
lastptid (Read Only) Specifies the partition ID of the last partition on the tape.
Partitions are numbered starting with zero. Only valid for fully
preformatted tapes.