]>
Commit | Line | Data |
---|---|---|
1227625a SP |
1 | .\" Copyright (c) 1985, 1991, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
3 | .\" | |
4 | .\" Redistribution and use in source and binary forms, with or without | |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" 3. All advertising materials mentioning features or use of this software | |
13 | .\" must display the following acknowledgement: | |
14 | .\" This product includes software developed by the University of | |
15 | .\" California, Berkeley and its contributors. | |
16 | .\" 4. Neither the name of the University nor the names of its contributors | |
17 | .\" may be used to endorse or promote products derived from this software | |
18 | .\" without specific prior written permission. | |
19 | .\" | |
20 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
21 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
22 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
23 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
24 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
25 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
26 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
27 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
28 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
30 | .\" SUCH DAMAGE. | |
31 | .\" | |
e51470bf | 32 | .\" $Id: restore.8.in,v 1.24 2002/01/25 14:59:53 stelian Exp $ |
1227625a | 33 | .\" |
8d4197bb | 34 | .Dd __DATE__ |
1227625a | 35 | .Dt RESTORE 8 |
df9ae507 | 36 | .Os "restore __VERSION__" |
1227625a SP |
37 | .Sh NAME |
38 | .Nm restore | |
39 | .Nd "restore files or file systems from backups made with dump" | |
40 | .Sh SYNOPSIS | |
41 | .Nm restore | |
42 | .Fl C | |
80dea635 | 43 | .Op Fl cklMvVy |
1227625a SP |
44 | .Op Fl b Ar blocksize |
45 | .Op Fl D Ar filesystem | |
46 | .Op Fl f Ar file | |
c534413c | 47 | .Op Fl F Ar script |
05f23c0c | 48 | .Op Fl L Ar limit |
1227625a SP |
49 | .Op Fl s Ar fileno |
50 | .Op Fl T Ar directory | |
51 | .Nm restore | |
52 | .Fl i | |
40df6a0e | 53 | .Op Fl achklmMNuvVy |
e51470bf | 54 | .Op Fl A Ar file |
1227625a SP |
55 | .Op Fl b Ar blocksize |
56 | .Op Fl f Ar file | |
c534413c | 57 | .Op Fl F Ar script |
35b24fb7 | 58 | .Op Fl Q Ar file |
1227625a SP |
59 | .Op Fl s Ar fileno |
60 | .Op Fl T Ar directory | |
61 | .Nm restore | |
62 | .Fl R | |
80dea635 | 63 | .Op Fl cklMNuvVy |
1227625a SP |
64 | .Op Fl b Ar blocksize |
65 | .Op Fl f Ar file | |
c534413c | 66 | .Op Fl F Ar script |
1227625a SP |
67 | .Op Fl s Ar fileno |
68 | .Op Fl T Ar directory | |
69 | .Nm restore | |
70 | .Fl r | |
80dea635 | 71 | .Op Fl cklMNuvVy |
1227625a SP |
72 | .Op Fl b Ar blocksize |
73 | .Op Fl f Ar file | |
c534413c | 74 | .Op Fl F Ar script |
1227625a SP |
75 | .Op Fl s Ar fileno |
76 | .Op Fl T Ar directory | |
77 | .Nm restore | |
78 | .Fl t | |
80dea635 | 79 | .Op Fl chklMNuvVy |
e51470bf | 80 | .Op Fl A Ar file |
1227625a SP |
81 | .Op Fl b Ar blocksize |
82 | .Op Fl f Ar file | |
c534413c | 83 | .Op Fl F Ar script |
35b24fb7 | 84 | .Op Fl Q Ar file |
1227625a SP |
85 | .Op Fl s Ar fileno |
86 | .Op Fl T Ar directory | |
08db2b86 | 87 | .Op Fl X Ar filelist |
1227625a | 88 | .Op file ... |
08db2b86 SP |
89 | .Nm restore |
90 | .Fl x | |
40df6a0e | 91 | .Op Fl achklmMNuvVy |
e51470bf | 92 | .Op Fl A Ar file |
08db2b86 SP |
93 | .Op Fl b Ar blocksize |
94 | .Op Fl f Ar file | |
c534413c | 95 | .Op Fl F Ar script |
35b24fb7 | 96 | .Op Fl Q Ar file |
08db2b86 SP |
97 | .Op Fl s Ar fileno |
98 | .Op Fl T Ar directory | |
99 | .Op Fl X Ar filelist | |
1a05d45d | 100 | .Op file ... |
1227625a | 101 | .Pp |
8d4197bb | 102 | .in |
1227625a SP |
103 | (The |
104 | .Bx 4.3 | |
ddd2ef55 | 105 | option syntax is implemented for backward compatibility but |
1227625a SP |
106 | is not documented here.) |
107 | .Sh DESCRIPTION | |
108 | The | |
109 | .Nm restore | |
110 | command performs the inverse function of | |
111 | .Xr dump 8 . | |
112 | A full backup of a file system may be restored and | |
113 | subsequent incremental backups layered on top of it. | |
114 | Single files and | |
115 | directory subtrees may be restored from full or partial | |
116 | backups. | |
117 | .Nm Restore | |
118 | works across a network; | |
119 | to do this see the | |
120 | .Fl f | |
121 | flag described below. | |
122 | Other arguments to the command are file or directory | |
123 | names specifying the files that are to be restored. | |
124 | Unless the | |
125 | .Fl h | |
126 | flag is specified (see below), | |
127 | the appearance of a directory name refers to | |
128 | the files and (recursively) subdirectories of that directory. | |
129 | .Pp | |
130 | Exactly one of the following flags is required: | |
131 | .Bl -tag -width Ds | |
132 | .It Fl C | |
133 | This mode allows comparison of files from a dump. | |
134 | .Nm Restore | |
135 | reads the backup and compares its contents with files present on the | |
136 | disk. | |
137 | It first changes its working directory to the root of the filesystem | |
138 | that was dumped and compares the tape with the files in its new | |
139 | current directory. | |
05f23c0c SP |
140 | See also the |
141 | .Fl L | |
142 | flag described below. | |
1227625a SP |
143 | .It Fl i |
144 | This mode allows interactive restoration of files from a dump. | |
145 | After reading in the directory information from the dump, | |
146 | .Nm restore | |
147 | provides a shell like interface that allows the user to move | |
148 | around the directory tree selecting files to be extracted. | |
149 | The available commands are given below; | |
150 | for those commands that require an argument, | |
151 | the default is the current directory. | |
152 | .Bl -tag -width Fl | |
153 | .It Ic add Op Ar arg | |
154 | The current directory or specified argument is added to the list of | |
155 | files to be extracted. | |
156 | If a directory is specified, then it and all its descendents are | |
157 | added to the extraction list | |
158 | (unless the | |
159 | .Fl h | |
160 | flag is specified on the command line). | |
ddd2ef55 SP |
161 | Files that are on the extraction list are prepended with a |
162 | .Dq \&* | |
1227625a SP |
163 | when they are listed by |
164 | .Ic ls . | |
165 | .It Ic \&cd Ar arg | |
166 | Change the current working directory to the specified argument. | |
167 | .It Ic delete Op Ar arg | |
168 | The current directory or specified argument is deleted from the list of | |
169 | files to be extracted. | |
170 | If a directory is specified, then it and all its descendents are | |
171 | deleted from the extraction list | |
172 | (unless the | |
173 | .Fl h | |
174 | flag is specified on the command line). | |
175 | The most expedient way to extract most of the files from a directory | |
176 | is to add the directory to the extraction list and then delete | |
177 | those files that are not needed. | |
178 | .It Ic extract | |
ddd2ef55 | 179 | All files on the extraction list are extracted |
1227625a SP |
180 | from the dump. |
181 | .Nm Restore | |
182 | will ask which volume the user wishes to mount. | |
183 | The fastest way to extract a few files is to | |
ddd2ef55 | 184 | start with the last volume and work towards the first volume. |
1227625a SP |
185 | .It Ic help |
186 | List a summary of the available commands. | |
187 | .It Ic \&ls Op Ar arg | |
188 | List the current or specified directory. | |
ddd2ef55 SP |
189 | Entries that are directories are appended with a |
190 | .Dq \&* . | |
1227625a SP |
191 | Entries that have been marked for extraction are prepended with a ``*''. |
192 | If the verbose | |
ddd2ef55 | 193 | flag is set, the inode number of each entry is also listed. |
1227625a SP |
194 | .It Ic pwd |
195 | Print the full pathname of the current working directory. | |
196 | .It Ic quit | |
197 | Restore immediately exits, | |
198 | even if the extraction list is not empty. | |
199 | .It Ic setmodes | |
ddd2ef55 | 200 | All directories that have been added to the extraction list |
1227625a SP |
201 | have their owner, modes, and times set; |
202 | nothing is extracted from the dump. | |
203 | This is useful for cleaning up after a restore has been prematurely aborted. | |
204 | .It Ic verbose | |
205 | The sense of the | |
206 | .Fl v | |
207 | flag is toggled. | |
208 | When set, the verbose flag causes the | |
209 | .Ic ls | |
210 | command to list the inode numbers of all entries. | |
211 | It also causes | |
212 | .Nm restore | |
213 | to print out information about each file as it is extracted. | |
214 | .El | |
215 | .It Fl R | |
216 | .Nm Restore | |
ddd2ef55 | 217 | requests a particular tape of a multi-volume set on which to restart |
1227625a SP |
218 | a full restore |
219 | (see the | |
220 | .Fl r | |
221 | flag below). | |
222 | This is useful if the restore has been interrupted. | |
223 | .It Fl r | |
ddd2ef55 | 224 | Restore (rebuild) a file system. |
1227625a | 225 | The target file system should be made pristine with |
8d4197bb | 226 | .Xr mke2fs 8 , |
ddd2ef55 | 227 | mounted, and the user |
1227625a SP |
228 | .Xr cd Ns 'd |
229 | into the pristine file system | |
230 | before starting the restoration of the initial level 0 backup. If the | |
231 | level 0 restores successfully, the | |
232 | .Fl r | |
233 | flag may be used to restore | |
234 | any necessary incremental backups on top of the level 0. | |
235 | The | |
236 | .Fl r | |
237 | flag precludes an interactive file extraction and can be | |
ddd2ef55 SP |
238 | detrimental to one's health (not to mention the disk) if not used carefully. |
239 | An example: | |
1227625a | 240 | .Bd -literal -offset indent |
8d4197bb SP |
241 | mke2fs /dev/sda1 |
242 | mount /dev/sda1 /mnt | |
1227625a SP |
243 | cd /mnt |
244 | ||
8d4197bb | 245 | restore rf /dev/st0 |
1227625a SP |
246 | .Ed |
247 | .Pp | |
248 | Note that | |
249 | .Nm restore | |
250 | leaves a file | |
251 | .Pa restoresymtable | |
252 | in the root directory to pass information between incremental | |
253 | restore passes. | |
254 | This file should be removed when the last incremental has been | |
255 | restored. | |
256 | .Pp | |
257 | .Nm Restore , | |
258 | in conjunction with | |
8d4197bb | 259 | .Xr mke2fs 8 |
1227625a SP |
260 | and |
261 | .Xr dump 8 , | |
262 | may be used to modify file system parameters | |
263 | such as size or block size. | |
264 | .It Fl t | |
265 | The names of the specified files are listed if they occur | |
266 | on the backup. | |
267 | If no file argument is given, | |
ddd2ef55 | 268 | the root directory is listed, |
1227625a SP |
269 | which results in the entire content of the |
270 | backup being listed, | |
271 | unless the | |
272 | .Fl h | |
273 | flag has been specified. | |
274 | Note that the | |
275 | .Fl t | |
276 | flag replaces the function of the old | |
277 | .Xr dumpdir 8 | |
278 | program. | |
08db2b86 SP |
279 | See also the |
280 | .Fl X | |
281 | option below. | |
1227625a SP |
282 | .ne 1i |
283 | .It Fl x | |
284 | The named files are read from the given media. | |
285 | If a named file matches a directory whose contents | |
286 | are on the backup | |
287 | and the | |
288 | .Fl h | |
289 | flag is not specified, | |
290 | the directory is recursively extracted. | |
291 | The owner, modification time, | |
292 | and mode are restored (if possible). | |
293 | If no file argument is given, | |
ddd2ef55 | 294 | the root directory is extracted, |
1227625a SP |
295 | which results in the entire content of the |
296 | backup being extracted, | |
297 | unless the | |
298 | .Fl h | |
299 | flag has been specified. | |
08db2b86 SP |
300 | See also the |
301 | .Fl X | |
302 | option below. | |
1227625a SP |
303 | .El |
304 | .Pp | |
305 | The following additional options may be specified: | |
306 | .Bl -tag -width Ds | |
40df6a0e SP |
307 | .It Fl a |
308 | In | |
309 | .Fl i | |
310 | or | |
311 | .Fl x | |
312 | mode, | |
313 | .Nm restore | |
314 | does ask the user for the volume number on which the files to | |
315 | be extracted are supposed to be (in order to minimise the time | |
316 | be reading only the interesting volumes). The | |
317 | .Fl a | |
318 | option disables this behaviour and reads all the volumes starting | |
319 | with 1. This option is useful when the operator does not know on which | |
320 | volume the files to be extracted are and/or when he prefers the | |
321 | longer unattended mode rather than the shorter interactive mode. | |
e51470bf SP |
322 | .It Fl A Ar archive_file |
323 | Read the table of contents from | |
324 | .Ar archive_file | |
325 | instead of the media. This option can be used in combination with the | |
326 | .Fl t, | |
327 | .Fl i, | |
328 | or | |
329 | .Fl x | |
330 | options, making it possible to check whether files are on the media | |
331 | without having to mount the media. | |
1227625a SP |
332 | .It Fl b Ar blocksize |
333 | The number of kilobytes per dump record. | |
334 | If the | |
335 | .Fl b | |
336 | option is not specified, | |
337 | .Nm restore | |
b45f51d6 | 338 | tries to determine the media block size dynamically. |
1227625a SP |
339 | .It Fl c |
340 | Normally, | |
341 | .Nm restore | |
342 | will try to determine dynamically whether the dump was made from an | |
b45f51d6 | 343 | old (pre-4.4) or new format file system. The |
1227625a SP |
344 | .Fl c |
345 | flag disables this check, and only allows reading a dump in the old | |
346 | format. | |
347 | .It Fl D Ar filesystem | |
348 | The | |
349 | .Fl D | |
350 | flag allows the user to specify the filesystem name when using | |
351 | .Nm restore | |
352 | with the | |
353 | .Fl C | |
354 | option to check the backup. | |
355 | .It Fl f Ar file | |
356 | Read the backup from | |
357 | .Ar file ; | |
358 | .Ar file | |
359 | may be a special device file | |
360 | like | |
ddd2ef55 | 361 | .Pa /dev/st0 |
1227625a | 362 | (a tape drive), |
8d4197bb | 363 | .Pa /dev/sda1 |
1227625a SP |
364 | (a disk drive), |
365 | an ordinary file, | |
366 | or | |
367 | .Ql Fl | |
368 | (the standard input). | |
369 | If the name of the file is of the form | |
ddd2ef55 | 370 | .Dq host:file |
1227625a SP |
371 | or |
372 | .Dq user@host:file , | |
373 | .Nm restore | |
374 | reads from the named file on the remote host using | |
375 | .Xr rmt 8 . | |
376 | .Pp | |
c534413c SP |
377 | .It Fl F Ar script |
378 | Run script at the beginning of each tape. The device name and the | |
379 | current volume number are passed on the command line. | |
380 | The script must return 0 if | |
381 | .Nm | |
382 | should continue without asking the user to change the tape, 1 if | |
383 | .Nm | |
384 | should continue but ask the user to change the tape. | |
385 | Any other exit code will cause | |
386 | .Nm | |
387 | to abort. | |
388 | For security reasons, | |
389 | .Nm | |
390 | reverts back to the real user ID and the real group ID before | |
391 | running the script. | |
1227625a SP |
392 | .It Fl h |
393 | Extract the actual directory, | |
394 | rather than the files that it references. | |
395 | This prevents hierarchical restoration of complete subtrees | |
396 | from the dump. | |
e51470bf SP |
397 | .It Fl k |
398 | Use Kerberos authentication when contacting the remote tape server. | |
399 | (Only available if this options was enabled when | |
400 | .Nm restore | |
401 | was compiled.) | |
80dea635 SP |
402 | .It Fl l |
403 | When doing remote restores, assume the remote file is a | |
404 | regular file (instead of a tape device). If you're restoring | |
405 | a remote compressed file, you will need to specify this | |
406 | option or | |
407 | .Nm restore | |
408 | will fail to access it correctly. | |
05f23c0c SP |
409 | .It Fl L Ar limit |
410 | The | |
411 | .Fl L | |
412 | flag allows the user to specify a maximal number of miscompares | |
413 | when using | |
414 | .Nm restore | |
415 | with the | |
416 | .Fl C | |
417 | option to check the backup. If this limit is reached, | |
418 | .Nm restore | |
419 | will abort with an error message. A value of 0 (the default value) | |
420 | disables the check. | |
1227625a SP |
421 | .It Fl m |
422 | Extract by inode numbers rather than by file name. | |
423 | This is useful if only a few files are being extracted, | |
424 | and one wants to avoid regenerating the complete pathname | |
425 | to the file. | |
dc7cb1e2 SP |
426 | .It Fl M |
427 | Enables the multi-volume feature (for reading dumps made using | |
428 | the | |
429 | .Fl M | |
430 | option of dump). The name specified with | |
431 | .Fl f | |
432 | is treated as a prefix and | |
433 | .Nm | |
434 | tries to read in sequence from <prefix>001, <prefix>002 etc. | |
1227625a SP |
435 | .It Fl N |
436 | The | |
437 | .Fl N | |
438 | flag causes | |
dc7cb1e2 | 439 | .Nm |
05f23c0c SP |
440 | to perform a full execution as requested by one of |
441 | .Fl i, | |
442 | .Fl R, | |
443 | .Fl r, | |
444 | .Fl t | |
445 | or | |
446 | .Fl x | |
447 | command without actually writing any file on disk. | |
35b24fb7 SP |
448 | .It Fl Q Ar file |
449 | Use the file | |
450 | .Ar file | |
451 | in order to read tape position as stored using the dump Quick File | |
e51470bf SP |
452 | Access mode, in one of |
453 | .Fl i, | |
454 | .Fl x | |
455 | or | |
456 | .Fl t | |
457 | mode. | |
b8f7cbe6 SP |
458 | .Pp |
459 | It is recommended to set up the st driver to return logical tape | |
460 | positions rather than physical before calling dump/restore with | |
461 | parameter Q. Since not all tape devices support physical tape | |
462 | positions those tape devices return an error during dump/restore when | |
463 | the st driver is set to the default physical setting. | |
464 | Please see the st man page, option MTSETDRVBUFFER, or the mt man | |
465 | page, on how to set the driver to return logical tape positions. | |
466 | .Pp | |
467 | Before calling restore with parameter Q, always make sure the st | |
468 | driver is set to return the same type of tape position used during the | |
469 | call to dump. Otherwise restore may be confused. | |
103122b3 | 470 | .Pp |
e51470bf SP |
471 | This option can be used when restoring from local or remote tapes |
472 | (see above) or from local or remote files. | |
1227625a SP |
473 | .It Fl s Ar fileno |
474 | Read from the specified | |
475 | .Ar fileno | |
476 | on a multi-file tape. | |
477 | File numbering starts at 1. | |
478 | .It Fl T Ar directory | |
479 | The | |
480 | .Fl T | |
481 | flag allows the user to specify a directory to use for the storage of | |
482 | temporary files. The default value is /tmp. This flag is most useful | |
483 | when restoring files after having booted from a floppy. There might be little | |
484 | or no space on the floppy filesystem, but another source of space might exist. | |
b45f51d6 SP |
485 | .It Fl u |
486 | When creating certain types of files, restore may generate a warning | |
487 | diagnostic if they already exist in the target directory. | |
488 | To prevent this, the | |
489 | .Fl u | |
490 | (unlink) flag causes restore to remove old entries before attempting | |
491 | to create new ones. | |
1227625a SP |
492 | .It Fl v |
493 | Normally | |
494 | .Nm restore | |
495 | does its work silently. | |
496 | The | |
497 | .Fl v | |
498 | (verbose) | |
499 | flag causes it to type the name of each file it treats | |
500 | preceded by its file type. | |
8b7882a8 SP |
501 | .It Fl V |
502 | Enables reading multi-volume non-tape mediums like CDROMs. | |
08db2b86 | 503 | .It Fl X Ar filelist |
1a05d45d | 504 | Read list of files to be listed or extracted from the text file |
08db2b86 | 505 | .Ar filelist |
1a05d45d | 506 | in addition to those specified on the command line. This can be used in |
08db2b86 SP |
507 | conjunction with the |
508 | .Fl t | |
509 | or | |
510 | .Fl x | |
511 | commands. The file | |
512 | .Ar filelist | |
513 | should contain file names separated by newlines. | |
1a05d45d SP |
514 | .Ar filelist |
515 | may be an ordinary file or | |
516 | .Ql Fl | |
517 | (the standard input). | |
1227625a SP |
518 | .It Fl y |
519 | Do not ask the user whether to abort the restore in the event of an error. | |
520 | Always try to skip over the bad block(s) and continue. | |
521 | .El | |
522 | .Sh DIAGNOSTICS | |
ddd2ef55 | 523 | Complains if it gets a read error. |
1227625a SP |
524 | If |
525 | .Fl y | |
526 | has been specified, or the user responds | |
527 | .Ql y , | |
528 | .Nm restore | |
529 | will attempt to continue the restore. | |
530 | .Pp | |
531 | If a backup was made using more than one tape volume, | |
532 | .Nm restore | |
533 | will notify the user when it is time to mount the next volume. | |
534 | If the | |
535 | .Fl x | |
536 | or | |
537 | .Fl i | |
538 | flag has been specified, | |
539 | .Nm restore | |
540 | will also ask which volume the user wishes to mount. | |
541 | The fastest way to extract a few files is to | |
542 | start with the last volume, and work towards the first volume. | |
543 | .Pp | |
544 | There are numerous consistency checks that can be listed by | |
545 | .Nm restore . | |
ddd2ef55 SP |
546 | Most checks are self-explanatory or can |
547 | .Dq never happen . | |
1227625a SP |
548 | Common errors are given below. |
549 | .Pp | |
550 | .Bl -tag -width Ds -compact | |
ddd2ef55 | 551 | .It Converting to new file system format |
1227625a SP |
552 | A dump tape created from the old file system has been loaded. |
553 | It is automatically converted to the new file system format. | |
554 | .Pp | |
555 | .It <filename>: not found on tape | |
556 | The specified file name was listed in the tape directory, | |
557 | but was not found on the tape. | |
558 | This is caused by tape read errors while looking for the file, | |
559 | and from using a dump tape created on an active file system. | |
560 | .Pp | |
561 | .It expected next file <inumber>, got <inumber> | |
562 | A file that was not listed in the directory showed up. | |
563 | This can occur when using a dump created on an active file system. | |
564 | .Pp | |
565 | .It Incremental dump too low | |
ddd2ef55 | 566 | When doing an incremental restore, |
1227625a SP |
567 | a dump that was written before the previous incremental dump, |
568 | or that has too low an incremental level has been loaded. | |
569 | .Pp | |
570 | .It Incremental dump too high | |
ddd2ef55 | 571 | When doing an incremental restore, |
1227625a SP |
572 | a dump that does not begin its coverage where the previous incremental |
573 | dump left off, | |
574 | or that has too high an incremental level has been loaded. | |
575 | .Pp | |
576 | .It Tape read error while restoring <filename> | |
577 | .It Tape read error while skipping over inode <inumber> | |
578 | .It Tape read error while trying to resynchronize | |
579 | A tape (or other media) read error has occurred. | |
580 | If a file name is specified, | |
ddd2ef55 | 581 | its contents are probably partially wrong. |
1227625a | 582 | If an inode is being skipped or the tape is trying to resynchronize, |
ddd2ef55 | 583 | no extracted files have been corrupted, |
1227625a SP |
584 | though files may not be found on the tape. |
585 | .Pp | |
586 | .It resync restore, skipped <num> blocks | |
587 | After a dump read error, | |
588 | .Nm restore | |
589 | may have to resynchronize itself. | |
590 | This message lists the number of blocks that were skipped over. | |
591 | .El | |
3d78f5f2 SP |
592 | .Pp |
593 | .Nm Restore | |
594 | exits with zero status on success. | |
595 | Tape errors are indicated with an exit code of 1. | |
596 | .Pp | |
597 | When doing a comparison of files from a dump, an exit code | |
598 | of 2 indicates that some files were modified or deleted since | |
599 | the dump was made. | |
b45f51d6 | 600 | .Sh ENVIRONMENT |
ddd2ef55 SP |
601 | If the following environment variable exists it will be utilized by |
602 | .Nm restore : | |
603 | .Pp | |
604 | .Bl -tag -width "TMPDIR" -compact | |
b45f51d6 SP |
605 | .It Ev TAPE |
606 | If no -f option was specified, | |
607 | .Nm | |
608 | will use the device specified via | |
609 | .Ev TAPE | |
610 | as the dump device. | |
611 | .Ev TAPE | |
612 | may be of the form | |
613 | .Qq tapename , | |
ddd2ef55 | 614 | .Qq host:tapename |
b45f51d6 SP |
615 | or |
616 | .Qq user@host:tapename . | |
ddd2ef55 SP |
617 | .It Ev TMPDIR |
618 | The directory given in | |
619 | .Ev TMPDIR | |
620 | will be used | |
621 | instead of | |
622 | .Pa /tmp | |
623 | to store temporary files. | |
b45f51d6 SP |
624 | .It Ev RMT |
625 | The environment variable | |
626 | .Ev RMT | |
627 | will be used to determine the pathname of the remote | |
628 | .Xr rmt 8 | |
629 | program. | |
0c62667d SP |
630 | .It Ev RSH |
631 | .Nm Restore | |
632 | uses the contents of this variable to determine the name of the | |
633 | remote shell command to use when doing a network restore (rsh, ssh etc.). | |
634 | If this variable is not set, | |
635 | .Xr rcmd 3 | |
636 | will be used, but only root will be able to do a network restore. | |
7ae7e903 | 637 | .El |
1227625a SP |
638 | .Sh FILES |
639 | .Bl -tag -width "./restoresymtable" -compact | |
ddd2ef55 | 640 | .It Pa /dev/st0 |
1227625a SP |
641 | the default tape drive |
642 | .It Pa /tmp/rstdir* | |
ddd2ef55 | 643 | file containing directories on the tape |
1227625a | 644 | .It Pa /tmp/rstmode* |
ddd2ef55 | 645 | owner, mode, and time stamps for directories |
1227625a | 646 | .It Pa \&./restoresymtable |
ddd2ef55 | 647 | information passed between incremental restores |
1227625a SP |
648 | .El |
649 | .Sh SEE ALSO | |
650 | .Xr dump 8 , | |
1227625a | 651 | .Xr mount 8 , |
8d4197bb | 652 | .Xr mke2fs 8 , |
1227625a SP |
653 | .Xr rmt 8 |
654 | .Sh BUGS | |
655 | .Nm Restore | |
656 | can get confused when doing incremental restores from | |
657 | dumps that were made on active file systems. | |
658 | .Pp | |
ddd2ef55 SP |
659 | A level 0 dump must be done after a full restore. |
660 | Because | |
661 | .Nm restore | |
662 | runs in user code, | |
1227625a SP |
663 | it has no control over inode allocation; |
664 | thus a full dump must be done to get a new set of directories | |
665 | reflecting the new inode numbering, | |
ddd2ef55 SP |
666 | even though the content of the files is unchanged. |
667 | .Pp | |
668 | The temporary files | |
669 | .Pa /tmp/rstdir* | |
670 | and | |
671 | .Pa /tmp/rstmode* | |
672 | are generated with a unique name based on the date of the dump | |
673 | and the process ID (see | |
674 | .Xr mktemp 3 ), | |
675 | except when | |
676 | .Fl r | |
677 | or | |
678 | .Fl R | |
679 | is used. | |
680 | Because | |
681 | .Fl R | |
682 | allows you to restart a | |
683 | .Fl r | |
684 | operation that may have been interrupted, the temporary files should | |
685 | be the same across different processes. | |
686 | In all other cases, the files are unique because it is possible to | |
687 | have two different dumps started at the same time, and separate | |
688 | operations shouldn't conflict with each other. | |
b45f51d6 | 689 | .Pp |
0c62667d SP |
690 | To do a network restore, you have to run restore as root or use |
691 | a remote shell replacement (see RSH variable). This is due | |
b45f51d6 SP |
692 | to the previous security history of dump and restore. (restore is |
693 | written to be setuid root, but we are not certain all bugs are gone | |
694 | from the restore code - run setuid at your own risk.) | |
8d4197bb SP |
695 | .Sh AUTHOR |
696 | The | |
697 | .Nm dump/restore | |
7422942f | 698 | backup suite was ported to Linux's Second Extended File System |
8d4197bb SP |
699 | by Remy Card <card@Linux.EU.Org>. He maintained the initial versions |
700 | of dump (up and including 0.4b4, released in january 1997). | |
701 | .Pp | |
702 | Starting with 0.4b5, the new maintainer is Stelian Pop | |
703 | .br | |
11856e77 | 704 | <stelian@popies.net>. |
8d4197bb SP |
705 | .Sh AVAILABILITY |
706 | The | |
707 | .Nm dump/restore | |
7422942f | 708 | backup suite is available from |
01fb6bd5 SP |
709 | .br |
710 | http://dump.sourceforge.net | |
1227625a SP |
711 | .Sh HISTORY |
712 | The | |
713 | .Nm restore | |
714 | command appeared in | |
715 | .Bx 4.2 . |