User Guide

5-46 Ampex 1308911-02
Model No.
Running Head
dst_rewind libdd2 API Functions
5.14 dst_rewind
NAME
dst_rewind() - rewind tape to Beginning of Partition (BOP).
SYNOPSIS
#include <dd2.h>
int dst_rewind(int fd);
DESCRIPTION
dst_rewind moves the current position to the beginning of the current partition (BOP). If the
cartridge was just inserted, the current partition is assumed to be 0.
dst_rewind is available to all users.
PARAMETERS
fd The file descriptor returned by the open call.
RETURN VALUES
The return value is DST_SUCCESS (0) or DST_FAILURE (-1). See paragraph “DST API
Overview” on page 5-1 for information on
errno failure messages and associated DST
result codes.
SEE ALSO
“API Introduction” on page 5-1, dd2_rewind_tape