Return to mt.1 CVS log

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

Annotation of researchv10dc/dist/man/v4/manx/mt.1, revision 1.1.1.1

1.1       root        1: .th MT I 6/12/72
                      2: .sh NAME
                      3: mt  \*-  manipulate magtape
                      4: .sh SYNOPSIS
                      5: .bd mt
                      6: [ key ] [ name ... ]
                      7: .sh DESCRIPTION
                      8: .it mt
                      9: saves and restores selected portions of the file system
                     10: hierarchy on magtape.
                     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 +3 3
                     25: \fBr\fR        The indicated files and directories, together with
                     26: all subdirectories, are dumped
                     27: onto the tape.
                     28: The old contents of the tape are lost.
                     29: If no arguments are given,
                     30: .bd r
                     31: is the default.
                     32: .s3
                     33: .lp +3 3
                     34: \fBx\fR        extracts the named files from the tape to the file system.
                     35: The owner, mode, and date-modified are restored to what they
                     36: were when the file was dumped.
                     37: If no file argument is given, the entire contents of the
                     38: tape are extracted.
                     39: .s3
                     40: .lp +3 3
                     41: \fBt\fR        lists the names of all files stored on the tape which
                     42: are the same as or are hierarchically below
                     43: the file arguments.  If no file argument is given,
                     44: the entire contents of the tape are tabled.
                     45: .s3
                     46: .lp +3 3
                     47: \fBl\fR        is the same as
                     48: .bd t
                     49: except that an expanded listing
                     50: is produced giving all the available information about the
                     51: listed files.
                     52: .s3
                     53: .i0
                     54: The following characters may be used in addition to the letter
                     55: which selects the function desired.
                     56: .s3
                     57: .lp +8 8
                     58: \fB0,|...,|7\fR        This modifier selects the drive on which the tape is mounted.
                     59: .bd 0
                     60: is the default.
                     61: .s3
                     62: .lp +8 8
                     63: \fBv\fR        Normally
                     64: .it mt
                     65: does its work silently.  The
                     66: .bd v
                     67: (verbose)
                     68: option causes it to type the name of each file it treats
                     69: preceded by a letter to indicate what is happening:
                     70: .bd a
                     71: indicates a file is being added;
                     72: .bd x
                     73: indicates a file is being extracted.
                     74: The
                     75: .bd v
                     76: option can be used with
                     77: .bd r
                     78: and
                     79: .bd x
                     80: only.
                     81: .s3
                     82: .lp +8 8
                     83: \fBf\fR        causes
                     84: new entries copied on tape to be `fake' in that
                     85: only the entries, not the data associated
                     86: with the entries are updated.
                     87: Such fake entries cannot be extracted.
                     88: Usable only with
                     89: .bd r.
                     90: .s3
                     91: .lp +8 8
                     92: \fBw\fR        causes
                     93: .it mt
                     94: to pause before treating each file, type
                     95: the indicative letter and the file name (as with
                     96: .bd v)
                     97: and await the user's response.  Response
                     98: .bd y
                     99: means `yes', so the file is treated.  Null response
                    100: means `no', and the file does not take part
                    101: in whatever is being done.  Response
                    102: .bd x
                    103: means `exit';
                    104: the
                    105: .it mt
                    106: command terminates immediately.  In the
                    107: .bd x
                    108: function,
                    109: files previously asked about
                    110: have been extracted already.
                    111: With
                    112: .bd r,
                    113: no change has been made to the tape.
                    114: .s3
                    115: .i0
                    116: .sh FILES
                    117: /dev/mt?
                    118: .sh "SEE ALSO"
                    119: tap(I), tap(V)
                    120: .sh DIAGNOSTICS
                    121: Several; the only non-obvious one is:
                    122: .br
                    123: `Phase error'\*- a file has changed after it was selected for
                    124: dumping but before it was dumped.
                    125: .br
                    126: .sh BUGS
                    127: It doesn't save the mode correctly, so files are restored
                    128: mode 666.
                    129: If, during an
                    130: .bd x,
                    131: the files are specified in a different order
                    132: than they are on the tape,
                    133: seek errors will result because the command believes
                    134: the tape
                    135: cannot be rewound.

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