restore(1)             (XENIX Compatibility Package)             restore(1)


   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/rmt/ctape1

         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 retored.

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

   SEE ALSO
         sh(1).







   7/91                                                                 Page 1