1994-05-26 06:35:07 +00:00
|
|
|
.\" Copyright (c) 1985, 1991, 1993
|
|
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
|
|
.\" may be used to endorse or promote products derived from this software
|
|
|
|
.\" without specific prior written permission.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
1997-03-11 12:55:19 +00:00
|
|
|
.\" @(#)restore.8 8.4 (Berkeley) 5/1/95
|
1999-08-28 00:22:10 +00:00
|
|
|
.\" $FreeBSD$
|
1997-03-11 12:55:19 +00:00
|
|
|
.\"
|
2006-10-12 14:47:20 +00:00
|
|
|
.Dd October 12, 2006
|
1994-05-26 06:35:07 +00:00
|
|
|
.Dt RESTORE 8
|
2001-07-10 11:04:34 +00:00
|
|
|
.Os
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh NAME
|
2000-01-10 12:27:33 +00:00
|
|
|
.Nm restore ,
|
|
|
|
.Nm rrestore
|
2002-08-21 18:11:48 +00:00
|
|
|
.Nd "restore files or file systems from backups made with dump"
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh SYNOPSIS
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl i
|
2006-12-05 11:18:51 +00:00
|
|
|
.Op Fl dDhmNuvy
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl b Ar blocksize
|
2004-04-13 02:58:06 +00:00
|
|
|
.Op Fl f Ar file | Fl P Ar pipecommand
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl s Ar fileno
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl R
|
2006-12-05 11:18:51 +00:00
|
|
|
.Op Fl dDNuvy
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl b Ar blocksize
|
2004-04-13 02:58:06 +00:00
|
|
|
.Op Fl f Ar file | Fl P Ar pipecommand
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl s Ar fileno
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl r
|
2006-12-05 11:18:51 +00:00
|
|
|
.Op Fl dDNuvy
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl b Ar blocksize
|
2004-04-13 02:58:06 +00:00
|
|
|
.Op Fl f Ar file | Fl P Ar pipecommand
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl s Ar fileno
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl t
|
2006-12-05 11:18:51 +00:00
|
|
|
.Op Fl dDhNuvy
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl b Ar blocksize
|
2004-04-13 02:58:06 +00:00
|
|
|
.Op Fl f Ar file | Fl P Ar pipecommand
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl s Ar fileno
|
2001-02-13 09:56:35 +00:00
|
|
|
.Op Ar
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl x
|
2006-12-05 11:18:51 +00:00
|
|
|
.Op Fl dDhmNuvy
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl b Ar blocksize
|
2004-04-13 02:58:06 +00:00
|
|
|
.Op Fl f Ar file | Fl P Ar pipecommand
|
1997-03-11 12:55:19 +00:00
|
|
|
.Op Fl s Ar fileno
|
2001-02-13 09:56:35 +00:00
|
|
|
.Op Ar
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
2002-07-06 19:35:14 +00:00
|
|
|
utility performs the inverse function of
|
1994-05-26 06:35:07 +00:00
|
|
|
.Xr dump 8 .
|
2002-08-21 18:11:48 +00:00
|
|
|
A full backup of a file system may be restored and
|
1994-05-26 06:35:07 +00:00
|
|
|
subsequent incremental backups layered on top of it.
|
|
|
|
Single files and
|
|
|
|
directory subtrees may be restored from full or partial
|
|
|
|
backups.
|
2002-07-06 19:35:14 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility works across a network;
|
1994-05-26 06:35:07 +00:00
|
|
|
to do this see the
|
|
|
|
.Fl f
|
2004-04-13 02:58:06 +00:00
|
|
|
and
|
|
|
|
.Fl P
|
|
|
|
flags described below.
|
1994-05-26 06:35:07 +00:00
|
|
|
Other arguments to the command are file or directory
|
|
|
|
names specifying the files that are to be restored.
|
|
|
|
Unless the
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl h
|
|
|
|
flag is specified (see below),
|
1994-05-26 06:35:07 +00:00
|
|
|
the appearance of a directory name refers to
|
|
|
|
the files and (recursively) subdirectories of that directory.
|
|
|
|
.Pp
|
2012-05-23 15:06:13 +00:00
|
|
|
.Nm
|
|
|
|
may also be invoked as
|
|
|
|
.Nm rrestore .
|
|
|
|
The
|
|
|
|
.Bx 4.3
|
|
|
|
option syntax is implemented for backward compatibility, but
|
|
|
|
is not documented here.
|
|
|
|
.Pp
|
1997-03-11 12:55:19 +00:00
|
|
|
Exactly one of the following flags is required:
|
1994-05-26 06:35:07 +00:00
|
|
|
.Bl -tag -width Ds
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl i
|
1994-05-26 06:35:07 +00:00
|
|
|
This mode allows interactive restoration of files from a dump.
|
|
|
|
After reading in the directory information from the dump,
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
provides a shell like interface that allows the user to move
|
|
|
|
around the directory tree selecting files to be extracted.
|
|
|
|
The available commands are given below;
|
|
|
|
for those commands that require an argument,
|
|
|
|
the default is the current directory.
|
|
|
|
.Bl -tag -width Fl
|
|
|
|
.It Ic add Op Ar arg
|
|
|
|
The current directory or specified argument is added to the list of
|
|
|
|
files to be extracted.
|
|
|
|
If a directory is specified, then it and all its descendents are
|
|
|
|
added to the extraction list
|
|
|
|
(unless the
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl h
|
|
|
|
flag is specified on the command line).
|
1994-05-26 06:35:07 +00:00
|
|
|
Files that are on the extraction list are prepended with a ``*''
|
2001-07-15 07:53:42 +00:00
|
|
|
when they are listed by
|
1994-05-26 06:35:07 +00:00
|
|
|
.Ic ls .
|
|
|
|
.It Ic \&cd Ar arg
|
|
|
|
Change the current working directory to the specified argument.
|
|
|
|
.It Ic delete Op Ar arg
|
|
|
|
The current directory or specified argument is deleted from the list of
|
|
|
|
files to be extracted.
|
|
|
|
If a directory is specified, then it and all its descendents are
|
|
|
|
deleted from the extraction list
|
|
|
|
(unless the
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl h
|
|
|
|
flag is specified on the command line).
|
2001-07-15 07:53:42 +00:00
|
|
|
The most expedient way to extract most of the files from a directory
|
1994-05-26 06:35:07 +00:00
|
|
|
is to add the directory to the extraction list and then delete
|
|
|
|
those files that are not needed.
|
|
|
|
.It Ic extract
|
|
|
|
All the files that are on the extraction list are extracted
|
|
|
|
from the dump.
|
2002-07-06 19:35:14 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility will ask which volume the user wishes to mount.
|
1994-05-26 06:35:07 +00:00
|
|
|
The fastest way to extract a few files is to
|
|
|
|
start with the last volume, and work towards the first volume.
|
|
|
|
.It Ic help
|
|
|
|
List a summary of the available commands.
|
|
|
|
.It Ic \&ls Op Ar arg
|
|
|
|
List the current or specified directory.
|
|
|
|
Entries that are directories are appended with a ``/''.
|
|
|
|
Entries that have been marked for extraction are prepended with a ``*''.
|
1997-03-11 12:55:19 +00:00
|
|
|
If the verbose
|
|
|
|
flag is set the inode number of each entry is also listed.
|
1994-05-26 06:35:07 +00:00
|
|
|
.It Ic pwd
|
|
|
|
Print the full pathname of the current working directory.
|
|
|
|
.It Ic quit
|
2002-07-06 19:35:14 +00:00
|
|
|
Exit immediately,
|
1994-05-26 06:35:07 +00:00
|
|
|
even if the extraction list is not empty.
|
|
|
|
.It Ic setmodes
|
|
|
|
All the directories that have been added to the extraction list
|
|
|
|
have their owner, modes, and times set;
|
|
|
|
nothing is extracted from the dump.
|
|
|
|
This is useful for cleaning up after a restore has been prematurely aborted.
|
|
|
|
.It Ic verbose
|
2001-07-15 07:53:42 +00:00
|
|
|
The sense of the
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl v
|
|
|
|
flag is toggled.
|
2001-07-15 07:53:42 +00:00
|
|
|
When set, the verbose flag causes the
|
1994-05-26 06:35:07 +00:00
|
|
|
.Ic ls
|
|
|
|
command to list the inode numbers of all entries.
|
|
|
|
It also causes
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
to print out information about each file as it is extracted.
|
2001-06-20 04:00:43 +00:00
|
|
|
.It Ic what
|
2002-07-06 19:35:14 +00:00
|
|
|
Display dump header information, which includes: date,
|
2002-08-21 18:11:48 +00:00
|
|
|
level, label, and the file system and host dump was made
|
2001-06-20 04:00:43 +00:00
|
|
|
from.
|
1994-05-26 06:35:07 +00:00
|
|
|
.El
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl R
|
2002-07-06 19:35:14 +00:00
|
|
|
Request a particular tape of a multi volume set on which to restart
|
1997-03-11 12:55:19 +00:00
|
|
|
a full restore
|
|
|
|
(see the
|
|
|
|
.Fl r
|
|
|
|
flag below).
|
|
|
|
This is useful if the restore has been interrupted.
|
|
|
|
.It Fl r
|
2002-08-21 18:11:48 +00:00
|
|
|
Restore (rebuild a file system).
|
|
|
|
The target file system should be made pristine with
|
1997-03-11 12:55:19 +00:00
|
|
|
.Xr newfs 8 ,
|
|
|
|
mounted and the user
|
2003-06-08 12:51:28 +00:00
|
|
|
.Xr cd 1 Ns 'd
|
2002-08-21 18:11:48 +00:00
|
|
|
into the pristine file system
|
2000-03-01 11:27:47 +00:00
|
|
|
before starting the restoration of the initial level 0 backup.
|
|
|
|
If the
|
1997-03-11 12:55:19 +00:00
|
|
|
level 0 restores successfully, the
|
|
|
|
.Fl r
|
|
|
|
flag may be used to restore
|
|
|
|
any necessary incremental backups on top of the level 0.
|
|
|
|
The
|
|
|
|
.Fl r
|
|
|
|
flag precludes an interactive file extraction and can be
|
|
|
|
detrimental to one's health if not used carefully (not to mention
|
2004-07-02 21:45:06 +00:00
|
|
|
the disk).
|
|
|
|
An example:
|
1997-03-11 12:55:19 +00:00
|
|
|
.Bd -literal -offset indent
|
2000-05-07 09:16:56 +00:00
|
|
|
newfs /dev/da0s1a
|
|
|
|
mount /dev/da0s1a /mnt
|
1997-03-11 12:55:19 +00:00
|
|
|
cd /mnt
|
|
|
|
|
2001-03-09 13:06:09 +00:00
|
|
|
restore rf /dev/sa0
|
1997-03-11 12:55:19 +00:00
|
|
|
.Ed
|
|
|
|
.Pp
|
2001-07-15 07:53:42 +00:00
|
|
|
Note that
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
2001-07-15 07:53:42 +00:00
|
|
|
leaves a file
|
1997-03-11 12:55:19 +00:00
|
|
|
.Pa restoresymtable
|
|
|
|
in the root directory to pass information between incremental
|
|
|
|
restore passes.
|
|
|
|
This file should be removed when the last incremental has been
|
|
|
|
restored.
|
|
|
|
.Pp
|
2002-07-06 19:35:14 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility ,
|
1997-03-11 12:55:19 +00:00
|
|
|
in conjunction with
|
|
|
|
.Xr newfs 8
|
|
|
|
and
|
|
|
|
.Xr dump 8 ,
|
2002-08-21 18:11:48 +00:00
|
|
|
may be used to modify file system parameters
|
1997-03-11 12:55:19 +00:00
|
|
|
such as size or block size.
|
|
|
|
.It Fl t
|
|
|
|
The names of the specified files are listed if they occur
|
|
|
|
on the backup.
|
|
|
|
If no file argument is given,
|
|
|
|
then the root directory is listed,
|
|
|
|
which results in the entire content of the
|
|
|
|
backup being listed,
|
|
|
|
unless the
|
|
|
|
.Fl h
|
|
|
|
flag has been specified.
|
|
|
|
Note that the
|
|
|
|
.Fl t
|
|
|
|
flag replaces the function of the old
|
|
|
|
.Xr dumpdir 8
|
|
|
|
program.
|
|
|
|
.It Fl x
|
|
|
|
The named files are read from the given media.
|
2001-07-15 07:53:42 +00:00
|
|
|
If a named file matches a directory whose contents
|
1997-03-11 12:55:19 +00:00
|
|
|
are on the backup
|
|
|
|
and the
|
|
|
|
.Fl h
|
|
|
|
flag is not specified,
|
|
|
|
the directory is recursively extracted.
|
|
|
|
The owner, modification time,
|
|
|
|
and mode are restored (if possible).
|
|
|
|
If no file argument is given,
|
|
|
|
then the root directory is extracted,
|
|
|
|
which results in the entire content of the
|
|
|
|
backup being extracted,
|
|
|
|
unless the
|
|
|
|
.Fl h
|
|
|
|
flag has been specified.
|
1994-05-26 06:35:07 +00:00
|
|
|
.El
|
|
|
|
.Pp
|
1997-03-11 12:55:19 +00:00
|
|
|
The following additional options may be specified:
|
1994-05-26 06:35:07 +00:00
|
|
|
.Bl -tag -width Ds
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl b Ar blocksize
|
|
|
|
The number of kilobytes per dump record.
|
1994-05-26 06:35:07 +00:00
|
|
|
If the
|
|
|
|
.Fl b
|
|
|
|
option is not specified,
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
tries to determine the media block size dynamically.
|
2001-10-02 08:24:37 +00:00
|
|
|
.It Fl d
|
|
|
|
Sends verbose debugging output to the standard error.
|
2006-12-05 11:18:51 +00:00
|
|
|
.It Fl D
|
|
|
|
This puts
|
|
|
|
.Nm
|
|
|
|
into degraded mode,
|
|
|
|
causing restore to operate less efficiently
|
|
|
|
but to try harder to read corrupted backups.
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl f Ar file
|
|
|
|
Read the backup from
|
|
|
|
.Ar file ;
|
|
|
|
.Ar file
|
|
|
|
may be a special device file
|
|
|
|
like
|
2001-03-09 13:06:09 +00:00
|
|
|
.Pa /dev/sa0
|
1997-03-11 12:55:19 +00:00
|
|
|
(a tape drive),
|
2000-05-07 09:16:56 +00:00
|
|
|
.Pa /dev/da1c
|
1997-03-11 12:55:19 +00:00
|
|
|
(a disk drive),
|
|
|
|
an ordinary file,
|
|
|
|
or
|
2002-12-23 16:04:51 +00:00
|
|
|
.Sq Fl
|
1997-03-11 12:55:19 +00:00
|
|
|
(the standard input).
|
1994-05-26 06:35:07 +00:00
|
|
|
If the name of the file is of the form
|
|
|
|
.Dq host:file ,
|
1997-03-11 12:55:19 +00:00
|
|
|
or
|
|
|
|
.Dq user@host:file ,
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
reads from the named file on the remote host using
|
|
|
|
.Xr rmt 8 .
|
2004-04-13 02:58:06 +00:00
|
|
|
.It Fl P Ar pipecommand
|
|
|
|
Use
|
|
|
|
.Xr popen 3
|
|
|
|
to execute the
|
|
|
|
.Xr sh 1
|
|
|
|
script string defined by
|
|
|
|
.Ar pipecommand
|
|
|
|
as the input for every volume in the backup.
|
|
|
|
This child pipeline's
|
|
|
|
.Dv stdout
|
2004-05-17 08:35:43 +00:00
|
|
|
.Pq Pa /dev/fd/1
|
2004-04-13 02:58:06 +00:00
|
|
|
is redirected to the
|
|
|
|
.Nm
|
|
|
|
input stream, and the environment variable
|
|
|
|
.Ev RESTORE_VOLUME
|
|
|
|
is set to the current volume number being read.
|
|
|
|
The
|
|
|
|
.Ar pipecommand
|
|
|
|
script is started each time a volume is loaded, as if it were a tape drive.
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl h
|
2001-07-15 07:53:42 +00:00
|
|
|
Extract the actual directory,
|
1994-05-26 06:35:07 +00:00
|
|
|
rather than the files that it references.
|
|
|
|
This prevents hierarchical restoration of complete subtrees
|
|
|
|
from the dump.
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl m
|
|
|
|
Extract by inode numbers rather than by file name.
|
1994-05-26 06:35:07 +00:00
|
|
|
This is useful if only a few files are being extracted,
|
|
|
|
and one wants to avoid regenerating the complete pathname
|
|
|
|
to the file.
|
2000-02-17 02:15:18 +00:00
|
|
|
.It Fl N
|
2001-07-15 07:53:42 +00:00
|
|
|
Do the extraction normally, but do not actually write any changes
|
2000-03-01 11:27:47 +00:00
|
|
|
to disk.
|
2001-07-15 07:53:42 +00:00
|
|
|
This can be used to check the integrity of dump media
|
2000-02-17 02:15:18 +00:00
|
|
|
or other test purposes.
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl s Ar fileno
|
|
|
|
Read from the specified
|
|
|
|
.Ar fileno
|
|
|
|
on a multi-file tape.
|
|
|
|
File numbering starts at 1.
|
1998-05-09 05:23:02 +00:00
|
|
|
.It Fl u
|
|
|
|
When creating certain types of files, restore may generate a warning
|
|
|
|
diagnostic if they already exist in the target directory.
|
|
|
|
To prevent this, the
|
|
|
|
.Fl u
|
|
|
|
(unlink) flag causes restore to remove old entries before attempting
|
|
|
|
to create new ones.
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl v
|
1994-05-26 06:35:07 +00:00
|
|
|
Normally
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
does its work silently.
|
|
|
|
The
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl v
|
1994-05-26 06:35:07 +00:00
|
|
|
(verbose)
|
1997-03-11 12:55:19 +00:00
|
|
|
flag causes it to type the name of each file it treats
|
1994-05-26 06:35:07 +00:00
|
|
|
preceded by its file type.
|
1997-03-11 12:55:19 +00:00
|
|
|
.It Fl y
|
|
|
|
Do not ask the user whether to abort the restore in the event of an error.
|
|
|
|
Always try to skip over the bad block(s) and continue.
|
1994-05-26 06:35:07 +00:00
|
|
|
.El
|
2005-01-18 10:09:38 +00:00
|
|
|
.Sh ENVIRONMENT
|
|
|
|
.Bl -tag -width ".Ev TMPDIR"
|
|
|
|
.It Ev TAPE
|
|
|
|
Device from which to read backup.
|
|
|
|
.It Ev TMPDIR
|
|
|
|
Name of directory where temporary files are to be created.
|
|
|
|
.El
|
|
|
|
.Sh FILES
|
|
|
|
.Bl -tag -width "./restoresymtable" -compact
|
|
|
|
.It Pa /dev/sa0
|
|
|
|
the default tape drive
|
|
|
|
.It Pa /tmp/rstdir*
|
|
|
|
file containing directories on the tape.
|
|
|
|
.It Pa /tmp/rstmode*
|
|
|
|
owner, mode, and time stamps for directories.
|
|
|
|
.It Pa \&./restoresymtable
|
|
|
|
information passed between incremental restores.
|
|
|
|
.El
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh DIAGNOSTICS
|
2002-07-06 19:35:14 +00:00
|
|
|
The
|
2001-08-20 02:16:41 +00:00
|
|
|
.Nm
|
2002-07-06 19:35:14 +00:00
|
|
|
utility complains if it gets a read error.
|
2001-07-15 07:53:42 +00:00
|
|
|
If
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl y
|
1994-05-26 06:35:07 +00:00
|
|
|
has been specified, or the user responds
|
|
|
|
.Ql y ,
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
will attempt to continue the restore.
|
|
|
|
.Pp
|
|
|
|
If a backup was made using more than one tape volume,
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
will notify the user when it is time to mount the next volume.
|
|
|
|
If the
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl x
|
1994-05-26 06:35:07 +00:00
|
|
|
or
|
1997-03-11 12:55:19 +00:00
|
|
|
.Fl i
|
|
|
|
flag has been specified,
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
will also ask which volume the user wishes to mount.
|
|
|
|
The fastest way to extract a few files is to
|
|
|
|
start with the last volume, and work towards the first volume.
|
|
|
|
.Pp
|
|
|
|
There are numerous consistency checks that can be listed by
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm .
|
1994-05-26 06:35:07 +00:00
|
|
|
Most checks are self-explanatory or can ``never happen''.
|
|
|
|
Common errors are given below.
|
|
|
|
.Pp
|
|
|
|
.Bl -tag -width Ds -compact
|
|
|
|
.It <filename>: not found on tape
|
|
|
|
The specified file name was listed in the tape directory,
|
|
|
|
but was not found on the tape.
|
|
|
|
This is caused by tape read errors while looking for the file,
|
2002-08-21 18:11:48 +00:00
|
|
|
and from using a dump tape created on an active file system.
|
1994-05-26 06:35:07 +00:00
|
|
|
.Pp
|
|
|
|
.It expected next file <inumber>, got <inumber>
|
|
|
|
A file that was not listed in the directory showed up.
|
2002-08-21 18:11:48 +00:00
|
|
|
This can occur when using a dump created on an active file system.
|
1994-05-26 06:35:07 +00:00
|
|
|
.Pp
|
|
|
|
.It Incremental dump too low
|
|
|
|
When doing incremental restore,
|
|
|
|
a dump that was written before the previous incremental dump,
|
|
|
|
or that has too low an incremental level has been loaded.
|
|
|
|
.Pp
|
|
|
|
.It Incremental dump too high
|
|
|
|
When doing incremental restore,
|
2001-07-15 07:53:42 +00:00
|
|
|
a dump that does not begin its coverage where the previous incremental
|
1994-05-26 06:35:07 +00:00
|
|
|
dump left off,
|
|
|
|
or that has too high an incremental level has been loaded.
|
|
|
|
.Pp
|
|
|
|
.It Tape read error while restoring <filename>
|
|
|
|
.It Tape read error while skipping over inode <inumber>
|
|
|
|
.It Tape read error while trying to resynchronize
|
|
|
|
A tape (or other media) read error has occurred.
|
|
|
|
If a file name is specified,
|
|
|
|
then its contents are probably partially wrong.
|
|
|
|
If an inode is being skipped or the tape is trying to resynchronize,
|
|
|
|
then no extracted files have been corrupted,
|
|
|
|
though files may not be found on the tape.
|
|
|
|
.Pp
|
|
|
|
.It resync restore, skipped <num> blocks
|
2001-07-15 07:53:42 +00:00
|
|
|
After a dump read error,
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
1994-05-26 06:35:07 +00:00
|
|
|
may have to resynchronize itself.
|
|
|
|
This message lists the number of blocks that were skipped over.
|
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr dump 8 ,
|
|
|
|
.Xr mount 8 ,
|
1997-01-13 00:25:51 +00:00
|
|
|
.Xr newfs 8 ,
|
1994-05-26 06:35:07 +00:00
|
|
|
.Xr rmt 8
|
2005-01-18 10:09:38 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility appeared in
|
|
|
|
.Bx 4.2 .
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh BUGS
|
2002-07-06 19:35:14 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility can get confused when doing incremental restores from
|
2006-10-12 14:47:20 +00:00
|
|
|
dumps that were made on active file systems without the
|
|
|
|
.Fl L
|
|
|
|
option (see
|
|
|
|
.Xr dump 8 ) .
|
1994-05-26 06:35:07 +00:00
|
|
|
.Pp
|
|
|
|
A level zero dump must be done after a full restore.
|
|
|
|
Because restore runs in user code,
|
|
|
|
it has no control over inode allocation;
|
1995-01-18 19:26:14 +00:00
|
|
|
thus a full dump must be done to get a new set of directories
|
1994-05-26 06:35:07 +00:00
|
|
|
reflecting the new inode numbering,
|
|
|
|
even though the contents of the files is unchanged.
|
1997-02-09 18:03:41 +00:00
|
|
|
.Pp
|
2004-07-02 21:45:06 +00:00
|
|
|
To do a network restore, you have to run restore as root.
|
|
|
|
This is due
|
|
|
|
to the previous security history of dump and restore.
|
|
|
|
(restore is
|
1997-02-09 18:03:41 +00:00
|
|
|
written to be setuid root, but we are not certain all bugs are gone
|
|
|
|
from the restore code - run setuid at your own risk.)
|
2000-08-11 10:37:39 +00:00
|
|
|
.Pp
|
|
|
|
The temporary files
|
|
|
|
.Pa /tmp/rstdir*
|
|
|
|
and
|
|
|
|
.Pa /tmp/rstmode*
|
|
|
|
are generated with a unique name based on the date of the dump
|
|
|
|
and the process ID (see
|
2001-01-16 09:15:57 +00:00
|
|
|
.Xr mktemp 3 ) ,
|
2000-08-11 10:37:39 +00:00
|
|
|
except for when
|
|
|
|
.Fl r
|
|
|
|
or
|
|
|
|
.Fl R
|
|
|
|
is used.
|
|
|
|
Because
|
|
|
|
.Fl R
|
|
|
|
allows you to restart a
|
|
|
|
.Fl r
|
|
|
|
operation that may have been interrupted, the temporary files should
|
|
|
|
be the same across different processes.
|
|
|
|
In all other cases, the files are unique because it is possible to
|
|
|
|
have two different dumps started at the same time, and separate
|
2005-02-13 22:25:33 +00:00
|
|
|
operations should not conflict with each other.
|