| 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: (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 | - Devices/Other:???␊ |
| 136 | ␊ |
| 137 | UseMemDetect=No␊ |
| 138 | Disable memory modules?? info detection.␊ |
| 139 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
| 140 | ␊ |
| 141 | EthernetBuiltIn=Yes␊ |
| 142 | Automatic device-properties generation, that sets "built-in" property␊ |
| 143 | for ethernet interfaces.␊ |
| 144 | ␊ |
| 145 | USBBusFix=Yes␊ |
| 146 | Enable all USB fixes below (fixes can be used individually):␊ |
| 147 | EHCIacquire=Yes - Enable the EHCI fix.␊ |
| 148 | UHCIreset=Yes - Enable the UHCI fix.␊ |
| 149 | USBLegacyOff=Yes - Enable the USB Legacy fix.␊ |
| 150 | ␊ |
| 151 | ForceHPET=Yes␊ |
| 152 | Force enabling HPET device on the PC's BIOS.␊ |
| 153 | ␊ |
| 154 | - Hibernation:␊ |
| 155 | ␊ |
| 156 | Wake=No␊ |
| 157 | Disable wake up after hibernation.␊ |
| 158 | ␊ |
| 159 | ForceWake=Yes␊ |
| 160 | Force using the sleepimage (when desired), if you get the message:␊ |
| 161 | "Hibernate image is too old by n seconds. Use ForceWake=y to override."␊ |
| 162 | ␊ |
| 163 | WakeImage=<path to file>␊ |
| 164 | Use an alternate sleepimage file.␊ |
| 165 | Default path: /private/var/vm/sleepimage␊ |
| 166 | ␊ |
| 167 | - ACPI:␊ |
| 168 | ␊ |
| 169 | DSDT=<path to file> or <file name>??????????????␊ |
| 170 | Override the default dsdt.aml paths/name.␊ |
| 171 | Default name: dsdt.aml␊ |
| 172 | Default paths:?????␊ |
| 173 | Ex:␊ |
| 174 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
| 175 | ␊ |
| 176 | DropSSDT=Yes␊ |
| 177 | Skip the SSDT tables while relocating the ACPI tables.␊ |
| 178 | ␊ |
| 179 | PciRoot=<value> <<<<<<< change "group" ??␊ |
| 180 | Use an alternate value for PciRoot UID. Can be retrieved from dsdt.aml␊ |
| 181 | by the booter, if supplied by the user and present on the ACPI table.␊ |
| 182 | Default value: 0␊ |
| 183 | ␊ |
| 184 | RestartFix=yes␊ |
| 185 | Enable restart fix for Intel chipsets.␊ |
| 186 | ␊ |
| 187 | GenerateCStates=Yes Enable auto generation of Processor (C-States) and/or␊ |
| 188 | GeneratePStates=Yes Performance (P-States) power states.␊ |
| 189 | ␊ |
| 190 | EnableC2State=Yes Enable specific Processor power states,␊ |
| 191 | EnableC3State=Yes C2, C3, C4.␊ |
| 192 | EnableC4State=Yes␊ |
| 193 | ␊ |
| 194 | - Bios/smbios:???␊ |
| 195 | ␊ |
| 196 | SMBIOS=<path to file> or <file name?????>␊ |
| 197 | Override the default smbios.plist paths/name.␊ |
| 198 | Default name: smbios.plist␊ |
| 199 | Default paths:?????␊ |
| 200 | Ex:␊ |
| 201 | ␊ |
| 202 | SMBIOSdefaults=No␊ |
| 203 | Disable the use of Default values for SMBIOS overriding, when smbios.plist␊ |
| 204 | is not used.␊ |
| 205 | ␊ |
| 206 | SystemType=<value>␊ |
| 207 | Set the system type where n is between 0..6 (default value =1 (Desktop).␊ |
| 208 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
| 209 | ␊ |
| 210 | According to CHANGES file, this should be SystemID, not SystemId! ????????␊ |
| 211 | SystemId=<UUID>␊ |
| 212 | Manually set the system UUID. (also known as Platform or Hardware UUID)␊ |
| 213 | SMUUID (reserved field) in smbios.plist config is deprecated.␊ |
| 214 | Ex: SystemId=12345678-1234-1234-1234-123456789012␊ |
| 215 | ␊ |
| 216 | - CD-ROM: (dvd??)␊ |
| 217 | ␊ |
| 218 | "Rescan Prompt"=Yes (*)␊ |
| 219 | Prompts for enable CD-ROM rescan mode.␊ |
| 220 | ␊ |
| 221 | Rescan=Yes␊ |
| 222 | Enable CD-ROM rescan mode.␊ |
| 223 | ␊ |
| 224 | "Scan Single Drive"=Yes (*)␊ |
| 225 | Scan "only" the drive where the booter got loaded from.␊ |
| 226 | Fixes rescan pbs when using a DVD reader in AHCI mode, on some PC's.␊ |
| 227 | - Ramdisk:␊ |
| 228 | ␊ |
| 229 | *****add ramdisk stuff: ?rd, ?rd [m, u, e, d, i]␊ |
| 230 | ␊ |
| 231 | md0=<path to file>␊ |
| 232 | Override the default "name"??? of raw img file, to be loaded into memory␊ |
| 233 | for use as the kernel's md0 ramdisk.␊ |
| 234 | Default name: Postboot.img␊ |
| 235 | Default paths:?????␊ |
| 236 | Ex:␊ |
| 237 | ␊ |
| 238 | - Gui/Graphics:␊ |
| 239 | ␊ |
| 240 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
| 241 | "Legacy Logo"=Yes (*) <-- seems to need quotes␊ |
| 242 | Use the legacy grey apple logo on the boot screen.␊ |
| 243 | ␊ |
| 244 | GraphicsEnabler=Yes␊ |
| 245 | Automatic device-properties generation for gfx cards.␊ |
| 246 | Note: it doesn't work for all cards and you may have to perform␊ |
| 247 | additional patching to get advantage of␊ |
| 248 | the automatic dev-prop generation. (Leo??)␊ |
| 249 | ␊ |
| 250 | UseAtiROM=Yes␊ |
| 251 | Use an alternate Ati ROM image ␊ |
| 252 | Default path: /Extra/<vendorid>_<devid>.rom␊ |
| 253 | Ex: /Extra/1002_1234.rom␊ |
| 254 | ␊ |
| 255 | UseNvidiaROM=Yes␊ |
| 256 | Use an alternate Nvidia ROM image.␊ |
| 257 | Default path: /Extra/<vendorid>_<devid>.rom)␊ |
| 258 | Ex: /Extra/10DE_1234.rom␊ |
| 259 | ␊ |
| 260 | VBIOS=Yes (nVidia only)␊ |
| 261 | Inject VBIOS to device-properties.␊ |
| 262 | ␊ |
| 263 | NVCAP_<devid>=<value> (nVidia only)␊ |
| 264 | Specify NVCAP value. This value is a 20 bytes long hex string.␊ |
| 265 | Ex: NVCAP_05e2=0000000000000000000000000000000000000000␊ |
| 266 | ␊ |
| 267 | AutoResolution=Yes␊ |
| 268 | Enable native resolution setting for booter Gui and System, even when␊ |
| 269 | graphics acceleration (qe/ci) is not available.␊ |
| 270 | ␊ |
| 271 | Graphics Mode=WIDTHxHEIGHTxDEPTH + F2 (*) (AutoResolution only)␊ |
| 272 | Change or set current resolution while at boot prompt.␊ |
| 273 | Only works if AutoResolution is already enabled (AutoResolution=Yes).␊ |
| 274 | Ex: "Graphics Mode"=1024x768x32 + press F2 key <-- needs quotes␊ |
| 275 | ␊ |
| 276 | - Modules:␊ |
| 277 | ␊ |
| 278 | PatchKernel=Yes␊ |
| 279 | Enable on the fly kernel patching.␊ |
| 280 | ␊ |
| 281 | ==============================================================================␊ |
| 282 | ␊ |
| 283 | F8␊ |
| 284 | Tab␊ |
| 285 | ␊ |
| 286 | "Text Mode"=<does this stuff work at all??>␊ |
| 287 | VGA Text Mode Dimensions␊ |
| 288 | ␊ |
| 289 | device-properties ???????␊ |
| 290 | ␊ |
| 291 | "Quiet Boot"=Yes (*)␊ |
| 292 | Use quiet boot mode (no messages or prompt).␊ |
| 293 | ␊ |
| 294 | Timeout=<n>␊ |
| 295 | Number of seconds to pause at the boot: prompt.␊ |
| 296 | There are diff timeouts for hd boot and cdrom boot (8 sec).␊ |
| 297 | ␊ |
| 298 | "Instant Menu"=Yes␊ |
| 299 | Force displaying the partition selection menu.␊ |
| 300 | ␊ |
| 301 | "Default Partition"=hd(x,y)|UUID|"Label" (*)␊ |
| 302 | Sets the default boot partition, specified as a disk/partition pair,␊ |
| 303 | an UUID, or a label enclosed in quotes.␊ |
| 304 | ␊ |
| 305 | 0000000000000000000000000000000000000000000000000000000000000000000000000000079␊ |
| 306 | "Hide Partition"=partition [;partition2 ...] (*)␊ |
| 307 | Remove unwanted partition(s) from the boot menu. Specified, possibly␊ |
| 308 | multiple times, as hd(x,y), an UUID or label enclosed in quotes.␊ |
| 309 | Only works for foreign partitions!! ?????␊ |
| 310 | ␊ |
| 311 | "Rename Partition"=partition <alias> [;partition2 <alias2>...] (*)␊ |
| 312 | Rename partition(s) for the boot menu. Where partition is hd(x,y), UUID or␊ |
| 313 | label enclosed in quotes. Alias should be quoted when containing any space.␊ |
| 314 | ␊ |
| 315 | GUI=No␊ |
| 316 | Disable the GUI.␊ |
| 317 | ␊ |
| 318 | "Boot Banner"=No (*)␊ |
| 319 | Disable boot banner in GUI mode.␊ |
| 320 | ␊ |
| 321 | Theme=<theme name>␊ |
| 322 | Specify the theme to use in GUI mode. Default theme's name is Default :P␊ |
| 323 | Ex: <key>Theme</key>␊ |
| 324 | <string>Embed</string>␊ |
| 325 | ␊ |
| 326 | DebugInfo=Yes␊ |
| 327 | Enable display of some debug info (bla bla...) on GUI mode.␊ |
| 328 | ␊ |
| 329 | ␊ |
| 330 | |
