rrestore(8c)rrestore(8c)Namerrestore - restore a file system dump across the network
Syntax
/etc/rrestore [ -key [ name ... ] ]
Description
The utility obtains files from a file, magnetic tape, or disk, which
were saved by a previous The utility is identical in operation to
except the f key must be specified and the file supplied should be of
the following form:
remote-system-name:device-or-file
The command initiates a remote server, on the remote machine to access
the remote file or device.
The command relies on the user having access to the remote system
through entries in the or files, as documented in
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.
This utility supports the TA90 style sequential stacker loader device.
The device ejects a cartridge when it is taken off line. This utility
performs the device ejection on behalf of the user when it encounters a
multivolume boundary during write or read operations involving tape.
The device then automatically loads the next available tape (if there
is one). The utility then attempts to access this next tape for a rea‐
sonable amount of time (approximately three minutes) before prompting
the user for a manual reload operation.
The function portion of the key is specified by one of the following
letters:
Keys
i This key allows interactive restoration of files from the dump
media. After reading in the directory information from the dump
media, lets the user move around the directory tree selecting or
deselecting files to be extracted. Only the first letter of the
interactive commands are parsed. The available interactive com‐
mands are:
ls [arg] List the specified directory. If no directory is
specified, the user's current directory is listed.
Entries that are directories are appended with a slash
(/). Entries that have been marked for extraction are
prepended with an asterisk (*). If the verbose key is
set, the inode number of each entry is also listed.
cd arg Change the current working directory to the directory
specified.
pwd Print the full pathname of the current working direc‐
tory.
add [arg] The current directory or the specified argument (a
directory or file) is added to the extraction list
(the list of files to be extracted). If a directory
is specified, then it and all its descendents are
added to the extraction list, unless the h key is
specified on the command line. Files that are on the
extraction list are prepended with an asterisk (*)
when they are listed by ls.
delete [arg]
The current directory or specified argument is deleted
from the extraction list (the list of files to be
extracted). If a directory is specified, then it and
all its descendents are deleted from the extraction
list, unless the h key modifier is specified on the
command line. The easiest way to extract most of the
files from a directory is to add the directory to the
extraction list and then delete those files that are
not needed.
extract All the files on the extraction list are extracted
from the dump media. The command asks which volume
the user wishes to mount.
verbose The verbose ( v ) key is toggled. Entering the com‐
mand turns on verbose. Entering the command again
turns off verbose. When used, the verbose key causes
the ls command to list the inode numbers of all
entries. It also causes to print out information
about each file as it is extracted.
help List a summary of the available commands.
quit The utility immediately exits, even if the extraction
list is not empty. A synonym exists for this command:
Do not confuse this interactive command with the
extract key, described below.
R The utility prompts for a particular volume of a multivolume set
on which to restart a full restore. This option lets be inter‐
rupted and then restarted.
r The dump medias' data is read into the current directory. You
should use this function key only to restore the complete dump
media onto a newly created file system, or to restore incremental
dump media after a full level-0 restore. See Examples for a typi‐
cal sequence to restore complete dump media. Note that leaves a
file, in the root directory to pass information between incremen‐
tal restore passes. Remove this file after the last incremental
dump media has been restored. A followed by a and a can be used
to change the size of a file system.
t The names of the specified files are listed if they occur on the
dump media. If no name argument is given, then the root directory
is listed. This results in the entire contents of the dump media
being listed, unless the h key modifier has been specified.
x The files specified by the name argument are extracted from the
dump media. If a named file matches a directory whose contents
had been written onto the dump media and the h key modifier is not
specified, the directory is recursively extracted. The owner,
modification time, and mode are restored, if possible. If no name
argument is given, the root directory is extracted. This results
in the extraction of the entire contents of the dump media unless
the h key modifier has been specified.
You can use any of the following characters in addition to the letter
that selects the function desired:
B The next argument to is a number giving the size, in 1024-byte
blocks, of a fixed-size storage medium, such as diskettes or
removable disks (see Examples). The utility does not ask whether
it should abort the restore if there is a dump media read error.
It always tries to skip over the bad block(s) and continue.
f The next argument to is used as the name of the remote system fol‐
lowed by a colon and the device or file containing the dump data.
h The utility extracts the actual directory, rather than the files
that it references. This prevents hierarchical restoration of
complete subtrees from the dump media.
m The utility extracts by inode numbers rather than by file name.
This is useful if only a few files are being extracted, and you
want to avoid typing the complete pathname to the file.
o Provides compatibility with non-ULTRIX or pre-ULTRIX V2.0 remote
systems.
s The next argument identifies, by number, which dump file on the
dump media is to be used by This is useful when the dump media has
more than one dump image on it and not all of them will be
restored.
v Normally, does its work silently. The v (verbose) key modifier
causes it to display the name of each file it treats, preceded by
its file type.
Examples
The following example shows a typical sequence of commands to restore
complete dump media from a system named ``remotesystem'' mounted on a
tape device on that system:
/etc/newfs /dev/rrp0g ra60
/etc/mount /dev/rp0g /mnt
cd /mnt
rrestore rf remotesystem:/dev/rmt0h
Another can be done to get an incremental dump. The following example
shows how to restore files interactively from a dump on RX50 diskettes:
rrestore iBf 400 remotesystem:/dev/ra2a
The following example restores a previously dumped file system from a -
non-ULTRIX or an ULTRIX remote system prior to Version 2.0. The com‐
mand restores the complete file system in verbose mode specifying a 400
block device size from a remote system's RX50 device:
rrestore rvoBf 400 remotesystem:/dev/ra2a
The following example shows how to obtain a log after dumping multiple
filesystems to the no-rewind device:
rdump 0uf remotesystem:/dev/nrmt1h /junkd
rdump 0uf remotesystem:/dev/nrmt1h /junke
rdump 0uf remotesystem:/dev/nrmt1h /junkf
mt -f remotesystem:/dev/rmt1h rew
rrestore tvf remotesystem:/dev/nrmt1h
rrestore tvfs remotesystem:/dev/nrmt1h 2
rrestore tvfs remotesystem:/dev/nrmt1h 2
The following example shows how to restore the 5th filesystem from a
multiarchive dump:
rrestore rvfs remotesystem:/dev/rmt1h 5
Restrictions
The command does not interface with sequential stacker loader tape
drives.
The utility can make errors when doing incremental restores from dump
media that were made on active file systems.
You must do a level 0 dump after a full restore. Because runs in user
code, it has no control over inode allocation; thus, you must do a full
to get a new set of directories that reflects the new inode numbering,
even though the contents of the files are unchanged.
Tape position following a command is before the end of archive tape
mark. Tape position after the command is after the end of archive tape
mark.
The utility requires that the initial tape position is at the start of
an archive, unless the
option is used.
Do not attempt to read tape archives from a ULTRIX Version 4.3 or ear‐
lier system if the archive was created with other than the default
record size. The program on Version 4.3 and earlier systems only sup‐
ports the default record sizes.
Diagnostics
Complains about bad key characters.
Complains if it gets a dump media read error. If the user responds
with a y, attempts to continue the restore.
If the dump extends over more than one dump volume, will ask the user
to change volumes. If the x or i function key has been specified, also
asks which volume the user wishes to mount.
There are numerous consistency checks that can be listed by Most checks
are self-explanatory. Some common errors are:
Converting to new file system format
If dump media created from the Fast File System (FFS) has been loaded.
It is automatically converted to the Berkeley Version 4.2 file system
format.
<filename>: not found on tape{disk}
The specified file name was listed in the dump media directory, but was
not found on the media. This is caused by dump media read errors while
looking for the file or from using dump media created on an active file
system.
expected next file <inumber>, got <inumber>
A file that was not listed in the directory was found on the media.
This can occur when using dump media created on an active file system.
Incremental tape{disk} too low
When doing incremental restore, dump media was loaded that was written
before the previous incremental media or has too low an incremental
level.
Incremental tape{disk} too high
When doing incremental restore, dump media that does not begin its cov‐
erage where the previous incremental dump media left off, or that has
too high an incremental level has been loaded.
Tape{Disk} read error while restoring <filename>
Dump media read error while skipping over inode <inumber>
Dump media read error while trying to resynchronize
A dump media read error has occurred. If a file name is specified,
then its contents are probably partially wrong. If an inode is being
skipped or the restore is trying to resynchronize, then no extracted
files have been corrupted, although files may not be found on the dump
media.
resync restore, skipped <num> blocks
After a dump media read error, may have to resynchronize itself. This
message lists the number of blocks that were skipped.
Files
Default tape drive
File containing directories on the dump media
Owner, mode, and time stamps for directories
Information passed between incremental restores
Required for user interface
See Alsorestore(8), rmt(8c)rrestore(8c)
