Return to tp.8 CVS log

Up to [Research Unix] / researchv10dc / man / manb

Annotation of researchv10dc/man/manb/tp.8, revision 1.1

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

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