vxrestore(1M) (VxFS) vxrestore(1M)
NAME
vxrestore - incremental file system restore
SYNOPSIS
vxrestore [-irRtxdhmvy] [-b factor] [-f dump-file] [-s n]
[filename ...]
DESCRIPTION
vxrestore restores files from backup tapes created with the vxdump
command using at least one of the options listed below, along with any
modifiers and arguments you supply. Remaining arguments to vxrestore
are the names of files (or directories whose files) are to be restored
to disk. Unless the -h modifier is in effect, a directory name refers
to the files it contains, and (recursively) its subdirectories and the
files they contain.
OPTIONS
-i Interactive. After reading in the directory information from the
tape, vxrestore invokes an interactive interface that allows you
to browse through the dump tape's directory hierarchy and select
individual files to be extracted. See Interactive Commands,
below, for a description of available commands.
-r Restores the entire tape and loads the tape's full contents into
the current directory. This option should be used only to restore
a complete dump tape onto a clear filesystem, or to restore an
incremental dump tape after a full "level 0" restore.
-R Resumes restoring. vxrestore requests a particular tape of a mul-
tivolume set from which to resume a full restore (see the -r
option above). This allows vxrestore to start from a checkpoint
when it is interrupted in the middle of a full restore.
-t Table of contents. Lists each filename that appears on the tape.
If no filename argument is given, the root directory is listed.
This results in a list of all files on the tape, unless the -h
modifier is in effect.
-x Extracts the named files from the tape. If a named file matches a
directory whose contents were written onto the tape, and the -h
modifier is not in effect, the directory is recursively
extracted. The owner, modification time, and mode are restored
(if possible). If no filename argument is given, the root direc-
tory is extracted. This results in the entire tape being
extracted unless the -h modifier is in effect.
-d Debug. Turns on debugging output.
-h Extracts the actual directory, rather than the files that it
references. This prevents hierarchical restoration of complete
subtrees from the tape.
Page 1 Reliant UNIX 5.44 Printed 11/98
vxrestore(1M) (VxFS) vxrestore(1M)
-m Extracts by inode numbers rather than by file name to avoid
regenerating complete path names. This is useful if only a few
files are being extracted.
-v Verbose. vxrestore displays the name of each file it restores,
preceded by its file type.
-y Does not ask whether to abort the restore in the event of tape
errors. vxrestore tries to skip over the bad tape block(s) and
continue as best it can.
-b factor
Blocking factor. Specifies the blocking factor for tape reads.
Note: A tape block is 512 bytes.
-e extentop
Specifies how to handle extent attribute information. This option
specifies the required persistence of extent attributes when re-
storing files which had preallocated space or fixed extent sizes.
Valid values for extentop are:
warn Issues a warning message if extent attribute information
cannot be kept (the default behavior if this option is
not specified).
force Fails the file restore if extent attribute information
cannot be kept.
ignore Ignores extent attribute information.
-f dump-file
Uses dump-file instead of /dev/rmt? as the file to restore from.
If dump-file is specified as "-", vxrestore reads from the stan-
dard input. This allows vxdump(1M) and vxrestore to be used in a
pipeline to dump and restore a file system:
vxdump 0f - /dev/ios0/rsdisk000s3 | (cd /mnt; vxrestore xf -)
-s n Skips to the n'th file when there are multiple dump files on the
same tape. For example, the command:
vxrestore xfs /dev/ios0/rstape000h 5
would position you at the fifth file on the tape.
Page 2 Reliant UNIX 5.44 Printed 11/98
vxrestore(1M) (VxFS) vxrestore(1M)
Interactive Commands
vxrestore enters interactive mode when invoked with the -i option.
Interactive commands are reminiscent of the shell. For those commands
that accept an argument, the default is the current directory.
ls [directory]
Lists files in directory or the current directory, represented by
a "." (period). Directories are appended with a "/" (backslash).
Entries marked for extraction are prefixed with a "*" (asterisk).
If the verbose option is in effect, inode numbers are also
listed.
cd directory
Changes to directory directory (within the dump tape).
pwd Prints the full path name of the current working directory.
add [filename]
Adds the current directory, or the named file or directory
directory to the list of files to extract. If a directory is
specified, add that directory and its files (recursively) to the
extraction list (unless the h modifier is in effect).
delete [filename]
Deletes the current directory, or the named file or directory
from the list of files to extract. If a directory is specified,
delete that directory and all its descendents from the extraction
list (unless the h modifier is in effect). The most expedient way
to extract a majority of files from a directory is to add that
directory to the extraction list, and then delete specific files
to omit.
extract
Extracts all files on the extraction list from the dump tape.
vxrestore asks which volume the user wishes to mount. The fastest
way to extract a small number of files is to start with the last
tape volume and work toward the first. The owner, modification
time, and mode are restored (if possible).
verbose
Toggles the status of the v modifier. While v is in effect, the
ls command lists the inode numbers of all entries, and vxrestore
displays information about each file as it is extracted.
help Displays a summary of the available commands.
quit vxrestore exits immediately, even if the extraction list is not
empty.
Page 3 Reliant UNIX 5.44 Printed 11/98
vxrestore(1M) (VxFS) vxrestore(1M)
NOTES
vxrestore can get confused when doing incremental restores from dump
tapes that were made on active file systems. Dumps should be made
using the snapshot mount facilities of VxFS.
A "level 0" dump must be done after a full restore. Because vxrestore
runs in user mode, it has no control over inode allocation; this means
that vxrestore repositions the files, although it does not change
their contents. Thus, a full dump must be done to get a new set of
directories reflecting the new file positions, so that later incremen-
tal dumps will be correct.
DIAGNOSTICS
vxrestore complains about bad option characters.
Read errors result in complaints. If -y has been specified, or the
user responds y, vxrestore will attempt to continue.
If the dump extends over more than one tape, vxrestore asks the user
to change tapes. If the -x or -i option has been specified, vxrestore
also asks which volume the user wishes to mount.
There are numerous consistency checks that can be listed by vxrestore.
Most checks are self-explanatory or can "never happen". Common errors
are given below.
Converting to new file system format.
A dump tape created from the old file system has been loaded. It
is automatically converted to the new file system format.
filename: not found on tape
The specified file name was listed in the tape directory, but was
not found on the tape. This is caused by tape read errors while
looking for the file, and from using a dump tape created on an
active file system.
expected next file inumber, got inumber
A file that was not listed in the directory showed up. This can
occur when using a dump tape created on an active file system.
Incremental tape too low
When doing an incremental restore, a tape that was written before
the previous incremental tape, or that has too low an incremental
level has been loaded.
Incremental tape too high
When doing incremental restore, a tape that does not begin its
coverage where the previous incremental tape left off, or one
that has too high an incremental level has been loaded.
Page 4 Reliant UNIX 5.44 Printed 11/98
vxrestore(1M) (VxFS) vxrestore(1M)
Tape read error while restoring filename
Tape read error while skipping over inode inumber
Tape read error while trying to resynchronize
A tape read error has occurred.
If a file name is specified, then its contents are probably par-
tially wrong. If an inode is being skipped or the tape is trying
to resynchronize, then no extracted files have been corrupted,
though files may not be found on the tape.
resync vxrestore, skipped num
After a tape read error, vxrestore may have to resynchronize
itself. This message lists the number of blocks that were skipped
over.
FILES
/dev/rmt8
the default tape drive
/tmp/rstdir*
file containing directories on the tape
/tmp/rstmode*
owner, mode, and timestamps for directories
./restoresymtable
information passed between incremental restores
SEE ALSO
vxdump(1M), mkfs(1M), mount(1M).
Page 5 Reliant UNIX 5.44 Printed 11/98