Go to the previous, next section.

Using the Restore Script

FIXME: subject to change as things develop
(This message will disappear, once this node revised.)

(This node was @ignore'd--merely listing it for now.)

To restore files that were archived using a scripted backup, use the restore script. The syntax for the script is:

where ***** are the file systems to restore from, and ***** is a regular expression which specifies which files to restore. If you specify --all, the script restores all the files in the file system.

You should start the restore script with the media containing the first volume of the archive mounted. The script will prompt for other volumes as they are needed. If the archive is on tape, you don't need to rewind the tape to to its beginning--if the tape head is positioned past the beginning of the archive, the script will rewind the tape as needed.

FIXME: xref Media
, for a discussion of tape positioning.

If you specify `--all' as the files argument, the restore script extracts all the files in the archived file system into the active file system.

Warning:The script will delete files from the active file system if they were not in the file system when the archive was made.

FIXME: xref incremental and listed-incremental
, for an explanation of how the script makes that determination.
FIXME: this may be an option, not a given

Go to the previous, next section.