tar: Scripted Restoration

1 
1 5.6 Using the Restore Script
1 ============================
1 
1 To restore files that were archived using a scripted backup, use the
1 'restore' script.  Its usage is quite straightforward.  In the simplest
1 form, invoke 'restore --all', it will then restore all the file systems
11 and files specified in 'backup-specs' (⇒BACKUP_DIRS
 General-Purpose Variables.).
1 
1    You may select the file systems (and/or files) to restore by giving
1 'restore' a list of "patterns" in its command line.  For example,
1 running
1 
1      restore 'albert:*'
1 
1 will restore all file systems on the machine 'albert'.  A more
1 complicated example:
1 
1      restore 'albert:*' '*:/var'
1 
1 This command will restore all file systems on the machine 'albert' as
1 well as '/var' file system on all machines.
1 
1    By default 'restore' will start restoring files from the lowest
1 available dump level (usually zero) and will continue through all
1 available dump levels.  There may be situations where such a thorough
1 restore is not necessary.  For example, you may wish to restore only
1 files from the recent level one backup.  To do so, use '--level' option,
1 as shown in the example below:
1 
1      restore --level=1
1 
1    The full list of options accepted by 'restore' follows:
1 
1 '-a'
1 '--all'
1      Restore all file systems and files specified in 'backup-specs'.
1 
1 '-l LEVEL'
1 '--level=LEVEL'
1      Start restoring from the given backup level, instead of the default
1      0.
1 
1 '-v[LEVEL]'
1 '--verbose[=LEVEL]'
1      Set verbosity level.  The higher the level is, the more debugging
1      information will be output during execution.  Default LEVEL is 100,
1      which means the highest debugging level.
1 
1 '-h'
1 '--help'
1      Display short help message and exit.
1 
1 '-V'
1 '--version'
1      Display information about the program's name, version, origin and
1      legal status, all on standard output, and then exit successfully.
1 
1    You should start the restore script with the media containing the
1 first volume of the archive mounted.  The script will prompt for other
1 volumes as they are needed.  If the archive is on tape, you don't need
1 to rewind the tape to to its beginning--if the tape head is positioned
1 past the beginning of the archive, the script will rewind the tape as
1 needed.  ⇒Tape Positioning, for a discussion of tape positioning.
1 
1      *Warning:* The script will delete files from the active file system
1      if they were not in the file system when the archive was made.
1 
1    ⇒Incremental Dumps, for an explanation of how the script makes
1 that determination.
1