.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: restore.8.in,v 1.12 2001/03/23 14:40:12 stelian Exp $
+.\" $Id: restore.8.in,v 1.18 2001/11/10 23:51:00 stelian Exp $
.\"
.Dd __DATE__
.Dt RESTORE 8
.Sh SYNOPSIS
.Nm restore
.Fl C
-.Op Fl ckMvy
+.Op Fl ckMvVy
.Op Fl b Ar blocksize
.Op Fl D Ar filesystem
.Op Fl f Ar file
+.Op Fl F Ar script
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Nm restore
.Fl i
-.Op Fl chkmMNuvy
+.Op Fl chkmMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
+.Op Fl F Ar script
+.Op Fl Q Ar file
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Nm restore
.Fl R
-.Op Fl ckMNuvy
+.Op Fl ckMNuvVy
.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 r
-.Op Fl ckMNuvy
+.Op Fl ckMNuvVy
.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 t
-.Op Fl chkMNuvy
+.Op Fl chkMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
+.Op Fl F Ar script
+.Op Fl Q 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 chkmMNuvy
+.Op Fl chkmMNuvVy
.Op Fl b Ar blocksize
.Op Fl f Ar file
+.Op Fl F Ar script
+.Op Fl Q Ar file
.Op Fl s Ar fileno
.Op Fl T Ar directory
.Op Fl X Ar filelist
reads from the named file on the remote host using
.Xr rmt 8 .
.Pp
+.It Fl F Ar script
+Run script at the beginning of each tape. The device name and the
+current volume number are passed on the command line.
+The script must return 0 if
+.Nm
+should continue without asking the user to change the tape, 1 if
+.Nm
+should continue but ask the user to change the tape.
+Any other exit code will cause
+.Nm
+to abort.
+For security reasons,
+.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
flag causes
.Nm
to only print file names. Files are not extracted.
+.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.
+.Pp
+It is recommended to set up the st driver to return logical tape
+positions rather than physical before calling dump/restore with
+parameter Q. Since not all tape devices support physical tape
+positions those tape devices return an error during dump/restore when
+the st driver is set to the default physical setting.
+Please see the st man page, option MTSETDRVBUFFER, or the mt man
+page, on how to set the driver to return logical tape positions.
+.Pp
+Before calling restore with parameter Q, always make sure the st
+driver is set to return the same type of tape position used during the
+call to dump. Otherwise restore may be confused.
.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 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