Commit | Line | Data |
---|---|---|
0e5d3dbd PC |
1 | .\" Copyright (c) 1980 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
5 | .\" @(#)dump.8 6.3 (Berkeley) 5/23/86 | |
c67409f7 | 6 | .\" @(#)dump.8 1.3 (UKC) %G% |
0e5d3dbd | 7 | .\" |
a43cd228 | 8 | .TH DUMP 8 "UKC altered %G%" |
0e5d3dbd PC |
9 | .UC 4 |
10 | .SH NAME | |
11 | dump \- incremental file system dump | |
12 | .SH SYNOPSIS | |
13 | .B /etc/dump | |
14 | [ key [ | |
15 | .I argument | |
16 | \&... ] filesystem ] | |
17 | .SH DESCRIPTION | |
18 | .I Dump | |
19 | copies to magnetic tape all files | |
20 | changed after a certain date | |
21 | in the | |
22 | .I filesystem. | |
23 | The | |
24 | .I key | |
25 | specifies the date and other options about the dump. | |
26 | .I Key | |
27 | consists of characters from | |
28 | the set | |
a43cd228 | 29 | .B 0123456789fusdWnolmt. |
0e5d3dbd PC |
30 | .TP 5 |
31 | .B 0\-9 | |
32 | This number is the `dump level'. | |
33 | All files modified since the last date stored | |
34 | in the file | |
35 | .I /etc/dumpdates | |
36 | for the same filesystem at lesser levels | |
37 | will be dumped. | |
38 | If no date is determined by the level, | |
39 | the beginning of time is assumed; | |
40 | thus the option | |
41 | .B 0 | |
42 | causes the entire filesystem to be dumped. | |
43 | .TP 5 | |
44 | .B f | |
45 | Place the dump on the next | |
46 | .I argument | |
47 | file | |
48 | instead of the tape. | |
49 | If the name of the file is ``\-'', | |
50 | .I dump | |
51 | writes to standard output. | |
52 | .TP 5 | |
53 | .B u | |
54 | If the dump completes successfully, | |
55 | write the date of the beginning of the dump on | |
56 | file | |
57 | .I /etc/dumpdates. | |
58 | This file records a separate date for | |
59 | each filesystem and each dump level. | |
60 | The format of | |
61 | .I /etc/dumpdates | |
62 | is readable by people, consisting of one | |
63 | free format record per line: | |
64 | filesystem name, increment level | |
65 | and | |
66 | .I ctime(3) | |
67 | format dump date. | |
68 | .I /etc/dumpdates | |
69 | may be edited to change any of the fields, | |
70 | if necessary. | |
71 | .TP 5 | |
72 | .B s | |
73 | The size of the dump tape is specified in feet. | |
74 | The number of feet is taken from the next | |
75 | .I argument. | |
76 | When the specified size is reached, | |
77 | .I dump | |
78 | will wait for reels to be changed. | |
79 | The default tape size is 2300 feet. | |
80 | .TP 5 | |
81 | .B d | |
82 | The density of the tape, expressed in BPI, | |
83 | is taken from the next | |
84 | .I argument. | |
85 | This is used in calculating the amount of tape | |
86 | used per reel. The default is 1600. | |
87 | .TP 5 | |
88 | .B W | |
89 | .I Dump | |
90 | tells the operator what file systems need to be dumped. | |
91 | This information is gleaned from the files | |
92 | .I /etc/dumpdates | |
93 | and | |
94 | .I /etc/fstab. | |
95 | The | |
96 | .B W | |
97 | option causes | |
98 | .I dump | |
99 | to print out, for each file system in | |
100 | .I /etc/dumpdates | |
101 | the most recent dump date and level, | |
102 | and highlights those file systems that should be dumped. | |
103 | If the | |
104 | .B W | |
105 | option is set, all other options are ignored, and | |
106 | .I dump | |
107 | exits immediately. | |
108 | .TP 5 | |
109 | .B w | |
110 | Is like W, but prints only those filesystems which need to be dumped. | |
111 | .TP 5 | |
112 | .B n | |
113 | Whenever | |
114 | .I dump | |
115 | requires operator attention, | |
116 | notify by means similar to a | |
117 | .IR wall (1) | |
118 | all of the operators in the group \*(lqoperator\*(rq. | |
119 | .PP | |
120 | If no arguments are given, | |
121 | the | |
122 | .I key | |
123 | is assumed to be | |
124 | .B 9u | |
125 | and a default file system is dumped | |
126 | to the default tape. | |
a43cd228 PC |
127 | .TP 5 |
128 | .B o | |
129 | This switch causes tapes to be rewound and the tape drive put offline after | |
130 | each tape write has been done. | |
131 | .TP 5 | |
132 | .B l | |
133 | The next argument in the command list is a tape label. | |
134 | The tape label is written into the dump file header at the beginning of each | |
135 | tape which the dump uses. | |
136 | Labels are currently limited to 15 characters. | |
137 | The argument may contain a `%s', which is replaced by the volume number | |
138 | in decimal of a multi-volume dump, unless the | |
139 | .B m | |
140 | argument is given (see below). | |
141 | .PP | |
142 | If the | |
143 | .B u | |
144 | flag is set and the output device appears to be a tape drive, | |
145 | each tape is logged in | |
146 | .IR /etc/dumpvolumes . | |
147 | The data written here contains the tape label, the | |
148 | name of the file system which has been dumped, the date, the device | |
149 | which was dumped, the dump level, the reel of the dump and the inode | |
150 | which the dump started from. | |
151 | The log is written just prior to the tape being written, this means that | |
152 | bad tapes will be logged. | |
153 | When a tape is overwritten, its old entry in the log file can be removed | |
154 | by the shell script /etc/cleanvolumes. | |
155 | .TP 5 | |
156 | .B m | |
157 | The m argument provides a way of mapping the volume numbers of a multi-volume dump | |
158 | into a series of strings. | |
159 | In the absence of an | |
160 | .B l | |
161 | argument, these strings become the tape label. | |
162 | Otherwise the string is inserted in the tape label by the use of a `%s' marker | |
163 | in the label format. | |
164 | The argument to the | |
165 | .B m | |
166 | switch may be a single string or an auto-incrementing range. | |
167 | These items may be grouped into a list by using commas to separate | |
168 | each item. | |
169 | An auto-incrementing range is two equal length strings separated by a minus | |
170 | sign. | |
171 | The first string is incremented starting at the rightmost character until | |
172 | a match with the second string is acheived. | |
173 | The increment treats the characters `0' to `9', `a' to `z', and `A' to `Z' | |
174 | as separate ranges. | |
175 | Examples to legal ranges are: 45-70, giving 45,46,47,48...69,70; | |
176 | a00-b99, giving a00,a01,a02...b98,b99; and A0a-A9z, giving A0a,A0b,A0c...A9x,A9y,A9z. | |
177 | .PP | |
178 | .I Dump | |
179 | will complain of the estimated number of tape which a dump will take is less | |
180 | than the label range supplied by the user. | |
181 | .TP 5 | |
182 | .B t | |
183 | Tests that the tape being currently overwritten contains a header | |
184 | bearing the correct label. | |
185 | When a fresh tape is loaded, the first block is read and its label checked. | |
186 | If the labels do not match, the write is refused on the tape. | |
187 | This provides considerable protection and the ability to construct | |
188 | tape dump cycles. | |
189 | A program | |
190 | .IR dumplabel (8) | |
191 | may be used to label tapes prior to the use of | |
192 | .IR dump . | |
0e5d3dbd PC |
193 | .PP |
194 | .I Dump | |
195 | requires operator intervention on these conditions: | |
196 | end of tape, | |
197 | end of dump, | |
198 | tape write error, | |
199 | tape open error or | |
200 | disk read error (if there are more than a threshold of 32). | |
201 | In addition to alerting all operators implied by the | |
202 | .B n | |
203 | key, | |
204 | .I dump | |
205 | interacts with the operator on | |
206 | .I dump's | |
207 | control terminal at times when | |
208 | .I dump | |
209 | can no longer proceed, | |
210 | or if something is grossly wrong. | |
211 | All questions | |
212 | .I dump | |
213 | poses | |
214 | .B must | |
215 | be answered by typing \*(lqyes\*(rq or \*(lqno\*(rq, | |
216 | appropriately. | |
217 | .PP | |
218 | Since making a dump involves a lot of time and effort for full dumps, | |
219 | .I dump | |
220 | checkpoints itself at the start of each tape volume. | |
221 | If writing that volume fails for some reason, | |
222 | .I dump | |
223 | will, | |
224 | with operator permission, | |
225 | restart itself from the checkpoint | |
226 | after the old tape has been rewound and removed, | |
227 | and a new tape has been mounted. | |
228 | .PP | |
229 | .I Dump | |
230 | tells the operator what is going on at periodic intervals, | |
231 | including usually low estimates of the number of blocks to write, | |
232 | the number of tapes it will take, the time to completion, and | |
233 | the time to the tape change. | |
234 | The output is verbose, | |
235 | so that others know that the terminal | |
236 | controlling | |
237 | .I dump | |
238 | is busy, | |
239 | and will be for some time. | |
240 | .PP | |
241 | Now a short suggestion on how to | |
242 | perform dumps. | |
243 | Start with a full level 0 dump | |
244 | .PP | |
245 | dump 0un | |
246 | .PP | |
247 | Next, dumps of active file | |
248 | systems are taken on a daily basis, | |
249 | using a modified Tower of Hanoi algorithm, | |
250 | with this sequence of dump levels: | |
251 | .ce 1 | |
252 | 3 2 5 4 7 6 9 8 9 9 ... | |
253 | For the daily dumps, a set of 10 tapes per dumped file system | |
254 | is used on a cyclical basis. | |
255 | Each week, a level 1 dump is taken, and | |
256 | the daily Hanoi sequence repeats with 3. | |
257 | For weekly dumps, a set of 5 tapes per dumped file system is | |
258 | used, also on a cyclical basis. | |
259 | Each month, a level 0 dump is taken | |
260 | on a set of fresh tapes that is saved forever. | |
261 | .SH FILES | |
262 | .nf | |
a43cd228 | 263 | .ta \w'/etc/dumpvolumes\ \ 'u |
0e5d3dbd PC |
264 | /dev/rrp1g default filesystem to dump from |
265 | /dev/rmt8 default tape unit to dump to | |
266 | /etc/dumpdates new format dump date record | |
a43cd228 | 267 | /etc/dumpvolumes Listing of tape labels and the data which the tapes contain |
0e5d3dbd PC |
268 | /etc/fstab dump table: file systems and frequency |
269 | /etc/group to find group \fIoperator\fP | |
270 | .fi | |
271 | .DT | |
272 | .br | |
273 | .SH "SEE ALSO" | |
274 | restore(8), | |
a43cd228 | 275 | dumplabel(8), |
c67409f7 | 276 | dumpdev(8), |
0e5d3dbd PC |
277 | dump(5), |
278 | fstab(5) | |
279 | .SH DIAGNOSTICS | |
280 | Many, and verbose. | |
281 | .PP | |
282 | Dump exits with zero status on success. | |
283 | Startup errors are indicated with an exit code of 1; | |
284 | abnormal termination is indicated with an exit code of 3. | |
285 | .SH BUGS | |
286 | .PP | |
287 | Fewer than 32 read errors on the filesystem are ignored. | |
288 | Each reel requires a new process, so parent processes for | |
289 | reels already written just hang around until the entire tape | |
290 | is written. | |
291 | .PP | |
292 | .I Dump | |
293 | with the | |
294 | .B W | |
295 | or | |
296 | .B w | |
297 | options does not report filesystems that have never been recorded | |
298 | in /etc/dumpdates, even if listed in /etc/fstab. | |
299 | .PP | |
300 | It would be nice if | |
301 | .I dump | |
302 | knew about the dump sequence, | |
303 | kept track of the tapes scribbled on, | |
304 | told the operator which tape to mount when, | |
305 | and provided more assistance | |
306 | for the operator running | |
307 | .IR restore . |