


      AAAANNNNSSSSIIIITTTTAAAARRRR((((1111))))                   ((((RRRRiiiiddddggggeeee))))                   AAAANNNNSSSSIIIITTTTAAAARRRR((((1111))))



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

      SSSSYYYYNNNNTTTTAAAAXXXX
           aaaannnnssssiiiittttaaaarrrr [crxtvblnf] [blocksize] [labelsize] [filecount] file

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

           cccc       create a tape

           rrrr       replace (update) a tape

           xxxx       extract files

           tttt       print table of contents

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

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

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

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

           llll       use next arg as a label size

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

           RRRR       use RT11 label and name conventions

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

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

           DDDD       read variable length records (D format)

           ffff       use next argument as number of files to search for tttt
                   or xxxx 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.

      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS



      PPPPaaaaggggeeee 1111                                                   ((((9999000011110000----EEEE))))






      AAAANNNNSSSSIIIITTTTAAAARRRR((((1111))))                   ((((RRRRiiiiddddggggeeee))))                   AAAANNNNSSSSIIIITTTTAAAARRRR((((1111))))



           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

      FFFFIIIILLLLEEEESSSS
           /dev/mt??

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           tar(1), mt(7)



































      Page 2                                                   (9010-E)






      AAAANNNNSSSSIIIITTTTAAAARRRR((((1111))))                   ((((RRRRiiiiddddggggeeee))))                   AAAANNNNSSSSIIIITTTTAAAARRRR((((1111))))



      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
           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>

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

           Wild cards have not been extensively tested.

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























      Page 3                                                   (9010-E)



