RESTOR(VIII)                11/24/73                 RESTOR(VIII)


     restor - incremental file system restore


     restor key [ arguments ]


     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


     A dump followed by a mkfs and a restor is used to change the

     size of a file system.




     dump, mkfs, check, clri (VIII)


     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.


     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.