1 | 00000000000000000000000000000000000000000000000000000000000000000000000000000080␊ |
2 | Chameleon Bootloader␊ |
3 | boot time help␊ |
4 | ␊ |
5 | The boot prompt waits for you to type advanced startup options. If you don't␊ |
6 | type anything, the computer continues starting up normally. It will use the␊ |
7 | kernel and configuration files on the selected/default device, which it also␊ |
8 | uses as the root device.␊ |
9 | Use the following syntax, when typing advanced startup options:␊ |
10 | ␊ |
11 | [device]<kernel> [arguments]␊ |
12 | ␊ |
13 | Arguments consist of either just a name, e.g. -v or a key=value pair,␊ |
14 | e.g. rd=disk0s2. The latest are commonly referred to as "keys" and the first␊ |
15 | as "flags". ????????????????? bs...␊ |
16 | Use the following syntax when typing arguments (recommended):␊ |
17 | ␊ |
18 | [flags] [Wait=y key] [any other key]␊ |
19 | ␊ |
20 | WARNINGS (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 | ␊ |
35 | Argument's names are case sensitive, values are not. Thus:␊ |
36 | /Extra/DSDT.aml = /extra/dsdt.aml, etc...␊ |
37 | ␊ |
38 | Thanks ?????␊ |
39 | ============================================================================79␊ |
40 | ␊ |
41 | Special booter hotkeys:␊ |
42 | ␊ |
43 | F5 Rescans optical drive.␊ |
44 | F10 Scans and displays all BIOS accessible drives.␊ |
45 | ␊ |
46 | Special 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 | ␊ |
58 | Most 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 | ␊ |
72 | curruption on Chamatic theme, due to too many spaces; the size of the spaces␊ |
73 | is "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 | ␊ |
112 | Options 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.␊ |
147 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
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:␊ |
182 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
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).␊ |
216 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
217 | ␊ |
218 | According 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 | ␊ |
248 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
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 | display_0=<value>␊ |
272 | Inject alternate value of display-cfg into NVDA,Display-A@0 (HEX).␊ |
273 | display_1=<value>␊ |
274 | Inject alternate value of display-cfg into NVDA,Display-B@1 (HEX).␊ |
275 | ␊ |
276 | NVCAP_<devid>=<value> (nVidia only)␊ |
277 | Specify NVCAP value. This value is a 20 bytes long hex string.␊ |
278 | Ex: NVCAP_05e2=0000000000000000000000000000000000000000␊ |
279 | ␊ |
280 | AutoResolution=Yes␊ |
281 | Enable native resolution setting for booter Gui and System, even when␊ |
282 | graphics acceleration (qe/ci) is not available.␊ |
283 | ␊ |
284 | Graphics Mode=WIDTHxHEIGHTxDEPTH + F2 (*) (AutoResolution only)␊ |
285 | Change or set current resolution while at boot prompt.␊ |
286 | Only works if AutoResolution is already enabled (AutoResolution=Yes).␊ |
287 | Ex: "Graphics Mode"=1024x768x32 + press F2 key <-- needs quotes␊ |
288 | ␊ |
289 | - Modules:␊ |
290 | ␊ |
291 | PatchKernel=Yes␊ |
292 | Enable on the fly kernel patching.␊ |
293 | ␊ |
294 | ==============================================================================␊ |
295 | ␊ |
296 | F8␊ |
297 | Tab␊ |
298 | ␊ |
299 | "Text Mode"=<does this stuff work at all??>␊ |
300 | VGA Text Mode Dimensions␊ |
301 | ␊ |
302 | device-properties ???????␊ |
303 | ␊ |
304 | "Quiet Boot"=Yes (*)␊ |
305 | Use quiet boot mode (no messages or prompt).␊ |
306 | ␊ |
307 | Timeout=<n>␊ |
308 | Number of seconds to pause at the boot: prompt.␊ |
309 | There are diff timeouts for hd boot and cdrom boot (8 sec).␊ |
310 | ␊ |
311 | "Instant Menu"=Yes␊ |
312 | Force displaying the partition selection menu.␊ |
313 | ␊ |
314 | "Default Partition"=hd(x,y)|UUID|"Label" (*)␊ |
315 | Sets the default boot partition, specified as a disk/partition pair,␊ |
316 | an UUID, or a label enclosed in quotes.␊ |
317 | ␊ |
318 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
319 | "Hide Partition"=partition [;partition2 ...] (*)␊ |
320 | Remove unwanted partition(s) from the boot menu. Specified, possibly␊ |
321 | multiple times, as hd(x,y), an UUID or label enclosed in quotes.␊ |
322 | Only works for foreign partitions!! ?????␊ |
323 | ␊ |
324 | "Rename Partition"=partition <alias> [;partition2 <alias2>...] (*)␊ |
325 | Rename partition(s) for the boot menu. Where partition is hd(x,y), UUID or␊ |
326 | label enclosed in quotes. Alias should be quoted when containing any space.␊ |
327 | ␊ |
328 | GUI=No␊ |
329 | Disable the GUI.␊ |
330 | ␊ |
331 | "Boot Banner"=No (*)␊ |
332 | Disable boot banner in GUI mode.␊ |
333 | ␊ |
334 | Theme=<theme name>␊ |
335 | Specify the theme to use in GUI mode. Default theme's name is Default :P␊ |
336 | Ex: <key>Theme</key>␊ |
337 | <string>Embed</string>␊ |
338 | ␊ |
339 | DebugInfo=Yes␊ |
340 | Enable display of some debug info (bla bla...) on GUI mode.␊ |
341 | ␊ |
342 | ␊ |
343 | |