Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/os9gen.refentry @ 2811:611715587834 lwtools-port
Updated rules.mak and level1/coco1/bootfiles/makefile
Updated the rules.mak file to remove the format entire image related
to drivewire server disk images.
Updated level1/coco1/bootfiles/makefile to create 3 new bootfile images.
These images are stripped down to just the common files needed
for vovdg games on os9 level 1. These bootfiles are for becker, dw,
and arduino. Also corrected a duplicated dd descriptor when building
some bootfiles that had both floppy_40d, floppy_80d, RBDW, RBBECKER,
and RBARDUINO. Removed the dd descriptor from each of these sections
and made it where the dd descriptor for the specific section was added
in the main bootfile list.
| author | David Ladd <drencor-xeen@users.sf.net> |
|---|---|
| date | Mon, 11 Feb 2013 20:16:24 -0600 |
| parents | 4dae346c4969 |
| children |
| rev | line source |
|---|---|
| 138 | 1 <refentry id="os9gen"> |
| 2 <refnamediv> | |
| 3 <refname>OS9GEN</refname> | |
| 4 <refpurpose>Build and Link a Bootstrap File</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>os9gen</command> |
| 138 | 10 <arg choice="plain"> |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
138
diff
changeset
|
11 <replaceable>device name</replaceable> |
| 138 | 12 </arg> |
| 13 </cmdsynopsis> | |
| 14 </refsynopsisdiv> | |
| 15 | |
| 16 <refsect1><title>Description</title> | |
| 17 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
18 <command>OS9Gen</command> is used to create and link the <filename>OS9Boot</filename> file required on any |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
19 disk from which OS-9 is to be bootstrapped. <command>OS9Gen</command> is used to add |
| 138 | 20 modules to an existing boot or to create an entirely new boot file. |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
21 If an exact copy of the existing <filename>OS9Boot</filename> file is desired, the |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
22 <command>cobbler</command> command should be used instead. |
| 138 | 23 </para> |
| 24 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
25 The name of the device on which the <filename>OS9Boot</filename> file is to be |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
26 installed is passed to <command>OS9Gen</command> as a command line parameter. <command>OS9Gen</command> then |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
27 creates a working file called <filename>TempBoot</filename> on the device specified. |
| 138 | 28 Next it reads file names (pathlists) from its standard input, one |
| 29 pathlist per line. Every file named is opened and copied to | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
30 <filename>TempBoot</filename>. This is repeated until end-of-file or a blank line is |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
31 reached on <command>OS9Gen</command>'s standard input. All boot files must contain the |
| 1093 | 32 OS-9 component modules listed in section <xref linkend="sec6.1"/>. |
| 138 | 33 </para> |
| 34 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
35 After all input files have been copied to <filename>TempBoot</filename>, the old |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
36 <filename>OS9Boot</filename> file, if present, is deleted. <filename>TempBoot</filename> is then renamed |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
37 to <filename>OS9Boot</filename>, and its starting address and size is linked in the |
| 138 | 38 disk's Identification Sector (LSN 0) for use by the OS-9 bootstrap |
| 39 firmware. | |
| 40 </para> | |
| 41 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
42 WARNING: Any <filename>OS9Boot</filename> file must be stored in physically contiguous |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
43 sectors. Therefore, <command>OS9Gen</command> is normally used on a freshly formatted |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
44 disk. If the <filename>OS9Boot</filename> file is fragmented, <command>OS9Gen</command> will print a |
| 138 | 45 warning message indicated the disk cannot be used to bootstrap OS-9. |
| 46 </para> | |
| 47 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
48 The list of file names given to <command>OS9Gen</command> can be entered from a keyboard, or |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
49 <command>OS9Gen</command>'s standard input may be redirected to a text file |
| 138 | 50 containing a list of file names (pathlists) . If names are entered |
| 51 manually, no prompts are given, and the end-of-file key (usually | |
| 52 ESCAPE) or a blank line is entered after the line containing the | |
| 53 last pathlist. | |
| 54 </para> | |
| 55 <para> | |
| 1093 | 56 For more information see: <xref linkend="sec6"/>, |
| 57 <xref linkend="sec6.1"/>, <xref linkend="sec6.6"/> | |
| 138 | 58 </para> |
| 59 </refsect1> | |
| 60 <refsect1><title>Examples</title> | |
| 61 <para> | |
| 62 To manually install a boot file on device "d1" which is an exact | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
63 copy of the <filename>OS9Boot</filename> file on device "d0": |
| 138 | 64 </para> |
| 65 <screen> | |
| 66 OS9: os9gen /d1 (run OS9Gen) | |
| 67 /d0/os9boot (enter file to be installed) | |
| 68 [ESCAPE] (enter end-of-file) | |
| 69 </screen> | |
| 70 <para> | |
| 71 To manually install a boot file on device "d1" which is a copy of | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
72 the <filename>OS9Boot</filename> file on device "d0" with the addition of |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
73 modules stored in the files <filename>/d0/tape.driver</filename> and <filename>/d2/video.driver</filename>: |
| 138 | 74 </para> |
| 75 <screen> | |
| 76 OS9: os9gen /d1 (run OS9Gen) | |
| 77 /d0/os9boot (enter main boot file name) | |
| 78 /d0/tape.driver (enter name of first file to be added) | |
| 79 /d2/video.driver (enter name of second file to be added) | |
| 80 [ESCAPE] (enter end-of-file) | |
| 81 </screen> | |
| 82 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
83 As above, but automatically by redirecting <command>OS9Gen</command> standard input: |
| 138 | 84 </para> |
| 85 <screen> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
86 OS9: build /d0/bootlist (use <command>build</command> to create file <filename>bootlist</filename>) |
| 138 | 87 ? /d0/os9boot (enter first file name) |
| 88 ? /d0/tape.driver (enter second file name) | |
| 89 ? /d2/video.driver (enter third file name) | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
90 ? [RETURN] (terminate <command>build</command>) |
| 138 | 91 OS9: os9gen /d1 </d0/bootlist (run OS9gen with redirected input) |
| 92 </screen> | |
| 93 </refsect1> | |
| 94 </refentry> | |
| 95 |