.TH ANSITAR 1 7/26/83
.UC 4
.SH NAME
ansitar \- ANSI format tape archiver
.SH SYNOPSIS
.B ansitar
[ key ] [ name ... ]
.SH DESCRIPTION
.PP
.I Ansitar
saves and restores files
on magtape in ANSI format.
Its actions are controlled by the
.I key
argument.
The
.I key
is a string of characters containing
at most one function letter and possibly
one or more function modifiers.
Other arguments to the command are file 
names specifying which files are to be dumped or restored.
Only files explicitly given on the command line will be dumped or restored.
.PP
The function portion of
the key is specified by one of the following letters:
.TP 8
.B  c
Create a new tape; writing begins on the beginning
of the tape instead of after the last file.
.TP 8
.B  r
The named files
are written
on the end of the tape.
.TP 8
.B  x
The named files are extracted from the tape.
If no file argument is given, the entire content of the
tape is extracted.
Note that if multiple entries specifying the same file
are on the tape, the last one overwrites
all earlier.
.TP 8
.B  t
The names of the specified files are listed each time they occur
on the tape.
If no file argument is given,
all of the names on the tape are listed.
.PP
The following characters may be used in addition to the letter
which selects the function desired.
.TP 10
.B  0,...,7
This
modifier selects an alternate drive on which the tape is mounted.
(The default is drive 0 at 1600 bpi, which is normally /dev/rmt8.)
.TP 10
.B  w
causes
.I ansitar
to print the action to be taken followed by file name, then
wait for user confirmation. If a word beginning with `y'
is given, the action is performed. Any other input means
don't do it.
.TP 10
.B  v
Normally
.I ansitar
does its work silently.
The
.B v
(verbose)
option causes it to type the name of each file it treats
preceded by the function letter.
With the
.B t
function,
.B v
causes the file labels to be typed.
.TP 10
.B b
causes
.I ansitar
to use the next argument as the block size for tape
records. The default is 512 bytes.
.TP 10
.B B
is used to specify a block size and a line size for fixed length records.
The first argument following is the block size and the next is the line
size.  The line size must divide the block size evenly.
.TP 10
.B l
causes the next argument to be used as a label size.
The default is 80 bytes.
.TP 10
.B U
forces file names to be translated to upper case when writing the tape, and
to lower case when reading it.
.TP 10
.B R
causes
.I ansitar
to use RT-11 label and name conventions.
(l=512, b=512, U)
.TP 10
.B S
use RSTS label and name conventions (l=80, b=512, U) 
.TP 10
.B V
set ANSI volume serial number.  Default 1.
.TP 10
.B P
causes translation to and from "pip" format.  This format is really the
FILES-11 text file variable-blocked format, and is useful when transferring
text files to/from a VMS or RSX system.  When using P format, lines longer
than 508 bytes will not be handled properly.  Also, the blocksize must be a
multiple of 512 bytes (should really be 512 bytes).
.PP
.SH FILES
/dev/rmt?
.SH DIAGNOSTICS
Complaints about bad key characters and tape read/write errors.
.SH BUGS
There is no way to ask for the
.IR n -th
occurrence of a file.
.br
Tape errors are handled ungracefully.
.br
The UNIX limit on file name length is 17 characters.
.br
File name translation to RT11
can't cope with more than one `.' in the name,
nor with other funny characters like `\(ru'.
.br
Block size and line size must both be an even number of bytes.
This is not enforced.