Return to tp.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / old / tp

Annotation of 43BSDReno/old/tp/tp.1, revision 1.1

1.1     ! root        1: .\"    @(#)tp.1        6.1 (Berkeley) 4/29/85
        !             2: .\"
        !             3: .TH TP 1 "April 29, 1985"
        !             4: .AT 3
        !             5: .SH NAME
        !             6: tp \- manipulate tape archive
        !             7: .SH SYNOPSIS
        !             8: .B tp
        !             9: [ key ] [ name ... ]
        !            10: .SH DESCRIPTION
        !            11: .PP
        !            12: .I Tp
        !            13: saves and restores files
        !            14: on DECtape or magtape.
        !            15: Its actions are controlled by the
        !            16: .I key
        !            17: argument.
        !            18: The key is a string of characters containing
        !            19: at most one function letter and possibly
        !            20: one or more function modifiers.
        !            21: Other arguments to the command are file or directory
        !            22: names specifying which files are to be dumped, restored,
        !            23: or listed.
        !            24: In all cases, appearance of a directory name refers to
        !            25: the files and (recursively) subdirectories of that directory.
        !            26: .PP
        !            27: The function portion of
        !            28: the key is specified by one of the following letters:
        !            29: .TP 8
        !            30: .B  r
        !            31: The named files
        !            32: are written
        !            33: on the tape.
        !            34: If files with the same names
        !            35: already exist, they are replaced.
        !            36: `Same' is determined by string comparison, so
        !            37: `./abc' can never be the same as `/usr/dmr/abc' even
        !            38: if `/usr/dmr' is the current directory.
        !            39: If no file argument is given, `\fB.\fR' is the default.
        !            40: .TP 8
        !            41: .B  u
        !            42: updates the tape.
        !            43: .B u
        !            44: is like
        !            45: .B r,
        !            46: but a file is replaced only if its
        !            47: modification date is later than the date stored on the tape;
        !            48: that is to say, if it has changed since it was dumped.
        !            49: .B u
        !            50: is the default command if none is given.
        !            51: .TP 8
        !            52: .B  d
        !            53: deletes the named files from
        !            54: the tape.
        !            55: At least one name argument must be given.
        !            56: This function is not permitted on magtapes.
        !            57: .TP 8
        !            58: .B  x
        !            59: extracts the named files from the tape to the file system.
        !            60: The owner and mode are restored.
        !            61: If no file argument is given, the entire contents of the
        !            62: tape are extracted.
        !            63: .TP 8
        !            64: .B  t
        !            65: lists the names of the specified files.
        !            66: If no file argument is given,
        !            67: the entire contents of the tape is listed.
        !            68: .PP
        !            69: The following characters may be used in addition to the letter
        !            70: which selects the function desired.
        !            71: .TP 10
        !            72: .B  m
        !            73: Specifies magtape as opposed to DECtape.
        !            74: .TP 10
        !            75: .B  0,...,7
        !            76: This
        !            77: modifier selects the drive on which the tape is mounted.
        !            78: For DECtape, 
        !            79: .B x
        !            80: is default; for magtape
        !            81: `0' is the default.
        !            82: .TP 10
        !            83: .B  v
        !            84: Normally
        !            85: .I tp
        !            86: does its work silently.
        !            87: The
        !            88: .B v
        !            89: (verbose)
        !            90: option causes it to type the name of each file it treats
        !            91: preceded by the function letter.
        !            92: With the
        !            93: .B t
        !            94: function,
        !            95: .B v
        !            96: gives more information about the
        !            97: tape entries than just the name.
        !            98: .TP 10
        !            99: .B  c
        !           100: means a fresh dump is being created; the tape directory
        !           101: is cleared before beginning.
        !           102: Usable only with
        !           103: .B r
        !           104: and
        !           105: .B u.
        !           106: This option is assumed with magtape since
        !           107: it is impossible to selectively overwrite
        !           108: magtape.
        !           109: .TP 10
        !           110: .B  i
        !           111: Errors reading and writing the
        !           112: tape are noted, but no action is taken.
        !           113: Normally, errors cause a return to the command level.
        !           114: .TP 10
        !           115: .B f
        !           116: Use the first named file, rather than a tape,
        !           117: as the archive.
        !           118: This option currently acts like 
        !           119: .BR m ;
        !           120: .I i.e.
        !           121: .BR r
        !           122: implies 
        !           123: .BR c ,
        !           124: and neither
        !           125: .BR d
        !           126: nor
        !           127: .BR u
        !           128: are permitted.
        !           129: .TP 10
        !           130: .B  w
        !           131: causes
        !           132: .I tp
        !           133: to pause before treating each file, type
        !           134: the indicative letter and the file name (as with
        !           135: .BR v )
        !           136: and await the user's response.
        !           137: Response
        !           138: .B y
        !           139: means `yes', so the file is treated.
        !           140: Null response
        !           141: means `no', and the file does not take part
        !           142: in whatever is being done.
        !           143: Response
        !           144: .B x
        !           145: means `exit';
        !           146: the
        !           147: .I tp
        !           148: command terminates immediately.
        !           149: In the
        !           150: .B x
        !           151: function,
        !           152: files previously asked about
        !           153: have been extracted already.
        !           154: With
        !           155: .B "r, u,"
        !           156: and
        !           157: .B d
        !           158: no change has been made to the tape.
        !           159: .PP
        !           160: .SH FILES
        !           161: /dev/tap?
        !           162: .br
        !           163: /dev/rmt?
        !           164: .SH SEE ALSO
        !           165: ar(1), tar(1)
        !           166: .SH DIAGNOSTICS
        !           167: Several; the non-obvious one is
        !           168: `Phase error', which means the file changed after it was selected for
        !           169: dumping but before it was dumped.
        !           170: .SH BUGS
        !           171: A single file with several links to it is treated like several files.
        !           172: .PP
        !           173: Binary-coded control information makes
        !           174: magnetic tapes written by
        !           175: .I tp
        !           176: difficult to carry to other machines;
        !           177: .IR tar (1)
        !           178: avoids the problem.

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