1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
|
<html>
<body bgcolor=#ffffff text=#000000 link=#4f4fff vlink=#0000ff alink=#00ff00>
<h1>Configuration</h1>
<ul>
<li><a href="#general">General</a>
<li><a href="#look">Look</a>
<li><a href="#images">Images</a>
<li><a href="#files">Files</a>
<ul> <li><a href="#common">Common options</a>
<li><a href="#linux">Linux options</a>
<li><a href="#bsect">Bootsector options</a>
</ul>
</ul>
<a name="general">
<p><h2>General</h2>
<dl>
<dt><i><b>delay=</b>seconds</i>
<dd>Set the time before booting the first image to <<i>seconds</i>> seconds.
<p>
<dt><i><b>autoboot=</b>no <b>|</b> pressed <b>|</b> not_pressed</i>
<dd>default=<i>no</i>. This option can be used to tell chos
when to load the first image at the bootup without
even displaying the menu and stuff at all.<p>
Setting this option to <i>pressed</i> will automagically boot the
first image when
any of the modifier keys (shift,ctrl,alt) is held
down.<p>
Setting it to <i>not_pressed</i> (<i>not pressed</i> is ok too)
will automatically make chos load the first image,
unless you hold down one of the modifier keys
( la LILO), in which case it will display the menu.
<p>
<dt><i><b>install=</b>device</i>
<dd>Install boot sector on device <i><device></i>. <b>Required!</b>.
<p>
<dt><i><b>emergency=</b>file</i>
<dd>Ask chos to use <i><name</i>> as "emergency" bootsector.
"Emergency" bootsector is a bootsector that will be
tried to load if chos, for any reason, couldn't load
it's second stage loader or mapfile.
<p>
<dt><i><b>password=</b>passwd</i>
<dd>Set password for all images to <<i>passwd</i>>.
If a password is set, it will always be asked for unless otherwise
told in <a href="#imgpass">image configuration</a>.
<font color=red>If you use this feature, remember to remove
world read permissions (chmod 600) from chos mapfile and configuration file (You don't
want others to be able to find out the password just by looking at either of
the files...)</font>
<p>
<dt><i><b>default=</b>number</i>
<dd>Set default image (i.e. one that is initially selected) number.
<p>
<a name="mapdrive">
<dt><i><b>mapdrive=</b>bios_number<b>,</b> device</i>
<dd>Maps device <<i>device</i>> to bios drive number
<<i>bios_number</i>> Use with drives bios doesn't know about
(e.g. '<i>mapdrive=0x90,/dev/sda</i>' would tell chos to assign bios
device number 0x90 to <i>/dev/sda*</i>).
</dl>
<p>
<a name="look">
<p><h2>Look</h2>
<dl>
<dt><i><b>banner=</b>banner</i>
<dd>This is what Choose-OS shows on top of the menu.<br>
The default is "<i>Choose-OS v0.8 BootUp Menu.</i>".
I'm sure you wanna change it to a more interesting
one, such as "<i>Whatcha wanna play today with ?</i>",
<p>
<dt><i><b>infoline=</b>on <b>|</b> off</i>
<dd>Do you want to see copyright and keyhelp on the bottom of the screen.
If not, set this to <i>off</i>. Else set the this to <i>on</i> (default).
<p>
<dt><i><b>color=</b>color</i>
<dd>Set default <a href=colors.html>color</a> used.
<p>
<dt><i><b>selection=</b>color</i>
<dd>Set selection <a href=colors.html>color</a>.
Can only be one of the eight first colors.
<p>
<a name="background">
<dt><i><b>background=</b>type<b>,</b>file</i>
<dd>Use <i><file></i> as background image.
<i><type></i> is either <i>dump</i> in case of
binary file, <i>ascii</i> in case of plain (latin1) text file and
<i>cp437</i> in case of codepage437 text file.
<p>
<dt><i><b>menupos=</b>column<b>,</b>row</i>
<dd>Set menu position. <b>(</b>0<b>,</b>0<b>)</b> is the topleft corner of the screen.
<p>
<dt><i><b>timerpos=</b>column<b>,</b>row</i>
<dd>Set timer position. <b>(</b>0<b>,</b>0<b>)</b> is the topleft corner of the screen.
</dl>
<p>
<a name="files">
<p><h3>Files</h3>
<p>
THESE ARE OVERRIDDEN BY ONES GIVEN ON THE COMMANDLINE, IF ANY ARE...
</p>
<dl>
<dt><i><b>bindir=</b>directory</i>
<dd>Search for loader and stuff in <i><directory></i>.
<p>
<dt><i><b>bgfile=</b>file</i>
<dd>Save generated background in <i><file></i>.
<p>
<dt><i><b>mapfile=</b>file</i>
<dd>Use <i><file></i> as mapfile.
<p>
</dl>
<p>
<a name="images">
<p><h2>Images</h2>
Images are configured in the following manner:
<ul>
<i>image_type <b>"</b>name<b>" {</b><br>
<dd>image_options<br>
<b>}</b></i>
</ul>
Where:
<ul>
<i>image_type</i> is the type of the image.<p>
<ul>
<li><b><i>linux</i></b>, in case of linux (zImage or bzImage)
<li><b><i>big_linux</i></b>, in case of bzImage (obsoleted)
<li><b><i>bootsect</i></b>, in case of device bootsector
<li><b><i>bootfile</i></b>, in case of a file that is a bootsector.<br>
At the moment it doesn't matter which one you use, <i>bootsect</i> or <i>bootfile</i>.
</ul>
<p>
<i>name</i> is the name of the image, i.e. the text shown in the bootup menu.
<a name="common">
<p><h3>Common image options</h3>
<p>
<dl>
<dt><i><b>color=</b>color</i>
<dd>Set the <a href=colors.html>color</a> used for this image in the menu.
<p>
<dt><i><b>hotkey=</b>hotkey</i>
<dd>Set the hotkey for this image.
<p>
<dt><i><b>position=</b>column<b>,</b>row</i>
<dd>Set the position of this image on screen, if it's to be
somewhere else on the screen instead of in the menu.
<p>
<dt><i><b>loader=</b>loader</i>
<dd>Use OS-specific loader <i><loader></i> instead of the default.
<p>
<dt><i><b>image=</b>image</i>
<dd>This tells the file/device to be booted. In case of linux this
is the kernel and in case of bootsector, a 512-bytes long file or a block device.
<p>
<a name="imgpass">
<dt><i><b>password=</b>yes<b>|</b>no<b>|</b>restricted<b>|</b>cmdline</i>
<dd>This is used to control when password is asked for the image:
<ul><dl>
<dt><i>yes</i><dd>Always ask for it (password must of course have been set).<br>
<dt><i>no</i><dd>Don't ask for it<br>
<dt><i>restricted</i> or <i>cmdline</i><dd>Only ask for password when entering
command line manually (i.e starting with space).
</dl></ul>
<p>
<dt><i><b>rebooter.</b>*</i>
<dd>These are options to <i>rebooter</i> and are ignored by chos.
</dl>
<p>
<a name="linux">
<p><h3>Linux options</h3>
<p>
<dl>
<dt><i><b>cmdline=</b>cmdline</i>
<dd>Set <a href="linux_cmdline.html">Linux command line.</a>
<p>
<dt><i><b>initrd=</b>file<b> [,</b>address<b>]</b></i>
<dd> Asks Choose-OS to load <i><file></i> as <a href="initrd.html">initial ramdisk</a>.<br>
If no address is given, or address is '<i>top</i>', the
ramdisk will be loaded on top of memory.<br>
Address may also be a memory address >2M
(preferably>4M) ( 6M and 8M for bzImages).<br>
You must have a <b>2.x</b> kernel for this feature.
<p>
</dl>
<p>
<a name="bsect">
<p><h3>Bootsector options</h3>
<dl>
<a name="dosmenukey">
<dt><i><b>dosmenukey=</b>key</i>
<dd>Put key <<i>key</i>> and <i>enter</i> into keyboard buffer.<br>
<<i>Key</i>> is either a decimal number or a hexadecimal scancode.<br>
This feature can be used to choose dos multiconfig menu option from
choose-os. Especially useful for choosing between windog95 and dos.
See example in <i><a href="../samples/dosmenukey">../samples/dosmenukey/</a></i>.
If you start the image with <i>space</i> the keys are not
put into the buffer. May not work on some non-standard systems.<br>
<p>
</dl>
<font color=red><b>
THESE ARE ALL UNTESTED OR OTHERWISE DANGEROUS FEATURES.<br>
YOU ARE EXPERIMENTING WITH THESE AT YOUR OWN RISK. PLEASE BACKUP ALL IMPORTANT DATA
ON YOU HARDDISKS BEFORE TRYING THESE.
THESE ARE NOT COMPILED IN BY DEFAULT, SO YOU MUST RECOMPILE.<br>
<p>
</b></font>
<dl>
<dt><i><b>dos4boot=</b>yes <b>|</b> no</i>
<dd>This option is used to tell <b>DOS</b> version <b>4.0+</b> (and <b>OS/2</b>?)
to boot of the second harddisk, <i>/dev/hdb</i>.
<p>
<a name="rewrite">
<dt><i><b>rewrite=</b>yes <b>|</b> device</i>
<dd> This is intended for partition table active flag/type modification.
Can be used to hide DOS from Winblows 95/NT.<p>
If the argument is '<i>yes</i>', /dev/hda will be selected.
In other case, the argument is a block special device, whose
MBR is to be modified. It must be the whole device, not a partition.
<BR><A HREF="rewrite.html">How to use</A>
<p>
</dl>
THE OS MUST USE BIOS FOR DISK ACCESS FOR THESE TO WORK:
<p>
<dl>
<dt><i><b>swapfd=</b>yes <b>|</b> no</i>
<dd>Swap first and second floppy drive (<i>/dev/fd0</i> and <i>/dev/fd1</i>).
<p>
<dt><i><b>swaphd=</b>yes <b>|</b> no</i>
<dd>Swap first and second harddisk drive (<i>/dev/hda</i> and <i>/dev/hdb</i>).
<p>
</dl>
<p>
</ul>
<p>
</html>
|
