Mercurial > hg > Members > kono > nitros9-code
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 ("/D0") when the | 7 system disk is generally kept in disk drive zero ("/D0") 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, "OS9Boot" and | 11 Two files used during the system startup operation, <filename>OS9Boot</filename> and |
12 "startup" <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 "OS9Boot" loaded into RAM memory by the | 27 The file called <filename>OS9Boot</filename> loaded into RAM memory by the |
26 "bootstrap" routine located in the OS-9 firmware. It includes file | 28 "bootstrap" 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 "OS9Boot" 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 "OS9Gen" 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 "/d0/SYS" 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 "login" 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 "login", "tsmon", or | 148 required to boot OS-9, they are needed if <command>login</command>, <command>tsmon</command>, or |
147 "printerr" 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 "/d0/startup" 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 "startup" any legal shell command line. Often | 160 user may include in <filename>startup</filename> any legal shell command line. Often |
159 this will include "setime" 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 "/d0/CMDS" 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 "shell" is not part of the | 173 execution directory. If <command>shell</command> is not part of the |
172 "OS9Boot" 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 "sysgo" makes CMDS the initial execution directory. | 175 startup process "sysgo" 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 "/d0/DEFS" 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 "use" directive. The presence and | 186 by means of the OS-9 Assembler "use" 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 "chx" and | 223 on multiuser systems. If it is, the <command>chx</command> and |
222 "chd" (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 "OS9Boot" file must be created and linked by the "OS9Gen" or | 257 The <filename>OS9Boot</filename> file must be created and linked by the <command>OS9Gen</command> or |
256 "Cobbler" commands. | 258 <command>Cobbler</command> commands. |
257 </para></listitem> | 259 </para></listitem> |
258 | 260 |
259 <listitem><para> | 261 <listitem><para> |
260 The "startup" 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 "dsave" 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 "backup" 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> |