[unix-history] / usr / man / man1 / restor.1m

.TH RESTOR 1M 
.SH NAME
restor \- incremental file system restore
.SH SYNOPSIS
.I restor
key [ argument ... ]
.SH DESCRIPTION
.I Restor
is used to read magtapes dumped with the
.I dump
command.
The
.I key
specifies what is to be done.
.I Key
is one of the characters
.B rRxt
optionally combined with
.BR f .
.TP
.B  f
Use the first
.I argument
as the name of the tape instead
of the default.
.TP
.B  r or R
The tape
is read and loaded into the file system
specified in
.I argument.
This should not be done lightly (see below).
If the key is
.B R
.I restor
asks which tape of a multi volume set to start on.
This allows restor to be interrupted and then
restarted (an
.I icheck \-s must be done before restart).
.TP
.B  x
Each file on the
tape named by an 
.I argument
is extracted.
The file extracted is placed in a file with a numeric name
supplied by
.I restor
(actually the inode number).
In order to keep the amount of tape read to a minimum,
the following procedure is recommended:
.sp
Mount volume 1 of the set of dump tapes.
.sp
Type the
.I restor
command.
.sp
.I Restor
will announce whether or not it found the files,
give the number it will name the file, and rewind the tape.
.sp
It then
asks you to `mount the desired tape volume'.
Type the number of the volume you choose.
On a
multivolume dump the recommended procedure is to mount the
last through the first volume in that order.
.I 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
.I restor
will read the tapes in sequential order.
.sp
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 resulting files to their homes.
.TP
.B t
Print the date the tape was written and the date
the filesystem was dumped from.
.PP
The
.B 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
.PP
	/etc/mkfs /dev/rp0 40600
.br
	restor r /dev/rp0
.PP
is a typical sequence to restore a complete dump.
Another
.I restor
can be done to get an incremental dump
in on top of this.
.PP
A
.I dump
followed by a
.I mkfs
and a
.I restor
is used to
change the size of a file system.
.SH FILES
default tape unit varies with installation
.br
rst*
.SH "SEE ALSO"
dump(1), mkfs(1), dumpdir(1)
.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.
.PP
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.
.SH BUGS
There is redundant information on the tape
that could be used in case of tape reading problems.
Unfortunately,
.I restor
doesn't use it.
Commit	Line	Data
38946242 TL	1	.TH RESTOR 1M
	2	.SH NAME
	3	restor \- incremental file system restore
	4	.SH SYNOPSIS
	5	.I restor
	6	key [ argument ... ]
	7	.SH DESCRIPTION
	8	.I Restor
	9	is used to read magtapes dumped with the
	10	.I dump
	11	command.
	12	The
	13	.I key
	14	specifies what is to be done.
	15	.I Key
	16	is one of the characters
	17	.B rRxt
	18	optionally combined with
	19	.BR f .
	20	.TP
	21	.B f
	22	Use the first
	23	.I argument
	24	as the name of the tape instead
	25	of the default.
	26	.TP
	27	.B r or R
	28	The tape
	29	is read and loaded into the file system
	30	specified in
	31	.I argument.
	32	This should not be done lightly (see below).
	33	If the key is
	34	.B R
	35	.I restor
	36	asks which tape of a multi volume set to start on.
	37	This allows restor to be interrupted and then
	38	restarted (an
	39	.I icheck \-s must be done before restart).
	40	.TP
	41	.B x
	42	Each file on the
	43	tape named by an
	44	.I argument
	45	is extracted.
	46	The file extracted is placed in a file with a numeric name
	47	supplied by
	48	.I restor
	49	(actually the inode number).
	50	In order to keep the amount of tape read to a minimum,
	51	the following procedure is recommended:
	52	.sp
	53	Mount volume 1 of the set of dump tapes.
	54	.sp
	55	Type the
	56	.I restor
	57	command.
	58	.sp
	59	.I Restor
	60	will announce whether or not it found the files,
	61	give the number it will name the file, and rewind the tape.
	62	.sp
	63	It then
	64	asks you to `mount the desired tape volume'.
65	Type the number of the volume you choose.
66	On a
67	multivolume dump the recommended procedure is to mount the
68	last through the first volume in that order.
69	.I Restor
70	checks to see if any of the files requested are on the
71	mounted tape (or a later tape, thus the reverse order) and doesn't
72	read through the tape if no files are.
73	If you are working with a single volume dump or the number of files
74	being restored is large, respond to the query with `1' and
75	.I restor
76	will read the tapes in sequential order.
77	.sp
78	If you have a hierarchy to restore you can use dumpdir(1)
79	to produce the list of names and a shell script to move
80	the resulting files to their homes.
81	.TP
82	.B t
83	Print the date the tape was written and the date
84	the filesystem was dumped from.
85	.PP
86	The
87	.B r
88	option should only be used to restore
89	a complete dump tape onto a clear file system
90	or to restore an incremental dump tape onto this.
91	Thus
92	.PP
93	/etc/mkfs /dev/rp0 40600
94	.br
95	restor r /dev/rp0
96	.PP
97	is a typical sequence to restore a complete dump.
98	Another
99	.I restor
100	can be done to get an incremental dump
101	in on top of this.
102	.PP
103	A
104	.I dump
105	followed by a
106	.I mkfs
107	and a
108	.I restor
109	is used to
110	change the size of a file system.
111	.SH FILES
112	default tape unit varies with installation
113	.br
114	rst*
115	.SH "SEE ALSO"
116	dump(1), mkfs(1), dumpdir(1)
117	.SH DIAGNOSTICS
118	There are various diagnostics
119	involved with reading the tape and writing the disk.
120	There are also diagnostics if the i-list or the free list
121	of the file system is not large enough to hold the dump.
122	.PP
123	If the dump extends over more than one tape,
124	it may ask you to change tapes.
125	Reply with a new-line when the next tape has been mounted.
126	.SH BUGS
127	There is redundant information on the tape
128	that could be used in case of tape reading problems.
129	Unfortunately,
130	.I restor
131	doesn't use it.