summaryrefslogtreecommitdiffstats
path: root/sbin/restore
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2000-11-20 16:52:27 +0000
committerru <ru@FreeBSD.org>2000-11-20 16:52:27 +0000
commitea31070695b2e513fcf660fbcc7f05a829839c35 (patch)
tree67d5b2b897cd080f9e1b7ede82c34bfc03085426 /sbin/restore
parent5df8ea840b4bfe32452ba29db4478efb738f96c8 (diff)
downloadFreeBSD-src-ea31070695b2e513fcf660fbcc7f05a829839c35.zip
FreeBSD-src-ea31070695b2e513fcf660fbcc7f05a829839c35.tar.gz
mdoc(7) police: use the new features of the Nm macro.
Diffstat (limited to 'sbin/restore')
-rw-r--r--sbin/restore/restore.842
1 files changed, 21 insertions, 21 deletions
diff --git a/sbin/restore/restore.8 b/sbin/restore/restore.8
index 100323c..5441036 100644
--- a/sbin/restore/restore.8
+++ b/sbin/restore/restore.8
@@ -40,32 +40,32 @@
.Nm rrestore
.Nd "restore files or file systems from backups made with dump"
.Sh SYNOPSIS
-.Nm restore
+.Nm
.Fl i
.Op Fl chkmNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
-.Nm restore
+.Nm
.Fl R
.Op Fl ckNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
-.Nm restore
+.Nm
.Fl r
.Op Fl ckNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
-.Nm restore
+.Nm
.Fl t
.Op Fl chkNuvy
.Op Fl b Ar blocksize
.Op Fl f Ar file
.Op Fl s Ar fileno
.Op file ...
-.Nm restore
+.Nm
.Fl x
.Op Fl chkmNuvy
.Op Fl b Ar blocksize
@@ -73,14 +73,14 @@
.Op Fl s Ar fileno
.Op file ...
.Pp
-.in -\\n(iSu
+.in -\n(iSu
(The
.Bx 4.3
option syntax is implemented for backward compatibility, but
is not documented here.)
.Sh DESCRIPTION
The
-.Nm restore
+.Nm
command performs the inverse function of
.Xr dump 8 .
A full backup of a file system may be restored and
@@ -106,7 +106,7 @@ Exactly one of the following flags is required:
.It Fl i
This mode allows interactive restoration of files from a dump.
After reading in the directory information from the dump,
-.Nm restore
+.Nm
provides a shell like interface that allows the user to move
around the directory tree selecting files to be extracted.
The available commands are given below;
@@ -170,7 +170,7 @@ When set, the verbose flag causes the
.Ic ls
command to list the inode numbers of all entries.
It also causes
-.Nm restore
+.Nm
to print out information about each file as it is extracted.
.El
.It Fl R
@@ -208,7 +208,7 @@ restore rf /dev/rsa0
.Ed
.Pp
Note that
-.Nm restore
+.Nm
leaves a file
.Pa restoresymtable
in the root directory to pass information between incremental
@@ -264,11 +264,11 @@ The number of kilobytes per dump record.
If the
.Fl b
option is not specified,
-.Nm restore
+.Nm
tries to determine the media block size dynamically.
.It Fl c
Normally,
-.Nm restore
+.Nm
will try to determine dynamically whether the dump was made from an
old (pre-4.4) or new format file system. The
.Fl c
@@ -292,14 +292,14 @@ If the name of the file is of the form
.Dq host:file ,
or
.Dq user@host:file ,
-.Nm restore
+.Nm
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
+.Nm
was compiled.)
.Pp
.It Fl h
@@ -331,7 +331,7 @@ To prevent this, the
to create new ones.
.It Fl v
Normally
-.Nm restore
+.Nm
does its work silently.
The
.Fl v
@@ -348,24 +348,24 @@ If
.Fl y
has been specified, or the user responds
.Ql y ,
-.Nm restore
+.Nm
will attempt to continue the restore.
.Pp
If a backup was made using more than one tape volume,
-.Nm restore
+.Nm
will notify the user when it is time to mount the next volume.
If the
.Fl x
or
.Fl i
flag has been specified,
-.Nm restore
+.Nm
will also ask which volume the user wishes to mount.
The fastest way to extract a few files is to
start with the last volume, and work towards the first volume.
.Pp
There are numerous consistency checks that can be listed by
-.Nm restore .
+.Nm .
Most checks are self-explanatory or can ``never happen''.
Common errors are given below.
.Pp
@@ -407,7 +407,7 @@ though files may not be found on the tape.
.Pp
.It resync restore, skipped <num> blocks
After a dump read error,
-.Nm restore
+.Nm
may have to resynchronize itself.
This message lists the number of blocks that were skipped over.
.El
@@ -467,6 +467,6 @@ have two different dumps started at the same time, and separate
operations shouldn't conflict with each other.
.Sh HISTORY
The
-.Nm restore
+.Nm
command appeared in
.Bx 4.2 .
OpenPOWER on IntegriCloud