Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/chap6.chapter @ 1093:4dae346c4969
Added crossreferences and lowercased synopsises
| author | roug |
|---|---|
| date | Mon, 07 Apr 2003 21:01:46 +0000 |
| parents | b5ff125a1d60 |
| children | b00cf13c9f61 |
| rev | line source |
|---|---|
| 1093 | 1 <chapter id="sec6"> |
| 146 | 2 <title>Use of the System Disk</title> |
| 3 <para> | |
| 4 Disk-based OS-9 systems use a system disk to load many parts of | |
| 5 the operating system during the system startup and to provide files | |
| 6 frequently used during normal system operations. Therefore, the | |
| 7 system disk is generally kept in disk drive zero ("/D0") when the | |
| 8 system is running. | |
| 9 </para> | |
| 10 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
11 Two files used during the system startup operation, <filename>OS9Boot</filename> and |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
12 <filename>startup</filename> <emphasis>must</emphasis> |
| 146 | 13 reside in the system disk's root directory. Other |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
14 files are organized into three directories: |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
15 <filename class="directory">CMDS</filename> (commands), |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
16 <filename class="directory">DEFS</filename> (system-wide definitions), |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
17 and <filename class="directory">SYS</filename> (other system files). Other files |
| 146 | 18 and directories created by the system manager and/or users may also |
| 19 reside on the system disk. These frequently include each user s | |
| 20 initial data directory. | |
| 21 </para> | |
| 22 | |
| 1093 | 23 <section id="sec6.1"> |
| 1011 | 24 <title>The OS9Boot File</title> |
| 146 | 25 |
| 26 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
27 The file called <filename>OS9Boot</filename> loaded into RAM memory by the |
| 146 | 28 "bootstrap" routine located in the OS-9 firmware. It includes file |
| 29 managers, device drivers and descriptors, and any other modules | |
| 30 which are permanently resident in memory. A typical Microware OS-9 | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
31 distribution disk's <filename>OS9Boot</filename> file contains the following modules: |
| 146 | 32 </para> |
| 33 <informaltable frame="none"> | |
| 34 <tgroup cols="2"> | |
| 646 | 35 <colspec colwidth="1.5in"/> |
| 36 <colspec colwidth="3.5in"/> | |
| 146 | 37 <tbody> |
| 38 <row> | |
| 1011 | 39 <entry>OS9P2</entry> |
| 40 <entry>OS-9 Kernel, Part 2</entry> | |
| 41 </row> | |
| 42 <row> | |
| 43 <entry>IOMan</entry> | |
| 146 | 44 <entry>OS-9 Input/Output Manager</entry> |
| 45 </row> | |
| 46 <row> | |
| 1011 | 47 <entry>Init</entry> |
| 48 <entry>Initialization Data Module</entry> | |
| 49 </row> | |
| 50 <row> | |
| 146 | 51 <entry>RBF</entry> |
| 52 <entry>Random Block (disk) File Manager</entry> | |
| 53 </row> | |
| 54 <row> | |
| 55 <entry>SCF</entry> | |
| 56 <entry>Sequential Character (terminal) File Manager</entry> | |
| 57 </row> | |
| 58 <row> | |
| 1011 | 59 <entry>PipeMan</entry> |
| 60 <entry>Pipe File Manager</entry> | |
| 146 | 61 </row> |
| 62 <row> | |
| 63 <entry>Piper</entry> | |
| 1011 | 64 <entry>Pipe Driver</entry> |
| 146 | 65 </row> |
| 66 <row> | |
| 67 <entry>Pipe</entry> | |
| 1011 | 68 <entry>Pipe Device Descriptor</entry> |
| 69 </row> | |
| 70 <row> | |
| 71 <entry>CC3IO</entry> | |
| 72 <entry>CoCo 3 Keyboard/Video Device Driver</entry> | |
| 73 </row> | |
| 74 <row> | |
| 75 <entry>WindInt</entry> | |
| 76 <entry>CoCo 3 Graphics Co-Module</entry> | |
| 146 | 77 </row> |
| 78 <row> | |
| 1011 | 79 <entry>VDGInt</entry> |
| 80 <entry>CoCo 2 Compatible Graphics Co-Module</entry> | |
| 81 </row> | |
| 82 <row> | |
| 83 <entry>Term</entry> | |
| 84 <entry>Terminal Device Descriptor</entry> | |
| 146 | 85 </row> |
| 86 <row> | |
| 1011 | 87 <entry>CC3Disk</entry> |
| 88 <entry>CoCo 3 Disk Driver</entry> | |
| 89 </row> | |
| 90 <row> | |
| 91 <entry>DD, D0, D1</entry> | |
| 92 <entry>Disk Device Descriptors</entry> | |
| 93 </row> | |
| 94 <row> | |
| 95 <entry>Printer</entry> | |
| 146 | 96 <entry>Printer Device Driver</entry> |
| 97 </row> | |
| 98 <row> | |
| 1011 | 99 <entry>p</entry> |
| 146 | 100 <entry>Printer Device Descriptor</entry> |
| 101 </row> | |
| 102 <row> | |
| 1011 | 103 <entry>Clock</entry> |
| 146 | 104 <entry>Real-Time Clock Module</entry> |
| 105 </row> | |
| 106 <row> | |
| 1011 | 107 <entry>CC3Go</entry> |
| 146 | 108 <entry>System Startup Process</entry> |
| 109 </row> | |
| 110 </tbody> | |
| 111 </tgroup> | |
| 112 </informaltable> | |
| 113 | |
| 114 <para> | |
| 115 Users may create new bootstrap files which may include additional | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
116 modules (see <command>OS9Gen</command> command). Any module loaded as part of the |
| 146 | 117 bootstrap cannot be unlinked and is stored in memory with a minimum |
| 118 of fragmentation. It may be advantageous to include in the OS9Boot | |
| 119 file any module used constantly during normal system operation. | |
| 120 This can be done with the OS9GEN command. | |
| 121 </para> | |
| 122 </section> | |
| 123 | |
| 1093 | 124 <section id="sec6.2"> |
| 146 | 125 <title>The SYS Directory</title> |
| 126 | |
| 127 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
128 The directory <filename>/d0/SYS</filename> contains two important files: |
| 146 | 129 </para> |
| 130 <informaltable frame="none"> | |
| 131 <tgroup cols="2"> | |
| 646 | 132 <colspec colwidth="1in"/> |
| 133 <colspec colwidth="4in"/> | |
| 146 | 134 <tbody> |
| 135 <row> | |
| 136 <entry>password</entry> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
137 <entry>the system password file (see <command>login</command> command)</entry> |
| 146 | 138 </row> |
| 139 <row> | |
| 140 <entry>errmsg</entry> | |
| 1011 | 141 <entry>the error message file</entry> |
| 146 | 142 </row> |
| 143 </tbody> | |
| 144 </tgroup> | |
| 145 </informaltable> | |
| 146 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
147 These files (and the <filename class="directory">SYS</filename> directory itself) are not absolutely |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
148 required to boot OS-9, they are needed if <command>login</command>, <command>tsmon</command>, or |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
149 <command>printerr</command> will be used. Users may add other system-wide files of |
| 146 | 150 similar nature if desired. |
| 151 </para> | |
| 152 </section> | |
| 153 | |
| 1093 | 154 <section id="sec6.3"> |
| 146 | 155 <title>The Startup File</title> |
| 156 | |
| 157 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
158 The file <filename>/d0/startup</filename> is a shell procedure file which |
| 146 | 159 is automatically processed immediately after system startup. The |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
160 user may include in <filename>startup</filename> any legal shell command line. Often |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
161 this will include <command>setime</command> to start the system clock. If this file |
| 146 | 162 is not present the system will still start correctly but the user |
| 163 must run the SETIME command manually. | |
| 164 </para> | |
| 165 </section> | |
| 166 | |
| 1093 | 167 <section id="sec6.4"> |
| 146 | 168 <title>The CMDS Directory</title> |
| 169 | |
| 170 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
171 The directory <filename class="directory">/d0/CMDS</filename> is the system-wide command object code |
| 146 | 172 directory, which is normally shared by all users as their working |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
173 execution directory. If <command>shell</command> is not part of the |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
174 <filename>OS9Boot</filename> file, it must be present in this directory. The system |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
175 startup process "sysgo" makes <filename class="directory">CMDS</filename> the initial execution directory. |
| 146 | 176 </para> |
| 177 </section> | |
| 178 | |
| 1093 | 179 <section id="sec6.5"> |
| 146 | 180 <title>The DEFS Directory</title> |
| 181 | |
| 182 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
183 The directory <filename class="directory">/d0/DEFS</filename> is a directory that contains assembly |
| 146 | 184 language source code files which contain common system-wide symbolic |
| 185 definitions, and are normally included in assembly language programs | |
| 186 by means of the OS-9 Assembler "use" directive. The presence and | |
| 187 use of this directory is optional, but highly recommended for any | |
| 188 system used for assembly language programs. The files commonly | |
| 189 contained in this directory are: | |
| 190 </para> | |
| 191 <informaltable frame="none"> | |
| 192 <tgroup cols="2"> | |
| 646 | 193 <colspec colwidth="1in"/> |
| 194 <colspec colwidth="4in"/> | |
| 146 | 195 <tbody> |
| 196 <row> | |
| 197 <entry>OS9Defs</entry> | |
| 198 <entry>main system-wide definition file</entry> | |
| 199 </row> | |
| 200 <row> | |
| 201 <entry>RBFDefs</entry> | |
| 202 <entry>RBF file manager definition file</entry> | |
| 203 </row> | |
| 204 <row> | |
| 205 <entry>SCFDefs</entry> | |
| 206 <entry>SCF file manager definition file</entry> | |
| 207 </row> | |
| 208 <row> | |
| 209 <entry>Systype</entry> | |
| 210 <entry>System types definition file</entry> | |
| 211 </row> | |
| 212 </tbody> | |
| 213 </tgroup> | |
| 214 </informaltable> | |
| 215 | |
| 216 </section> | |
| 217 | |
| 1093 | 218 <section id="sec6.6"> |
| 146 | 219 <title>Changing System Disks</title> |
| 220 | |
| 221 <para> | |
| 222 The system disk is not usually removed while the system is running, especially | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
223 on multiuser systems. If it is, the <command>chx</command> and |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
224 <command>chd</command> (if the working data directory was on the system disk) |
| 146 | 225 commands should be executed to reset the working directory pointers |
| 226 because the directories may be at different addresses on the new | |
| 227 disk, for example: | |
| 228 </para> | |
| 229 | |
| 230 <screen> | |
| 231 chx /d0/cmds | |
| 232 chd /d0 | |
| 233 </screen> | |
| 234 | |
| 235 <para> | |
| 236 In general, it is unwise to remove a disk and replace it with | |
| 237 another if any paths are open to files resident on the disk. It is | |
| 238 <emphasis>dangerous</emphasis> to exchange <emphasis>any</emphasis> | |
| 239 disk if any files on it are open in WRITE or UPDATE modes. | |
| 240 </para> | |
| 241 | |
| 242 | |
| 243 </section> | |
| 244 | |
| 1093 | 245 <section id="sec6.7"> |
| 146 | 246 <title>Making New System Disks</title> |
| 247 | |
| 248 <para> | |
| 249 To make a system disk, the following steps must be performed: | |
| 250 | |
| 251 <orderedlist numeration="arabic"> | |
| 252 <listitem><para> | |
| 253 The new disk must be formatted. | |
| 254 </para></listitem> | |
| 255 | |
| 256 <listitem><para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
257 The <filename>OS9Boot</filename> file must be created and linked by the <command>OS9Gen</command> or |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
258 <command>Cobbler</command> commands. |
| 146 | 259 </para></listitem> |
| 260 | |
| 261 <listitem><para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
262 The <filename>startup</filename> file must be created or copied. |
| 146 | 263 </para></listitem> |
| 264 | |
| 265 <listitem><para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
266 The <filename class="directory">CMDS</filename> and |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
267 <filename class="directory">SYS</filename> directories and the files they contain must be |
| 146 | 268 copied. |
| 269 </para></listitem> | |
| 270 </orderedlist> | |
| 271 | |
| 272 Steps 2 through 4 may be performed manually, or automatically by any | |
| 273 of the following methods: | |
| 274 <orderedlist numeration="arabic"> | |
| 275 <listitem><para> | |
| 276 By a shell procedure file created by the user. | |
| 277 </para></listitem> | |
| 278 | |
| 279 <listitem><para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
280 By a shell procedure file generated by the <command>dsave</command> command |
| 146 | 281 </para></listitem> |
| 282 | |
| 283 <listitem><para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
284 By the <command>backup</command> command |
| 146 | 285 </para></listitem> |
| 286 </orderedlist> | |
| 287 </para> | |
| 288 </section> | |
| 289 </chapter> |