Return to tap.1 CVS log

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

Annotation of researchv10dc/dist/man/v4/manx/tap.1, revision 1.1

1.1     ! root        1: .th TAP I 3/15/72
        !             2: .sh NAME
        !             3: tap  \*-  manipulate DECtape
        !             4: .sh SYNOPSIS
        !             5: .bd tap
        !             6: [ key ] [ name ... ]
        !             7: .sh DESCRIPTION
        !             8: .it tap
        !             9: saves and restores selected portions of the file system
        !            10: hierarchy on DECtape.
        !            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 tabled.
        !            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: \fBc\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   \fRdeletes the named files and directories from
        !            48: the tape.  At least one file argument must be given.
        !            49: .s3
        !            50: .lp +8 4
        !            51: \fBx\fR        extracts the named files from the tape to the file system.
        !            52: The owner, mode, and date-modified are restored to what they
        !            53: were when the file was dumped.
        !            54: If no file argument is given, the entire contents of the
        !            55: tape are extracted.
        !            56: .s3
        !            57: .lp +8 4
        !            58: \fBt\fR        lists the names of all files stored on the tape which
        !            59: are the same as or are hierarchically below
        !            60: the file arguments.  If no file argument is given,
        !            61: the entire contents of the tape are tabled.
        !            62: .s3
        !            63: .lp +8 4
        !            64: \fBl\fR        is the same as
        !            65: .bd t
        !            66: except that an expanded listing
        !            67: is produced giving all the available information about the
        !            68: listed files.
        !            69: .s3
        !            70: .i0
        !            71: The following characters may be used in addition to the letter
        !            72: which selects the function desired.
        !            73: .s3
        !            74: .lp +10 6
        !            75: \fB0,...,7\fR  This
        !            76: modifier selects the drive on which the tape is mounted.
        !            77: `0' is the default.
        !            78: .s3
        !            79: .lp +10 6
        !            80: \fBv\fR        Normally
        !            81: .it tap
        !            82: does its work silently.  The
        !            83: .bd v
        !            84: (verbose)
        !            85: option causes it to type the name of each file it treats
        !            86: preceded by a letter to indicate what is happening.
        !            87: .s3
        !            88: .lp +13 3
        !            89: \fBr\fR        file is being replaced
        !            90: .lp +13 3
        !            91: \fBa\fR        file is being added (not there before)
        !            92: .lp +13 3
        !            93: \fBx\fR        file is being extracted
        !            94: .lp +13 3
        !            95: \fBd\fR        file is being deleted
        !            96: .s3
        !            97: .lp +10 6
        !            98:        The
        !            99: .bd v
        !           100: option can be used with
        !           101: .bd "r, u, d,"
        !           102: and
        !           103: .bd x
        !           104: only.
        !           105: .s3
        !           106: .lp +10 6
        !           107: \fBc\fR        means a fresh dump is being created; the tape directory
        !           108: will be zeroed before beginning.  Usable only with
        !           109: .bd r
        !           110: and
        !           111: .bd u.
        !           112: .s3
        !           113: .lp +10 6
        !           114: \fBf\fR        causes new entries on tape to be `fake' in that
        !           115: no data is present for these entries.
        !           116: Such fake entries cannot be extracted.
        !           117: Usable only with
        !           118: .bd r
        !           119: and
        !           120: .bd u.
        !           121: .s3
        !           122: .lp +10 6
        !           123: \fBw\fR        causes
        !           124: .it tap
        !           125: to pause before treating each file, type
        !           126: the indicative letter and the file name (as with v)
        !           127: and await the user's response.  Response
        !           128: .bd y
        !           129: means `yes', so the file is treated.  Null response
        !           130: means `no', and the file does not take part
        !           131: in whatever is being done.  Response
        !           132: .bd x
        !           133: means `exit';
        !           134: the
        !           135: .it tap
        !           136: command terminates immediately.  In the
        !           137: .bd x
        !           138: function,
        !           139: files previously asked about
        !           140: have been extracted already.
        !           141: With
        !           142: .bd "r, u,"
        !           143: and
        !           144: .bd d
        !           145: no change has been made to the tape.
        !           146: .s3
        !           147: .i0
        !           148: .sh FILES
        !           149: /dev/tap?
        !           150: .sh "SEE ALSO"
        !           151: mt(I)
        !           152: .sh DIAGNOSTICS
        !           153: Several; the non-obvious one is
        !           154: `Phase error', which means the file changed after it was selected for
        !           155: dumping but before it was dumped.
        !           156: .sh BUGS
        !           157: Asks
        !           158: about fake entries on \fBxw\fR, when it should ignore
        !           159: them.
        !           160: If a fake entry is extracted, and the file already
        !           161: exists on disk, the extraction does not take
        !           162: place (as is correct), but the mode and user ID of the file
        !           163: are set to 0.

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