RESTORE(ADM)                       UNIX System V



     Name
          restore - UNIX incremental filesystem backup restore


     Syntax
          restore  [-c]  [-i]   [-o]   [-t]   [-d   device]   [pattern
          [pattern]...]


     Description
          This utility acts as a front end to cpio(C), and thus  reads
          cpio  format tapes or floppies.  This utility should only be
          used to restore  backups  made  with  the  AT&T  backup(ADM)
          utility, not xbackup(ADM).

          -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 entering
          ``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
          sh(C)


     (printed 8/23/89)                                  RESTORE(ADM)