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
 .\" 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
 .\"
 .Dd May 1, 1995
 .Dt RESTORE 8


@@ -40,7 +41,7 @@
 .Sh SYNOPSIS
 .Nm restore
 .Fl C
 .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
 .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 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 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 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 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
 .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 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
 .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
 .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
 .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.
 .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
 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.
 .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.
 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
 .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
 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?
 .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 ,
 .El
 .Sh SEE ALSO
 .Xr dump 8 ,

-.Xr newfs 8 ,

 .Xr mount 8 ,
 .Xr mount 8 ,

+.Xr newfs 8 ,

 .Xr mkfs 8 ,
 .Xr rmt 8
 .Sh BUGS
 .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.
 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
 .Sh HISTORY
 The
 .Nm restore