1 02/27/85 reload
2
3 Syntax as a command: reload -control_args
4
5
6 Function: reloads the entire storage system from a hierarchy dump
7 tape. It deletes segments and directories from the hierarchy that were
8 not present when the hierarchy dump tape was made, and replaces
9 existing segments and directories with their counterparts from the
10 tape. However, to avoid destroying useful information, it does not
11 delete directories, and it does not replace segments and directories in
12 the hierarchy that were modified after the time at which they were
13 dumped to tape. The reload command calls the backup_load command to do
14 the actual reloading.
15
16 The reload command places its map in the directory >reload_dir to
17 which the process must have sma access, and automatically dprints it.
18 Quota on the reloaded directories is force-set to that specified on the
19 hierarchy dump tape.
20
21
22 The reload command is one of the commands used for hierarchy reloading
23 and retrieving of storage system segments and directories. The other
24 commands are:
25
26 backup_load
27 reload initializer command
28 reload_system_release
29 retrieve
30
31 Do not confuse this reload command, which is a Multics command, with
32 the reload initializer command.
33
34
35 You should note that argument processing for all of the hierarchy
36 backup commands is performed by a common argument processing procedure.
37 The values of all arguments are remembered in static storage and remain
38 in effect for the life of the process, unless changed by arguments
39 given in subsequent invocations of backup commands. It should also be
40 noted that the dumping commands and the reloading/retrieving commands
41 are all part of the same hierarchy backup system, and argument values
42 set by the dumping commands remain in effect for the
43 reloading/retrieving commands and vice versa, unless overridden.
44 However, dumping and reloading cannot be done in the same process; use
45 the new_proc command between dumping and reloading. See "Notes on
46 Default Arguments" below.
47
48
49 Control arguments:
50 -all
51 causes segments to be retrieved from the tape regardless of their
52 date/time dumped. This control argument overrides a previously
53 given DATE argument. This is the default.
54 -brief_map, -bfmap
55 creates a map file that lists the processed entries.
56 -debug
57 disables those hphcs_ calls that set quotas and transparency
58 switches.
59 -destination STR, -ds STR
60 specifies a destination for printing maps and error file. The
61 default is "incremental" for maps and "error file" for error files.
62
63
64 -dprint, -dp
65 causes the reload command to dprint maps and error files. This is
66 the default.
67 -error_of
68 writes error messages into a file rather than printing them. The
69 name of the error file is printed when the first error is
70 encountered. This is the default.
71 -error_on
72 writes error messages on the user's terminal.
73 -first
74 prevents searching a tape for additional copies of a requested
75 segment or subtree after the first copy has been retrieved.
76 -header STR, -he STR
77 specifies a heading for printing maps and error files.
78
79
80 -last
81 indicates that the last copy of a given segment or subtree on a tape
82 or set of tapes is to be retrieved. This is the default.
83 -map
84 writes a list of the segments and directories processed into a file.
85 This is the default.
86 -nodebug
87 enables hphcs_ calls to set quotas and the transparency switches.
88 This is the default.
89
90
91 -nodprint, -no_deprint, -ndp
92 causes the reload command not to dprint maps and error files. The
93 default is -dprint.
94 -nomap
95 inhibits listing of the names of processed segments and directories.
96 This control argument and the -noreload control argument are
97 incompatible when used with the reload command; only one or the
98 other can be used.
99 -noprimary, -npri
100 uses each pathname as given. The default is -primary.
101 -noqcheck
102 causes the hierarchy reload to be done with quota checking
103 suspended. Access to hphcs_ is required. This is the default.
104
105
106 -noquota
107 inhibits resetting of quotas. See -quota. This is the default.
108 -noreload
109 inhibits actual hierarchy reloading of segments into the hierarchy.
110 This control argument can be used with -map to create a table of
111 contents of the tape. The -noreload control argument also causes
112 the names that would have been reloaded to be put into the map.
113 This control argument and the -nomap control argument are
114 incompatible when used with the reload command; only one or the
115 other can be used.
116 -nosetlvid
117 inhibits the setting of the logical volume identifiers for each
118 directory to be reloaded.
119
120
121 -notrim
122 inhibits deletion of entries in a directory. Entries can only be
123 added or modified.
124 -operator STR
125 indicates that STR is the user's name or initials up to 16
126 characters in length.
127 -primary, -pri
128 replaces all directory names in each pathname with the primary
129 names. This is the default.
130 -pvname STR
131 indicates that segments and directories may only be reloaded onto
132 the physical volume specified by STR.
133 -qcheck
134 causes quota restrictions to be enforced during the reload.
135
136
137 -queue N, -q N
138 specifies a queue number for any maps and error files that are
139 dprinted. The default is queue 1.
140 -quota
141 causes the quotas on directories being reloaded to be set to the
142 values they had when the directories were dumped. Access to hphcs_
143 is required. This is the default.
144 -reload
145 enables actual reloading of segments into the hierarchy. This is
146 the default.
147
148
149 -request_type STR, -rqt STR
150 specifies an output request type for printing maps and error files.
151 Available request types can be listed by using the
152 print_request_types command described in the Multics Commands and
153 Active Functions manual Order No. AG92 . The default is
154 "printer".
155 -setlvid
156 enables setting of the logical volume identifier for reloaded
157 entries inferior to each directory reloaded. This is the default.
158
159
160 -trim
161 enables deletion of all entries in a directory not found in the copy
162 of that directory being reloaded. This causes entries deleted from
163 an earlier version of the directory to be deleted when a later
164 version is reloaded. This is the default. It has effect only in
165 the case of a directory that is both on the tape and in the
166 hierarchy.
167 DATE
168 an argument beginning with a character other than "-", or ">" is
169 assumed to be a date in a format acceptable to the
170 convert_date_to_binary_ subroutine. If it can be converted
171 successfully, then the hierarchy retriever only retrieves segments
172 and directories dumped at or after the given date/time.
173
174
175 Notes on default arguments: The values of arguments given to any of
176 the hierarchy backup commands are remembered in static storage and
177 remain in effect for the life of the process, unless explicitly changed
178 during the invocation of a subsequent backup command.
179
180 The following defaults are in effect for the reloader and retriever
181 before any backup commands are given; they are not, however, reset to
182 these values at the start of each backup command, except as noted
183 below.
184
185 -all -noquota
186 -error_of -primary
187 -map -reload
188 -nodebug -setlvid
189 -nohold -trim
190
191
192 The following defaults are set automatically at the time the respective
193 commands are executed:
194
195 reload initializer command, reload Multics command,
196 reload_system_release:
197 -quota
198 -trim
199
200 retrieve:
201 -all
202 -noquota
203 -notrim
204
205 All of the above commands:
206 -map