X-Git-Url: https://git.wh0rd.org/?p=dump.git;a=blobdiff_plain;f=restore%2Frestore.8.in;h=74c182ee2aa61b48e6fd65883c9af59c0d0209b4;hp=703111ef5b2afd8339f86354240a3569efc230d4;hb=fceb4f25728fd34fabfad406c32c5d8c142aae90;hpb=40df6a0e578b56977f18c2a960f3fd30c4c78e60

diff --git a/restore/restore.8.in b/restore/restore.8.in
index 703111e..74c182e 100644
--- a/restore/restore.8.in
+++ b/restore/restore.8.in
@@ -29,7 +29,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	$Id: restore.8.in,v 1.22 2002/01/16 10:29:26 stelian Exp $
+.\"	$Id: restore.8.in,v 1.26 2002/06/05 13:29:15 stelian Exp $
 .\"
 .Dd __DATE__
 .Dt RESTORE 8
@@ -40,7 +40,7 @@
 .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
@@ -50,7 +50,8 @@
 .Op Fl T Ar directory
 .Nm restore
 .Fl i
-.Op Fl achklmMNuvVy
+.Op Fl acdhklmMNuvVy
+.Op Fl A Ar file
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl F Ar script
@@ -58,8 +59,19 @@
 .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
@@ -67,7 +79,7 @@
 .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
@@ -75,7 +87,8 @@
 .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
@@ -86,7 +99,8 @@
 .Op file ...
 .Nm restore
 .Fl x
-.Op Fl achklmMNuvVy
+.Op Fl adchklmMNuvVy
+.Op Fl A Ar file
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl F Ar script
@@ -209,6 +223,11 @@ It also causes
 .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
@@ -316,6 +335,16 @@ 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 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
@@ -331,6 +360,13 @@ old (pre-4.4) or new format file system.  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
@@ -376,17 +412,16 @@ 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
-.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
@@ -437,7 +472,12 @@ command without actually writing any file on disk.
 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 
@@ -450,6 +490,9 @@ page, on how to set the driver to return logical tape positions.
 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.
+.Pp
+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