Chameleon

Chameleon Svn Source Tree

Root/branches/ErmaC/Enoch/doc/BootHelp.txt

1The boot: prompt waits for you to type advanced startup options.
2If you don't type anything, the computer continues starting up normally. It
3uses the kernel and configuration files on the startup device, which it also
4uses as the root device.
5
6Advanced startup options use the following syntax:
7
8 [device]<kernel> [arguments]
9
10Example 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
26Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="1920x1200x32"
27
28If the computer won't start up properly, you may be able to start it up using
29safe mode. Type -x to start up in safe mode, which ignores all cached
30driver files.
31
32Special booter hotkeys:
33-----------------------
34 F5 Rescans optical drive.
35 F10 Scans and displays all BIOS accessible drives.
36
37Special 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
43Additional useful command-line options:
44---------------------------------------
45 config=<file> Use an alternate Boot.plist file.
46
47Options 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 RebootOnPanic=Yes|No (disabled by default).
74
75 EnableHiDPI=Yes|No Enable High resolution display (disabled by default).
76
77 BlackMode=Yes|No The new BlackMode loads the white Apple logo,
78 instead of the gray Apple logo, on a black background (disabled by default).
79
80 CsrActiveConfig=<value> Set CsrActiveConfig for OS 10.11.x, range 0..255 (default 0x67)
81
82 PciRoot=<value> Use an alternate value for PciRoot (default value 0).
83
84 UseKernelCache=Yes|No Yes will load pre-linked kernel and will ignore /E/E
85 and /S/L/E/Extensions.mkext.
86Default is No but Yes if you use Lion on a Raid partition.
87
88 KeyLayout=keymap Use to change the keyboard mapping of the bootloader
89 (e.g. KeyLayout=mac-fr)
90
91 HDAEnabler=Yes|No Automatic device-properties generation for audio controllers.
92 HDEFLayoutID=<value> Inject alternate value of layout-id for HDEF (HEX).
93 HDAULayoutID=<value> Inject alternate value of layout-id for HDAU (HEX).
94
95 GraphicsEnabler=Yes|No Automatic device-properties generation for graphics cards.
96 SkipIntelGfx=Yes|No Skip the Automatic device-properties generation for Intel cards.
97 SkipNvidiaGfx=Yes|No Skip the Automatic device-properties generation for Nvidia cards.
98 SkipAtiGfx=Yes|No Skip the Automatic device-properties generation for Ati cards.
99
100 NvidiaGeneric=Yes|No Use the classic Nvidia name for the SystemProfiler (disabled by default).
101 NvidiaSingle=Yes|No If you have two cards Nvidia and wants to inject only
102 first one then you can set this parameter (enbaled by default).
103 NvidiaNoEFI=Yes|No Inject NVDA,noEFI value as true
104
105 AtiConfig=<cardcfg> Use a different card config, e.g. AtiConfig=Megalodon.
106 AtiPorts=<value> Specify the number of ports, e.g. AtiPorts=2.
107 UseAtiROM=Yes|No Use an alternate Ati ROM image
108 (default path: /Extra/<vendorid>_<devid>_<subsysid>.rom)
109 UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image
110 (default path: /Extra/<vendorid>_<devid>.rom)
111 VBIOS=Yes|No Inject VBIOS to device-properties.
112 display_0=<value> Inject alternate value of display-cfg into NVDA,Display-A@0 (HEX).
113 display_1=<value> Inject alternate value of display-cfg into NVDA,Display-B@1 (HEX).
114 IntelCapriFB=<value> For Intel Ivy Bridge, range 0-11.
115 IntelAzulFB=<value> For Intel Haswell, range 0-16.
116 IntelBdwFB=<value> For Intel Broadwell, range 0-19.
117 IntelSklFB=<value> For Intel Skylake, range 0-12.
118 InjectIntel-ig=<value> Inject alternate value into AAPL,ig-platform-id (HEX).
119
120 EnableBacklight=Yes Enable Back light option for NVIDIA and ATI
121 EnableDualLink=Yes Enable DualLink option for NVIDIA and ATI
122 EnableHDMIAudio=Yes Inject HDMI audio for NVIDIA and ATI.
123
124 EthernetBuiltIn=Yes|No Automatic "built-in"=YES device-properties generation
125 for ethernet interfaces.
126 ForceHPET=Yes|No Force HPET on (disabled by default).
127
128 USBBusFix=Yes Enable the XHCI, EHCI and UHCI fixes (disabled by default).
129 EHCIacquire=Yes Enable the EHCI fix (disabled by default).
130 UHCIreset=Yes Enable the UHCI fix (disabled by default).
131 USBLegacyOff=Yes Force USB Legacy off for XHCI and EHCI (disabled by default).
132 XHCILegacyOff=Yes Force USB Legacy off for XHCI (disabled by default).
133
134 Wake=No Disable wake up after hibernation (enbaled by default).
135 ForceWake=Yes Force using the sleepimage (disabled by default).
136 WakeImage=<file> Use an alternate sleepimage file
137 (default path is /private/var/vm/sleepimage).
138
139 DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.
140 Drop<file>=Yes Skip:[HPET, SLIC, SBST, ECDT, ASF! or DMAR]
141
142 DSDT=<file> Use an alternate DSDT.aml file
143 (default path: /DSDT.aml
144 /Extra/DSDT.aml bt(0,0)/Extra/DSDT.aml).
145 HPET=<file> Use an alternate HPET.aml file
146 (default path: /HPET.aml
147 /Extra/HPET.aml bt(0,0)/Extra/HPET.aml).
148 SBST=<file> Use an alternate SBST.aml file
149 (default path: /SBST.aml
150 /Extra/SBST.aml bt(0,0)/Extra/SBST.aml).
151 ECDT=<file> Use an alternate ECDT.aml file
152 (default path: /ECDT.aml
153 /Extra/ECDT.aml bt(0,0)/Extra/ECDT.aml).
154 ASFT=<file> Use an alternate ASFT.aml file
155 (default path: /ASFT.aml
156 /Extra/ASFT.aml bt(0,0)/Extra/ASFT.aml).
157 DMAR=<file> Use an alternate DMAR.aml file
158 (default path: /DMAR.aml
159 /Extra/DMAR.aml bt(0,0)/Extra/DMAR.aml).
160 APIC=<file> Use an alternate APIC.aml file
161 (default path: /APIC.aml
162 /Extra/APIC.aml bt(0,0)/Extra/APIC.aml).
163 MCFG=<file> Use an alternate MCFG.aml file
164 (default path: /MCFG.aml
165 /Extra/MCFG.aml bt(0,0)/Extra/MCFG.aml).
166 FADT=<file> Use an alternate FADT.aml file
167 (default path: /FADT.aml
168 /Extra/FADT.aml bt(0,0)/Extra/FADT.aml).
169
170 GenerateCStates=Yes Enable auto generation of processor idle sleep states
171 (C-States).
172 GeneratePStates=Yes Enable auto generation of processor power performance
173 states (P-States).
174 CSTUsingSystemIO=Yes New C-State _CST generation method using SystemIO
175 registers instead of FixedHW.
176
177 EnableC2State=Yes Enable specific Processor power state, C2.
178 EnableC3State=Yes Enable specific Processor power state, C3.
179 EnableC4State=Yes Enable specific Processor power state, C4.
180 EnableC6State=Yes Enable specific Processor power state, C6.
181 EnableC7State=Yes Enable specific Processor power state, C7.
182
183 PrivateData=No Show masked data (serial number) in bdmesg log (enbaled by default).
184
185 ForceFullMemInfo=Yes Force SMBIOS Table 17 to be 27 bytes long (disabled by default).
186
187 SMBIOS=<file> Use an alternate SMBIOS.plist file
188 (default path: /smbios.plist /Extra/smbios.plist
189 bt(0,0)/Extra/smbios.plist).
190
191 SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding
192 if smbios.plist doesn't exist, factory
193 values are kept.
194
195
196 KERNELPlist=<file> Use an alternate kernel.plist file
197 (default path: /Extra/Kernel.plist
198 bt(0,0)/Extra/kernel.plist).
199
200 KEXTPlist=<file> Use an alternate kext.plist file
201 (default path: /Extra/Kext.plist
202 bt(0,0)/Extra/kext.plist).
203
204 "Scan Single Drive" Scan the drive only where the booter got loaded from.
205 =Yes|No Fix rescan issues when using a DVD reader in AHCI mode.
206 Rescan=Yes Enable CD-ROM rescan mode.
207 "Rescan Prompt"=Yes Prompts for enable CD-ROM rescan mode.
208 SystemId=<UUID> Set the system id manually to UUID.
209 Deprecated - Now SMsystemuuid in smbios.plist
210 SMUUID in smbios config (reserved field) isn't used then.
211 SystemType=<n> Set the system type to n, where n is between 0..6
212 (default=1 Desktop)
213 md0=<file> Load raw img file into memory for use as XNU's md0
214 ramdisk. /Extra/Postboot.img is used otherwise.
215

Archive Download this file

Revision: 2898