Only level 0 and no -u when dumping a subdirectory

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

diff --git a/restore/restore.8.in b/restore/restore.8.in
index 14cf11689e1ae843c9768a9a650a559ca070bac6..3bf87deb24e10c0b0f8caa29c2c04e4d61bb74d5 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.6 2000/01/21 10:17:41 stelian Exp $
+.\"    $Id: restore.8.in,v 1.10 2000/05/28 16:52:21 stelian Exp $

 .\"
 .Dd __DATE__
 .Dt RESTORE 8
 .\"
 .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 f Ar file
 .Op Fl s Ar fileno
 .Op Fl T Ar directory

+.Op Fl X Ar filelist

 .Op file ...
 .Nm restore
 .Fl x
 .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 f Ar file
 .Op Fl s Ar fileno
 .Op Fl T Ar directory

+.Op Fl X Ar filelist

 .Op file ...
 .Pp
 .in
 .Op file ...
 .Pp
 .in


@@ -258,6 +260,9 @@ Note that the
 flag replaces the function of the old
 .Xr dumpdir 8
 program.
 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.
 .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.
 unless the
 .Fl h
 flag has been specified.

+See also the
+.Fl X
+option below.

 .El
 .Pp
 The following additional options may be specified:
 .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.
 (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.
 .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
 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 :


@@ -565,7 +596,9 @@ Starting with 0.4b5, the new maintainer is Stelian Pop
 .Sh AVAILABILITY
 The
 .Nm dump/restore
 .Sh AVAILABILITY
 The
 .Nm dump/restore

-backup suit is available from http://dump.sourceforge.net
+backup suit is available from 
+.br
+http://dump.sourceforge.net

 .Sh HISTORY
 The
 .Nm restore
 .Sh HISTORY
 The
 .Nm restore