Chameleon

Chameleon Svn Source Tree

Root/branches/Chimera/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 safe mode.
29Type -x to start up in safe mode, which ignores all cached driver files.
30
31Special booter hotkeys:
32-----------------------
33 F5 Rescans optical drive.
34 F10 Scans and displays all BIOS accessible drives.
35
36Special booter commands:
37------------------------
38 ?memory Displays information about the computer's memory.
39 ?video Displays VESA video modes supported by the computer's BIOS.
40 ?norescan Leaves optical drive rescan mode.
41
42Additional useful command-line options:
43---------------------------------------
44 config=<file> Use an alternate Boot.plist file.
45
46Options useful in the org.chameleon.Boot.plist file:
47----------------------------------------------------
48 Wait=Yes|No Prompt for a key press before starting the kernel.
49 "Quiet Boot"=Yes|No Use quiet boot mode (no messages or prompt).
50 Timeout=8 Number of seconds to pause at the boot: prompt.
51 "Instant Menu"=Yes Force displaying the partition selection menu.
52
53 "Default Partition" Sets the default boot partition,
54 =hd(x,y)|UUID|"Label" Specified as a disk/partition pair, an UUID, or a label enclosed in quotes.
55
56 "Hide Partition" Remove unwanted partition(s) from the boot menu.
57 =partition Specified, possibly multiple times, as hd(x,y), an
58 [;partition2 ...] UUID or label enclosed in quotes.
59
60 "Rename Partition" Rename partition(s) for the boot menu.
61 =partition <alias> Where partition is hd(x,y), UUID or label enclosed
62 [;partition2 <alias2> in quotes. The alias can optionally be quoted too.
63 ...]
64
65 GUI=No Disable the GUI (enabled by default).
66 "Boot Banner"=Yes|No Show boot banner in GUI mode (enabled by default).
67 ShowInfo=No Disables display of partition and resolution details.
68 "Boot Banner"=No will also disable this info.
69 "Legacy Logo"=Yes|No Use the legacy grey apple logo (disabled by default).
70
71 PciRoot=<value> Use an alternate value for PciRoot (default value 0).
72
73 UseKernelCache=Yes|No Yes will load pre-linked kernel and will ignore /E/E and /S/L/E/Extensions.mkext.
74 Default is No but Yes if you use Lion on a Raid partition.
75
76 KeyLayout=keymap Use to change the keyboard mapping of the bootloader
77 (e.g. KeyLayout=mac-fr)
78
79 HDAEnabler=Yes|No Automatic device-properties generation for audio controllers.
80 HDEFLayoutID=<value> Inject alternate value of layout-id for HDEF (HEX).
81 HDAULayoutID=<value> Inject alternate value of layout-id for HDAU (HEX).
82
83 GraphicsEnabler=Yes|No Automatic device-properties generation for graphics cards.
84 IGPlatformID=<value> Override or set Intel HD Graphics Platform ID
85 IGPEnabler=Yes|No Automatic device-properties generation for Intel IGP when GraphicsEnabler=No
86 IGPDeviceID=<value> Override default unsupported device ID injection
87
88 NvidiaGeneric =Yes|No Use the classic Nvidia name for the SystemProfiler (enabled by default).
89 UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image (default path: /Extra/<vendorid>_<devid>.rom)
90 display_0=<value> Inject alternate value of display-cfg into NVDA,Display-A@0 (HEX).
91 display_1=<value> Inject alternate value of display-cfg into NVDA,Display-B@1 (HEX).
92
93 AtiConfig=<cardcfg> Use a different card config, e.g. AtiConfig=Megalodon.
94 AtiPorts=<value> Specify the number of ports, e.g. AtiPorts=2.
95 UseAtiROM=Yes|No Use an alternate Ati ROM image (default path: /Extra/<vendorid>_<devid>_<subsysid>.rom)
96 VBIOS=Yes|No Inject VBIOS to device-properties.
97
98 EnableBacklight=Yes Enable Back light option for NVIDIA and ATI
99 EnableDualLink=Yes Enable DualLink option for NVIDIA and ATI
100 EnableHDMIAudio=Yes Inject HDMI audio for NVIDIA and ATI.
101
102 EthernetBuiltIn=Yes|No Automatic "built-in"=YES device-properties generation for ethernet interfaces.
103 ForceHPET=Yes|No Force HPET on (disabled by default).
104
105 USBBusFix=Yes Enable the EHCI and UHCI fixes (disabled by default).
106 EHCIacquire=Yes Enable the EHCI fix (disabled by default).
107 UHCIreset=Yes Enable the UHCI fix (disabled by default).
108 USBLegacyOff=Yes Force USB Legacy off (disabled by default).
109
110 Wake=No Disable wake up after hibernation (enbaled by default).
111 ForceWake=Yes Force using the sleepimage (disabled by default).
112 WakeImage=<file> Use an alternate sleepimage file
113 (default path is /private/var/vm/sleepimage).
114
115 DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.
116 DSDT=<file> Use an alternate DSDT.aml file
117 (default paths: /DSDT.aml /Extra/DSDT.aml bt(0,0)/Extra/DSDT.aml).
118
119 GenerateCStates=Yes Enable auto generation of processor idle sleep states (C-States).
120 GeneratePStates=Yes Enable auto generation of processor power performance states (P-States).
121 CSTUsingSystemIO=Yes New C-State _CST generation method using SystemIO registers instead of FixedHW.
122
123 EnableC2State=Yes Enable specific Processor power state, C2.
124 EnableC3State=Yes Enable specific Processor power state, C3.
125 EnableC4State=Yes Enable specific Processor power state, C4.
126
127 PrivateData=No Show masked data (serial number) in bdmesg log (enbaled by default).
128
129 ForceFullMemInfo=Yes Force SMBIOS Table 17 to be 27 bytes long (disabled by default).
130
131 SMBIOS=<file> Use an alternate SMBIOS.plist file
132 (default path: /smbios.plist /Extra/smbios.plist
133 bt(0,0)/Extra/smbios.plist).
134
135 SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding if smbios.plist doesn't exist,
136 factory values are kept.
137
138 "Scan Single Drive" Scan the drive only where the booter got loaded from.
139 =Yes|No Fix rescan issues when using a DVD reader in AHCI mode.
140 Rescan=Yes Enable CD-ROM rescan mode.
141 "Rescan Prompt"=Yes Prompts for enable CD-ROM rescan mode.
142 SystemId=<UUID> Set the system id manually to UUID.
143 Deprecated - Now SMsystemuuid in smbios.plist
144 SMUUID in smbios config (reserved field) isn't used then.
145 SystemType=<n> Set the system type to n, where n is between 0..6
146 (default=1 Desktop)
147 md0=<file> Load raw img file into memory for use as XNU's md0
148 ramdisk. /Extra/Postboot.img is used otherwise.
149

Archive Download this file

Revision: 2394