NAME

restore − incremental file system restore

SYNOPSIS

/etc/restore key [ name ... ]

DESCRIPTION

Restore is used to read tapes dumped with the dump(8) command. Its actions are controlled by the key argument.  The key is a string of characters containing at most one function letter and possibly one or more function modifiers.  Other arguments to the command are file or directory names specifying which files are to be restored.  Unless the −h flag is specified (see below), the appearance of a directory name refers to the files and (recursively) subdirectories of that directory. 

The function portion of the key is specified by one of the following letters:

r or R The tape is read and loaded into the current directory.  [If the key is R restore asks which tape of a multi volume set to start on.  This allows restore to be interrupted and then restarted.] This should not be done lightly; 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/rrp0g 145673 ... 
/etc/mount /dev/rp0g /mnt
cd /mnt
restore r

is a typical sequence to restore a complete dump.  [Another restore can be done to get an incremental dump in on top of this.]

A dump(8) followed by a mkfs and a restore is used to change the size of a file system. 

x The named files are extracted from the tape.  If the named file matches a directory whose contents had been written onto the tape, this directory is (recursively) extracted.  The owner, modification time, and mode are restored (if possible).  If no file argument is given, the entire content of the tape is extracted. 

t The names of the specified files are listed if they occur on the tape.  If no file argument is given, all of the names on the tape are listed.  Note that this key replaces the function of dumpdir(8).

The following characters may be used in addition to the letter which selects the function desired. 

v Normally restore does its work silently.  The v (verbose) option causes it to type the name of each file it treats preceded by the function letter.  [With the t function, v gives more information about the tape entries than just the name.]

f causes restore to use the next argument as the name of the archive instead of /dev/rmt?.  [If the name of the file is ‘−’, restore reads from standard input.  Thus, dump(8) and restore can be used in a pipeline to dump and restore a file system with the command

dump 0f - /usr | (cd /mnt; restore xf -) ]

y tells restore not to complain if gets a tape error, but simply to skip over the bad tape blocks and continue as best it can. 

m causes restore to extract by inode numbers rather than by file name. 

h causes restore to extract the actual directory, rather than the files that it references. 

SEE ALSO

dump(8), mkfs(8)

FILES

/dev/rmt?the default tape drive
rst∗the temporary file used by restore. 

DIAGNOSTICS

Complaints about bad key characters. 

Complaints if it gets a read error.  If −y has been specified, or the user responds "y", restore will attempt to continue the restore. 

If the dump extends over more than one tape, restore will ask the user to change tapes.  [If the −x flag has been specified, restore will also ask which volume the user wishes to mount.  The fastest way to extract a small number of files is to start with the last volume, and work towards the first volume.]

BUGS

The sections in brackets are not yet implemented.  Most importantly the −r option can only restore level zero dumps, it cannot restore incremental dumps. 

Sun System Release 0.3  —  4/1/81