vrestore - restores files from savesets that are produced by vdump
/sbin/vrestore -t [-f device]
/sbin/vrestore -l [-f device]
/sbin/vrestore -i [-mqv] [-f device] [-D path] [-o opt]
/sbin/vrestore -x [-mqv] [-f device] [-D path] [-o opt] [file...]
Displays usage help for vrestore. Displays the current vrestore version. 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. Lists the entire saveset structure. 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 interactive commands require as an arg parameter a subdirectory or file name for an argument. For others, when the arg parameter is unspecified, the default directory is the current one. 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.
The vrestore command restores data from a saveset previously written by the vdump command. The data, which can be restored from a file, a pipe, or a storage device (typically tape), is written to the specified directory. The default storage device from which files are read is /dev/rmt0h. You can use the -f option to specify a different device or file. Tape storage devices can contain more than one saveset.
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 filenames used to refer to them will be quota.user and quota.group, regardless 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.
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 -o no or -o ask options, you can prevent this behavior.
The vdump command can write many savesets to a tape. If you want to use the vrestore command to restore a particular saveset, you must first position the tape to the saveset by using the mt command with the fsf option. For example, to position a tape that is rewound at the beginning of its second saveset, you can enter the command mt fsf 1. The vdump and vrestore commands save and restore AdvFS sparse files. However, sparse files that have been striped are still handled in the fashion of releases earlier than DIGITAL UNIX Version 4.0D: they are allocated disk space and filled with zeros.
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
command, but you must have write access to the directory to which you want
to restore the files.
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.
The vrestore command in versions earlier than DIGITAL UNIX Version 4.0 cannot be used to restore savesets produced by the vdump command in DIGITAL UNIX Version 4.0 or higher systems.
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 fileset. If AdvFS quota files are to be restored to a UFS file system, quotas must be enabled on the UFS file system. Otherwise, the operation fails.
AdvFS fileset quotas cannot be restored to an UFS file system because
there is no UFS analog to AdvFS fileset quotas.
When the restore saveset device is the character - (dash), the vrestore command reads from standard input. Thus, the vdump and vrestore commands may be used in a pipeline expression to copy filesets. The following are typical commands, both equivalent: # vdump -0 -f - /usr | (cd /mnt; vrestore -x -f -) # vdump -0f - /usr | vrestore -xf - -D /mnt
The default storage device.