 |
Index for Section 8 |
|
 |
Alphabetical listing for V |
|
vrestore(8)
NAME
vrestore - restores files from savesets that are produced by vdump
SYNOPSIS
/sbin/vrestore -h
/sbin/vrestore -V
/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...]
OPTIONS
-h Displays usage help for vrestore.
-V Displays the current vrestore version.
-t 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.
-l Lists the entire saveset structure.
-i 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:
add arg
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.
cd [arg]
Changes the current saveset directory to the directory specified
with the arg parameter.
delete arg
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.
extract or restore
Restores files, previously added by using the add command, to the
current destination directory.
help
Displays help information for the interactive commands.
ls [arg]
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.
pwd Writes the path name of the current saveset directory to the
standard output device.
quit or exit
Exits immediately, even when the files on the list of files to
restored have not been read.
sh command
Escapes from the shell, runs the system command, then returns to
the shell.
verbose
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 information for the interactive commands.
-x 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
/dev/rmt0h to the /mnt directory, enter:
# vrestore -x -D /mnt file1 file2
-m Does not preserve the owner, group, or modes of each file from the
device.
-q Prints only error messages; does not print information messages.
-v 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.
-f device
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/rmt0h.
-D path
Specifies the destination path of where to restore the files. Without
the -D option, the files are restored to the current directory.
-o opt
Specifies the action to take when a file already exists. The options
are:
yes Overwrites existing files without any query. The default is yes.
no Does not overwrite existing files.
ask Asks whether to overwrite an existing file.
file ...
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 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 vrestore command, but you
must have write access to the directory to which you want to restore the
files.
RESTRICTIONS
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.
EXAMPLES
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
FILES
/sbin/vrestore
The vrestore command path.
/dev/rmt0h
The default storage device.
SEE ALSO
mt(1), vdump(8)