unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (v7man)
Page:
Section:
Apropos / Subsearch:
optional field

RESTOR(1M)                                                          RESTOR(1M)



NAME
       restor - incremental file system restore

SYNOPSIS
       restor key [ argument ... ]

DESCRIPTION
       Restor  is used to read magtapes dumped with the dump command.  The key
       specifies what is to be done.   Key  is  one  of  the  characters  rRxt
       optionally combined with f.

       f      Use  the  first  argument as the name of the tape instead of the
              default.

       r or R The tape is read and loaded into the file  system  specified  in
              argument.   This should not be done lightly (see below).  If the
              key is R restor asks which tape of a multi volume set  to  start
              on.  This allows restor to be interrupted and then restarted (an
              icheck -s must be done before restart).

       x      Each file on the tape named by an argument  is  extracted.   The
              file  name  has  all  `mount'  prefixes  removed;  for  example,
              /usr/bin/lpr is named /bin/lpr on the tape.  The file  extracted
              is  placed  in  a  file  with  a numeric name supplied by restor
              (actually the inode number).  In order to  keep  the  amount  of
              tape read to a minimum, the following procedure is recommended:

              Mount volume 1 of the set of dump tapes.

              Type the restor command.

              Restor will announce whether or not it found the files, give the
              number it will name the file, and rewind the tape.

              It then asks you to `mount the desired tape volume'.   Type  the
              number of the volume you choose.  On a multivolume dump the rec-
              ommended procedure is to mount the last through the first volume
              in  that  order.   Restor  checks  to  see  if  any of the files
              requested are on the mounted tape (or a  later  tape,  thus  the
              reverse  order)  and  doesn't  read through the tape if no files
              are.  If you are working with a single volume dump or the number
              of  files being restored is large, respond to the query with `1'
              and restor will read the tapes in sequential order.

              If you have a hierarchy to restore you  can  use  dumpdir(1)  to
              produce the list of names and a shell script to move the result-
              ing files to their homes.

       t      Print the date the tape was written and the date the  filesystem
              was dumped from.

       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
       default tape unit varies with installation
       rst*

SEE ALSO
       dump(1), mkfs(1), dumpdir(1)

DIAGNOSTICS
       There  are various diagnostics involved with reading the tape and writ-
       ing 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.

       If  the  dump extends over more than one tape, it may ask you to change
       tapes.  Reply with a new-line when the next tape has been mounted.

BUGS
       There is redundant information on the tape that could be used  in  case
       of tape reading problems.  Unfortunately, restor doesn't use it.



                                                                    RESTOR(1M)