[unix-history] / man / man8 / restor.8

.th RESTOR VIII 11/24/73
.sh NAME
restor \*- incremental file system restore
.sh SYNOPSIS
.bd restor
key [ arguments ]
.sh DESCRIPTION
.it Restor
is used to read magtapes dumped with the
.it dump
command.
The
.it key
argument specifies what is to be done.
.it Key
is a character from the set
.bd trxw.
.s3
.lp +5 3
\fBt\fR	The date that the tape was made and the date that
was specified in the
.it dump
command are printed.
A list of all of the i-numbers on the tape
are also given.
.s3
.lp +5 3
\fBr\fR	The tape
is read and loaded into the file system
specified in
.it arguments.
This should not be done lightly (see below).
.s3
.lp +5 3
\fBx\fR	Each file on the
tape is individually extracted into
a file whose name is the file's i-number.
If
there are
.it arguments,
they are interpreted as i-numbers and only they are
extracted.
.s3
.lp +5 3
\fBw\fR	In conjunction with the
.bd x
option,
before each file is extracted,
its i-number is typed out.
To extract this file,
you must respond with
.bd y.
.s3
.i0
The
.bd 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
.s3
	/etc/mkfs /dev/rp0 40600
.br
	restor r /dev/rp0
.s3
is a typical sequence to restore a complete dump.
Another
.it restor
can be done to get an incremental dump
in on top of this.
.s3
A
.it dump
followed by a
.it mkfs
and a
.it restor
is used to
change the size of a file system.
.sh FILES
/dev/mt0
.sh "SEE ALSO"
dump, mkfs, check, clri (VIII)
.sh 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.
.sh BUGS
There is redundant information on the tape
that could be used in case of tape reading problems.
Unfortunately,
.it restor's
approach is to exit if anything is wrong.
.s3
Files that have been deleted are
not removed when incremental tapes are loaded.
It will be necessary to
.it check
the restored file system and
.it clri
any files that show up with
a 201 delta diagnostic.
.s3
The current version of
.it restor
does not free space occupied
by files that are overwritten.
Thus a
.it check
will have to be performed to reclain the missing
space.
Commit	Line	Data
37c22d79 KT	1	.th RESTOR VIII 11/24/73
	2	.sh NAME
	3	restor \*- incremental file system restore
	4	.sh SYNOPSIS
	5	.bd restor
	6	key [ arguments ]
	7	.sh DESCRIPTION
	8	.it Restor
	9	is used to read magtapes dumped with the
	10	.it dump
	11	command.
	12	The
	13	.it key
	14	argument specifies what is to be done.
	15	.it Key
	16	is a character from the set
	17	.bd trxw.
	18	.s3
	19	.lp +5 3
	20	\fBt\fR The date that the tape was made and the date that
	21	was specified in the
	22	.it dump
	23	command are printed.
	24	A list of all of the i-numbers on the tape
	25	are also given.
	26	.s3
	27	.lp +5 3
	28	\fBr\fR The tape
	29	is read and loaded into the file system
	30	specified in
	31	.it arguments.
	32	This should not be done lightly (see below).
	33	.s3
	34	.lp +5 3
	35	\fBx\fR Each file on the
	36	tape is individually extracted into
	37	a file whose name is the file's i-number.
	38	If
	39	there are
	40	.it arguments,
	41	they are interpreted as i-numbers and only they are
	42	extracted.
	43	.s3
	44	.lp +5 3
	45	\fBw\fR In conjunction with the
	46	.bd x
	47	option,
	48	before each file is extracted,
	49	its i-number is typed out.
	50	To extract this file,
	51	you must respond with
	52	.bd y.
	53	.s3
	54	.i0
	55	The
	56	.bd r
	57	option should only be used to restore
	58	a complete dump tape onto a clear file system
	59	or to restore an incremental dump tape onto this.
	60	Thus
	61	.s3
	62	/etc/mkfs /dev/rp0 40600
	63	.br
	64	restor r /dev/rp0
65	.s3
66	is a typical sequence to restore a complete dump.
67	Another
68	.it restor
69	can be done to get an incremental dump
70	in on top of this.
71	.s3
72	A
73	.it dump
74	followed by a
75	.it mkfs
76	and a
77	.it restor
78	is used to
79	change the size of a file system.
80	.sh FILES
81	/dev/mt0
82	.sh "SEE ALSO"
83	dump, mkfs, check, clri (VIII)
84	.sh DIAGNOSTICS
85	There are various diagnostics
86	involved with reading the tape and writing the disk.
87	There are also diagnostics if the i-list or the free list
88	of the file system is not large enough to hold the dump.
89	.sh BUGS
90	There is redundant information on the tape
91	that could be used in case of tape reading problems.
92	Unfortunately,
93	.it restor's
94	approach is to exit if anything is wrong.
95	.s3
96	Files that have been deleted are
97	not removed when incremental tapes are loaded.
98	It will be necessary to
99	.it check
100	the restored file system and
101	.it clri
102	any files that show up with
103	a 201 delta diagnostic.
104	.s3
105	The current version of
106	.it restor
107	does not free space occupied
108	by files that are overwritten.
109	Thus a
110	.it check
111	will have to be performed to reclain the missing
112	space.