RESTOR(VIII)                11/24/73                 RESTOR(VIII)
NAME
     restor - incremental file system restore
SYNOPSIS
     restor key [ arguments ]
DESCRIPTION
     Restor is  used  to  read  magtapes  dumped  with  the  dump
     command.   The  key  argument  specifies what is to be done.
     Key is a character from the set trxw.
       t   The date that the tape was made and the date that  was
          specified  in  the dump command are printed.  A list of
          all of the i-numbers on the tape are also given.
       r   The tape is read  and  loaded  into  the  file  system
          specified  in  arguments.   This  should  not  be  done
          lightly (see below).
       x   Each file on the tape is individually extracted into a
          file  whose  name is the file's i-number.  If there are
          arguments, they are interpreted as i-numbers  and  only
          they are extracted.
       w   In conjunction with the x option, before each file  is
          extracted,  its i-number is typed out.  To extract this
          file, you must respond with y.
     The r option should only be used to restore a complete  dump
     tape  onto  a clear file system or to restore an incremental
     dump tape onto this.  Thus
         /etc/mkfs /dev/rp0 40600
         restor r /dev/rp0
     is a typical sequence to restore a complete  dump.   Another
     restor  can  be done to get an incremental dump in on top of
     this.
     A dump followed by a mkfs and a restor is used to change the
     size of a file system.
FILES
     /dev/mt0
SEE ALSO
     dump, mkfs, check, clri (VIII)
DIAGNOSTICS
     There are various diagnostics involved with reading the tape
     and  writing the disk.  There are also diagnostics if the i-
     list or the free list of the file system is not large enough
     to hold the dump.
BUGS
     There is redundant information on the  tape  that  could  be
     used  in  case  of  tape  reading  problems.  Unfortunately,
     restor's approach is to exit if anything is wrong.
     Files  that  have  been  deleted  are   not   removed   when
     incremental tapes are loaded.  It will be necessary to check
     the restored file system and clri any  files  that  show  up
     with a 201 delta diagnostic.
     The current version of restor does not free  space  occupied
     by files that are overwritten.  Thus a check will have to be
     performed to reclain the missing space.