vrestore(8) — Maintenance
NAME
vrestore − restores files from devices written with the vdump command
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 ...]
FLAGS
−hDisplays usage help for vrestore.
−VDisplays the current vrestore version.
−tLists the names and size (in bytes) of all files contained on the storage device.
−lLists the saveset structure.
−iPermits interactive restoration of files read from the specified device. After reading directory information from the device, 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. The interactive commands are explained in the following list:
add argAdds the files in the saveset specified by arg to the list of files to be restored from the device. 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 argDeletes all files and their subdirectories specified by the arg parameter from the list of files to be restored from the device. An expedient way to select wanted files from any directory whose files are stored on the device 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 all files added to the list of files to be restored to the previously specified destination.
helpDisplays 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.
pwdPrints the path name of the current saveset directory to the standard output device.
quit or exitExits immediately, even when the files on the list of files to restored have not been read.
verboseToggles the −v modifier (see the −v flag). The name of each file restored from the device is written to the standard output device.
?Displays help information for the interactive commands.
−xExtracts a specific file or files from the saveset device instead of using the add command in interactive mode. The −x flag 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 /dev/rmt0h save device to the /mnt directory, enter:
# vrestore -x -D /mnt file1 file2
−mDoes not preserve the owner, group, or modes of each file from the device.
−qPrints only error messages; does not print information messages.
−vWrites the name of each file read from the device to the standard output device. Without this flag the vrestore command does not notify you about progress on reading from the storage device.
−f device
When an argument follows the −f flag, it specifies the name of the archive device, replacing the default device /dev/rmt0h.
−D pathSpecifies the destination path of where to restore the files. Without the −D flag, the files are restored to the current directory.
−o optSpecifies the action to take when a file already exists. The options are:
yesOverwrites existing files without any query. The default is yes.
noDoes not overwrite existing files.
askAsks whether to overwrite an existing file.
file ...Specifies the file or files to restore when using the −x flag. All other flags must precede any file names on the command line.
DESCRIPTION
The vrestore command restores data from a file, a pipe, magnetic devices, or disks. The data, previously written with the vdump command, is restored to the specified directory. The default dump media from which files are read is /dev/rmt0h. Using the -f flag you can specify another dump device or dump image file.
When you specify a directory name by using the -D option, the vrestore command restores all the files to the specified directory.
RESTRICTIONS
You must have write access to the directory you restore to. Root-user privilege allows you to restore to any directory that has write privileges.
This command does not restore quota files and displays a warning message when you attempt to recover a quota file.
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 location of the executable file for the vrestore command with static libraries.
/dev/rmt0h
The default storage device.