vrestore(8)vrestore(8)NAME
vrestore, rvrestore - Restores files from savesets that are produced by
vdump and rvdump
SYNOPSIS
/sbin/vrestore -h
/sbin/vrestore -V
/sbin/vrestore -t [-f device]
/sbin/vrestore -l [-Q] [-f device]
/sbin/vrestore -i [-mqQv] [-f device] [-D path] [-o opt]
/sbin/vrestore -x [-mqQv] [-f device] [-D path] [-o opt] [file...]
/sbin/rvrestore -h
/sbin/rvrestore -V
/sbin/rvrestore -t [-f nodename:device]
/sbin/rvrestore -l [-Q] [-f nodename:device]
/sbin/rvrestore -i [-mqQv] [-f nodename:device] [-D path] [-o opt]
/sbin/rvrestore -x [-mqQv] [-f nodename:device] [-D path] [-o opt]
[file...]
OPTIONS
Specifies the destination path of where to restore the files. Without
the -D option, the files are restored to the current directory. When
an argument follows the -f option, it specifies the name of the storage
device that contains the saveset to be restored. The argument replaces
the default device /dev/tape/tape0_d1.
For rvrestore, the mandatory specification is nodename:device to
specify the remote machine name that holds the saveset to be
restored. There is no default device. Displays usage help for
the command. Permits interactive restoration of files read from
a saveset. After reading directory information from the
saveset, the vrestore command provides a shell-like interface
that allows you to select the files you want to restore. Some
of the following interactive commands require an arg parameter
that is a subdirectory or one or more file names. The other
interactive commands use the current directory as default when
the arg parameter is not specified. Multiple file names can be
separated by spaces. Quotes (") can be used around a file name
that contains space(s). File names containing quotes (") can be
specified by preceding the quote with a backslash (\). The
interactive commands are explained in the following list: Adds
the files in the saveset specified by arg to the list of files
to be restored. Files on the list of files to be restored are
prepended with the * (asterisk) character when they are listed
with the ls interactive command. Changes the current saveset
directory to the directory specified with the arg parameter.
Deletes all files and their subdirectories specified by the arg
parameter from the list of files to be restored.
An expedient way to select wanted files from any directory in a
saveset is to add the directory to the list of files to be
restored and then delete the ones that are not wanted. Restores
files, previously added by using the add command, to the current
destination directory. Displays help information for the inter‐
active commands. Lists files in the current saveset directory
or the directory specified with the arg parameter. Directory
entries are appended with a slash (/) character. Entries that
have been marked to be restored are prepended with an asterisk
(*) character. Writes the path name of the current saveset
directory to the standard output device. Exits immediately,
even when the files on the list of files to be restored have not
been read. Escapes from the shell, runs the system command,
then returns to the shell. Selects the -v modifier (see the -v
option). The name of each file restored from the saveset is
written to the standard output device. Displays help informa‐
tion for the interactive commands. Lists the entire saveset
structure. Does not preserve the owner, group, or modes of each
file from the device. Specifies the action to take when a file
already exists. The options are: Overwrites existing files with‐
out any query. The default is yes. Does not overwrite existing
files. Asks whether to overwrite an existing file. Prints only
error messages; does not print information messages. Specifies
that quota files should not be restored. Lists the names and
size (in bytes) of all files contained in a saveset. Exception:
the sizes of any AdvFS quota files are not shown. Writes the
name of each file read from the storage device to the standard
output device. Without this option the vrestore command does
not notify you about progress on reading from the storage
device. Displays the current version for the command. Extracts
a specific file or files from the saveset. Use this command as
an alternate to using the add command in interactive mode. The
-x option can precede any other options, but the file... list
must be the last item on the command line.
For example, to restore the files file1 and file2 from the
saveset on the default device, /dev/tape/tape0_d1, to the /mnt
directory, enter: # vrestore-x -D /mnt file1 file2 Specifies
the file or files to restore when using the -x option. All
other options must precede any file names on the command line.
DESCRIPTION
The vrestore and rvrestore commands restore data from a saveset previ‐
ously archived by the vdump command or the rvdump command. The data,
which can be restored from a file, a pipe (not applicable for the rvre‐
store command), or a storage device (typically tape), is written to the
specified directory. The default storage device from which files are
read is /dev/tape/tape0_d1. You can use the -f option to specify a
different device or file. Tape storage devices can contain more than
one saveset. The vrestore and rvrestore commands restore any associated
extended attributes, including ACLs, in the archive data. See the pro‐
plist(4) and acl(4) reference pages.
The vrestore and rvrestore commands are the restore facility for the
AdvFS file system. However, the commands can be used to restore UFS
and NFS files that have been archived by using the vdump or rvdump com‐
mands.
The default directory into which the files are restored is the current
directory. You can specify an alternate directory by using the -D
option.
Use the -t option to list the file names and sizes of the files in a
saveset without restoring any files.
When you are using the interactive shell and the AdvFS user and group
quota files are available in the saveset for restoration, the file
names used to refer to them will be quota.user and quota.group, regard‐
less of what the quota files are named in either the backed up fileset
or in the destination fileset. Restoration of the quota files does not
change the names of the quota files in the destination fileset. Use the
-Q option if you do not want to restore quota files.
If the destination fileset is AdvFS, and the saveset contains AdvFS
fileset quotas, the fileset quotas are restored, even when they differ
from the fileset quotas of the destination fileset. By using the -Q
option, -o no, option or -o ask option, you can prevent this behavior.
The vdump and rvdump commands can write many savesets to a tape. If you
want to use the vrestore or the rvrestore commands to restore a partic‐
ular saveset, you must first position the tape to the saveset by using
the mt command with the fsf option to move through your tape.
The source directory path from a vdump command line is stored as a
string in the header record of the saveset produced. The vrestore com‐
mand displays this string when it restores the archived saveset. The
string truncates at 128 characters. Several vrestore command options,
including -t, -l, -i, and -x, display the source directory path. The
command is the exact string from the vdump command: it contains no
relative pathname expansions or resolved symbolic links.
For example, if a vdump command line contained instructions to dump
files from a directory named /usr/specs, which was a symbolic link to a
directory named /tmp_mnt/pease1/usr/specs, the source directory string
displayed by the vrestore command would be /usr/specs:
The vdump command: % vdump -0 -f mydump /usr/specs
The vrestore command and string displayed: % vrestore-t -f mydump vre‐
store: Date of the vdump save-set: "date" >>> vrestore: Save-set
source directory: /usr/specs
Files that were saved on a system running a pre-Version 5 operating
system will be restored by a Version 5 operating system in the same
manner as they would have been restored by a pre-Version 5 system. This
means that any UFS sparse files archived with the vdump command prior
to Tru64 UNIX Version 5.0 will be allocated disk space and filled with
zeros and any AdvFS striped sparse files archived with the vdump com‐
mand prior to Version 4.0D will be allocated disk space and filled with
zeros. If you save and restore your sparse files under Version 5, they
will remain sparse.
Note that an incremental dump only captures the files that have
changed, ignoring all others. This means that if you perform a level 0
dump and a later incremental dump, deleted files are not marked as gone
(deleted). If you then do a complete restore with a level 0 saveset and
incremental backups, the deleted files will be restored. You must then
delete these files individually.
You do not have to be the root user to use the vrestore command, but
you must have write access to the directory to which you want to
restore the files.
RESTRICTIONS
To run the rvrestore command, you must be able to execute the rsh com‐
mand from the remote node from which you want to restore. See rsh(1)
for server and client access rules.
Filesets that have been archived by using the vdump or rvdump command
must be restored by using the vrestore or rvrestore command. The vdump
and rvdump commands are not interchangeable with the dump and rdump
commands. Similarly, the vrestore and rvrestore commands are not inter‐
changeable with the restore and rrestore commands.
A saveset stored on a block special device file containing disk block 0
that has not had the disk label cleared will contain an error and no
files will be restored. See vdump(8) for more information.
Only the root user can restore AdvFS quota files and fileset quotas. A
warning message is displayed when a non-root user attempts to use the
vrestore command to restore AdvFS quota files or fileset quotas. Use
the -Q option to prevent the restoration of quota files.
The vrestore command in operating system versions earlier than Version
4.0 cannot be used to restore savesets produced by the vdump command in
Version 4.0 or higher systems.
The vrestore command in Tru64 UNIX Version 5.0 cannot interactively
restore quota files that have been saved by the vdump command in Ver‐
sion 4.0D and earlier. However, the command mode of the vrestore com‐
mand in Tru64 UNIX Version 5.0 can restore such quota files.
AdvFS quota files can be restored to either an AdvFS fileset or a UFS
file system, but UFS quota files cannot be restored to an AdvFS file‐
set. If AdvFS quota files are to be restored to a UFS file system, quo‐
tas must be enabled on the UFS file system. Otherwise, the operation
fails. AdvFS fileset quotas cannot be restored to a UFS file system
because there is no UFS analog to AdvFS fileset quotas.
Attempting to use a vrestore or rvrestore to restore to a base direc‐
tory that has a default directory access control list (ACL) or a
default access ACL may cause unintended ACLs to be created on the
restored files and directories. If ACLs are enabled on the system,
check all ACLs after using the vrestore or rvrestore command. View the
documents in SEE ALSO for more information about access control lists
(ACLs).
EXAMPLES
To restore a local archive produced by the vdump command and mounted on
the default storage device to the mnt directory, enter a command simi‐
lar to the following: % vrestore-D /mnt To restore a remote archive
produced by the vdump or rvdump command and mounted on the default
storage device on machine node pease to the local mnt directory, enter
a command similar to the following: # rvrestore -xf
pease:/dev/tape/tape0 -D /mnt When the restore saveset device is the
character dash (-), the vrestore command reads from standard input.
Thus, the vdump and vrestore commands can be used in a pipeline expres‐
sion to copy filesets. The following are typical commands; they are
equivalent: # vdump -0 -f - /usr | (cd /mnt; vrestore-x -f -) # vdump
-0f - /usr | vrestore-xf - -D /mnt
The rvdump and rvrestore commands are unable to use the dash
(-) character. The output device must be specified. To restore
from a tape containing multiple savesets you created with the
vdump command, use the mt fsf n command (forward space n
savesets or files) to locate the saveset to restore. The follow‐
ing example will space forward to the third saveset and then
restore it: # mt fsf 2 # vrestore-xf /dev/tape/tape0
FILES
The vrestore command path. The rvrestore command path. The default
storage device.
SEE ALSO
Commands: mt(1), rsh(1), rvdump(8), vdump(8)
Files: acl(4), proplist(4)
AdvFS Administration
vrestore(8)