.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" @(#)restore.8 8.4 (Berkeley) 5/1/95
-.\" $Id: restore.8.in,v 1.1 1999/10/11 13:08:09 stelian Exp $
+.\" $Id: restore.8.in,v 1.10 2000/05/28 16:52:21 stelian Exp $
.\"
.Dd __DATE__
.Dt RESTORE 8
-.Os "__VERSION__"
+.Os "restore __VERSION__"
.Sh NAME
.Nm restore
.Nd "restore files or file systems from backups made with dump"
.Sh SYNOPSIS
.Nm restore
.Fl C
-.Op Fl ckvy
+.Op Fl ckMvy
.Op Fl b Ar blocksize
.Op Fl D Ar filesystem
.Op Fl f Ar file
.Op Fl T Ar directory
.Nm restore
.Fl i
-.Op Fl chkmNuvy
+.Op Fl chkmMNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Nm restore
.Fl R
-.Op Fl ckNuvy
+.Op Fl ckMNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Nm restore
.Fl r
-.Op Fl ckNuvy
+.Op Fl ckMNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Nm restore
.Fl t
-.Op Fl chkNuvy
+.Op Fl chkMNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
.Op Fl T Ar directory
+.Op Fl X Ar filelist
.Op file ...
.Nm restore
.Fl x
-.Op Fl chkmNuvy
+.Op Fl chkmMNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
.Op Fl T Ar directory
+.Op Fl X Ar filelist
.Op file ...
.Pp
.in
flag replaces the function of the old
.Xr dumpdir 8
program.
+See also the
+.Fl X
+option below.
.ne 1i
.It Fl x
The named files are read from the given media.
unless the
.Fl h
flag has been specified.
+See also the
+.Fl X
+option below.
.El
.Pp
The following additional options may be specified:
This is useful if only a few files are being extracted,
and one wants to avoid regenerating the complete pathname
to the file.
+.It Fl M
+Enables the multi-volume feature (for reading dumps made using
+the
+.Fl M
+option of dump). The name specified with
+.Fl f
+is treated as a prefix and
+.Nm
+tries to read in sequence from <prefix>001, <prefix>002 etc.
.It Fl N
The
.Fl N
flag causes
-.Nm restore to only print file names. Files are not extracted.
+.Nm
+to only print file names. Files are not extracted.
.It Fl s Ar fileno
Read from the specified
.Ar fileno
(verbose)
flag causes it to type the name of each file it treats
preceded by its file type.
+.It Fl X Ar filelist
+Read list of files to be listed or extracted from the text file
+.Ar filelist
+in addition to those specified on the command line. This can be used in
+conjunction with the
+.Fl t
+or
+.Fl x
+commands. The file
+.Ar filelist
+should contain file names separated by newlines.
+.Ar filelist
+may be an ordinary file or
+.Ql Fl
+(the standard input).
.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.
may have to resynchronize itself.
This message lists the number of blocks that were skipped over.
.El
+.Pp
+.Nm Restore
+exits with zero status on success.
+Tape errors are indicated with an exit code of 1.
+.Pp
+When doing a comparison of files from a dump, an exit code
+of 2 indicates that some files were modified or deleted since
+the dump was made.
.Sh ENVIRONMENT
If the following environment variable exists it will be utilized by
.Nm restore :
will be used to determine the pathname of the remote
.Xr rmt 8
program.
+.It Ev RSH
+.Nm Restore
+uses the contents of this variable to determine the name of the
+remote shell command to use when doing a network restore (rsh, ssh etc.).
+If this variable is not set,
+.Xr rcmd 3
+will be used, but only root will be able to do a network restore.
.Sh FILES
.Bl -tag -width "./restoresymtable" -compact
.It Pa /dev/st0
have two different dumps started at the same time, and separate
operations shouldn't conflict with each other.
.Pp
-To do a network restore, you have to run restore as root. This is due
+To do a network restore, you have to run restore as root or use
+a remote shell replacement (see RSH variable). This is due
to the previous security history of dump and restore. (restore is
written to be setuid root, but we are not certain all bugs are gone
from the restore code - run setuid at your own risk.)
.Sh AVAILABILITY
The
.Nm dump/restore
-backup suit is available for anonymous ftp from tsx-11.mit.edu
-in /pub/linux/ALPHA/ext2fs (development versions) or
-/pub/linux/packages/ext2fs (stable versions).
-.Pp
-An alternate downloading location is http://perso.cybercable.fr/pop/dump.
+backup suit is available from
+.br
+http://dump.sourceforge.net
.Sh HISTORY
The
.Nm restore