vxrestore(1M_VXFS) (VXFS) vxrestore(1M_VXFS)
NAME
vxrestore - incremental file system restore
SYNOPSIS
vxrestore options [filename . . . ]
DESCRIPTION
vxrestore restores files from backup tapes created with the
vxdump command. options is a string of at least one of the
options listed below, along with any modifiers and arguments
supplied. 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, as well as (recursively) its
subdirectories and the files they contain.
The options are:
-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 the section on interactive commands,
below, for a description of available commands.
-r Restore the entire tape. Load the tape's full contents
into the current directory. This option should be used
only to restore a complete dump tape onto a clear file
system, or to restore an incremental dump tape after a
full level 0 restore.
-R Resume restoring. vxrestore requests a particular tape
of a multivolume set from which to resume a full restore
(see the -r option). This allows vxrestore to start from
a checkpoint when it is interrupted in the middle of a
full restore.
-t Table of contents. List 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
modifier is in effect.
Copyright 1994 Novell, Inc. Page 1
vxrestore(1M_VXFS) (VXFS) vxrestore(1M_VXFS)
-x Extract the named files from the tape. If a named file
matches a directory whose contents were written onto the
tape, and the
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 directory is extracted. This results in
the entire tape being extracted unless the
modifier is in effect.
-d Debug. Turn on debugging output.
h Extract the actual directory, rather than the files that
it references. This prevents hierarchical restoration of
complete subtrees from the tape.
m Extract by inode numbers rather than by filename to avoid
regenerating complete pathnames. 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 Do 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. Specify the blocking factor for tape
reads. By default, vxrestore will attempt to figure out
the block size of the tape.
NOTE: A tape block is 512 bytes.
-e extent_opt
Specify how to handle a vxfs file that has extent
attribute information. Extent attributes include
reserved space, a fixed extent size, and extent
alignment. It may not be possible to preserve the
information if the destination file system does not
support extent attributes, has a different block size
than the source file system, or lacks free extents
appropriate to satisfy the extent attribute requirements.
Valid values for extent_opt are:
Copyright 1994 Novell, Inc. Page 2
vxrestore(1M_VXFS) (VXFS) vxrestore(1M_VXFS)
warn Issue a warning message if extent attribute
information cannot be kept (the default).
force Fail the file restore if extent attribute
information cannot be kept.
ignore Ignore extent attribute information entirely.
f dump-file
Use dump-file instead of /dev/rmt? as the file to
restore from. If dump-file is specified as ``-'',
vxrestore reads from the standard input. This allows
vxdump(1M) and vxrestore to be used in a pipeline to dump
and restore a file system:
example# vxdump 0f - /dev/rxy0g | (cd /mnt; vxrestore xf -)
s ni Skip to the n'th file when there are multiple dump files
on the same tape. For example, the command:
example# vxrestore xfs /dev/nrar0 5
would position you at the fifth file on the tape.
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]
List files in directory or the current directory,
represented by a ``.'' (period). Directories are
appended with a ``/'' (slash). Entries marked for
extraction are prefixed with an ``*'' (asterisk).
If the verbose option is in effect, inode numbers
are also listed.
cd directory
Change to directory directory (within the dump-
tape).
pwd Print the full pathname of the current working
directory.
Copyright 1994 Novell, Inc. Page 3
vxrestore(1M_VXFS) (VXFS) vxrestore(1M_VXFS)
add[filename]
Add 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]
Delete 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 Extract 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.
verbose Toggle 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 Display a summary of the available commands.
quit vxrestore exits immediately, even if the
extraction list is not empty.
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 incremental dumps will be
Copyright 1994 Novell, Inc. Page 4
vxrestore(1M_VXFS) (VXFS) vxrestore(1M_VXFS)
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 include the following:
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 an 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.
Copyright 1994 Novell, Inc. Page 5
vxrestore(1M_VXFS) (VXFS) vxrestore(1M_VXFS)
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, its contents are probably
partially wrong. If an inode is being skipped or the
tape is trying to resynchronize, 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
REFERENCES
mkfs(1M), mount(1M), vxdump(1M)
Copyright 1994 Novell, Inc. Page 6