RESTORE(1M)          INTERACTIVE UNIX System          RESTORE(1M)



          NAME
               restore - restore file to original directory

          SYNOPSIS
               restore [-c] [-i] [-o] [-t] [-d <device>]
               [pattern [pattern]...]

          DESCRIPTION
               -c   complete restore.  All files on the tape are restored.

               -i   gets the index file off of the medium.  This only works
                    when the archive was created using backup.  The output
                    is a list of all the files on the medium.  No files are
                    actually restored.

               -o   overwrite existing files.  If the file being restored
                    already exists it will not be restored unless this
                    option is specified.

               -t   indicates that the tape device is to be used.  MUST be
                    used with the -d option when restoring from tape.

               -d   <device> is the raw device to be used.  It defaults to
                    /dev/rdsk/f0q15d (the 1.2M floppy).

               When doing a restore, one or more patterns can be specified.
               These patterns are matched against the files on the tape.
               When a match is found, the file is restored.  Since backups
               are done using full pathnames, the file is restored to its
               original directory.  Metacharacters can be used to match
               multiple files.  The patterns should be in quotes to prevent
               the characters from being expanded before they are passed to
               the command.  If no patterns are specified, it defaults to
               restoring all files.  If a pattern does not match any file
               on the tape, a message is printed.

               When end of medium is reached, the user is prompted for the
               next media.  The user can exit at this point by typing "q".
               (This may cause files to be corrupted if a file happens to
               span a medium.)  In general, quitting in the middle is not a
               good idea.

               If the file already exists and an attempt is made to restore
               it without the -o option, the file name will be printed on
               the screen followed by a question mark.  This file will not
               be restored.

               In order for multi-volume restores to work correctly, the
               raw device MUST be used.

          SEE ALSO
               qt(7), sh(1).



          Rev.                                                       Page 1