Chameleon

Chameleon Svn Source Tree

Root/branches/valv/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 boot configuration file)
19
20 keystrokes :
21 F8 Abort quiet mode, and display the menu.
22 alt+f Old safe mode
23 shift+f Ignore boot configuration file
24 alt+s Single user mode
25 alt+v Verbose
26 alt+x Safe mode
27 alt+l Legacy mode (not sure why you need this)
28 6+4 64-bit
29 3+2 32-bit
30
31 "Graphics Mode"="WIDTHxHEIGHTxDEPTH" (e.g. "1024x768x32")
32
33 kernel flags (e.g. debug=0x144)
34 io=0xffffffff (defined in IOKit/IOKitDebug.h)
35
36Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="1920x1200x32"
37
38If the computer won't start up properly, you may be able to start it up
39using safe mode. Type -x to start up in safe mode, which ignores all
40cached driver files.
41
42Special booter hotkeys:
43 F5 Rescans optical drive.
44 F10 Scans and displays all BIOS accessible drives.
45
46Special booter commands:
47 ?memory Displays information about the computer's memory.
48 ?video Displays VESA video modes supported by the computer's BIOS.
49 ?norescan Leaves optical drive rescan mode.
50
51Additional useful command-line options:
52 config=<file> Use an alternate Boot.plist file.
53
54Options useful in the com.apple.Boot.plist file:
55 Wait=Yes|No Prompt for a key press before starting the kernel.
56 "Quiet Boot"=Yes|No Use quiet boot mode (no messages or prompt).
57 Timeout=8 Number of seconds to pause at the boot: prompt.
58 "Instant Menu"=Yes Force displaying the partition selection menu.
59
60 "Default Partition" Sets the default boot partition,
61 =hd(x,y) where 'x' & 'y' are the disk and partition numbers.
62 "Hide Partition" Remove unwanted partition(s) from the boot menu.
63 =hd(x,y) [hd(m,n)] only non mac osx boot partitions can be hidden.
64
65 "Rename Partition" Rename partition(s) for the boot menu.
66 =hd(x,y) <alias> [;hd(m,n) <alias2> ...]
67
68 GUI=No Disable the GUI (enabled by default).
69 "Boot Banner"=Yes|No Show boot banner in GUI mode (enabled by default).
70 "Legacy Logo"=Yes|No Use the legacy grey apple logo (disabled by default).
71
72 PciRoot=<value> Use an alternate value for PciRoot (default value 0).
73
74 GraphicsEnabler=Yes|No Automatic device-properties generation for gfx cards.
75 UseAtiROM=Yes|No Use an alternate Ati ROM image
76 (path: /Extra/<vendorid>_<devid>.rom)
77 UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image
78 (path: /Extra/<vendorid>_<devid>.rom)
79 VBIOS=Yes|No Inject VBIOS to device-properties.
80
81 EthernetBuiltIn=Yes|No Automatic "built-in"=yes device-properties generation
82 for ethernet interfaces.
83
84 USBBusFix=Yes Enable the EHCI and UHCI fixes (disabled by default).
85 USBLegacyOff=Yes Enable the force USB legacy off fix (disabled by default).
86 EHCIacquire=Yes Enable the EHCI fix (disabled by default).
87 UHCIreset=Yes Enable the UHCI fix (disabled by default).
88 ForceHPET=Yes|No Force Enable HPET.
89
90 Wake=No Disable wake up after hibernation (default: enabled).
91 ForceWake=Yes Force using the sleepimage (disabled by default).
92 WakeImage=<file> Use an alternate sleepimage file.
93 (default path is /private/var/vm/sleepimage).
94
95 UpdateACPI=Yes Upgrade automatically ACPI V1 tables to ACPI V4 tables.
96 DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.
97 DropHPET=Yes Skip the HPET table while relocating the ACPI tables.
98 DropSLIC=Yes Skip the SLIC table while relocating the ACPI tables.
99 DropSBST=Yes Skip the SBST table while relocating the ACPI tables.
100 DropECDT=Yes Skip the ECDT table while relocating the ACPI tables.
101 DropASFT=Yes Skip the ASF! table while relocating the ACPI tables.
102 DropDMAR=Yes Skip the DMAR table while relocating the ACPI tables.
103 oemDSDT=Yes Use the standard DSDT and ACPI tables.
104 oemSSDT=Yes Use the standard SSDT tables.
105 oemHPET=Yes Use the standard HPET table.
106 oemSBST=Yes Use the standard SBST table.
107 oemECDT=Yes Use the standard ECDT table.
108 oemASFT=Yes Use the standard ASF! table.
109 oemDMAR=Yes Use the standard DMAR table.
110 oemAPIC=Yes Use the standard APIC table.
111 oemMCFG=Yes Use the standard MCFG table.
112 DSDT=<file> Use an alternate DSDT.aml file
113 (default path: /DSDT.aml /Extra/DSDT.aml).
114 SSDT=<file_prefix> Use alternative DSDT-X.aml file prefix
115 (default prefix: /SSDT /Extra/SSDT).
116 HPET=<file> Use an alternate HPET.aml file
117 (default path: /HPET.aml /Extra/HPET.aml).
118 SBST=<file> Use an alternate SBST.aml file
119 (default path: /SBST.aml /Extra/SBST.aml).
120 ECDT=<file> Use an alternate ECDT.aml file
121 (default path: /ECDT.aml /Extra/ECDT.aml).
122 ASFT=<file> Use an alternate ASFT.aml file
123 (default path: /ASFT.aml /Extra/ASFT.aml).
124 DMAR=<file> Use an alternate DMAR.aml file
125 (default path: /DMAR.aml /Extra/DMAR.aml).
126 APIC=<file> Use an alternate APIC.aml file
127 (default path: /APIC.aml /Extra/APIC.aml).
128 MCFG=<file> Use an alternate MCFG.aml file
129 (default path: /MCFG.aml /Extra/MCFG.aml).
130 FADT=<file> Use an alternate FADT.aml file
131 (default path: /FADT.aml /Extra/FADT.aml).
132
133 SMBIOS=<file> Use an alternate smbios.plist file
134 (default path: /smbios.plist /Extra/smbios.plist
135 bt(0,0)/Extra/smbios.plist).
136
137 SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding
138 if smbios.plist doesn't exist, factory
139 values are kept.
140
141 "Scan Single Drive" Scan the drive only where the booter got loaded from.
142 =Yes|No Fix rescan pbs when using a DVD reader in AHCI mode.
143 Rescan=Yes Enable CD-ROM rescan mode.
144 "Rescan Prompt"=Yes Prompts for enable CD-ROM rescan mode.
145 SystemId=<UUID> Set manually the system id UUID,
146 SMUUID in smbios config (reserved field) isn't used.
147 SystemType=<n> Set the system type where n is between 0..6
148 (default =1 (Desktop)
149

Archive Download this file

Revision: 171