1 | TODO:␊ |
2 | - add TAB, change between textmode/gui??␊ |
3 | - add ramdisk stuff␊ |
4 | ␊ |
5 | The boot: prompt waits for you to type advanced startup options.␊ |
6 | If you don't type anything, the computer continues starting up normally. It␊ |
7 | uses the kernel and configuration files on the startup device, which it also␊ |
8 | uses as the root device. ␊ |
9 | ␊ |
10 | Advanced startup options use the following syntax:␊ |
11 | ␊ |
12 | [device]<kernel> [arguments]␊ |
13 | ␊ |
14 | Example arguments include␊ |
15 | ␊ |
16 | device: rd=<BSD device name> (e.g. rd=disk0s2)␊ |
17 | rd=*<IODeviceTree path> (e.g. rd=*/PCI0@0/CHN0@0/@0:1)␊ |
18 | ␊ |
19 | kernel: kernel name (e.g. "mach_kernel" - must be in "/" )␊ |
20 | ␊ |
21 | flags: -v (verbose) -s (single user mode) -x (safe mode) ␊ |
22 | -F (ignore "Kernel Flags" specified in boot configuration file)␊ |
23 | 32 (i386 arch) -legacy (no 64 bit apps - kernel flag)␊ |
24 | 64 (x86_64 arch)␊ |
25 | ␊ |
26 | "Graphics Mode"="WIDTHxHEIGHTxDEPTH" (e.g. "1024x768x32")␊ |
27 | ␊ |
28 | kernel flags (e.g. debug=0x144)␊ |
29 | io=0xffffffff (defined in IOKit/IOKitDebug.h)␊ |
30 | ␊ |
31 | Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="1920x1200x32"␊ |
32 | ␊ |
33 | If the computer won't start up properly, you may be able to start it up ␊ |
34 | using safe mode. Type -x to start up in safe mode, which ignores all ␊ |
35 | cached driver files.␊ |
36 | ␊ |
37 | Special booter hotkeys:␊ |
38 | F5 Rescans optical drive.␊ |
39 | F10 Scans and displays all BIOS accessible drives.␊ |
40 | ␊ |
41 | Special booter commands:␊ |
42 | ?memory Displays information about the computer's memory.␊ |
43 | ?video Displays VESA video modes supported by the computer's BIOS.␊ |
44 | ?norescan Leaves optical drive rescan mode.␊ |
45 | ␊ |
46 | Additional useful command-line options:␊ |
47 | config=<file> Use an alternate Boot.plist file.␊ |
48 | kext=<folder> Use an alternate folder with drivers, kext or mkext.␊ |
49 | ␊ |
50 | Options useful in the com.apple.Boot.plist file:␊ |
51 | Wait=Yes|No Prompt for a key press before starting the kernel.␊ |
52 | Quiet Boot=Yes|No Use quiet boot mode (no messages or prompt).␊ |
53 | Timeout=8 Number of seconds to pause at the boot: prompt.␊ |
54 | Instant Menu=Yes Force displaying the partition selection menu. ␊ |
55 | ␊ |
56 | Default Partition Sets the default boot partition,␊ |
57 | =hd(x,y)| where 'x' & 'y' are the disk and partition numbers␊ |
58 | =<UUID> or specify the selected volume UUID string.␊ |
59 | Hide Partition Remove unwanted partition(s) from the boot menu.␊ |
60 | =hd(x,y) [hd(m,n)] only non mac osx boot partitions can be hidden.␊ |
61 | ␊ |
62 | Rename Partition Rename partition(s) for the boot menu.␊ |
63 | =hd(x,y) <alias> [;hd(m,n) <alias2> ...]␊ |
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 | Legacy Logo=Yes|No Use the legacy grey apple logo (disabled by default).␊ |
68 | ␊ |
69 | PciRoot=<value> Use an alternate value for PciRoot (default value 0).␊ |
70 | ␊ |
71 | GraphicsEnabler=Yes|No Automatic device-properties generation for gfx cards.␊ |
72 | UseAtiROM=Yes|No Use an alternate Ati ROM image ␊ |
73 | (path: /Extra/<vendorid>_<devid>.rom)␊ |
74 | UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image ␊ |
75 | (path: /Extra/<vendorid>_<devid>.rom)␊ |
76 | VBIOS=Yes|No Inject VBIOS to device-properties.␊ |
77 | ␊ |
78 | EthernetBuiltIn=Yes|No Automatic "built-in"=yes device-properties generation␊ |
79 | for ethernet interfaces.␊ |
80 | ␊ |
81 | USBBusFix=Yes Enable all USB fixes below:␊ |
82 | EHCIacquire=Yes Enable the EHCI fix (disabled by default).␊ |
83 | UHCIreset=Yes Enable the UHCI fix (disabled by default).␊ |
84 | USBLegacyOff=Yes Enable the USB Legacy fix (disabled by default).␊ |
85 | ␊ |
86 | ForceHPET=Yes|No Force Enable HPET.␊ |
87 | ␊ |
88 | Wake=No Disable wake up after hibernation (default: enabled).␊ |
89 | ForceWake=Yes Force using the sleepimage (disabled by default).␊ |
90 | WakeImage=<file> Use an alternate sleepimage file. ␊ |
91 | (default path is /private/var/vm/sleepimage).␊ |
92 | ␊ |
93 | DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.␊ |
94 | DSDT=<file> Use an alternate DSDT.aml file ␊ |
95 | (default path: /DSDT.aml /Extra/DSDT.aml).␊ |
96 | ␊ |
97 | SMBIOS=<file> Use an alternate smbios.plist file ␊ |
98 | (default path: /smbios.plist /Extra/smbios.plist␊ |
99 | bt(0,0)/Extra/smbios.plist).␊ |
100 | ␊ |
101 | SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding␊ |
102 | if smbios.plist doesn't exist, factory␊ |
103 | values are kept.␊ |
104 | ␊ |
105 | Scan Single Drive Scan the drive only where the booter got loaded from.␊ |
106 | =Yes|No Fix rescan pbs when using a DVD reader in AHCI mode. ␊ |
107 | Rescan=Yes Enable CD-ROM rescan mode.␊ |
108 | Rescan Prompt=Yes Prompts for enable CD-ROM rescan mode.␊ |
109 | SystemId=<UUID> Set manually the system id UUID,␊ |
110 | SMUUID in smbios config (reserved field) isn't used.␊ |
111 | SystemType=<n> Set the system type where n is between 0..6␊ |
112 | (default =1 (Desktop)␊ |
113 | md0=<file> Load raw img file into memory for use as XNU's md0␊ |
114 | ramdisk. /Extra/Postboot.img is used otherwise.␊ |
115 | |