2.9BSD/usr/man/cat8/restor.8
RESTOR(8) UNIX Programmer's Manual RESTOR(8)
NAME
restor, 512restor - incremental file system restore
SYNOPSIS
_r_e_s_t_o_r key [ argument ... ]
_5_1_2_r_e_s_t_o_r key [ argument ... ]
DESCRIPTION
_R_e_s_t_o_r is used to read magtapes dumped with the _d_u_m_p com-
mand. The _k_e_y specifies what is to be done. _K_e_y is one of
the characters rRxt optionally combined with f.
f Use the first _a_r_g_u_m_e_n_t as the name of the tape instead
of the default.
r or R
The tape is read and loaded into the file system speci-
fied in _a_r_g_u_m_e_n_t. This should not be done lightly (see
below). If the key is R _r_e_s_t_o_r asks which tape of a
multi volume set to start on. This allows restor to be
interrupted and then restarted (an _i_c_h_e_c_k -s must be
done before restarting ).
x Each file on the tape named by an _a_r_g_u_m_e_n_t is
extracted. The file name has all `mount' prefixes
removed; for example, /usr/bin/lpr is named /bin/lpr on
the tape. The file extracted is placed in a file with
a numeric name supplied by _r_e_s_t_o_r (actually the inode
number). In order to keep the amount of tape read to a
minimum, the following procedure is recommended:
Mount volume 1 of the set of dump tapes.
Type the _r_e_s_t_o_r command.
_R_e_s_t_o_r will announce whether or not it found the files,
give the number it will name the file, and rewind the
tape.
It then asks you to `mount the desired tape volume'.
Type the number of the volume you choose. On a mul-
tivolume dump the recommended procedure is to mount the
last through the first volume in that order. _R_e_s_t_o_r
checks to see if any of the files requested are on the
mounted tape (or a later tape, thus the reverse order)
and doesn't read through the tape if no files are. If
you are working with a single volume dump or the number
of files being restored is large, respond to the query
with `1' and _r_e_s_t_o_r will read the tapes in sequential
order.
If you have a hierarchy to restore you can use
Printed 8/2/83 1
RESTOR(8) UNIX Programmer's Manual RESTOR(8)
_d_u_m_p_d_i_r(8) to produce the list of names and a shell
script to move the resulting files to their homes.
t Print the date the tape was written and the date the
file system was dumped from.
The r option should only be used to restore a complete dump
tape onto a clear file system or to restore an incremental
dump tape onto this. Thus
/etc/mkfs /dev/hp0a 4807
restor r /dev/hp0a
is a typical sequence to restore a complete dump. Another
_r_e_s_t_o_r can be done to get an incremental dump in on top of
this.
A _d_u_m_p followed by a _m_k_f_s and a _r_e_s_t_o_r is used to change the
size of a file system.
_5_1_2_r_e_s_t_o_r is a version of _r_e_s_t_o_r that can restore tapes
written from 512-byte block file systems.
FILES
/dev/rmt1 default file name
rst* temporary files
SEE ALSO
dump(8), dumpdir(8), mkfs(8)
DIAGNOSTICS
There are various diagnostics involved with reading the tape
and writing the disk. There are also diagnostics if the i-
list or the free list of the file system is not large enough
to hold the dump.
If the dump extends over more than one tape, it may ask you
to change tapes. Reply with a newline when the next tape
has been mounted.
BUGS
There is redundant information on the tape that could be
used in case of tape reading problems. Unfortunately, _r_e_s_-
_t_o_r and _5_1_2_r_e_s_t_o_r don't use it.
Printed 8/2/83 2