.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: restore.8.in,v 1.23 2002/01/22 11:12:28 stelian Exp $
+.\" $Id: restore.8.in,v 1.27 2002/06/08 07:10:37 stelian Exp $
.\"
.Dd __DATE__
.Dt RESTORE 8
.Sh SYNOPSIS
.Nm restore
.Fl C
-.Op Fl cklMvVy
+.Op Fl cdklMvVy
.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 achklmMNuvVy
+.Op Fl acdhklmMNouvVy
+.Op Fl A Ar file
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Nm restore
+.Fl P Ar file
+.Op Fl acdhklmMNuvVy
+.Op Fl A Ar file
+.Op Fl b Ar blocksize
+.Op Fl f Ar file
+.Op Fl F Ar script
+.Op Fl s Ar fileno
+.Op Fl T Ar directory
+.Op Fl X Ar filelist
+.Op file ...
+.Nm restore
.Fl R
-.Op Fl cklMNuvVy
+.Op Fl cdklMNuvVy
.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 cklMNuvVy
+.Op Fl cdklMNuvVy
.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 chklMNuvVy
+.Op Fl cdhklMNuvVy
+.Op Fl A Ar file
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Op file ...
.Nm restore
.Fl x
-.Op Fl achklmMNuvVy
+.Op Fl adchklmMNouvVy
+.Op Fl A Ar file
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Nm restore
to print out information about each file as it is extracted.
.El
+.It Fl P Ar file
+.Nm Restore
+creates a new Quick File Access file
+.Ar file
+from an existing dump file without restoring its contents.
.It Fl R
.Nm Restore
requests a particular tape of a multi-volume set on which to restart
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 A Ar archive_file
+Read the table of contents from
+.Ar archive_file
+instead of the media. This option can be used in combination with the
+.Fl t,
+.Fl i,
+or
+.Fl x
+options, making it possible to check whether files are on the media
+without having to mount the media.
.It Fl b Ar blocksize
The number of kilobytes per dump record.
If the
.Fl c
flag disables this check, and only allows reading a dump in the old
format.
+.It Fl d
+The
+.Fl d
+(debug)
+flag causes
+.Nm restore
+to print debug information.
.It Fl D Ar filesystem
The
.Fl D
.Nm
reverts back to the real user ID and the real group ID before
running the script.
-.It Fl k
-Use Kerberos authentication when contacting the remote tape server.
-(Only available if this options was enabled when
-.Nm restore
-was compiled.)
-.Pp
.It Fl h
Extract the actual directory,
rather than the files that it references.
This prevents hierarchical restoration of complete subtrees
from the dump.
+.It Fl k
+Use Kerberos authentication when contacting the remote tape server.
+(Only available if this options was enabled when
+.Nm restore
+was compiled.)
.It Fl l
When doing remote restores, assume the remote file is a
regular file (instead of a tape device). If you're restoring
or
.Fl x
command without actually writing any file on disk.
+.It Fl o
+The
+.Fl o
+flag causes
+.Nm
+to automatically restore the current directory permissions
+without asking the operator whether to do so in one of
+.Fl i
+or
+.Fl x
+modes.
.It Fl Q Ar file
Use the file
.Ar file
in order to read tape position as stored using the dump Quick File
-Access mode.
+Access mode, in one of
+.Fl i,
+.Fl x
+or
+.Fl t
+mode.
.Pp
It is recommended to set up the st driver to return logical tape
positions rather than physical before calling dump/restore with
driver is set to return the same type of tape position used during the
call to dump. Otherwise restore may be confused.
.Pp
-This option can be used when restoring from local tapes (see above)
-or from local files.
+This option can be used when restoring from local or remote tapes
+(see above) or from local or remote files.
.It Fl s Ar fileno
Read from the specified
.Ar fileno