]> git.wh0rd.org - dump.git/blobdiff - restore/restore.8.in
Made dump report the total number of MB written to tape.
[dump.git] / restore / restore.8.in
index 5c1233745050c136986a5f3a5d068a134e3b7816..f853fefca748347581282c78f28aaa078017057a 100644 (file)
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)restore.8  8.4 (Berkeley) 5/1/95
-.\"    $Id: restore.8.in,v 1.1 1999/10/11 13:08:09 stelian Exp $
+.\"    $Id: restore.8.in,v 1.7 2000/01/21 10:23:30 stelian Exp $
 .\"
 .Dd __DATE__
 .Dt RESTORE 8
-.Os "__VERSION__"
+.Os "restore __VERSION__"
 .Sh NAME
 .Nm restore
 .Nd "restore files or file systems from backups made with dump"
 .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
 .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
@@ -78,7 +77,7 @@
 .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
@@ -342,11 +341,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
@@ -479,6 +488,13 @@ The environment variable
 will be used to determine the pathname of the remote
 .Xr rmt 8
 program.
+.It Ev RSH
+.Nm Restore
+uses the contents of this variable to determine the name of the
+remote shell command to use when doing a network restore (rsh, ssh etc.).
+If this variable is not set,
+.Xr rcmd 3
+will be used, but only root will be able to do a network restore.
 .Sh FILES
 .Bl -tag -width "./restoresymtable" -compact
 .It Pa /dev/st0
@@ -531,7 +547,8 @@ In all other cases, the files are unique because it is possible to
 have two different dumps started at the same time, and separate
 operations shouldn't conflict with each other.
 .Pp
-To do a network restore, you have to run restore as root.  This is due
+To do a network restore, you have to run restore as root or use
+a remote shell replacement (see RSH variable).  This is due
 to the previous security history of dump and restore.  (restore is
 written to be setuid root, but we are not certain all bugs are gone
 from the restore code - run setuid at your own risk.)
@@ -548,11 +565,9 @@ Starting with 0.4b5, the new maintainer is Stelian Pop
 .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 suit is available from 
+.br
+http://dump.sourceforge.net
 .Sh HISTORY
 The
 .Nm restore