RESTOR(1M)RESTOR(1M)NAME
restor - incremental file system restore
SYNOPSIS
restor key [ argument ... ]
DESCRIPTION
Restor is used to read magtapes dumped with the dump command. The key specifies what is to be done. Key is one of the characters rRxt
optionally combined with f.
f Use the first argument as the name of the tape instead of the default.
r or R The tape 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 of a multi volume set to start on. This allows restor to be interrupted and then restarted (an icheck -s
must be done before restart).
x Each file on the tape named by an argument 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 restor (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 restor command.
Restor 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 multivolume dump the recom-
mended 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 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 restor will read
the tapes in sequential order.
If you have a hierarchy to restore you can use dumpdir(1) 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 filesystem 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/rp0 40600
restor r /dev/rp0
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 unit varies with installation
rst*
SEE ALSO dump(1), mkfs(1), dumpdir(1)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 new-line 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, restor doesn't use it.
RESTOR(1M)
Check Out this Related Man Page
dump(8) System Manager's Manual dump(8)Name
dump - create file system dump
Syntax
/etc/dump [ key [ argument... ] filesystem ]
Description
The command copies all files changed after a certain date from a specified filesystem to a file, a pipe, magnetic tapes, or disks. The key
specifies the date and other options to be used by
Dumping a filesystem requires operator attention. An operator must intervene when the end of a tape or disk is reached, when the end of
the occurs, or when an unrecoverable input disk read error occurs (if more than 32 read errors occur). In addition to alerting all opera-
tors in the operator group, interacts with the operator at the control terminal when can no longer proceed, or if something is grossly
wrong. All questions that poses must be answered by typing yes or no.
Because a full dump uses considerable system time, checkpoints itself at the start of each tape or disk volume. If writing that volume
fails, asks the operator to restart from the checkpoint after the present tape or disk has been replaced.
The utility reports to the operator periodically, giving usually low estimates of the number of blocks to write, the number of tapes or
disks the dump will take, the time to completion, and the time until the tape or disk must be changed. The output is verbose, so that oth-
ers know that the terminal controlling is busy, and will be for some time.
This utility supports EOT handling which allows the use of multiple media. The utility prompts for the next volume when it encounters the
end of the current volume.
Options
With the command, you specify a string of one or more of the options described below. If no options are specified, the key 9u is assumed.
0-9 Specifies the dump level. All files that were modified since the last date stored in the file for the same filesystem at lesser
levels will be dumped. If no date is determined by the level, the beginning of time is assumed. Thus, the level 0 causes the
entire filesystem to be dumped.
B Indicates that the next argument is a number that specifies the size, in 1024-byte blocks, of a storage medium, such as a diskette
or removable disk cartridge. See the first example.
d Indicates that the density of the tape, expressed in bits per inch, is taken from the next argument. This density is used in cal-
culating the amount of tape used per reel. The default density is 1600 bpi.
f Places the dump on the file or device specified by the next argument. If the name of the file is -, writes to standard output.
The default dump device is
n Notifies, by means similar to a command, all users in the group operator when needs operator attention.
S Prints output file size in bytes, or number of volumes for devices. See the third example.
s Indicates that the next argument specifies the size of the dump tape, in feet. When the specified size is reached, waits for the
reel to be changed. The default tape size is 2300 feet.
u Writes the date of the beginning of the dump on the file if the completes successfully. This file records a separate date for each
filesystem and each dump level. The format of consists of one free format record per line: filesystem name, increment level and
format dump date. The superuser can carefully edit to change any of the fields.
W Tells the operator which file systems need to be dumped. This information is taken from the files and The W option causes to print
out, for each file system in the most recent dump date and level, and highlights those file systems that should be dumped. If the
W option is used, all other options are ignored, and exits immediately.
w Lists only those filesystems that need to be dumped.
Examples
This example dumps the filesystem to RX50 diskettes. The option is needed when running to read this dump.
dump 9Bf 400 /dev/rra2a /dev/ra0a
This example dumps the filesystem to a 6250 bpi tape on a TU78 tape drive:
dump 0undf 6250 /dev/rmt?h /usr/users
This example reports number of bytes to be output for a level 0 dump of the root file system. Please note: the file test is not created.
dump 0Sf test /
Restrictions
The programs returns a 1 on successful completion.
Sizes are based on 1600-bpi blocked tape.
Anything fewer than 32 read errors on the filesystem are ignored.
Each reel requires a new process, so parent processes for reels already written remain until the entire tape is written.
Files
Default filesystem to dump from
Default tape unit to dump to
Dump date record
Dump table: file systems and frequency
Operator group definition
Required for user interface
See Alsodump(5), fstab(5), opser(8), restore(8), rrestore(8c)
Guide to Backup and Restore
dump(8)