


      ANSITAR(1)                 (Bull-SPS9)                 ANSITAR(1)



      NAME
           ANSITAR - a program to read and write ANSI labeled tapes

      SYNTAX
           ansitar [crxtvblnf] [blocksize] [labelsize] [filecount] file

      DESCRIPTION
           Ansitar is a program which reads and writes ANSI format
           labelled tapes.  Its options are similar to tar:

           c       create a tape

           r       replace (update) a tape

           x       extract files

           t       print table of contents

           v       set verbose mode: for crx, print names; for t print
                   labels

           0-31    select drive 0-31 (default 0)

           b       use next argument as a block size (default is 2048
                   bytes)

           B       use next argument as tape block size, and following
                   argument as line size (for blocking/unblocking)

           l       use next arg as a label size

           U       select upper(out)/lower(in) case translation of
                   names

           R       use RT11 label and name conventions

           S       use RSTS conventions (same as RT11 except 80-byte
                   labels)

           P       create/read files in "pip" (FILES-11) counted
                   format.

           D       read variable length records (D format)

           f       use next argument as number of files to search for t
                   or x options.  Ignored if file names specified.

           The filename may contain * to indicate a wild card; however,
           the asterisk should be enclosed in quotes to prevent the
           shell from interpreting it.

      EXAMPLES



      Page 1                                         (73 A2 02MTA REV1)






      ANSITAR(1)                 (Bull-SPS9)                 ANSITAR(1)



           ansitar tv               Verbose table of contents

           ansitar xvDUb 2000 file1 file2     Extract file1 and file2
           from
                               tape with 2000 bytes/block
                               and variable length records

           ansitar xv *.c                Extract all files with .c
                               extension from tape with
                               2048 byte/block

           ansitar tvf 5            List contents of first 5 files

           ansitar xvf 5            Extract the first five files

      FILES
           /dev/mt??

      SEE ALSO
           tar(1), mt(7)



































      Page 2                                         (73 A2 02MTA REV1)






      ANSITAR(1)                 (Bull-SPS9)                 ANSITAR(1)



      DIAGNOSTICS
           Many and verbose. Most are self-explanatory.

           bad block size: block size <= 0

           bad line size: line size <= 0 or not divisor of block size

           label size must be >= <int>: label size too small to hold
           header

           can't open <tapefile>: couldn't open tape device

           can't allocate buffer of <int> bytes: malloc couldn't get
           buffer

           can't allocate line buffer of <int> bytes: malloc couldn't
           get buffer

           can't create <file>

           can't open <file>

      BUGS
           Writing variable length records (D format) is not
           implemented.

           Wild cards have not been extensively tested.

      AUTHORS
           Purdue University
           Spencer Thomas, University of Utah.
           David Brown, Varian























      Page 3                                         (73 A2 02MTA REV1)



