BSD 4_4_Lite1 release

[unix-history] / usr / src / sbin / restore / restore.8

diff --git a/usr/src/sbin/restore/restore.8 b/usr/src/sbin/restore/restore.8
index 679c107..dfe7d68 100644 (file)
--- a/usr/src/sbin/restore/restore.8
+++ b/usr/src/sbin/restore/restore.8
@@ -1,11 +1,37 @@
-.\" Copyright (c) 1985, 1991 The Regents of the University of California.
-.\" All rights reserved.
+.\" Copyright (c) 1985, 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\" %sccs.include.redist.man%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"     @(#)restore.8  6.10 (Berkeley) %G%
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.Dd 
+.\"     @(#)restore.8  8.2 (Berkeley) 12/11/93
+.\"
+.Dd December 11, 1993

 .Dt RESTORE 8
 .Os BSD 4
 .Sh NAME
 .Dt RESTORE 8
 .Os BSD 4
 .Sh NAME


@@ -26,9 +52,10 @@ Single files and
 directory subtrees may be restored from full or partial
 backups.
 .Nm Restore
 directory subtrees may be restored from full or partial
 backups.
 .Nm Restore

-cannot work across a network, to do this, see the companion
-command
-.Xr rrestore .
+works across a network;
+to do this see the
+.Fl f
+flag described below.

 The actions
 of
 .Nm restore
 The actions
 of
 .Nm restore


@@ -65,7 +92,7 @@ any necessary incremental backups on top of the level 0.
 The
 .Cm r
 key precludes an interactive file extraction and can be
 The
 .Cm r
 key precludes an interactive file extraction and can be

-detrimental to ones health if not used carefully (not to mention
+detrimental to one's health if not used carefully (not to mention

 the disk). An example:
 .Bd -literal -offset indent
 newfs /dev/rrp0g eagle
 the disk). An example:
 .Bd -literal -offset indent
 newfs /dev/rrp0g eagle


@@ -220,6 +247,11 @@ The next argument to
 is used as the name of the archive instead
 of
 .Pa /dev/rmt? . 
 is used as the name of the archive instead
 of
 .Pa /dev/rmt? . 

+If the name of the file is of the form
+.Dq host:file ,
+.Nm restore
+reads from the named file on the remote host using
+.Xr rmt 8 .

 If the name of the file is
 .Ql Fl ,
 .Nm restore
 If the name of the file is
 .Ql Fl ,
 .Nm restore


@@ -263,7 +295,7 @@ key causes it to type the name of each file it treats
 preceded by its file type.
 .It Cm y
 .Nm Restore
 preceded by its file type.
 .It Cm y
 .Nm Restore

-will not ask whether it should abort the restore if gets an error.
+will not ask whether it should abort the restore if it gets an error.

 It will always try to skip over the bad block(s) and continue as
 best it can.
 .El
 It will always try to skip over the bad block(s) and continue as
 best it can.
 .El


@@ -350,11 +382,11 @@ owner, mode, and time stamps for directories.
 information passed between incremental restores.
 .El
 .Sh SEE ALSO
 information passed between incremental restores.
 .El
 .Sh SEE ALSO

-.Xr rrestore 8

 .Xr dump 8 ,
 .Xr newfs 8 ,
 .Xr mount 8 ,
 .Xr dump 8 ,
 .Xr newfs 8 ,
 .Xr mount 8 ,

-.Xr mkfs 8
+.Xr mkfs 8 ,
+.Xr rmt 8

 .Sh BUGS
 .Nm Restore
 can get confused when doing incremental restores from
 .Sh BUGS
 .Nm Restore
 can get confused when doing incremental restores from