Restore(1)

NAME
     Restore - restore the specified file or directory from tape

SYNOPSIS
     Restore [ -h hostname ] [ -t tapedevice ] [ directory_name | file_name ]

DESCRIPTION
     The Restore command copies the named file or directory from a local or
     remote backup tapes to disk.  If no file or directory is specified,
     Restore copies all the files found on the tape to disk.

     Files are restored into the current directory if the backup tape contains
     pathnames beginning with ".".

     Files on disk are overwritten even if they are more recent than the
     respective files on tape.

     The options and arguments to Restore are:

     -h hostname     If a tape drive attached to a remote host is used for
                     restoring, specify the name of the remote host with the
                     -h hostname option.  For remote restore to successfully
                     work, you should have a TCP/IP network connection to the
                     remote host and guest login privileges on that host.

     -t tapedevice   If the local or remote tape device is pointed to by a
                     device file other than /dev/tape, the device should be
                     specified by the -t tapedevice option.

     directory_name  Restore just the files in the directory directory_name.
                     This is not the inverse of passing a single directory to
                     the Backup program.  It is intended for restoring only
                     some directories from a full backup.  To restore files
                     when only a single directory was archived with Backup,
                     The wild card * must be used, since they are archived
                     relative to the given directory.  When in doubt, use
                     List_tape to see the archive contents.

     file_name       Restore just the file file_name.

     The Restore command expects the backup tape to be in the special bru(1),
     tar(1) (older releases) or cpio(1) (newer releases) format written by
     Backup(1) and by the System Manager Backup & Restore tool when doing full
     (not partial) backups.  This is the same format used for system recovery.

SEE ALSO
     Backup(1), List_tape(1), bru(1), cpio(1), tar(1).