NAME

restor − incremental file system restore

SYNOPSIS

restor key [ argument ... ]

DESCRIPTION

Restor is used to read files from tape or disk that were dumped with the dump command.  The key specifies what is to be done.  Key is one of the characters rRxt and f. 

f The first argument after the "key" set of letters is the name of the dump device, whether tape or disk. 

r or R
The tape or disk is read and loaded into the file system specified in argument.  This should not be done lightly (see below).  If the key is R restor asks which tape or disk of a multi volume set to start on.  This allows restor to be interrupted and then restarted (an fsck must be done before restart). 

x Each file on the tape or disk named by an argument is extracted.  The file extracted is placed in a file with a numeric name supplied by restor (actually the inode number).  In order to keep the amount of tape or disk read to a minimum, the following procedure is recommended:

Mount volume 1 of the set of dump tapes or disks. 

Type the restor command. 

Restor will announce whether or not it found the files, if given the number it will name the file, and rewind the tape or disk. 

It then asks you to ’mount the desired tape or disk volume’.  Type the number of the volume you choose.  On a multivolume dump the recommended procedure is to mount the last through the first volume in that order.  Restor checks to see if any of the files requested are on the mounted tape or disk (or a later tape or disk, thus the reverse order). 

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 restor will read the tape or disks in sequential order. 

If you have a hierarchy to restore you can use dumpdir(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 or disk was written and the date the filesystem was dumped from. 

The r option should only be used to restore a complete dump tape or disk onto a clear file system or to restore an incremental dump tape or disk onto this. 

EXAMPLE

/etc/mkfs /dev/rrp0g 145673
restor rf /dev/rfdc1 /dev/rrp0g

is a typical sequence to restore a complete dump. 

Another restor can be done to get an incremental dump in on top of this. 

A dump followed by a mkfs and a restor is used to change the size of a file system. 

FILES

default tape or disk unit varies with installation
rst*

SEE ALSO

dump(8), mkfs(8), dumpdir(8)

DIAGNOSTICS

There are various diagnostics involved with reading the tape or disk 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 or disk, it may ask you to change tape or disks.  Reply with a new-line when the next tape or disk has been mounted. 

BUGS

There is redundant information on the tape or disk that could be used in case of tape or disk reading problems.  Unfortunately, restor doesn’t use it. 

7th Edition  —  1/26/82