![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to restore.nr CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 42BSD / ingres / doc / unix|
Return to restore.nr CVS log | Up to [CSRG BSD Unix] / 42BSD / ingres / doc / unix |
1.1 root 1: .th RESTORE UNIX 3/14/79
2: .sh NAME
3: restore \- recover from an \*(II or \*(UU crash.
4: .sh SYNOPSIS
5: .bd restore
6: [
7: .bd \-a
8: ] [
9: .bd \-s
10: ] [
11: .bd \*(+-w
12: ] [ database ... ]
13: .sh DESCRIPTION
14: .it Restore
15: is used to restore a data base after
16: an \*(II or \*(UU crash.
17: It should always be run after any abnormal termination
18: to ensure the integrity of the data base.
19: .s3
20: In order to run restore,
21: you must be the DBA for the database you are restoring
22: or the \*(II superuser and specify the
23: .bd \-s
24: flag.
25: .s3
26: If no databases are specified then all databases for which you are the DBA
27: are restored.
28: All databases will be restored if the \*(II superuser
29: has specified the
30: .bd \-s
31: flag.
32: .s3
33: If the
34: .bd \-a
35: flag is specified you will be asked before restore takes any serious
36: actions.
37: It is advisable to use this flag if you suspect the database is in bad shape.
38: Using /dev/null as input with the
39: .bd \-a
40: flag will provide a report of problems in
41: the data base.
42: If there were no errors while restoring a database,
43: .it purge
44: will be called, with the same flags that were given to
45: .it restore,
46: to remove unwanted files
47: and system temporaries.
48: .it Restore
49: may be called with the
50: .bd \-f
51: and/or
52: .bd \-p
53: flags for
54: .it purge.
55: Unrecognized files and expired relations are not removed unless the proper
56: flags are given.
57: In the case of an incomplete destroy, create or index
58: .it restore
59: will not delete
60: files for partially created or destroyed relations.
61: .it Purge
62: must be called with the
63: .bd \-f
64: flag to accomplish this.
65: .s3
66: .it Restore
67: locks the data base while it is being processed.
68: If a data base is busy
69: .it restore
70: will report this and go on to the next data base.
71: If standard input is not a terminal
72: .it restore
73: will wait for the data base to be free.
74: If the
75: .bd \-w
76: flag is set
77: .it restore
78: will not wait regardless of standard input.
79: If
80: .bd +w
81: is set it will always wait.
82: .s3
83: .it Restore
84: can recover a database from an update which had finished filling the
85: batch file.
86: Updates which did not make it to this stage should be rerun.
87: Similarly modifies which have finished recreating the relation will be completed
88: (the relation relation and attribute relations will be updated).
89: If a destroy was in progress it will be carried to completion, while a create
90: will almost always be backed out.
91: Destroying a relation with an index should destroy the index so
92: .it restore
93: may report
94: that a secondary relation has been found with no primary.
95: .s3
96: If interrupt (signal 2) is received the current database is closed and
97: the next, if any, is processed.
98: Quit (signal 3) will cause restore to terminate.
99: .sh EXAMPLE
100: restore \-f demo
101: .br
102: restore \-a grants < /dev/null
103: .sh DIAGNOSTICS
104: All diagnostics are followed by
105: a tuple from a system relations.
106: .s3
107: .in +5
108: .ti -5
109: ``No relation for attribute(s)'' \- the attributes listed have no corresponding entry in the
110: relation relation
111: .ti -5
112: ``No primary relation for index'' \- the tuple printed is the relation tuple for a secondary
113: index for which there is no primary relation.
114: The primary probably was destroyed the secondary will be.
115: .ti -5
116: ``No indexes entry for primary relation'' \- the tuple is for a primary relation, the relindxd
117: domain will be set to zero.
118: This is the product of an incomplete destroy.
119: .ti -5
120: ``No indexes entry for index'' \-
121: the tuple is for a secondary index, the index will be destroyed.
122: This is the product of an incomplete destroy.
123: .ti -5
124: ``\c
125: .it relname
126: is index for'' \- an index has been found for a primary which is not marked as indexed.
127: The primary will be so marked.
128: This is probably the product of an incomplete index command.
129: The index will have been created properly but not modified.
130: .ti -5
131: ``No file for'' \- There is no data for this relation tuple, the tuple will be
132: deleted.
133: If, under the
134: .bd \-a
135: option, the tuple is not deleted purge will not be called.
136: .ti -5
137: ``No secondary index for indexes entry'' \- An entry has been found in the
138: indexes relation for which the secondary index does not exist (no relation
139: relation tuple).
140: The entry will be deleted.
141: .in -5
142: .sh "SEE ALSO"
143: purge(unix)
144: .sh BUGS
145: If no database names are given,
146: only the databases located in the directory
147: .bd data/base
148: are restored,
149: and not the old databases
150: in
151: .bd datadir.
152: Explicit database names still work
153: for databases
154: in either directory.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.