Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP Path: utzoo!linus!decvax!microsoft!uw-beaver!cornell!vax135!floyd!harpo!utah-cs!utah-gr!thomas From: thomas@utah-gr.UUCP (Spencer W. Thomas) Newsgroups: net.sources Subject: Manual page for ansitar Message-ID: <838@utah-gr.UUCP> Date: Thu, 21-Jul-83 21:56:28 EDT Article-I.D.: utah-gr.838 Posted: Thu Jul 21 21:56:28 1983 Date-Received: Fri, 22-Jul-83 15:09:01 EDT Lines: 138 Note: I added the option for producing/decoding the Files-11 format, it is not in the distributed version. Other than that, I think this manual page accurately describes the program. =Spencer .TH ANSITAR 1 7/11/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 or directory names specifying which files are to be dumped or restored. Only files explicitly given on the command line will be dumped or restored. The file name field is only 17 characters long. .PP The function portion of the key is specified by one of the following letters: .TP 8 .B r The named files are written on the end of the tape. The .B c function implies this. .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. .TP 8 .B c Create a new tape; writing begins on the beginning of the tape instead of after the last file. This command implies .B r. .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 gives more information about the tape entries than just the name. .TP 10 .B b causes .I ansitar to use the next argument as the block size for tape records. The default is 512. .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. .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. .TP 10 .B S uses RSTS label and name conventions (same as RT11 except it uses 80 byte labels). .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 current limit on file name length is 17 characters.