]> git.wh0rd.org - dump.git/blobdiff - restore/restore.8.in
Error code to restore when compare errors detected.
[dump.git] / restore / restore.8.in
index f853fefca748347581282c78f28aaa078017057a..3bf87deb24e10c0b0f8caa29c2c04e4d61bb74d5 100644 (file)
@@ -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.7 2000/01/21 10:23:30 stelian Exp $
+.\"    $Id: restore.8.in,v 1.10 2000/05/28 16:52:21 stelian Exp $
 .\"
 .Dd __DATE__
 .Dt RESTORE 8
@@ -74,6 +74,7 @@
 .Op Fl f Ar file
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
+.Op Fl X Ar filelist
 .Op file ...
 .Nm restore
 .Fl x
@@ -82,6 +83,7 @@
 .Op Fl f Ar file
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
+.Op Fl X Ar filelist
 .Op file ...
 .Pp
 .in
@@ -258,6 +260,9 @@ Note that the
 flag replaces the function of the old
 .Xr dumpdir 8
 program.
+See also the
+.Fl X
+option below.
 .ne 1i
 .It Fl x
 The named files are read from the given media.
@@ -276,6 +281,9 @@ backup being extracted,
 unless the
 .Fl h
 flag has been specified.
+See also the
+.Fl X
+option below.
 .El
 .Pp
 The following additional options may be specified:
@@ -384,6 +392,21 @@ The
 (verbose)
 flag causes it to type the name of each file it treats
 preceded by its file type.
+.It Fl X Ar filelist
+Read list of files to be listed or extracted from the text file
+.Ar filelist
+in addition to those specified on the command line. This can be used in 
+conjunction with the
+.Fl t
+or
+.Fl x
+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.
@@ -458,6 +481,14 @@ After a dump read error,
 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 :