Commit | Line | Data |
---|---|---|
3a749e91 | 1 | .\" @(#)tp.1 6.1 (Berkeley) %G% |
1e41e9d9 | 2 | .\" |
3a749e91 | 3 | .TH TP 1 "" |
1e41e9d9 KM |
4 | .AT 3 |
5 | .SH NAME | |
6 | tp \- manipulate tape archive | |
7 | .SH SYNOPSIS | |
8 | .B tp | |
9 | [ key ] [ name ... ] | |
10 | .SH DESCRIPTION | |
11 | .PP | |
12 | .I Tp | |
13 | saves and restores files | |
14 | on DECtape or magtape. | |
15 | Its actions are controlled by the | |
16 | .I key | |
17 | argument. | |
18 | The key is a string of characters containing | |
19 | at most one function letter and possibly | |
20 | one or more function modifiers. | |
21 | Other arguments to the command are file or directory | |
22 | names specifying which files are to be dumped, restored, | |
23 | or listed. | |
24 | In all cases, appearance of a directory name refers to | |
25 | the files and (recursively) subdirectories of that directory. | |
26 | .PP | |
27 | The function portion of | |
28 | the key is specified by one of the following letters: | |
29 | .TP 8 | |
30 | .B r | |
31 | The named files | |
32 | are written | |
33 | on the tape. | |
34 | If files with the same names | |
35 | already exist, they are replaced. | |
36 | `Same' is determined by string comparison, so | |
37 | `./abc' can never be the same as `/usr/dmr/abc' even | |
38 | if `/usr/dmr' is the current directory. | |
39 | If no file argument is given, `\fB.\fR' is the default. | |
40 | .TP 8 | |
41 | .B u | |
42 | updates the tape. | |
43 | .B u | |
44 | is like | |
45 | .B r, | |
46 | but a file is replaced only if its | |
47 | modification date is later than the date stored on the tape; | |
48 | that is to say, if it has changed since it was dumped. | |
49 | .B u | |
50 | is the default command if none is given. | |
51 | .TP 8 | |
52 | .B d | |
53 | deletes the named files from | |
54 | the tape. | |
55 | At least one name argument must be given. | |
56 | This function is not permitted on magtapes. | |
57 | .TP 8 | |
58 | .B x | |
59 | extracts the named files from the tape to the file system. | |
60 | The owner and mode are restored. | |
61 | If no file argument is given, the entire contents of the | |
62 | tape are extracted. | |
63 | .TP 8 | |
64 | .B t | |
65 | lists the names of the specified files. | |
66 | If no file argument is given, | |
67 | the entire contents of the tape is listed. | |
68 | .PP | |
69 | The following characters may be used in addition to the letter | |
70 | which selects the function desired. | |
71 | .TP 10 | |
72 | .B m | |
73 | Specifies magtape as opposed to DECtape. | |
74 | .TP 10 | |
75 | .B 0,...,7 | |
76 | This | |
77 | modifier selects the drive on which the tape is mounted. | |
78 | For DECtape, | |
79 | .B x | |
80 | is default; for magtape | |
81 | `0' is the default. | |
82 | .TP 10 | |
83 | .B v | |
84 | Normally | |
85 | .I tp | |
86 | does its work silently. | |
87 | The | |
88 | .B v | |
89 | (verbose) | |
90 | option causes it to type the name of each file it treats | |
91 | preceded by the function letter. | |
92 | With the | |
93 | .B t | |
94 | function, | |
95 | .B v | |
96 | gives more information about the | |
97 | tape entries than just the name. | |
98 | .TP 10 | |
99 | .B c | |
100 | means a fresh dump is being created; the tape directory | |
101 | is cleared before beginning. | |
102 | Usable only with | |
103 | .B r | |
104 | and | |
105 | .B u. | |
106 | This option is assumed with magtape since | |
107 | it is impossible to selectively overwrite | |
108 | magtape. | |
109 | .TP 10 | |
110 | .B i | |
111 | Errors reading and writing the | |
112 | tape are noted, but no action is taken. | |
113 | Normally, errors cause a return to the command level. | |
114 | .TP 10 | |
115 | .B f | |
116 | Use the first named file, rather than a tape, | |
117 | as the archive. | |
118 | This option currently acts like | |
119 | .BR m ; | |
120 | .I i.e. | |
121 | .BR r | |
122 | implies | |
123 | .BR c , | |
124 | and neither | |
125 | .BR d | |
126 | nor | |
127 | .BR u | |
128 | are permitted. | |
129 | .TP 10 | |
130 | .B w | |
131 | causes | |
132 | .I tp | |
133 | to pause before treating each file, type | |
134 | the indicative letter and the file name (as with | |
135 | .BR v ) | |
136 | and await the user's response. | |
137 | Response | |
138 | .B y | |
139 | means `yes', so the file is treated. | |
140 | Null response | |
141 | means `no', and the file does not take part | |
142 | in whatever is being done. | |
143 | Response | |
144 | .B x | |
145 | means `exit'; | |
146 | the | |
147 | .I tp | |
148 | command terminates immediately. | |
149 | In the | |
150 | .B x | |
151 | function, | |
152 | files previously asked about | |
153 | have been extracted already. | |
154 | With | |
155 | .B "r, u," | |
156 | and | |
157 | .B d | |
158 | no change has been made to the tape. | |
159 | .PP | |
160 | .SH FILES | |
161 | /dev/tap? | |
162 | .br | |
163 | /dev/rmt? | |
164 | .SH SEE ALSO | |
165 | ar(1), tar(1) | |
166 | .SH DIAGNOSTICS | |
167 | Several; the non-obvious one is | |
168 | `Phase error', which means the file changed after it was selected for | |
169 | dumping but before it was dumped. | |
170 | .SH BUGS | |
171 | A single file with several links to it is treated like several files. | |
172 | .PP | |
173 | Binary-coded control information makes | |
174 | magnetic tapes written by | |
175 | .I tp | |
176 | difficult to carry to other machines; | |
177 | .IR tar (1) | |
178 | avoids the problem. |