Commit | Line | Data |
---|---|---|
4a420619 KT |
1 | .pa 1 |
2 | .he 'MT (I)'6/12/72'MT (I)' | |
3 | .ti 0 | |
4 | NAME mt -- manipulate magtape | |
5 | .sp | |
6 | .ti 0 | |
7 | SYNOPSIS mt\b\b__ [ key ] [ name ... ] | |
8 | .sp | |
9 | .ti 0 | |
10 | DESCRIPTION mt\b\b__ | |
11 | saves and restores selected portions of the file system | |
12 | hierarchy on magtape. | |
13 | Its actions are controlled by the key\b\b\b___ 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 | The old contents of the tape are lost. | |
30 | ||
31 | .ti -3 | |
32 | x extracts the named files from the tape to the file system. | |
33 | The owner, mode, and date-modified are restored to what they | |
34 | were when the file was dumped. | |
35 | If no file argument is given, the entire contents of the | |
36 | tape are extracted. | |
37 | ||
38 | .ti -3 | |
39 | t lists the names of all files stored on the tape which | |
40 | are the same as or are hierarchically below | |
41 | the file arguments. If no file argument is given, | |
42 | the entire contents of the tape are tabled. | |
43 | ||
44 | .ti -3 | |
45 | l is the same as t\b_ except that an expanded listing | |
46 | is produced giving all the available information about the | |
47 | listed files. | |
48 | ||
49 | .in -6 | |
50 | The following characters may be used in addition to the letter | |
51 | which selects the function desired. | |
52 | ||
53 | .in +6 | |
54 | .ti -3 | |
55 | 0, ..., 7 This modifier selects the drive on which the tape is mounted. | |
56 | "0" is the default. | |
57 | ||
58 | .ti -3 | |
59 | v Normally mt\b\b__ does its work silently. The v\b_ (verbose) | |
60 | option causes it to type the name of each file it treats | |
61 | preceded by a letter to indicate what is happening. | |
62 | ||
63 | .in +2 | |
64 | a file is being added | |
65 | x file is being extracted | |
66 | ||
67 | .in -2 | |
68 | The v\b_ option can be used with r\b_ and x\b_ only. | |
69 | ||
70 | .ti -3 | |
71 | f causes | |
72 | new entries copied on tape to be 'fake' in that | |
73 | only the entries, not the data associated | |
74 | with the entries are updated. | |
75 | Such fake entries cannot be extracted. | |
76 | Usable only with r\b_. | |
77 | ||
78 | .ti -3 | |
79 | w causes mt\b\b__ to pause before treating each file, type | |
80 | the indicative letter and the file name (as with v\b_) | |
81 | and await the user's response. Response | |
82 | "y" means "yes", so the file is treated. Null response | |
83 | means "no", and the file does not take part | |
84 | in whatever is being done. Response "x" means "exit"; | |
85 | the mt\b\b__ command terminates immediately. In the x\b_ function, | |
86 | files previously asked about | |
87 | have been extracted already. | |
88 | With r\b_, no change has been made to the tape. | |
89 | ||
90 | .ti -3 | |
91 | m make (create) directories during an x\b_ if necessary. | |
92 | .in -6 | |
93 | .sp | |
94 | .ti 0 | |
95 | FILES /dev/mt? | |
96 | .sp | |
97 | .ti 0 | |
98 | SEE ALSO tap(I), tap(V) | |
99 | .sp | |
100 | .ti 0 | |
101 | DIAGNOSTICS Tape open error | |
102 | .br | |
103 | Tape read error | |
104 | .br | |
105 | Tape write error | |
106 | .br | |
107 | Directory checksum | |
108 | .br | |
109 | Directory overflow | |
110 | .br | |
111 | Seek error | |
112 | .br | |
113 | Tape overflow | |
114 | .br | |
115 | Phase error (a file has changed after it was selected for | |
116 | dumping but before it was dumped) | |
117 | .br | |
118 | .sp | |
119 | .ti 0 | |
120 | BUGS If, during an "x", | |
121 | the files are specified in a different order | |
122 | than they are on the tape, | |
123 | seek errors will result because the tape | |
124 | cannot be rewound. |