Chameleon

Chameleon Svn Source Tree

Root/branches/andyvand/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 "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 using
28safe mode. Type -x to start up in safe mode, which ignores all cached
29driver files.
30
31Special booter hotkeys:
32 F5 Rescans optical drive.
33 F10 Scans and displays all BIOS accessible drives.
34
35Special booter commands:
36 ?memory Displays information about the computer's memory.
37 ?video Displays VESA video modes supported by the computer's BIOS.
38 ?norescan Leaves optical drive rescan mode.
39
40Additional useful command-line options:
41 config=<file> Use an alternate Boot.plist file.
42
43Options useful in the com.apple.Boot.plist file:
44 Wait=Yes|No Prompt for a key press before starting the kernel.
45 "Quiet Boot"=Yes|No Use quiet boot mode (no messages or prompt).
46 Timeout=8 Number of seconds to pause at the boot: prompt.
47 "Instant Menu"=Yes Force displaying the partition selection menu.
48
49 "Default Partition" Sets the default boot partition,
50 =hd(x,y) where 'x' is the disk number, 'y' the partition number.
51 "Hide Partition" Remove unwanted partition(s) from the boot menu.
52 =hd(x,y) [hd(m,n)]
53
54 arch=<i386/x86_64> Force ABI to 32/64 bit and load 32/64 bit kernel.
55 -x32 Enable forcing 32 bit ABI only and load 32 bit kernel.
56 -x64 Enable forcing 64 bit ABI and load 64 bit kernel.
57
58 LoadTestDrivers=Yes|No Enable loading of test drivers from /Test/Extensions(.mkext)
59
60 GUI=No Disable the GUI (enabled by default).
61 "Boot Banner"=Yes|No Show boot banner in GUI mode (enabled by default).
62 "Legacy Logo"=Yes|No Use the legacy grey apple logo (disabled by default).
63
64 PciRoot=<value> Use an alternate value for PciRoot. (default value: 0).
65
66 GraphicsEnabler=Yes|No Automatic device-properties generation for graphics cards.
67 VideoROM=<file> Use an alternate ROM image (default path: /NVIDIA.ROM).
68 VBIOS=Yes|No Inject VBIOS to device-properties.
69
70 EthernetBuiltIn=Yes|No Automatic "built-in"=yes device-properties generation
71 for ethernet interfaces.
72 UpdateACPIVersion=Yes Enable ACPI V1 to ACPI V4 upgrade (disabled by default).
73 FixRestart=Yes Enable the restart fix (disabled by default).
74 ForceHPET=Yes Force HPET on (disabled by default).
75
76 USBBusFix=Yes Enable the EHCI and UHCI fixes (disabled by default).
77 EHCIacquire=Yes Enable the EHCI fix (disabled by default).
78 UHCIreset=Yes Enable the UHCI fix (disabled by default).
79 USBLegacyOff=Yes Force USB Legacy off (disabled by default).
80
81 Wake=No Disable wake up after hibernation (enbaled by default).
82 ForceWake=Yes Force using the sleepimage (disabled by default).
83 WakeImage=<file> Use an alternate sleepimage file
84 (default path is /private/var/vm/sleepimage).
85
86 PMProfile=<0-7> Set preferred power management profile.
87
88 oemDSDT=Yes Use standard DSDT and don't patch ACPI.
89 oemHPET=Yes Use standard HPET table.
90 oemSSDT=Yes Use standard SSDT tables.
91 oemHPET=Yes Use standard HPET table.
92 oemSBST=Yes Use standard SBST table.
93 oemECDT=Yes Use standard ECDT table.
94 oemASFT=Yes Use standard ASF! table.
95 oemDMAR=Yes Use standard DMAR table.
96 oemFADT=Yes Use standard FADT table.
97 oemAPIC=Yes Use standard APIC table.
98 oemMCFG=Yes Use standard MCFG table.
99 DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.
100 DropHPET=Yes Skip the HPET table while relocating the ACPI tables.
101 DropSLIC=Yes Skip the SLIC table while relocating the ACPI tables.
102 DropSBST=Yes Skip the SBST table while relocating the ACPI tables.
103 DropECDT=Yes Skip the ECDT table while relocating the ACPI tables.
104 DropASFT=Yes Skip the ASF! table while relocating the ACPI tables.
105 DropDMAR=Yes Skip the DMAR table while relocating the ACPI tables.
106 DSDT=<file> Use an alternate DSDT.aml file
107 (default path: /DSDT.aml /Extra/DSDT.aml)
108 HPET=<file> Use an alternate HPET.aml file
109 (default path: /HPET.aml /Extra/HPET.aml)
110 SBST=<file> Use an alternate SBST.aml file
111 (default path: /DSDT.aml /Extra/SBST.aml)
112 ECDT=<file> Use an alternate ECDT.aml file
113 (default path: /ECDT.aml /Extra/ECDT.aml)
114 DSDT=<file> Use an alternate DSDT.aml file
115 (default path: /DSDT.aml /Extra/DSDT.aml)
116 ASFT=<file> Use an alternate ASFT.aml file
117 (default path: /ASFT.aml /Extra/ASFT.aml)
118 DMAR=<file> Use an alternate DMAR.aml file
119 (default path: /DMAR.aml /Extra/DMAR.aml)
120 FADT=<file> Use an alternate FADT.aml file
121 (default path: /FADT.aml /Extra/FADT.aml)
122 APIC=<file> Use an alternate APIC.aml file
123 (default path: /APIC.aml /Extra/APIC.aml)
124 MCFG=<file> Use an alternate MCFG.aml file
125 (default path: /MCFG.aml /Extra/MCFG.aml)
126
127 SMBIOS=<file> Use an alternate smbios.plist file
128 (default path: /smbios.plist /Extra/smbios.plist
129 bt(0,0)/Extra/smbios.plist).
130
131 SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding
132 if smbios.plist doesn't exist, factory
133 values are kept.
134
135 "Scan Single Drive" Scan the drive only where the booter got loaded from.
136 =Yes|No Fix rescan issues when using a DVD reader in AHCI mode.
137 Rescan=Yes Enable CD-ROM rescan mode.
138 "Rescan Prompt"=Yes Prompts for enable CD-ROM rescan mode.
139

Archive Download this file

Revision: HEAD