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