More documentation on -Q use.

[dump.git] / restore / restore.8.in

diff --git a/restore/restore.8.in b/restore/restore.8.in
index 073cc8e45c018fb41717d9398c6f06dfa951c226..0c208596eb53029aaa8ad247519cb361c9f4c1bc 100644 (file)
--- 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.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\"    $Id: restore.8.in,v 1.8 2000/03/08 11:25:58 stelian Exp $
+.\"    $Id: restore.8.in,v 1.14 2001/04/24 15:04:59 stelian Exp $

 .\"
 .Dd __DATE__
 .Dt RESTORE 8
 .\"
 .Dd __DATE__
 .Dt RESTORE 8


@@ -51,6 +51,7 @@
 .Op Fl chkmMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl chkmMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file

+.Op Fl Q Ar file

 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Nm restore
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Nm restore


@@ -72,33 +73,21 @@
 .Op Fl chkMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl chkMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file

-.Op Fl s Ar fileno
-.Op Fl T Ar directory
-.Op file ...
-.Nm restore
-.Fl t
-.Op Fl chkMNuvy
-.Op Fl b Ar blocksize
-.Op Fl f Ar file
+.Op Fl Q Ar file

 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Op Fl X Ar filelist
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Op Fl X Ar filelist

-.Nm restore
-.Fl x
-.Op Fl chkmMNuvy
-.Op Fl b Ar blocksize
-.Op Fl f Ar file
-.Op Fl s Ar fileno
-.Op Fl T Ar directory

 .Op file ...
 .Nm restore
 .Fl x
 .Op Fl chkmMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op file ...
 .Nm restore
 .Fl x
 .Op Fl chkmMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file

+.Op Fl Q Ar file

 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Op Fl X Ar filelist
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Op Fl X Ar filelist

+.Op file ...

 .Pp
 .in
 (The
 .Pp
 .in
 (The


@@ -378,6 +367,11 @@ The
 flag causes
 .Nm
 to only print file names. Files are not extracted.
 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.

 .It Fl s Ar fileno
 Read from the specified
 .Ar fileno
 .It Fl s Ar fileno
 Read from the specified
 .Ar fileno


@@ -407,9 +401,9 @@ The
 flag causes it to type the name of each file it treats
 preceded by its file type.
 .It Fl X Ar filelist
 flag causes it to type the name of each file it treats
 preceded by its file type.
 .It Fl X Ar filelist

-Get the list of the files to be listed or extracted from the text file
+Read list of files to be listed or extracted from the text file

 .Ar filelist
 .Ar filelist

-instead of reading them on the command line. This can be used in 
+in addition to those specified on the command line. This can be used in 

 conjunction with the
 .Fl t
 or
 conjunction with the
 .Fl t
 or


@@ -417,6 +411,10 @@ or
 commands. The file
 .Ar filelist
 should contain file names separated by newlines.
 commands. The file
 .Ar filelist
 should contain file names separated by newlines.

+.Ar filelist
+may be an ordinary file or
+.Ql Fl
+(the standard input).

 .It Fl y
 Do not ask the user whether to abort the restore in the event of an error.
 Always try to skip over the bad block(s) and continue.
 .It Fl y
 Do not ask the user whether to abort the restore in the event of an error.
 Always try to skip over the bad block(s) and continue.


@@ -491,6 +489,14 @@ After a dump read error,
 may have to resynchronize itself.
 This message lists the number of blocks that were skipped over.
 .El
 may have to resynchronize itself.
 This message lists the number of blocks that were skipped over.
 .El

+.Pp
+.Nm Restore
+exits with zero status on success.
+Tape errors are indicated with an exit code of 1.
+.Pp
+When doing a comparison of files from a dump, an exit code
+of 2 indicates that some files were modified or deleted since
+the dump was made.

 .Sh ENVIRONMENT
 If the following environment variable exists it will be utilized by
 .Nm restore :
 .Sh ENVIRONMENT
 If the following environment variable exists it will be utilized by
 .Nm restore :


@@ -588,17 +594,17 @@ from the restore code - run setuid at your own risk.)
 .Sh AUTHOR
 The
 .Nm dump/restore
 .Sh AUTHOR
 The
 .Nm dump/restore

-backup suit was ported to Linux's Second Extended File System
+backup suite was ported to Linux's Second Extended File System

 by Remy Card <card@Linux.EU.Org>. He maintained the initial versions
 of dump (up and including 0.4b4, released in january 1997).
 .Pp
 Starting with 0.4b5, the new maintainer is Stelian Pop
 .br
 by Remy Card <card@Linux.EU.Org>. He maintained the initial versions
 of dump (up and including 0.4b4, released in january 1997).
 .Pp
 Starting with 0.4b5, the new maintainer is Stelian Pop
 .br

-<pop@cybercable.fr>.
+<pop@noos.fr>.

 .Sh AVAILABILITY
 The
 .Nm dump/restore
 .Sh AVAILABILITY
 The
 .Nm dump/restore

-backup suit is available from 
+backup suite is available from 

 .br
 http://dump.sourceforge.net
 .Sh HISTORY
 .br
 http://dump.sourceforge.net
 .Sh HISTORY