TAPECNTL(C) UNIX System V
Name
tapecntl - AT&T tape control for QIC-24/QIC-02 tape device
Syntax
tapecntl [ -etrw ] [ -p arg ]
Description
tapecntl will send the optioned commands to the tape device
driver sub-device /dev/rmt/c0s0 for all commands except
``position,'' which will use sub-device /dev/rmt/c0s0n using
the ioctl command function. Sub-device /dev/rmt/c0s0
provides a rewind on close capability, while /dev/rmt/c0s0n
allows for closing of the device without rewind. Error
messages will be written to standard error.
-e erase tape
-t retension tape
-r reset tape device
-w rewind tape
-p[n] position tape to ``end of file'' mark - n
Erasing the tape causes the erase bar to be activated while
moving the tape from end to end, causing all data tracks to
be erased in a single pass over the tape.
Retensioning the tape causes the tape to be moved from end
to end, thereby repacking the tape with the proper tension
across its length.
Reset of the tape device initializes the tape controller
registers and positions the tape at the beginning of the
tape mark (BOT).
Rewinding the tape will move the tape to the BOT.
Positioning the tape command requires an integer argument.
Positioning the tape will move the tape forward relative to
its current position to the end of the specified file mark.
The positioning option used with an argument of zero will be
ignored. Illegal or out-of-range value arguments to the
positioning command will leave the tape positioned at the
end of the last valid file mark.
Options may be used individually or strung together with
selected options being executed sequentially from left to
right in the command line.
Files
/usr/lib/tape/tapecntl
/dev/rmt/c0s0n
/dev/rmt/c0s0
Notes
Exit codes and their meanings are as follows:
exit (1) device function could not initiate properly
due to misconnected cables or poorly
inserted tape cartridge.
exit (2) device function failed to complete properly
due to unrecoverable error condition, either
in the command setup or due to mechanical
failure.
exit (3) device function failed due to the cartridge
being write protected or to the lack of
written data on the tape.
exit (4) device /dev/rmt/c0s0n or /dev/rmt/c0s0
failed to open properly due to already being
opened or claimed by another process.
(printed 8/24/89) TAPECNTL(C)