restore.1m (2010 09)

r
restore(1M) restore(1M)
delete [arg] The current directory or specified argument is deleted from the list of files to
be extracted. If a directory is specified, it and all its descendents are deleted
from the extraction list (unless h is specified on the command line). The most
expedient way to extract files from a directory is to add the directory to the
extraction list, then delete unnecessary files.
extract All files named on the extraction list are extracted from the dump tape.
restore and rrestore ask which volume the user wants to mount. The
fastest way to extract a few files is to start with the last volume, then work
toward the first volume.
help List a summary of the available commands.
ls [arg] List the current or specified directory. Entries that are directories are
displayed with a trailing /. Entries marked for extraction are displayed with
a leading *. If the verbose key is set, the inode number of each entry is also
listed.
pwd Print the full path name of the current working directory.
quit restore and rrestore immediately exit, even if the extraction list is not
empty.
set-modes Set the owner, modes, and times of all directories that are added to the
extraction list. Nothing is extracted from the tape. This setting is useful for
cleaning up after a restore aborts prematurely.
verbose The sense of the v modifier is toggled. When set, the verbose key causes the
ls command to list the inode numbers of all entries. It also causes restore
and rrestore to print out information about each file as it is extracted.
Function Modifiers
The following function modifier characters can be used in addition to the letter that selects the function
desired:
b Specify the block size of the tape in kilobytes. If the -b option is not specified,
restore and
rrestore try to determine the tape block size dynamically.
f Specify the name of the archive instead of /dev/rmt/0m. If the name of the file is
-,
restore reads from standard input. Thus, dump 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 -)
When using rrestore, this key should be specified, and the next argument supplied should
be of the form machine :device.
h Extract the actual directory, rather than the files to which it refers. This prevents hierarchi-
cal restoration of complete subtrees from the tape, rather than the files to which it refers.
m Extract by inode numbers rather than by file name. This is useful if only a few files are being
extracted and one wants to avoid regenerating the complete path name to the file.
v Type the name of each file restore and rrestore treat, preceded by its file type. Nor-
mally restore and rrestore do their work silently; the v modifier specifies verbose out-
put.
y Do not ask whether to abort the operation if restore and rrestore encounters a tape
error. restore and rrestore attempt to skip over the bad tape block(s) and continue.
rrestore creates a server, either /usr/sbin/rmt or /etc/rmt, on the remote machine to
access the tape device.
DIAGNOSTICS
restore and rrestore complain about bad key characters.
restore and rrestore complain if a read error is encountered. If the y modifier has been specified,
or the user responds y, restore and rrestore attempt to continue the restore.
If the dump extends over more than one tape,
restore and rrestore ask the user to change tapes. If
the x or i function has been specified, restore and rrestore also ask which volume the user wants
to mount. The fastest way to extract a few files is to start with the last volume and work towards the first
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010