Version 0.4b5.

[dump.git] / restore / restore.8

diff --git a/restore/restore.8 b/restore/restore.8
index 785a6c3386833809213f3e4025d36558a21289e8..667729bbd3108779b66e30d254a44da64b6b7d6b 100644 (file)
--- a/restore/restore.8
+++ b/restore/restore.8
@@ -30,6 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)restore.8  8.4 (Berkeley) 5/1/95
+.\"    $Id: restore.8,v 1.2 1999/10/11 12:53:24 stelian Exp $
 .\"
 .Dd May 1, 1995
 .Dt RESTORE 8
@@ -40,7 +41,7 @@
 .Sh SYNOPSIS
 .Nm restore
 .Fl C
-.Op Fl cvy
+.Op Fl ckvy
 .Op Fl b Ar blocksize
 .Op Fl D Ar filesystem
 .Op Fl f Ar file
@@ -48,28 +49,28 @@
 .Op Fl T Ar directory
 .Nm restore
 .Fl i
-.Op Fl chmNvy
+.Op Fl chkmNuvy
 .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 cNvy
+.Op Fl ckNuvy
 .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 cNvy
+.Op Fl ckNuvy
 .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 chvy
+.Op Fl chkNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl s Ar fileno
@@ -77,7 +78,7 @@
 .Op file ...
 .Nm restore
 .Fl x
-.Op Fl chmNvy
+.Op Fl chkmNuvy
 .Op Fl b Ar blocksize
 .Op Fl f Ar file
 .Op Fl s Ar fileno
@@ -284,12 +285,12 @@ If the
 .Fl b
 option is not specified,
 .Nm restore
-tries to determine the block size dynamically.
+tries to determine the media block size dynamically.
 .It Fl c
 Normally,
 .Nm restore
 will try to determine dynamically whether the dump was made from an
-old (pre-4.4) or new format file sytem.  The
+old (pre-4.4) or new format file system.  The
 .Fl c
 flag disables this check, and only allows reading a dump in the old
 format.
@@ -323,6 +324,12 @@ or
 reads from the named file on the remote host using
 .Xr rmt 8 .
 .Pp
+.It Fl k
+Use Kerberos authentication when contacting the remote tape server.
+(Only available if this options was enabled when
+.Nm restore
+was compiled.)
+.Pp
 .It Fl h
 Extract the actual directory, 
 rather than the files that it references.
@@ -350,6 +357,13 @@ flag allows the user to specify a directory to use for the storage of
 temporary files. The default value is /tmp. This flag is most useful
 when restoring files after having booted from a floppy.  There might be little
 or no space on the floppy filesystem, but another source of space might exist.
+.It Fl u
+When creating certain types of files, restore may generate a warning
+diagnostic if they already exist in the target directory.
+To prevent this, the
+.Fl u
+(unlink) flag causes restore to remove old entries before attempting
+to create new ones.
 .It Fl v
 Normally
 .Nm restore
@@ -432,6 +446,26 @@ After a dump read error,
 may have to resynchronize itself.
 This message lists the number of blocks that were skipped over.
 .El
+.Sh ENVIRONMENT
+.Bl -tag -width Fl
+.It Ev TAPE
+If no -f option was specified,
+.Nm
+will use the device specified via
+.Ev TAPE
+as the dump device.
+.Ev TAPE
+may be of the form
+.Qq tapename ,
+.Qq host:tapename ,
+or
+.Qq user@host:tapename .
+.It Ev RMT
+The environment variable
+.Ev RMT
+will be used to determine the pathname of the remote
+.Xr rmt 8
+program.
 .Sh FILES
 .Bl -tag -width "./restoresymtable" -compact
 .It Pa /dev/rmt?
@@ -445,8 +479,8 @@ information passed between incremental restores.
 .El
 .Sh SEE ALSO
 .Xr dump 8 ,
-.Xr newfs 8 ,
 .Xr mount 8 ,
+.Xr newfs 8 ,
 .Xr mkfs 8 ,
 .Xr rmt 8
 .Sh BUGS
@@ -460,6 +494,11 @@ it has no control over inode allocation;
 thus a full dump must be done to get a new set of directories
 reflecting the new inode numbering,
 even though the contents of the files is unchanged.
+.Pp
+To do a network restore, you have to run restore as root.  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.)
 .Sh HISTORY
 The
 .Nm restore