Chameleon

Chameleon Svn Source Tree

Root/branches/valv/branch/doc/BootHelp.txt

  • Property svn:executable set to
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 boot configuration file)
19
20 "Graphics Mode"="WIDTHxHEIGHTxDEPTH" (e.g. "1024x768x32")
21
22 kernel flags (e.g. debug=0x144)
23 io=0xffffffff (defined in IOKit/IOKitDebug.h)
24
25Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="1920x1200x32"
26
27If the computer won't start up properly, you may be able to start it up
28using safe mode. Type -x to start up in safe mode, which ignores all
29cached driver files.
30
31Special booter hotkeys:
32-----------------------
33 F2 Reload screen with the specified "Graphics Mode", if any.
34 F5 Rescan optical drive.
35 F8 Abort quiet mode, and display the menu.
36 F10 Scan and display all BIOS accessible drives.
37 alt+f Ignore caches
38 shift+f Ignore boot configuration file
39 alt+s Single user mode
40 alt+v Verbose
41 alt+x Safe mode
42 alt+l Legacy mode (not sure why you need this)
43 6+4 64-bit
44 3+2 32-bit
45
46Special booter commands:
47------------------------
48 ?memory Display information about the computer's memory.
49 ?video Display VESA video modes supported by the computer's BIOS.
50 ?norescan Leave optical drive rescan mode.
51
52Additional useful command-line options:
53---------------------------------------
54 config=<file> Use an alternate Boot.plist file.
55
56Options useful in the com.apple.Boot.plist file:
57------------------------------------------------
58 Wait=Yes|No Prompt for a key press before starting the kernel.
59 "Quiet Boot"=Yes|No Use quiet boot mode (no messages or prompt).
60 Timeout=8 Number of seconds to pause at the boot: prompt.
61 "Instant Menu"=Yes Force displaying the partition selection menu.
62 "Default Partition" Sets the default boot partition,
63 =hd(x,y)|UUID|"Label" Specified as a disk/partition pair, an UUID, or a
64 label enclosed in quotes.
65 "Hide Partition" Remove unwanted partition(s) from the boot menu.
66 =partition Specified, possibly multiple times, as hd(x,y), an
67 [;partition2 ...] UUID or label enclosed in quotes.
68 "Rename Partition" Rename partition(s) for the boot menu.
69 =partition <alias> Where partition is hd(x,y), UUID or label enclosed
70 [;partition2 <alias2> in quotes. The alias can optionally be quoted too.
71 ...]
72 "Boot Banner"=No Show boot banner in GUI mode (default: enabled).
73 "Legacy Logo"=Yes Use the legacy grey apple logo (default: disabled).
74 GUI=No Disable the GUI (default: enabled).
75 PCIRootUID=<value> Use an alternate value for PciRoot (default value 0).
76 AutoResolution=Yes Automatic display resolution detection (default: disabled).
77 GraphicsEnabler=Yes Automatic device-properties generation for gfx cards (default: disabled).
78 NVCAP_<ID>=<value> Use aternate nvcap value.
79 display_0=<value> Inject alternate value of display-cfg into NVDA,Display-A@0
80 display_1=<value> Inject alternate value of display-cfg into NVDA,Display-B@1
81 UseAtiROM=Yes Use an alternate Ati ROM image
82 (path: /Extra/<vendorid>_<devid>.rom)
83 UseNvidiaROM=Yes Use an alternate Nvidia ROM image
84 (path: /Extra/<vendorid>_<devid>.rom)
85 VBIOS=Yes Inject VBIOS to device-properties.
86 EthernetBuiltIn=Yes Add "built-in"=yes to device-properties of ethernet interfaces.
87 USBBusFix=Yes Enable all USB fixes below:
88 EHCIacquire=Yes Enable the EHCI fix (default: disabled).
89 EHCIhard=No Disable Hard BIOS reset (default: enabled).
90 UHCIreset=Yes Enable the UHCI fix (default: disabled).
91 USBLegacyOff=Yes Enable the USB Legacy fix (default: disabled).
92 ForceHPET=Yes|No Force Enable HPET (default: disabled).
93 Wake=No Disable wake up after hibernation (default: enabled).
94 ForceWake=Yes Force using the sleepimage (default: disabled).
95 WakeImage=<file> Use an alternate sleepimage file.
96 (default: /private/var/vm/sleepimage).
97 UpdateACPI=Yes Upgrade automatically ACPI V1 tables to ACPI V4 tables.
98 Drop<file>=Yes Skip:[SSDT, HPET, SLIC, SBST, ECDT, ASF! or DMAR]
99 oem<file>=Yes oem:[DSDT, SSDT, HPET, SBST, ECDT, ASF!, DMAR, APIC or MCFG]
100 DSDT=<file> Use an alternate DSDT.aml file
101 SSDT=<file> Use alternative SSDT_X.aml
102 HPET=<file> Use an alternate HPET.aml file
103 SBST=<file> Use an alternate SBST.aml file
104 ECDT=<file> Use an alternate ECDT.aml file
105 ASFT=<file> Use an alternate ASFT.aml file
106 DMAR=<file> Use an alternate DMAR.aml file
107 APIC=<file> Use an alternate APIC.aml file
108 MCFG=<file> Use an alternate MCFG.aml file
109 FADT=<file> Use an alternate FADT.aml file
110 SMBIOS=<file> Use an alternate SMBIOS.plist file
111 SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding.
112 If smbios.plist doesn't exist, factory values are kept.
113 "Scan Single Drive"=Yes Omly scan the drive from which the booter got loaded.
114 Fixes rescan-problems (DVD reader in AHCI mode).
115 Rescan=Yes Enable CD-ROM rescan mode.
116 "Rescan Prompt"=Yes Prompt for enabling CD-ROM rescan mode.
117 SystemId=<UUID> Set the system id manually to UUID.
118 SMUUID in smbios config (reserved field) isn't used then.
119 SystemType=<n> Set the system type to n, where n is between 0..6
120 (default: Desktop)
121 md0=<file> Load raw img file into memory for use as XNU's md0
122 ramdisk. /Extra/Postboot.img is used otherwise.
123 UseMemDetect=No Disable Automatic memory detection (default: Yes).
124 GeneratePStates=Yes Automatically generate supported CPU P-States (default: disabled).
125 GenerateCStates=Yes Automatically generate supported CPU C-States (default: disabled).
126 EnableC2State=Yes Add C2 and lower supported states to _CST section (default: disabled).
127 EnableC3State=Yes Add C3 and lower supported states to _CST section (default: disabled).
128 EnableC4State=Yes Add C4 and lower supported states to _CST section (default: disabled).
129 EnableC6State=Yes Add C6 and lower supported states to _CST section (default: disabled).
130 PStates=<value> Maximum number of P-States to generate (default: all);
131 e.g.: 8 to generate the 8 highest Frequency states only.
132 PStart=<value> The highest Frequency state to start from (default: 0);
133 e.g.: 1 to start from P1.
134
135Overclocking Options: (To use with CAUTION!)
136--------------------------------------------
137 FixFSB=Yes Automatically correct erroneous FSB frequency (default: No).
138 busratio=<value> Alter bus ratio - e.g.: 8.5 (default: auto).
139 ForceFSB=<value> Alter FSB frequency - e.g.: 266 (default: auto).
140 minVolt=<value> Under-volt the processor to the specified value (mVolt);
141 e.g.: 1100 for 1.1 V
142 maxVolt=<value> Over-volt the processor to the specified value (mVolt);
143 e.g.: 750 for 0.75 V
144 moreVolt=<value> how much mVolts to add to each step;
145 e.g.: 20 for getting additional 0.02 V for each CPU state
146 lessVolt=<value> how much mVolts to take-out from each step;
147 e.g.: 10 to substract 0.0.1 V from each CPU state
148

Archive Download this file

Revision: 661