X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;f=restore%2Frestore.8.in;h=7903d7e5e5f2455322c0670f4346ca121479a9bf;hb=7422942fcabc3e5735e850fce8113e9751ddd399;hp=c25c8c70a6e2b955809c2b7a9b4a9a3097880372;hpb=0c62667d42afb10ad85e1bbeff43ad2f6a8a4e2a;p=dump.git

diff --git a/restore/restore.8.in b/restore/restore.8.in
index c25c8c7..7903d7e 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.4 1999/10/30 22:55:51 tiniou Exp $
+.\"	$Id: restore.8.in,v 1.12 2001/03/23 14:40:12 stelian Exp $
 .\"
 .Dd __DATE__
 .Dt RESTORE 8
@@ -40,7 +40,7 @@
 .Sh SYNOPSIS
 .Nm restore
 .Fl C
-.Op Fl ckvy
+.Op Fl ckMvy
 .Op Fl b Ar blocksize
 .Op Fl D Ar filesystem
 .Op Fl f Ar file
@@ -48,40 +48,42 @@
 .Op Fl T Ar directory
 .Nm restore
 .Fl i
-.Op Fl chkmNuvy
+.Op Fl chkmMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Nm restore
 .Fl R
-.Op Fl ckNuvy
+.Op Fl ckMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Nm restore
 .Fl r
-.Op Fl ckNuvy
+.Op Fl ckMNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl s Ar fileno
 .Op Fl T Ar directory
 .Nm restore
 .Fl t
-.Op Fl chkNuvy
+.Op Fl chkMNuvy
 .Op Fl b Ar blocksize
 .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 Fl chkmNuvy
+.Op Fl chkmMNuvy
 .Op Fl b Ar blocksize
 .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:
@@ -341,11 +349,21 @@ Extract by inode numbers rather than by file name.
 This is useful if only a few files are being extracted,
 and one wants to avoid regenerating the complete pathname
 to the file.
+.It Fl M
+Enables the multi-volume feature (for reading dumps made using
+the 
+.Fl M
+option of dump). The name specified with
+.Fl f
+is treated as a prefix and
+.Nm
+tries to read in sequence from <prefix>001, <prefix>002 etc. 
 .It Fl N
 The
 .Fl N
 flag causes
-.Nm restore to only print file names. Files are not extracted.
+.Nm
+to only print file names. Files are not extracted.
 .It Fl s Ar fileno
 Read from the specified
 .Ar fileno
@@ -374,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.
@@ -448,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 :
@@ -545,21 +586,19 @@ from the restore code - run setuid at your own risk.)
 .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
-<pop@cybercable.fr>.
+<pop@noos.fr>.
 .Sh AVAILABILITY
 The
 .Nm dump/restore
-backup suit is available for anonymous ftp from tsx-11.mit.edu
-in /pub/linux/ALPHA/ext2fs (development versions) or
-/pub/linux/packages/ext2fs (stable versions).
-.Pp
-An alternate downloading location is http://perso.cybercable.fr/pop/dump.
+backup suite is available from 
+.br
+http://dump.sourceforge.net
 .Sh HISTORY
 The
 .Nm restore