restore(1)     UNIX System V(Application 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/SA/diskette

      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)








10/89                                                                    Page 1