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