.\" 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.24 2002/01/25 14:59:53 stelian Exp $
.\"
.Dd __DATE__
.Dt RESTORE 8
.Nm restore
.Fl i
.Op Fl achklmMNuvVy
+.Op Fl A Ar file
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Nm restore
.Fl t
.Op Fl chklMNuvVy
+.Op Fl A Ar file
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
.Nm restore
.Fl x
.Op Fl achklmMNuvVy
+.Op Fl A Ar file
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl F Ar script
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
.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
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