HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

v
vxrestore(1M) vxrestore(1M)
ignore Ignore extent attribute information entirely.
warn Issue a warning message if extent attribute information cannot be kept (the
default).
-f file
Specify the name of the archive instead of
/dev/rmt/0m. If the name of the file is -(dash),
vxrestore reads from standard input. So you can use
vxdump and vxrestore in a pipe-
line to vxdump and vxrestore a file system with the command
vxdump 0f - /usr | (cd /mnt; vxrestore xf -)
You can use an archive name of the form machine
:device to specify a tape device on a remote
machine.
-h Extract the actual directory, rather than the files to which it refers. This prevents hierarchi-
cal restoration of complete subtrees.
-m Extract by inode numbers rather than by file name. This is useful if only a few files are being
extracted and you want to avoid regenerating the complete pathname to the file.
-v Specify verbose output; list the name of each file restored, preceded by its file type.
-y Do not ask whether to abort the operation if
vxrestore encounters a tape error, but con-
tinue. Normally
vxrestore asks whether to continue after encountering a read error.
With this option, vxrestore continues without asking, skipping over the bad tape block(s)
and continuing as best it can.
Operands
vxrestore recognizes the following operands:
filename
The name one or more files that contain file or directory names specifying the files to restore.
key A string of characters controlling what actions are taken by
vxrestore. This string con-
tains exactly one function letter from the group irRtx, and zero or more function modifiers
from the group befhmsvy.
Compatibility
A file with a large uid (user ID of the file owner) or large gid (group ID of the file owner) cannot be
restored correctly on a file system that does not support large IDs. Instead, the owner and/or group of the
file will be that of the user invoking
vxrestore. (A large ID is a value greater than 65535. The VxFS
Version 2 disk layout does not support large IDs).
Notes
If the dump tape contains files larger than 2 gigabytes, and if the file system being restored to does not
support files larger than 2 gigabytes, the file is not restored correctly. Instead it is truncated to 2 giga-
bytes.
The current version of vxrestore can read dumps produced by older versions of vxdump. Dumps pro-
duced by vxdump on other platforms can also be read by vxrestore, provided they are not from a ver-
sion of vxdump more recent the version of vxrestore in use.
vxrestore can restore files to a file system of a type other than VxFS. If the file system type does not
support extent attributes, than the extent attributes are not restored (see the -e option).
A version of
vxrestore resides in /sbin for use when the system is in single user state.
DIAGNOSTICS
vxrestore complains if a read error is encountered. If the -y option has been specified, or you respond
y, vxrestore tries to continue the restore.
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 to mount. The fastest way to extract a
few files is to start with the last volume and work towards the first volume.
Error Processing
vxrestore typically terminates if it encounters an error condition severe enough that it cannot continue
reliably. Termination generally indicates that there is a serious problems either in the backup media or
in the administrative procedures used during the dump/restore.
HP-UX 11i Version 2: August 2003 − 3 − Hewlett-Packard Company Section 1M−−905