| 1 | The boot: prompt waits for you to type advanced startup options.␊ |
| 2 | If you don't type anything, the computer continues starting up normally. It␊ |
| 3 | uses the kernel and configuration files on the startup device, which it also␊ |
| 4 | uses as the root device.␊ |
| 5 | ␊ |
| 6 | Advanced startup options use the following syntax:␊ |
| 7 | ␊ |
| 8 | [device]<kernel> [arguments]␊ |
| 9 | ␊ |
| 10 | Example arguments include␊ |
| 11 | ␊ |
| 12 | device: rd=<BSD device name> (e.g. rd=disk0s2)␊ |
| 13 | rd=*<IODeviceTree path> (e.g. rd=*/PCI0@0/CHN0@0/@0:1)␊ |
| 14 | ␊ |
| 15 | kernel: kernel name (e.g. "mach_kernel" - must be in "/" )␊ |
| 16 | ␊ |
| 17 | flags: -v (verbose), -s (single user mode),␊ |
| 18 | -x (safe mode), -f (ignore caches),␊ |
| 19 | -F (ignore "Kernel Flags" specified in boot configuration file)␊ |
| 20 | ␊ |
| 21 | "Graphics Mode"="WIDTHxHEIGHTxDEPTH" (e.g. "1024x768x32")␊ |
| 22 | ␊ |
| 23 | kernel flags (e.g. debug=0x144)␊ |
| 24 | io=0xffffffff (defined in IOKit/IOKitDebug.h)␊ |
| 25 | ␊ |
| 26 | Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="1920x1200x32"␊ |
| 27 | ␊ |
| 28 | If the computer won't start up properly, you may be able to start it up using␊ |
| 29 | safe mode. Type -x to start up in safe mode, which ignores all cached␊ |
| 30 | driver files.␊ |
| 31 | ␊ |
| 32 | Special booter hotkeys:␊ |
| 33 | -----------------------␊ |
| 34 | F5 Rescans optical drive.␊ |
| 35 | F10 Scans and displays all BIOS accessible drives.␊ |
| 36 | ␊ |
| 37 | Special booter commands:␊ |
| 38 | ------------------------␊ |
| 39 | ?memory Displays information about the computer's memory.␊ |
| 40 | ?video Displays VESA video modes supported by the computer's BIOS.␊ |
| 41 | ?norescan Leaves optical drive rescan mode.␊ |
| 42 | ␊ |
| 43 | Additional useful command-line options:␊ |
| 44 | ---------------------------------------␊ |
| 45 | config=<file> Use an alternate Boot.plist file.␊ |
| 46 | ␊ |
| 47 | Options useful in the org.chameleon.Boot.plist file:␊ |
| 48 | ----------------------------------------------------␊ |
| 49 | Wait=Yes|No Prompt for a key press before starting the kernel.␊ |
| 50 | "Quiet Boot"=Yes|No Use quiet boot mode (no messages or prompt).␊ |
| 51 | Timeout=8 Number of seconds to pause at the boot: prompt.␊ |
| 52 | "Instant Menu"=Yes Force displaying the partition selection menu.␊ |
| 53 | ␊ |
| 54 | "Default Partition" Sets the default boot partition,␊ |
| 55 | =hd(x,y)|UUID|"Label" Specified as a disk/partition pair, an UUID, or a␊ |
| 56 | label enclosed in quotes.␊ |
| 57 | ␊ |
| 58 | "Hide Partition" Remove unwanted partition(s) from the boot menu.␊ |
| 59 | =partition Specified, possibly multiple times, as hd(x,y), an␊ |
| 60 | [;partition2 ...] UUID or label enclosed in quotes.␊ |
| 61 | ␊ |
| 62 | "Rename Partition" Rename partition(s) for the boot menu.␊ |
| 63 | =partition <alias> Where partition is hd(x,y), UUID or label enclosed␊ |
| 64 | [;partition2 <alias2> in quotes. The alias can optionally be quoted too.␊ |
| 65 | ...]␊ |
| 66 | ␊ |
| 67 | GUI=No Disable the GUI (enabled by default).␊ |
| 68 | "Boot Banner"=Yes|No Show boot banner in GUI mode (disabled by default).␊ |
| 69 | ShowInfo=No Disables display of partition and resolution details.␊ |
| 70 | "Boot Banner"=No will also disable this info.␊ |
| 71 | "Legacy Logo"=Yes|No Use the legacy grey apple logo (enabled by default).␊ |
| 72 | ␊ |
| 73 | EnableHiDPI=Yes|No Enable High resolution display (disabled by default).␊ |
| 74 | ␊ |
| 75 | BlackMode=Yes|No The new BlackMode loads the white Apple logo,␊ |
| 76 | instead of the gray Apple logo, on a black background (disabled by default).␊ |
| 77 | ␊ |
| 78 | PciRoot=<value> Use an alternate value for PciRoot (default value 0).␊ |
| 79 | ␊ |
| 80 | UseKernelCache=Yes|No Yes will load pre-linked kernel and will ignore /E/E␊ |
| 81 | ␉␉␉␉␉␉ and /S/L/E/Extensions.mkext.␊ |
| 82 | ␉␉␉␉␉␉␉Default is No but Yes if you use Lion on a Raid partition.␊ |
| 83 | ␊ |
| 84 | KeyLayout=keymap Use to change the keyboard mapping of the bootloader␊ |
| 85 | (e.g. KeyLayout=mac-fr)␊ |
| 86 | ␊ |
| 87 | HDAEnabler=Yes|No Automatic device-properties generation for audio controllers.␊ |
| 88 | HDEFLayoutID=<value> Inject alternate value of layout-id for HDEF (HEX).␊ |
| 89 | HDAULayoutID=<value> Inject alternate value of layout-id for HDAU (HEX).␊ |
| 90 | ␊ |
| 91 | GraphicsEnabler=Yes|No Automatic device-properties generation for graphics cards.␊ |
| 92 | SkipIntelGfx=Yes|No Skip the Automatic device-properties generation for Intel cards.␊ |
| 93 | SkipNvidiaGfx=Yes|No Skip the Automatic device-properties generation for Nvidia cards.␊ |
| 94 | SkipAtiGfx=Yes|No Skip the Automatic device-properties generation for Ati cards.␊ |
| 95 | ␊ |
| 96 | NvidiaGeneric =Yes|No Use the classic Nvidia name for the SystemProfiler (disabled by default).␊ |
| 97 | NvidiaSingle =Yes|No If you have two cards Nvidia and wants to inject only␊ |
| 98 | first one then you can set this parameter (enbaled by default).␊ |
| 99 | ␊ |
| 100 | AtiConfig=<cardcfg> Use a different card config, e.g. AtiConfig=Megalodon.␊ |
| 101 | AtiPorts=<value> Specify the number of ports, e.g. AtiPorts=2.␊ |
| 102 | UseAtiROM=Yes|No Use an alternate Ati ROM image␊ |
| 103 | (default path: /Extra/<vendorid>_<devid>_<subsysid>.rom)␊ |
| 104 | UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image␊ |
| 105 | (default path: /Extra/<vendorid>_<devid>.rom)␊ |
| 106 | VBIOS=Yes|No Inject VBIOS to device-properties.␊ |
| 107 | display_0=<value> Inject alternate value of display-cfg into NVDA,Display-A@0 (HEX).␊ |
| 108 | display_1=<value> Inject alternate value of display-cfg into NVDA,Display-B@1 (HEX).␊ |
| 109 | IntelCapriFB=<value> For Intel Ivy Bridge, range 0-11.␊ |
| 110 | IntelAzulFB=<value> For Intel Haswell, range 0-16.␊ |
| 111 | IntelBdwFB=<value> For Intel Broadwell, range 0-18.␊ |
| 112 | IntelSklFB=<value> For Intel Skylake, range 0-12.␊ |
| 113 | InjectIntel-ig=<value> Inject alternate value into AAPL,ig-platform-id (HEX).␊ |
| 114 | ␊ |
| 115 | EnableBacklight=Yes␉ Enable Back light option for NVIDIA and ATI␊ |
| 116 | EnableDualLink=Yes␉ Enable DualLink option for NVIDIA and ATI␊ |
| 117 | EnableHDMIAudio=Yes␉ Inject HDMI audio for NVIDIA and ATI.␊ |
| 118 | ␊ |
| 119 | EthernetBuiltIn=Yes|No Automatic "built-in"=YES device-properties generation␊ |
| 120 | for ethernet interfaces.␊ |
| 121 | ForceHPET=Yes|No Force HPET on (disabled by default).␊ |
| 122 | ␊ |
| 123 | USBBusFix=Yes Enable the XHCI, EHCI and UHCI fixes (disabled by default).␊ |
| 124 | EHCIacquire=Yes Enable the EHCI fix (disabled by default).␊ |
| 125 | UHCIreset=Yes Enable the UHCI fix (disabled by default).␊ |
| 126 | USBLegacyOff=Yes Force USB Legacy off for XHCI and EHCI (disabled by default).␊ |
| 127 | XHCILegacyOff=Yes Force USB Legacy off for XHCI (disabled by default).␊ |
| 128 | ␊ |
| 129 | Wake=No Disable wake up after hibernation (enbaled by default).␊ |
| 130 | ForceWake=Yes Force using the sleepimage (disabled by default).␊ |
| 131 | WakeImage=<file> Use an alternate sleepimage file ␊ |
| 132 | (default path is /private/var/vm/sleepimage).␊ |
| 133 | ␊ |
| 134 | DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.␊ |
| 135 | Drop<file>=Yes Skip:[HPET, SLIC, SBST, ECDT, ASF! or DMAR]␊ |
| 136 | ␊ |
| 137 | DSDT=<file> Use an alternate DSDT.aml file ␊ |
| 138 | (default path: /DSDT.aml␊ |
| 139 | /Extra/DSDT.aml bt(0,0)/Extra/DSDT.aml).␊ |
| 140 | HPET=<file> Use an alternate HPET.aml file ␊ |
| 141 | (default path: /HPET.aml␊ |
| 142 | /Extra/HPET.aml bt(0,0)/Extra/HPET.aml).␊ |
| 143 | SBST=<file> Use an alternate SBST.aml file ␊ |
| 144 | (default path: /SBST.aml␊ |
| 145 | /Extra/SBST.aml bt(0,0)/Extra/SBST.aml).␊ |
| 146 | ECDT=<file> Use an alternate ECDT.aml file ␊ |
| 147 | (default path: /ECDT.aml␊ |
| 148 | /Extra/ECDT.aml bt(0,0)/Extra/ECDT.aml).␊ |
| 149 | ASFT=<file> Use an alternate ASFT.aml file ␊ |
| 150 | (default path: /ASFT.aml␊ |
| 151 | /Extra/ASFT.aml bt(0,0)/Extra/ASFT.aml).␊ |
| 152 | DMAR=<file> Use an alternate DMAR.aml file ␊ |
| 153 | (default path: /DMAR.aml␊ |
| 154 | /Extra/DMAR.aml bt(0,0)/Extra/DMAR.aml).␊ |
| 155 | APIC=<file> Use an alternate APIC.aml file ␊ |
| 156 | (default path: /APIC.aml␊ |
| 157 | /Extra/APIC.aml bt(0,0)/Extra/APIC.aml).␊ |
| 158 | MCFG=<file> Use an alternate MCFG.aml file ␊ |
| 159 | (default path: /MCFG.aml␊ |
| 160 | /Extra/MCFG.aml bt(0,0)/Extra/MCFG.aml).␊ |
| 161 | FADT=<file> Use an alternate FADT.aml file ␊ |
| 162 | (default path: /FADT.aml␊ |
| 163 | /Extra/FADT.aml bt(0,0)/Extra/FADT.aml).␊ |
| 164 | ␊ |
| 165 | GenerateCStates=Yes Enable auto generation of processor idle sleep states␊ |
| 166 | (C-States).␊ |
| 167 | GeneratePStates=Yes Enable auto generation of processor power performance␊ |
| 168 | states (P-States).␊ |
| 169 | CSTUsingSystemIO=Yes New C-State _CST generation method using SystemIO␊ |
| 170 | registers instead of FixedHW.␊ |
| 171 | ␊ |
| 172 | EnableC2State=Yes Enable specific Processor power state, C2.␊ |
| 173 | EnableC3State=Yes Enable specific Processor power state, C3.␊ |
| 174 | EnableC4State=Yes Enable specific Processor power state, C4.␊ |
| 175 | EnableC6State=Yes Enable specific Processor power state, C6.␊ |
| 176 | EnableC7State=Yes Enable specific Processor power state, C7.␊ |
| 177 | ␊ |
| 178 | PrivateData=No Show masked data (serial number) in bdmesg log (enbaled by default).␊ |
| 179 | ␊ |
| 180 | ForceFullMemInfo=Yes Force SMBIOS Table 17 to be 27 bytes long (disabled by default).␊ |
| 181 | ␊ |
| 182 | SMBIOS=<file> Use an alternate SMBIOS.plist file␊ |
| 183 | (default path: /smbios.plist /Extra/smbios.plist␊ |
| 184 | bt(0,0)/Extra/smbios.plist).␊ |
| 185 | ␊ |
| 186 | SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding␊ |
| 187 | if smbios.plist doesn't exist, factory␊ |
| 188 | values are kept.␊ |
| 189 | ␊ |
| 190 | "Scan Single Drive" Scan the drive only where the booter got loaded from.␊ |
| 191 | =Yes|No Fix rescan issues when using a DVD reader in AHCI mode. ␊ |
| 192 | Rescan=Yes Enable CD-ROM rescan mode.␊ |
| 193 | "Rescan Prompt"=Yes Prompts for enable CD-ROM rescan mode.␊ |
| 194 | SystemId=<UUID> Set the system id manually to UUID.␊ |
| 195 | Deprecated - Now SMsystemuuid in smbios.plist␊ |
| 196 | SMUUID in smbios config (reserved field) isn't used then.␊ |
| 197 | SystemType=<n> Set the system type to n, where n is between 0..6␊ |
| 198 | (default=1 Desktop)␊ |
| 199 | md0=<file> Load raw img file into memory for use as XNU's md0␊ |
| 200 | ramdisk. /Extra/Postboot.img is used otherwise.␊ |
| 201 | |
