Commit | Line | Data |
---|---|---|
0462c67d KT |
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 |