User Guide

vi Ampex 1308911-02
Model No.
Running Head
Addendum DST/DIS Tape Drive UNIX Programmer’s Guide
dst_setnoflush()
NAME
dst_setnoflush() - select buffered or unbuffered filemarks.
SYNOPSIS
#include <dd2.h>
int dst_setnoflush(int fd , int noflush_setting );
DESCRIPTION
dst_setnoflush() configures the
DST_NO_FLUSH
drive interface parameter which controls
whether or not the buffer is flushed to tape when filemarks are written.
•
When
DST_NO_FLUSH
is set to on, any filemarks written to tape are buffered and the
tape drive buffer is not flushed to tape on close . One exception is that if a flush buffer
command is issued (i.e., write zero filemarks), the tape drive buffer is flushed to tape
regardless of this parameter setting.
•
When
DST_NO_FLUSH
is set to off, filemarks written to tape are unbuffered and the tape
drive buffer is flushed to tape on close .
The
DST_NO_FLUSH
setting is retained until the tape drive is power off or it is changed using
this function. The default setting is off. To view the current setting, use dst_getparam() or
dd2_getparam_drive .
dst_setnoflush() is available to all users.
PARAMETERS
fd The file descriptor returned by the open call.
noflush_setting Integer value; 0 for off (default), nonzero for on.
RETURN VALUES
The return value is DST_SUCCESS (0) or DST_FAILURE (-1). See the dst_api_intro()
manual page for information on
errno
failure messages and associated DST result codes.
SEE ALSO
dst_getparam() , dd2_getparam_drive