.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: restore.8.in,v 1.16 2001/07/18 13:12:33 stelian Exp $
+.\" $Id: restore.8.in,v 1.22 2002/01/16 10:29:26 stelian Exp $
.\"
.Dd __DATE__
.Dt RESTORE 8
.Sh SYNOPSIS
.Nm restore
.Fl C
-.Op Fl ckMvy
+.Op Fl cklMvVy
.Op Fl b Ar blocksize
.Op Fl D Ar filesystem
.Op Fl f Ar file
.Op Fl F Ar script
+.Op Fl L Ar limit
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Nm restore
.Fl i
-.Op Fl chkmMNuvy
+.Op Fl achklmMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Op Fl T Ar directory
.Nm restore
.Fl R
-.Op Fl ckMNuvy
+.Op Fl cklMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Op Fl T Ar directory
.Nm restore
.Fl r
-.Op Fl ckMNuvy
+.Op Fl cklMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Op Fl T Ar directory
.Nm restore
.Fl t
-.Op Fl chkMNuvy
+.Op Fl chklMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Op file ...
.Nm restore
.Fl x
-.Op Fl chkmMNuvy
+.Op Fl achklmMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
It first changes its working directory to the root of the filesystem
that was dumped and compares the tape with the files in its new
current directory.
+See also the
+.Fl L
+flag described below.
.It Fl i
This mode allows interactive restoration of files from a dump.
After reading in the directory information from the dump,
.Pp
The following additional options may be specified:
.Bl -tag -width Ds
+.It Fl a
+In
+.Fl i
+or
+.Fl x
+mode,
+.Nm restore
+does ask the user for the volume number on which the files to
+be extracted are supposed to be (in order to minimise the time
+be reading only the interesting volumes). The
+.Fl a
+option disables this behaviour and reads all the volumes starting
+with 1. This option is useful when the operator does not know on which
+volume the files to be extracted are and/or when he prefers the
+longer unattended mode rather than the shorter interactive mode.
.It Fl b Ar blocksize
The number of kilobytes per dump record.
If the
rather than the files that it references.
This prevents hierarchical restoration of complete subtrees
from the dump.
+.It Fl l
+When doing remote restores, assume the remote file is a
+regular file (instead of a tape device). If you're restoring
+a remote compressed file, you will need to specify this
+option or
+.Nm restore
+will fail to access it correctly.
+.It Fl L Ar limit
+The
+.Fl L
+flag allows the user to specify a maximal number of miscompares
+when using
+.Nm restore
+with the
+.Fl C
+option to check the backup. If this limit is reached,
+.Nm restore
+will abort with an error message. A value of 0 (the default value)
+disables the check.
.It Fl m
Extract by inode numbers rather than by file name.
This is useful if only a few files are being extracted,
.Fl N
flag causes
.Nm
-to only print file names. Files are not extracted.
+to perform a full execution as requested by one of
+.Fl i,
+.Fl R,
+.Fl r,
+.Fl t
+or
+.Fl x
+command without actually writing any file on disk.
.It Fl Q Ar file
Use the file
.Ar file
(verbose)
flag causes it to type the name of each file it treats
preceded by its file type.
+.It Fl V
+Enables reading multi-volume non-tape mediums like CDROMs.
.It Fl X Ar filelist
Read list of files to be listed or extracted from the text file
.Ar filelist
If this variable is not set,
.Xr rcmd 3
will be used, but only root will be able to do a network restore.
+.El
.Sh FILES
.Bl -tag -width "./restoresymtable" -compact
.It Pa /dev/st0
.Pp
Starting with 0.4b5, the new maintainer is Stelian Pop
.br
-<pop@noos.fr>.
+<stelian@popies.net>.
.Sh AVAILABILITY
The
.Nm dump/restore