Return to ansitape.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / ansi

Annotation of 43BSDReno/contrib/ansi/ansitape.1, revision 1.1

1.1     ! root        1: .TH ANSITAPE LOCAL "4/10/85 UCB Local"
        !             2: .SH NAME
        !             3: ansitape - ANSI standard tape handler
        !             4: .SH SYNOPSIS
        !             5: .B ansitape
        !             6: [key] [keyargs] [files]
        !             7: .SH DESCRIPTION
        !             8: .I Ansitape
        !             9: reads and writes magnetic tapes written in
        !            10: ANSI standard format
        !            11: (called ``Files-11'' by DEC).
        !            12: Tapes written by
        !            13: .I ansitape
        !            14: are labeled with the first 6 characters of the machine name by default.
        !            15: Actions are controlled by the
        !            16: .I key
        !            17: argument.
        !            18: The
        !            19: .I key
        !            20: is a string of characters containing at
        !            21: most one function letter.
        !            22: Other arguments to the command are
        !            23: a tape label and file names specifying which files are
        !            24: to be written onto or extracted from the tape.
        !            25: .PP
        !            26: The function portion of the key is
        !            27: specified by one of the following letters:
        !            28: .TP 8
        !            29: .B r
        !            30: The named files are written at the end of the tape.
        !            31: The
        !            32: .B c
        !            33: function implies this.
        !            34: .TP 8
        !            35: .B x
        !            36: The named files are extracted from the tape.
        !            37: If no file argument is given,
        !            38: the entire contents of the tape is extracted.
        !            39: Note that if the tape has duplicated file names,
        !            40: only the last file of a given name can
        !            41: be extracted.
        !            42: .TP 8
        !            43: .B t
        !            44: The names of the specified files are listed
        !            45: each time they occur on the tape.
        !            46: If no file argument is given,
        !            47: all files on the tape are listed.
        !            48: .TP 8
        !            49: .B c
        !            50: Create a new tape; writing begins at the
        !            51: beginning of the tape instead of after
        !            52: the last file.
        !            53: This command implies
        !            54: .B r.
        !            55: .PP
        !            56: The following characters may be used in
        !            57: addition to the letter which selects
        !            58: the function desired.
        !            59: .TP 8
        !            60: .B f
        !            61: This argument allows the selection of a different tape
        !            62: device.  
        !            63: The next word in the keyargs list is taken to be
        !            64: the full name of a device to write the tape on.
        !            65: The default is /dev/rmt12.
        !            66: .TP 8
        !            67: .B n
        !            68: The
        !            69: .B n
        !            70: option allows the user to specify as the next argument in the keyargs list,
        !            71: a control file 
        !            72: containing the names of files to put on the tape.  
        !            73: If the file name is '-', the control file will, instead, be read
        !            74: from standard input.
        !            75: The control file contains one line for each file
        !            76: to be placed on the tape.
        !            77: Each line has two names, the name of the file on
        !            78: the local machine, and the name it is to have when
        !            79: placed on the tape.  This allows for more convenient
        !            80: flattening of hierarchies when placing them on tape.
        !            81: If the second name is omitted, the UNIX file name will be
        !            82: used on the tape also.
        !            83: This argument can only be used with the 
        !            84: .B r 
        !            85: and 
        !            86: .B c
        !            87: functions.
        !            88: .TP 8
        !            89: .B l
        !            90: The 
        !            91: .B l
        !            92: option allows the user to specify the label to be placed on the tape. 
        !            93: The next argument in the keyargs list is taken as the tape label, which
        !            94: will be space padded or truncated to six characters.
        !            95: This option is meaningless unless 
        !            96: .B c
        !            97: is also specified.
        !            98: .TP 8
        !            99: .B v
        !           100: Normally
        !           101: .I ansitape
        !           102: works relatively silently.
        !           103: The
        !           104: .B v
        !           105: (verbose) option causes it to type 
        !           106: information about each file as it processes it.
        !           107: .TP 8
        !           108: .B b
        !           109: The
        !           110: .B b
        !           111: option allows the user to select the blocksize to be used for the
        !           112: tape.
        !           113: By default,
        !           114: .I ansitape
        !           115: uses the maximum block size permitted by the ANSI standard, 2048.
        !           116: Some systems will permit a much larger block size, and if large
        !           117: files are being put on the tape it may be advantageous to do so.
        !           118: .I Ansitape
        !           119: will take the next argument of the keyargs list as the blocksize for the tape.
        !           120: Values below 18 or above 32k will be limited to that range.
        !           121: The standard scale factors b=512 and k=1024 are accepted.
        !           122: .TP 8
        !           123: .B F
        !           124: The 
        !           125: .B F
        !           126: flag allows
        !           127: .I ansitape
        !           128: to write ansi 'D' format fixed record length tapes.
        !           129: The next two keyargs must be the recordsize and blocksize to be used,
        !           130: with the same scale factors and range limits as for the
        !           131: .B b
        !           132: option.
        !           133: The files to be written by the
        !           134: .B F
        !           135: flag must be in fixed format on the unix end - all lines should be
        !           136: .I EXACTLY
        !           137: .B recordsize
        !           138: bytes long plus a terminating newline (which will be discarded).
        !           139: Note that this is exactly the same format produced by
        !           140: .I ansitape
        !           141: when reading an ansi 'D' format tape.
        !           142: .PP
        !           143: .I Ansitape
        !           144: will not copy directories, character or block special files,
        !           145: symbolic links, sockets, or binary executables.  
        !           146: Attempts to put these on tape will result in warnings, and they will
        !           147: be skipped completely.
        !           148: .SH FILES
        !           149: /dev/rmt12
        !           150: .br
        !           151: .SH DIAGNOSTICS
        !           152: A warning message will be generated when a record exceeds the maximum record
        !           153: length and the affected file will be truncated.
        !           154: .br
        !           155: .SH BUGS
        !           156: Ansitape quietly truncates names longer than 17 characters.
        !           157: .br
        !           158: Multivolume tapes can be read (provided no files cross the
        !           159: volume boundary) but not written.
        !           160: .br

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.