1RESTOR(1M)                                                          RESTOR(1M)
2
3
4

NAME

6       restor - incremental file system restore
7

SYNOPSIS

9       restor key [ argument ... ]
10

DESCRIPTION

12       Restor  is used to read magtapes dumped with the dump command.  The key
13       specifies what is to be done.   Key  is  one  of  the  characters  rRxt
14       optionally combined with f.
15
16       f      Use  the  first  argument as the name of the tape instead of the
17              default.
18
19       r or R The tape is read and loaded into the file  system  specified  in
20              argument.   This should not be done lightly (see below).  If the
21              key is R restor asks which tape of a multi volume set  to  start
22              on.  This allows restor to be interrupted and then restarted (an
23              icheck -s must be done before restart).
24
25       x      Each file on the tape named by an argument  is  extracted.   The
26              file  name  has  all  `mount'  prefixes  removed;  for  example,
27              /usr/bin/lpr is named /bin/lpr on the tape.  The file  extracted
28              is  placed  in  a  file  with  a numeric name supplied by restor
29              (actually the inode number).  In order to  keep  the  amount  of
30              tape read to a minimum, the following procedure is recommended:
31
32              Mount volume 1 of the set of dump tapes.
33
34              Type the restor command.
35
36              Restor will announce whether or not it found the files, give the
37              number it will name the file, and rewind the tape.
38
39              It then asks you to `mount the desired tape volume'.   Type  the
40              number of the volume you choose.  On a multivolume dump the rec‐
41              ommended procedure is to mount the last through the first volume
42              in  that  order.   Restor  checks  to  see  if  any of the files
43              requested are on the mounted tape (or a  later  tape,  thus  the
44              reverse  order)  and  doesn't  read through the tape if no files
45              are.  If you are working with a single volume dump or the number
46              of  files being restored is large, respond to the query with `1'
47              and restor will read the tapes in sequential order.
48
49              If you have a hierarchy to restore you  can  use  dumpdir(1)  to
50              produce the list of names and a shell script to move the result‐
51              ing files to their homes.
52
53       t      Print the date the tape was written and the date the  filesystem
54              was dumped from.
55
56       The r option should only be used to restore a complete dump tape onto a
57       clear file system or to restore an incremental  dump  tape  onto  this.
58       Thus
59
60            /etc/mkfs /dev/rp0 40600
61            restor r /dev/rp0
62
63       is  a  typical sequence to restore a complete dump.  Another restor can
64       be done to get an incremental dump in on top of this.
65
66       A dump followed by a mkfs and a restor is used to change the size of  a
67       file system.
68

FILES

70       default tape unit varies with installation
71       rst*
72

SEE ALSO

74       dump(1), mkfs(1), dumpdir(1)
75

DIAGNOSTICS

77       There  are various diagnostics involved with reading the tape and writ‐
78       ing the disk.  There are also diagnostics if the  i-list  or  the  free
79       list of the file system is not large enough to hold the dump.
80
81       If  the  dump extends over more than one tape, it may ask you to change
82       tapes.  Reply with a new-line when the next tape has been mounted.
83

BUGS

85       There is redundant information on the tape that could be used  in  case
86       of tape reading problems.  Unfortunately, restor doesn't use it.
87
88
89
90                                                                    RESTOR(1M)
Impressum