Return to tap.1 CVS log

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

Annotation of researchv10dc/dist/man/v3/man1/tap.1, revision 1.1

1.1     ! root        1: .pa 1
        !             2: .he 'TAP (I)'3/15/72'TAP (I)'
        !             3: .ti 0
        !             4: NAME           tap  --  manipulate DECtape
        !             5: .sp
        !             6: .ti 0
        !             7: SYNOPSIS       tap___  [ key ] [ name ... ]
        !             8: .sp
        !             9: .ti 0
        !            10: DESCRIPTION    tap___
        !            11: saves and restores selected portions of the file system
        !            12: hierarchy on DECtape.
        !            13: Its actions are controlled by the key___ 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: 
        !            21: The function portion of
        !            22: the key is specified by one of the following letters:
        !            23: 
        !            24: .in +6
        !            25: .ti -3
        !            26: r  The indicated files and directories, together with
        !            27: all subdirectories, are dumped
        !            28: onto the tape.
        !            29: If files with the same names
        !            30: already exist, they are replaced (hence the "r").
        !            31: "Same" is determined by string comparison, so
        !            32: "./abc" can never be the same as "/usr/dmr/abc" even
        !            33: if "/usr/dmr" is the current directory.
        !            34: If no file argument is given, "." is the default.
        !            35: 
        !            36: .ti -3
        !            37: u  updates the tape.
        !            38: u_ is the same as r_, but a file is replaced only if its
        !            39: modification date is later than the date stored on the tape;
        !            40: that is to say, if it has changed since it was dumped.
        !            41: u_ is the default command if none is given.
        !            42: 
        !            43: .ti -3
        !            44: d  deletes the named files and directories from
        !            45: the tape.  At least one file argument must be given.
        !            46: 
        !            47: .ti -3
        !            48: x  extracts the named files from the tape to the file system.
        !            49: The owner, mode, and date-modified are restored to what they
        !            50: were when the file was dumped.
        !            51: If no file argument is given, the entire contents of the
        !            52: tape are extracted.
        !            53: 
        !            54: .ti -3
        !            55: t  lists the names of all files stored on the tape which
        !            56: are the same as or are hierarchically below
        !            57: the file arguments.  If no file argument is given,
        !            58: the entire contents of the tape are tabled.
        !            59: 
        !            60: .ti -3
        !            61: l  is the same as t_ except that an expanded listing
        !            62: is produced giving all the available information about the
        !            63: listed files.
        !            64: 
        !            65: .in -6
        !            66: The following characters may be used in addition to the letter
        !            67: which selects the function desired.
        !            68: 
        !            69: .in +6
        !            70: .ti -3
        !            71: 0, ..., 7  This modifier selects the drive on which the tape is mounted.
        !            72: "0" is the default.
        !            73: 
        !            74: .ti -3
        !            75: v  Normally tap___ does its work silently.  The v_ (verbose)
        !            76: option causes it to type the name of each file it treats
        !            77: preceded by a letter to indicate what is happening.
        !            78: 
        !            79: .in +2
        !            80:  r  file is being replaced
        !            81: .nf
        !            82:  a  file is being added (not there before)
        !            83: .fi
        !            84:  x  file is being extracted
        !            85:  d  file is being deleted
        !            86: 
        !            87: .in -2
        !            88: The v_ option can be used with r_, u_, d_, and x_ only.
        !            89: 
        !            90: .ti -3
        !            91: c  means a fresh dump is being created; the tape directory
        !            92: will be zeroed before beginning.  Usable only with r_ and u_.
        !            93: 
        !            94: .ti -3
        !            95: f  causes
        !            96: new entries copied on tape to be 'fake' in that
        !            97: no data is present for these entries.
        !            98: Such fake entries cannot be extracted.
        !            99: Usable only with r_ and u_.
        !           100: 
        !           101: .ti -3
        !           102: w  causes tap___ to pause before treating each file, type
        !           103: the indicative letter and the file name (as with v_)
        !           104: and await the user's response.  Response
        !           105: "y" means "yes", so the file is treated.  Null response
        !           106: means "no", and the file does not take part
        !           107: in whatever is being done.  Response "x" means "exit";
        !           108: the tap___ command terminates immediately.  In the x_ function,
        !           109: files previously asked about
        !           110: have been extracted already.
        !           111: With r_, u_, and d_ no change has been made to the tape.
        !           112: 
        !           113: .ti -3
        !           114: m  make (create) directories during an x_ if necessary.
        !           115: .in -6
        !           116: .sp
        !           117: .ti 0
        !           118: FILES          /dev/tap?
        !           119: .sp
        !           120: .ti 0
        !           121: SEE ALSO       mt(I)
        !           122: .sp
        !           123: .ti 0
        !           124: DIAGNOSTICS    Tape open error
        !           125: .br
        !           126: Tape read error
        !           127: .br
        !           128: Tape write error
        !           129: .br
        !           130: Directory checksum
        !           131: .br
        !           132: Directory overflow
        !           133: .br
        !           134: Tape overflow
        !           135: .br
        !           136: Phase error (a file has changed after it was selected for
        !           137: dumping but before it was dumped)
        !           138: .br
        !           139: .sp
        !           140: .ti 0
        !           141: BUGS           Asks
        !           142: about "fake" entries on "xw", when it should ignore
        !           143: them.
        !           144: If a fake entry is extracted, and the file already
        !           145: exists on disk, the extraction does not take
        !           146: place (as is correct), but the mode and user ID of the file
        !           147: are set to 0.

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