From tonymacx86 Wiki
Jump to: navigation, search
This page is a stub! You can help the TonyMacx86 community by expanding it!



org.chameleon.Boot.plist is an XML property list, located in /Extra, that provides Chimera with commands, alternate kernels, system boot options, etc. It was previously named, to match the system-provided version stored in /Library/Preferences/SystemConfiguration.


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
<plist version="1.0">
	<key>Kernel Flags</key>
	<string>darkwake=0 npci=0x3000</string>
	<key>Legacy Logo</key>

System Boot Options

"Graphics Mode"="<width>x<height>x<depth>@<frequency>"
Works only if you have a VESA 3.0 compliant card
"Text Mode"="<width>x<height>"
Sets text mode dimentions [Default 80x25]
"Quiet Boot"=Yes | No
Use quiet boot mode (no messages or prompt) [Default No]
"Kernel Flags"="<key1>=<value1>[ <key2>=<value2>...]"
This is a series of flags sent to the kernel
"Kernel Architecture"=i386 | x86_64 | ppc
Kernel architecture boot mode
MKext Cache
The filename of your kernel you wish to boot. This can be different from mach_kernel, but be sure to create a symlink that points to the new kernel you're booting with a name of mach_kernel to allow all software to be compatible. Note that this is necessary for you to boot a differently named kernel, because osx naively tries to load the symlink itself as the kernel and not the file that the symlink points to if you don't tell the bootloader! [Default mach_kernel]
Kernel Cache=<file>
UseKernelCache=Yes | No
Use the system's prelinked kernel cache [Default Yes]
Boot Device
Number of seconds to countdown before choosing the default partition [Default 2]
Root UUID=<uuid>
CD-ROM Prompt
CD-ROM Option
"Scan Single Drive"=Yes | No
Scan the drive only where the booter got loaded from. Fix rescan pbs when using a DVD reader in AHCI mode [Default No]
Rescan=Yes | No
Enable CD-ROM rescan mode [Default No]
"Rescan Prompt"=Yes | No
Prompts for enable CD-ROM rescan mode [Default No]
"Instant Menu"=Yes | No
Force displaying the partition selection menu [Default No]
GUI=Yes | No
Enable/Disable the GUI [Default Yes]
"Boot Banner"=Yes | No
Show boot banner in GUI mode [Default Yes]
ShowInfo=Yes | No
Wait=Yes | No
Prompt for a key press before starting the kernel [Default No]

Chimera Boot Options

DropSSDT=Yes | No
Skip the SSDT tables while relocating the ACPI tables [Default No]
Use an alternate DSDT.aml file [Defaults /DSDT.aml /Extra/DSDT.aml bt(0,0)/Extra/DSDT.aml]
RestartFix=Yes | No
If disabled, no FACP patch will be done at boot time. [Default Yes]
CSTUsingSystemIO=Yes | No
GenerateCStates=Yes | No
Enable auto generation of processor idle sleep states [Default Yes]
GeneratePStates=Yes | No
Enable auto generation of processor power performance states [Default Yes]
EnableC2State=Yes | No
Enable specific Processor power state, C2 [Default No]
EnableC3State=Yes | No
Enable specific Processor power state, C3 [Default No]
EnableC4State=Yes | No
Enable specific Processor power state, C4 [Default No]
Wake=Yes | No
Disable wake up after hibernation [Default Yes]
ForceWake=Yes | No
Force using the sleepimage [Default No]
Use an alternate sleepimage file. [Default /private/var/vm/sleepimage]
Force busratio multiplier, such as CPUFreq=FSB freq x busratio
Sets additional device properties like gfx card efi injection, network
"Default Partition"=hd(<x>,<y>) | <uuid> | <label>
Sets the default boot partition, Specified as a disk/partition pair, an uuid, or a label enclosed in quotes [No default]
"Hide Partition"="<partition>[;<partition2>...]"
Remove unwanted partition(s) from the boot menu. Specified, possibly multiple times, as hd(x,y), an uuid or label enclosed in quotes [No default]
"Rename Partition"="<partition> <alias>[;<partition2> <alias2>...]"
Rename partition(s) for the boot menu. Where partition is hd(x,y), uuid or label enclosed in quotes. The alias can optionally be quoted too. [No default]
Use an alternate SMBIOS.plist file [Defaults /Extra/SMBIOS.plist bt(0,0)/Extra/SMBIOS.plist]
SMBIOSdefaults=Yes | No
Don't use the default values for smbios.plist [Default No]
Manually set the system id uuid, overriding SMuuid in smbios config [No Default]
Set the system type [Default 1]
UseMemDetect=Yes | No
PCIRootUID=0 | 1
Use an alternate value for PciRoot [Default 0]
Change the number of graphics ports reported to OSX
Use a different framebuffer personality [No default]
UseAtiROM=Yes | No
Use an alternate Ati ROM image with path /Extra/<vendorid>_<devid>_<subsysid>.rom [Default No]
UseNvidiaROM=Yes | No
Use an alternate Nvidia ROM image with path /Extra/<vendorid>_<devid>.rom [Default No]
VBIOS=Yes | No
Inject NVIDIA VBIOS into device-properties [Default No]
EthernetBuiltIn=Yes | No
Automatic device-properties generation for ethernet interfaces [Default Yes]
GraphicsEnabler=Yes | No
Automatic device-properties generation for gfx cards [Default Yes]
ForceHPET=Yes | No
Force Enable HPET [Default No]
Load raw img file into memory for use as XNU's md0 ramdisk [Default /Extra/Postboot.img]
USBBusFix=Yes | No
Enable all of the USB fixes [Default No]
EHCIacquire=Yes | No
Enable the EHCI fix [Default No]
UHCIreset=Yes | No
Enable the UHCI fix [Default No]
USBLegacyOff=Yes | No
Enable the USB Legacy fix [Default No]
EHCIhard=Yes | No

Kernel Flags

Force physical cpus count (all cores in all cpus), use only if autodetection doesn't work
darkwake=0 | 1
Governs the initialization order and method of the PCI bus [Default 0x3000]
Increases AHCI debugging level, usually "1" when OS X boots too quickly [Default 0]
dart=0 | 1
Enables or disables extended memory mapping [Default 0]
nv_disable=0 | 1
Disables QE/CI on nVidia graphics cards [Default 0]
Real Time Clock debugging level, use 7 for an RTC dump to the kernel log

Chimera-Specific Options

Here are extended properties that are recognized by Chimera.

The name of the bootloader's graphical theme, stored as a directory in /Extra/Themes. See also Theme your bootloader

Advanced Techniques

Basic Troubleshooting

This option can be used to troubleshoot systems using UserDSDT
This option nullifies the effects of the current org.chameleon.Boot.plist
This option nullifies the effects of the current smbios.plist
npci=0x3000 | 0x2000 | (nothing)
These options control the initialization order and can prevent random kernel panics
This is usually necessary for laptops, and CPUs that are unknown to the OS
PCIRootUID=0 | 1
These options depend on the graphics card and prevent hangs at [PCI Configuration begin]

Boot Partition

This is a dedicated partition for the bootloader and its extensions, presumably to further isolate it from Software Updates and such (since you can place a bootable kernel here that won't ever be overwritten). It's akin to putting iBoot on a separate partition, and is common / standard practice in UNIX / Linux.