Return to tp.1 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v4 / man1

Annotation of researchv10dc/dist/man/v4/man1/tp.1, revision 1.1

1.1     ! root        1: .th TP I 10/15/73
        !             2: .sh NAME
        !             3: tp  \*-  manipulate DECtape and magtape
        !             4: .sh SYNOPSIS
        !             5: .bd tp
        !             6: [ key ] [ name ... ]
        !             7: .sh DESCRIPTION
        !             8: .it Tp
        !             9: saves and restores selected portions of the file system
        !            10: hierarchy on DECtape or mag tape.
        !            11: Its actions are controlled by the
        !            12: .it key
        !            13: argument.
        !            14: The key is a string of characters containing
        !            15: at most one function letter and possibly
        !            16: one or more function modifiers.
        !            17: Other arguments to the command are file or directory
        !            18: names specifying which files are to be dumped, restored,
        !            19: or listed.
        !            20: .s3
        !            21: The function portion of
        !            22: the key is specified by one of the following letters:
        !            23: .s3
        !            24: .lp +8 4
        !            25: \fBr\fR        The indicated files and directories, together with
        !            26: all subdirectories, are dumped
        !            27: onto the tape.
        !            28: If files with the same names
        !            29: already exist, they are replaced.
        !            30: `Same' is determined by string comparison, so
        !            31: `./abc' can never be the same as `/usr/dmr/abc' even
        !            32: if `/usr/dmr' is the current directory.
        !            33: If no file argument is given, `\fB.\fR' is the default.
        !            34: .s3
        !            35: .lp +8 4
        !            36: \fBu\fR        updates the tape.
        !            37: .bd u
        !            38: is the same as
        !            39: .bd r,
        !            40: but a file is replaced only if its
        !            41: modification date is later than the date stored on the tape;
        !            42: that is to say, if it has changed since it was dumped.
        !            43: .bd u
        !            44: is the default command if none is given.
        !            45: .s3
        !            46: .lp +8 4
        !            47: \fBd\fR        deletes the named files and directories from
        !            48: the tape.  At least one file argument must be given.
        !            49: This function is not permitted on magtapes.
        !            50: .s3
        !            51: .lp +8 4
        !            52: \fBx\fR        extracts the named files from the tape to the file system.
        !            53: The owner, mode, and date-modified are restored to what they
        !            54: were when the file was dumped.
        !            55: If no file argument is given, the entire contents of the
        !            56: tape are extracted.
        !            57: .s3
        !            58: .lp +8 4
        !            59: \fBt\fR        lists the names of all files stored on the tape which
        !            60: are the same as or are hierarchically below
        !            61: the file arguments.  If no file argument is given,
        !            62: the entire contents of the tape is listed.
        !            63: .s3
        !            64: .i0
        !            65: The following characters may be used in addition to the letter
        !            66: which selects the function desired.
        !            67: .s3
        !            68: .lp +10 6
        !            69: \fBm\fR        Specifies magtape as opposed to DECtape.
        !            70: .s3
        !            71: .lp +10 6
        !            72: \fB0,...,7\fR  This
        !            73: modifier selects the drive on which the tape is mounted.
        !            74: For DECtape, `x' is default; for magtape
        !            75: `0' is the default.
        !            76: .s3
        !            77: .lp +10 6
        !            78: \fBv\fR        Normally
        !            79: .it tp
        !            80: does its work silently.  The
        !            81: .bd v
        !            82: (verbose)
        !            83: option causes it to type the name of each file it treats
        !            84: preceded by the function letter.
        !            85: With the
        !            86: .bd t
        !            87: function,
        !            88: .bd v
        !            89: gives more information about the
        !            90: tape entries than just the name.
        !            91: .s3
        !            92: .lp +10 6
        !            93: \fBc\fR        means a fresh dump is being created; the tape directory
        !            94: will be zeroed before beginning.  Usable only with
        !            95: .bd r
        !            96: and
        !            97: .bd u.
        !            98: This option is assumed with magtape since
        !            99: it is impossible to selectively overwrite
        !           100: magtape.
        !           101: .s3
        !           102: .lp +10 6
        !           103: \fBf\fR        causes new entries on tape to be `fake' in that
        !           104: no data is present for these entries.
        !           105: Such fake entries cannot be extracted.
        !           106: Usable only with
        !           107: .bd r
        !           108: and
        !           109: .bd u.
        !           110: .s3
        !           111: .lp +10 6
        !           112: \fBi\fR        Errors reading and writing the
        !           113: tape are noted, but no action is taken.
        !           114: Normally, errors cause a return to the command level.
        !           115: .s3
        !           116: .lp +10 6
        !           117: \fBw\fR        causes
        !           118: .it tp
        !           119: to pause before treating each file, type
        !           120: the indicative letter and the file name (as with v)
        !           121: and await the user's response.  Response
        !           122: .bd y
        !           123: means `yes', so the file is treated.  Null response
        !           124: means `no', and the file does not take part
        !           125: in whatever is being done.  Response
        !           126: .bd x
        !           127: means `exit';
        !           128: the
        !           129: .it tp
        !           130: command terminates immediately.  In the
        !           131: .bd x
        !           132: function,
        !           133: files previously asked about
        !           134: have been extracted already.
        !           135: With
        !           136: .bd "r, u,"
        !           137: and
        !           138: .bd d
        !           139: no change has been made to the tape.
        !           140: .s3
        !           141: .i0
        !           142: .sh FILES
        !           143: /dev/tap?
        !           144: .br
        !           145: /dev/mt?
        !           146: .sh DIAGNOSTICS
        !           147: Several; the non-obvious one is
        !           148: `Phase error', which means the file changed after it was selected for
        !           149: dumping but before it was dumped.
        !           150: .sh BUGS

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