Chameleon

Chameleon Svn Source Tree

Root/branches/azimutz/Chazi/doc/BootHelp.txt

100000000000000000000000000000000000000000000000000000000000000000000000000000080
2 Chameleon Bootloader
3 boot time help
4
5The boot prompt waits for you to type advanced startup options. If you don't
6type anything, the computer continues starting up normally. It will use the
7kernel and configuration files on the selected/default device, which it also
8uses as the root device.
9Use the following syntax, when typing advanced startup options:
10
11 [device]<kernel> [arguments]
12
13Arguments consist of either just a name, e.g. -v or a key=value pair,
14e.g. rd=disk0s2. The latest are commonly referred to as "keys" and the first
15as "flags". ????????????????? bs...
16Use the following syntax when typing arguments (recommended):
17
18 [flags] [Wait=y key] [any other key]
19
20WARNINGS (OUTDATED*****): (feedback is welcome)
21- At least Wait=y is breaking other keys/flags?, when typed after them. This
22 is the main reason for the "argument" syntax above. If you have any problem
23 of this nature please try the recommended syntax or play with it.
24- Arguments with spaces on their name (marked with (*)) are failing when
25 wrapped in quotation marks.
26
27 Syntax examples:
28
29 backup_kernel -legacy -v DSDT=/extra/test.aml Wait=y <-- :( DSDT= failed
30 backup_kernel -legacy -v Wait=y DSDT=/extra/test.aml <-- :)
31
32 rd(0,0)/test_kernel -v debug=0x144
33 -v Wait=y UseMemDetect=n SMBIOSDefaults=n SMBIOS=/path/to/smbios.plist
34
35Argument's names are case sensitive, values are not. Thus:
36 /Extra/DSDT.aml = /extra/dsdt.aml, etc...
37
38 Thanks ?????
39 ============================================================================79
40
41Special booter hotkeys:
42
43 F5 Rescans optical drive.
44 F10 Scans and displays all BIOS accessible drives.
45
46Special booter commands:
47
48 ? Displays this file.
49 ?memory Displays information about the computer's memory.
50 ?video Displays VESA video modes supported by the computer's BIOS.
51 ?norescan Leaves optical drive rescan mode.
52 ?lspci Displays information about PCI buses and devices in the system.
53 ?more Displays the text on an extra txt file (needs to be supplied).
54 Ex: ?more /extra/MoreInfo.txt
55
56 ==============================================================================
57
58Most used "flags" include: ?????????????
59
60 rd=<BSD device name> or rd=*<IODeviceTree path> flag
61 Used to specify the root device (selected volume), from were the booter
62 will load start the System. ....when using Apple software RAID helper
63 partitions (apple boot).?????????
64 Ex: rd=disk0s2 or rd=uuid (used in conjunction with boot-uuid=<UUID>)??
65 Ex: rd=*/PCI0@0/CHN0@0/@0:1
66
67 <kernel name>
68 Specify a different kernel (name) to be loaded. Kernel must be in the
69 "/" (root) of the selected/default volume.
70 Ex: my_kernel ??
71
72curruption on Chamatic theme, due to too many spaces; the size of the spaces
73is "wrong"...???***
74 boot-uuid=<UUID> flag
75 Specify the UUID of the boot volume.
76 Ex: boot-uuid=12345678-1234-1234-1234-123456789012
77
78 -v
79 Verbose boot: see what booter and kernel are doing on your back :)
80
81 -s
82 Single User Mode: Boot into CLI to perform tasks.
83
84 -x
85 Safe Mode: ignore System caches and disable most devices.
86
87 -f
88 Ignore caches: ignore System caches and boot normally.
89
90 -F
91 Ignore "Kernel Flags" specified in boot configuration file. ??
92
93 64 BIT SPECIFIC STUFF... ??
94 arch=i386/x86_64
95 Specify kernel architecture to be loaded
96
97 -legacy
98 Legacy Mode: disable handling 64 bit apps on i386... ??
99 Note: on Snow needs arch=i386 to work on 64 bit cpu's.. ??
100
101 config=<path to file> ???? it's not working :-/
102 Use an alternate/backup "override" Boot.plist file.
103 Ex: config=/extra/testBoot.plist
104
105 blacklist=0 Kernel flag used on Voodoo kernel and others based...???????
106
107 kernel debug flags: e.g. debug=0x144
108 IOkit debug flags: e.g. io=0xffffffff (defined in IOKit/IOKitDebug.h) ???
109
110 ==============================================================================
111
112Options useful either at the prompt or in com.apple.Boot.plist file: ?????
113
114 "Root UUID"=<UUID> or y/n?????? (*) ...... man...... :-S key
115
116 "Boot Device"=hd(x,y) ?????????? key - corruption***
117
118 Wait=Yes
119 Pause before starting the kernel.??????
120
121 kext=<path to folder> (ends with a / (slash))
122 Use an alternate/backup folder with drivers, kext or mkext.
123 Ex: kext=/extra/test/
124
125 "MKext Cache"=<path to file>
126 Use an alternate/backup "System" cache file.
127 Ex: "MKext Cache"=rd(0,0)/Extensions.mkext
128
129 Kernel=<file name>
130
131 "Kernel Cache"=<path to file> ???? check this stuff - how does it work???
132 Use an alternate/backup "Kernel" cache file.
133 Ex: "Kernel Cache"=bt(0,0)/kernelcache_i386.A701C40B
134
135 Note: damn long keys to type at the boot prompt!? :-/ UseKC would be enough!!
136 Doesn't anyone use the prompt anymore? Going to keep this here just
137 because i hope this file ends up on the trunk, but my Chazi will use
138 UseKC :P - update above***
139 UseKernelCache=Yes
140 Yes will load the system prelinked kernel or the one specified by the user
141 with "Kernel Cache" arg, and ignore /E/E kexts/mkext and system kext cache.
142
143- Devices/Other:???
144
145 UseMemDetect=No
146 Disable memory modules?? info detection.
1470000000000000000000000000000000000000000000000000000000000000000000000000000079
148
149 EthernetBuiltIn=Yes
150 Automatic device-properties generation, that sets "built-in" property
151 for ethernet interfaces.
152
153 USBBusFix=Yes
154 Enable all USB fixes below (fixes can be used individually):
155 EHCIacquire=Yes - Enable the EHCI fix.
156 UHCIreset=Yes - Enable the UHCI fix.
157 USBLegacyOff=Yes - Enable the USB Legacy fix.
158
159 ForceHPET=Yes
160 Force enabling HPET device on the PC's BIOS.
161
162- Hibernation:
163
164 Wake=No
165 Disable wake up after hibernation.
166
167 ForceWake=Yes
168 Force using the sleepimage (when desired), if you get the message:
169 "Hibernate image is too old by n seconds. Use ForceWake=y to override."
170
171 WakeImage=<path to file>
172 Use an alternate sleepimage file.
173 Default path: /private/var/vm/sleepimage
174
175- ACPI:
176
177 DSDT=<path to file> or <file name>??????????????
178 Override the default dsdt.aml paths/name.
179 Default name: dsdt.aml
180 Default paths:?????
181 Ex:
1820000000000000000000000000000000000000000000000000000000000000000000000000000079
183
184 DropSSDT=Yes
185 Skip the SSDT tables while relocating the ACPI tables.
186
187 PciRoot=<value> <<<<<<< change "group" ??
188 Use an alternate value for PciRoot UID. Can be retrieved from dsdt.aml
189 by the booter, if supplied by the user and present on the ACPI table.
190 Default value: 0
191
192 RestartFix=yes
193 Enable restart fix for Intel chipsets.
194
195 GenerateCStates=Yes Enable auto generation of Processor (C-States) and/or
196 GeneratePStates=Yes Performance (P-States) power states.
197
198 EnableC2State=Yes Enable specific Processor power states,
199 EnableC3State=Yes C2, C3, C4.
200 EnableC4State=Yes
201
202- Bios/smbios:???
203
204 SMBIOS=<path to file> or <file name?????>
205 Override the default smbios.plist paths/name.
206 Default name: smbios.plist
207 Default paths:?????
208 Ex:
209
210 SMBIOSdefaults=No
211 Disable the use of Default values for SMBIOS overriding, when smbios.plist
212 is not used.
213
214 SystemType=<value>
215 Set the system type where n is between 0..6 (default value =1 (Desktop).
2160000000000000000000000000000000000000000000000000000000000000000000000000000079
217
218According to CHANGES file, this should be SystemID, not SystemId! ????????
219 SystemId=<UUID>
220 Manually set the system UUID. (also known as Platform or Hardware UUID)
221 SMUUID (reserved field) in smbios.plist config is deprecated.
222 Ex: SystemId=12345678-1234-1234-1234-123456789012
223
224- CD-ROM: (dvd??)
225
226 "Rescan Prompt"=Yes (*)
227 Prompts for enable CD-ROM rescan mode.
228
229 Rescan=Yes
230 Enable CD-ROM rescan mode.
231
232 "Scan Single Drive"=Yes (*)
233 Scan "only" the drive where the booter got loaded from.
234 Fixes rescan pbs when using a DVD reader in AHCI mode, on some PC's.
235- Ramdisk:
236
237 *****add ramdisk stuff: ?rd, ?rd [m, u, e, d, i]
238
239 md0=<path to file>
240 Override the default "name"??? of raw img file, to be loaded into memory
241 for use as the kernel's md0 ramdisk.
242 Default name: Postboot.img
243 Default paths:?????
244 Ex:
245
246- Gui/Graphics:
247
2480000000000000000000000000000000000000000000000000000000000000000000000000000079
249 "Legacy Logo"=Yes (*) <-- seems to need quotes
250 Use the legacy grey apple logo on the boot screen.
251
252 GraphicsEnabler=Yes
253 Automatic device-properties generation for gfx cards.
254 Note: it doesn't work for all cards and you may have to perform
255 additional patching to get advantage of
256 the automatic dev-prop generation. (Leo??)
257
258 UseAtiROM=Yes
259 Use an alternate Ati ROM image
260 Default path: /Extra/<vendorid>_<devid>.rom
261 Ex: /Extra/1002_1234.rom
262
263 UseNvidiaROM=Yes
264 Use an alternate Nvidia ROM image.
265 Default path: /Extra/<vendorid>_<devid>.rom)
266 Ex: /Extra/10DE_1234.rom
267
268 VBIOS=Yes (nVidia only)
269 Inject VBIOS to device-properties.
270
271 NVCAP_<devid>=<value> (nVidia only)
272 Specify NVCAP value. This value is a 20 bytes long hex string.
273 Ex: NVCAP_05e2=0000000000000000000000000000000000000000
274
275 AutoResolution=Yes
276 Enable native resolution setting for booter Gui and System, even when
277 graphics acceleration (qe/ci) is not available.
278
279 Graphics Mode=WIDTHxHEIGHTxDEPTH + F2 (*) (AutoResolution only)
280 Change or set current resolution while at boot prompt.
281 Only works if AutoResolution is already enabled (AutoResolution=Yes).
282 Ex: "Graphics Mode"=1024x768x32 + press F2 key <-- needs quotes
283
284- Modules:
285
286 PatchKernel=Yes
287 Enable on the fly kernel patching.
288
289==============================================================================
290
291 F8
292 Tab
293
294 "Text Mode"=<does this stuff work at all??>
295 VGA Text Mode Dimensions
296
297 device-properties ???????
298
299 "Quiet Boot"=Yes (*)
300 Use quiet boot mode (no messages or prompt).
301
302 Timeout=<n>
303 Number of seconds to pause at the boot: prompt.
304 There are diff timeouts for hd boot and cdrom boot (8 sec).
305
306 "Instant Menu"=Yes
307 Force displaying the partition selection menu.
308
309 "Default Partition"=hd(x,y)|UUID|"Label" (*)
310 Sets the default boot partition, specified as a disk/partition pair,
311 an UUID, or a label enclosed in quotes.
312
3130000000000000000000000000000000000000000000000000000000000000000000000000000079
314 "Hide Partition"=partition [;partition2 ...] (*)
315 Remove unwanted partition(s) from the boot menu. Specified, possibly
316 multiple times, as hd(x,y), an UUID or label enclosed in quotes.
317 Only works for foreign partitions!! ?????
318
319 "Rename Partition"=partition <alias> [;partition2 <alias2>...] (*)
320 Rename partition(s) for the boot menu. Where partition is hd(x,y), UUID or
321 label enclosed in quotes. Alias should be quoted when containing any space.
322
323 GUI=No
324 Disable the GUI.
325
326 "Boot Banner"=No (*)
327 Disable boot banner in GUI mode.
328
329 Theme=<theme name>
330 Specify the theme to use in GUI mode. Default theme's name is Default :P
331 Ex: <key>Theme</key>
332 <string>Embed</string>
333
334 DebugInfo=Yes
335 Enable display of some debug info (bla bla...) on GUI mode.
336
337
338

Archive Download this file

Revision: 1028