comparison docs/nitros9guide/chap6.chapter @ 1053:b5ff125a1d60

Since this book was only typeset in fixed width, single-font, they used capitalization and quotes (") to show what was commands, files and just text. With today's formatting, this is not necessary, so everywhere capitalization was used to show a command the <command> element is now used instead, and everywhere a file is mentioned the <filename> element is used.
author roug
date Thu, 20 Mar 2003 20:19:53 +0000 (2003-03-20)
parents cc153d1671f7
children 4dae346c4969
comparison
equal deleted inserted replaced
1052:6404be5d6368 1053:b5ff125a1d60
6 frequently used during normal system operations. Therefore, the 6 frequently used during normal system operations. Therefore, the
7 system disk is generally kept in disk drive zero (&quot;/D0&quot;) when the 7 system disk is generally kept in disk drive zero (&quot;/D0&quot;) when the
8 system is running. 8 system is running.
9 </para> 9 </para>
10 <para> 10 <para>
11 Two files used during the system startup operation, &quot;OS9Boot&quot; and 11 Two files used during the system startup operation, <filename>OS9Boot</filename> and
12 &quot;startup&quot; <emphasis>must</emphasis> 12 <filename>startup</filename> <emphasis>must</emphasis>
13 reside in the system disk's root directory. Other 13 reside in the system disk's root directory. Other
14 files are organized into three directories: CMDS (commands), DEFS 14 files are organized into three directories:
15 (system-wide definitions), and SYS (other system files). Other files 15 <filename class="directory">CMDS</filename> (commands),
16 <filename class="directory">DEFS</filename> (system-wide definitions),
17 and <filename class="directory">SYS</filename> (other system files). Other files
16 and directories created by the system manager and/or users may also 18 and directories created by the system manager and/or users may also
17 reside on the system disk. These frequently include each user s 19 reside on the system disk. These frequently include each user s
18 initial data directory. 20 initial data directory.
19 </para> 21 </para>
20 22
21 <section> 23 <section>
22 <title>The OS9Boot File</title> 24 <title>The OS9Boot File</title>
23 25
24 <para> 26 <para>
25 The file called &quot;OS9Boot&quot; loaded into RAM memory by the 27 The file called <filename>OS9Boot</filename> loaded into RAM memory by the
26 &quot;bootstrap&quot; routine located in the OS-9 firmware. It includes file 28 &quot;bootstrap&quot; routine located in the OS-9 firmware. It includes file
27 managers, device drivers and descriptors, and any other modules 29 managers, device drivers and descriptors, and any other modules
28 which are permanently resident in memory. A typical Microware OS-9 30 which are permanently resident in memory. A typical Microware OS-9
29 distribution disk's &quot;OS9Boot&quot; file contains the following modules: 31 distribution disk's <filename>OS9Boot</filename> file contains the following modules:
30 </para> 32 </para>
31 <informaltable frame="none"> 33 <informaltable frame="none">
32 <tgroup cols="2"> 34 <tgroup cols="2">
33 <colspec colwidth="1.5in"/> 35 <colspec colwidth="1.5in"/>
34 <colspec colwidth="3.5in"/> 36 <colspec colwidth="3.5in"/>
109 </tgroup> 111 </tgroup>
110 </informaltable> 112 </informaltable>
111 113
112 <para> 114 <para>
113 Users may create new bootstrap files which may include additional 115 Users may create new bootstrap files which may include additional
114 modules (see &quot;OS9Gen&quot; command). Any module loaded as part of the 116 modules (see <command>OS9Gen</command> command). Any module loaded as part of the
115 bootstrap cannot be unlinked and is stored in memory with a minimum 117 bootstrap cannot be unlinked and is stored in memory with a minimum
116 of fragmentation. It may be advantageous to include in the OS9Boot 118 of fragmentation. It may be advantageous to include in the OS9Boot
117 file any module used constantly during normal system operation. 119 file any module used constantly during normal system operation.
118 This can be done with the OS9GEN command. 120 This can be done with the OS9GEN command.
119 </para> 121 </para>
121 123
122 <section> 124 <section>
123 <title>The SYS Directory</title> 125 <title>The SYS Directory</title>
124 126
125 <para> 127 <para>
126 The directory &quot;/d0/SYS&quot; contains two important files: 128 The directory <filename>/d0/SYS</filename> contains two important files:
127 </para> 129 </para>
128 <informaltable frame="none"> 130 <informaltable frame="none">
129 <tgroup cols="2"> 131 <tgroup cols="2">
130 <colspec colwidth="1in"/> 132 <colspec colwidth="1in"/>
131 <colspec colwidth="4in"/> 133 <colspec colwidth="4in"/>
132 <tbody> 134 <tbody>
133 <row> 135 <row>
134 <entry>password</entry> 136 <entry>password</entry>
135 <entry>the system password file (see &quot;login&quot; command)</entry> 137 <entry>the system password file (see <command>login</command> command)</entry>
136 </row> 138 </row>
137 <row> 139 <row>
138 <entry>errmsg</entry> 140 <entry>errmsg</entry>
139 <entry>the error message file</entry> 141 <entry>the error message file</entry>
140 </row> 142 </row>
141 </tbody> 143 </tbody>
142 </tgroup> 144 </tgroup>
143 </informaltable> 145 </informaltable>
144 <para> 146 <para>
145 These files (and the SYS directory itself) are not absolutely 147 These files (and the <filename class="directory">SYS</filename> directory itself) are not absolutely
146 required to boot OS-9, they are needed if &quot;login&quot;, &quot;tsmon&quot;, or 148 required to boot OS-9, they are needed if <command>login</command>, <command>tsmon</command>, or
147 &quot;printerr&quot; will be used. Users may add other system-wide files of 149 <command>printerr</command> will be used. Users may add other system-wide files of
148 similar nature if desired. 150 similar nature if desired.
149 </para> 151 </para>
150 </section> 152 </section>
151 153
152 <section> 154 <section>
153 <title>The Startup File</title> 155 <title>The Startup File</title>
154 156
155 <para> 157 <para>
156 The file &quot;/d0/startup&quot; is a shell procedure file which 158 The file <filename>/d0/startup</filename> is a shell procedure file which
157 is automatically processed immediately after system startup. The 159 is automatically processed immediately after system startup. The
158 user may include in &quot;startup&quot; any legal shell command line. Often 160 user may include in <filename>startup</filename> any legal shell command line. Often
159 this will include &quot;setime&quot; to start the system clock. If this file 161 this will include <command>setime</command> to start the system clock. If this file
160 is not present the system will still start correctly but the user 162 is not present the system will still start correctly but the user
161 must run the SETIME command manually. 163 must run the SETIME command manually.
162 </para> 164 </para>
163 </section> 165 </section>
164 166
165 <section> 167 <section>
166 <title>The CMDS Directory</title> 168 <title>The CMDS Directory</title>
167 169
168 <para> 170 <para>
169 The directory &quot;/d0/CMDS&quot; is the system-wide command object code 171 The directory <filename class="directory">/d0/CMDS</filename> is the system-wide command object code
170 directory, which is normally shared by all users as their working 172 directory, which is normally shared by all users as their working
171 execution directory. If &quot;shell&quot; is not part of the 173 execution directory. If <command>shell</command> is not part of the
172 &quot;OS9Boot&quot; file, it must be present in this directory. The system 174 <filename>OS9Boot</filename> file, it must be present in this directory. The system
173 startup process &quot;sysgo&quot; makes CMDS the initial execution directory. 175 startup process &quot;sysgo&quot; makes <filename class="directory">CMDS</filename> the initial execution directory.
174 </para> 176 </para>
175 </section> 177 </section>
176 178
177 <section> 179 <section>
178 <title>The DEFS Directory</title> 180 <title>The DEFS Directory</title>
179 181
180 <para> 182 <para>
181 The directory &quot;/d0/DEFS&quot; is a directory that contains assembly 183 The directory <filename class="directory">/d0/DEFS</filename> is a directory that contains assembly
182 language source code files which contain common system-wide symbolic 184 language source code files which contain common system-wide symbolic
183 definitions, and are normally included in assembly language programs 185 definitions, and are normally included in assembly language programs
184 by means of the OS-9 Assembler &quot;use&quot; directive. The presence and 186 by means of the OS-9 Assembler &quot;use&quot; directive. The presence and
185 use of this directory is optional, but highly recommended for any 187 use of this directory is optional, but highly recommended for any
186 system used for assembly language programs. The files commonly 188 system used for assembly language programs. The files commonly
216 <section> 218 <section>
217 <title>Changing System Disks</title> 219 <title>Changing System Disks</title>
218 220
219 <para> 221 <para>
220 The system disk is not usually removed while the system is running, especially 222 The system disk is not usually removed while the system is running, especially
221 on multiuser systems. If it is, the &quot;chx&quot; and 223 on multiuser systems. If it is, the <command>chx</command> and
222 &quot;chd&quot; (if the working data directory was on the system disk) 224 <command>chd</command> (if the working data directory was on the system disk)
223 commands should be executed to reset the working directory pointers 225 commands should be executed to reset the working directory pointers
224 because the directories may be at different addresses on the new 226 because the directories may be at different addresses on the new
225 disk, for example: 227 disk, for example:
226 </para> 228 </para>
227 229
250 <listitem><para> 252 <listitem><para>
251 The new disk must be formatted. 253 The new disk must be formatted.
252 </para></listitem> 254 </para></listitem>
253 255
254 <listitem><para> 256 <listitem><para>
255 The &quot;OS9Boot&quot; file must be created and linked by the &quot;OS9Gen&quot; or 257 The <filename>OS9Boot</filename> file must be created and linked by the <command>OS9Gen</command> or
256 &quot;Cobbler&quot; commands. 258 <command>Cobbler</command> commands.
257 </para></listitem> 259 </para></listitem>
258 260
259 <listitem><para> 261 <listitem><para>
260 The &quot;startup&quot; file must be created or copied. 262 The <filename>startup</filename> file must be created or copied.
261 </para></listitem> 263 </para></listitem>
262 264
263 <listitem><para> 265 <listitem><para>
264 The CMDS and SYS directories and the files they contain must be 266 The <filename class="directory">CMDS</filename> and
267 <filename class="directory">SYS</filename> directories and the files they contain must be
265 copied. 268 copied.
266 </para></listitem> 269 </para></listitem>
267 </orderedlist> 270 </orderedlist>
268 271
269 Steps 2 through 4 may be performed manually, or automatically by any 272 Steps 2 through 4 may be performed manually, or automatically by any
272 <listitem><para> 275 <listitem><para>
273 By a shell procedure file created by the user. 276 By a shell procedure file created by the user.
274 </para></listitem> 277 </para></listitem>
275 278
276 <listitem><para> 279 <listitem><para>
277 By a shell procedure file generated by the &quot;dsave&quot; command 280 By a shell procedure file generated by the <command>dsave</command> command
278 </para></listitem> 281 </para></listitem>
279 282
280 <listitem><para> 283 <listitem><para>
281 By the &quot;backup&quot; command 284 By the <command>backup</command> command
282 </para></listitem> 285 </para></listitem>
283 </orderedlist> 286 </orderedlist>
284 </para> 287 </para>
285 </section> 288 </section>
286 </chapter> 289 </chapter>