| 1 | The boot: prompt waits for you to type advanced startup options.␊ |
| 2 | If you don't type anything, the computer continues starting up normally. It␊ |
| 3 | uses the kernel and configuration files on the startup device, which it also␊ |
| 4 | uses as the root device. ␊ |
| 5 | ␊ |
| 6 | Advanced startup options use the following syntax:␊ |
| 7 | ␊ |
| 8 | [device]<kernel> [arguments]␊ |
| 9 | ␊ |
| 10 | Example 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 | ␊ |
| 26 | Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="1920x1200x32"␊ |
| 27 | ␊ |
| 28 | If the computer won't start up properly, you may be able to start it up ␊ |
| 29 | using safe mode. Type -x to start up in safe mode, which ignores all ␊ |
| 30 | cached driver files.␊ |
| 31 | ␊ |
| 32 | Special booter hotkeys:␊ |
| 33 | F5 Rescans optical drive.␊ |
| 34 | F10 Scans and displays all BIOS accessible drives.␊ |
| 35 | ␊ |
| 36 | Special booter commands:␊ |
| 37 | ?memory Displays information about the computer's memory.␊ |
| 38 | ?video Displays VESA video modes supported by the computer's BIOS.␊ |
| 39 | ?norescan Leaves optical drive rescan mode.␊ |
| 40 | ␊ |
| 41 | Additional useful command-line options:␊ |
| 42 | config=<file> Use an alternate Boot.plist file.␊ |
| 43 | ␊ |
| 44 | Options useful in the com.apple.Boot.plist file:␊ |
| 45 | Wait=Yes|No Prompt for a key press before starting the kernel.␊ |
| 46 | "Quiet Boot"=Yes|No Use quiet boot mode (no messages or prompt).␊ |
| 47 | Timeout=8 Number of seconds to pause at the boot: prompt.␊ |
| 48 | "Instant Menu"=Yes Force displaying the partition selection menu. ␊ |
| 49 | ␊ |
| 50 | "Default Partition" Sets the default boot partition,␊ |
| 51 | =hd(x,y)|UUID|"Label" Specified as a disk/partition pair, an UUID, or a ␊ |
| 52 | label enclosed in quotes.␊ |
| 53 | ␊ |
| 54 | "Hide Partition" Remove unwanted partition(s) from the boot menu.␊ |
| 55 | =partition Specified, possibly multiple times, as hd(x,y), an␊ |
| 56 | [;partition2 ...] UUID or label enclosed in quotes.␊ |
| 57 | ␊ |
| 58 | "Rename Partition" Rename partition(s) for the boot menu.␊ |
| 59 | =partition <alias> Where partition is hd(x,y), UUID or label enclosed␊ |
| 60 | [;partition2 <alias2> in quotes. The alias can optionally be quoted too. ␊ |
| 61 | ...]␊ |
| 62 | ␊ |
| 63 | GUI=No Disable the GUI (enabled by default).␊ |
| 64 | "Boot Banner"=Yes|No Show boot banner in GUI mode (enabled by default).␊ |
| 65 | "Legacy Logo"=Yes|No Use the legacy grey apple logo (disabled by default).␊ |
| 66 | ␊ |
| 67 | PciRoot=<value> Use an alternate value for PciRoot (default value 0).␊ |
| 68 | ␊ |
| 69 | GraphicsEnabler=Yes|No Automatic device-properties generation for gfx cards.␊ |
| 70 | UseAtiROM=Yes|No Use an alternate Ati ROM image ␊ |
| 71 | (path: /Extra/<vendorid>_<devid>.rom)␊ |
| 72 | UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image ␊ |
| 73 | (path: /Extra/<vendorid>_<devid>.rom)␊ |
| 74 | VBIOS=Yes|No Inject VBIOS to device-properties.␊ |
| 75 | ␊ |
| 76 | EthernetBuiltIn=Yes|No Automatic "built-in"=yes device-properties generation␊ |
| 77 | for ethernet interfaces.␊ |
| 78 | ␊ |
| 79 | USBBusFix=Yes Enable all USB fixes below:␊ |
| 80 | EHCIacquire=Yes Enable the EHCI fix (disabled by default).␊ |
| 81 | UHCIreset=Yes Enable the UHCI fix (disabled by default).␊ |
| 82 | USBLegacyOff=Yes Enable the USB Legacy fix (disabled by default).␊ |
| 83 | ␊ |
| 84 | ForceHPET=Yes|No Force Enable HPET.␊ |
| 85 | ␊ |
| 86 | Wake=No Disable wake up after hibernation (default: enabled).␊ |
| 87 | ForceWake=Yes Force using the sleepimage (disabled by default).␊ |
| 88 | WakeImage=<file> Use an alternate sleepimage file. ␊ |
| 89 | (default path is /private/var/vm/sleepimage).␊ |
| 90 | ␊ |
| 91 | DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.␊ |
| 92 | DSDT=<file> Use an alternate DSDT.aml file ␊ |
| 93 | (default paths:␊ |
| 94 | /DSDT.aml /Extra/DSDT.aml bt(0,0)/Extra/DSDT.aml).␊ |
| 95 | ␊ |
| 96 | GenerateCStates=Yes Enable auto generation of Processor (C-States) and/or␊ |
| 97 | GeneratePStates=Yes Performance (P-States) power states.␊ |
| 98 | ␊ |
| 99 | EnableC2State=Yes Enable specific Processor power states, C2,␊ |
| 100 | EnableC3State=Yes C3␊ |
| 101 | EnableC4State=Yes and C4.␊ |
| 102 | ␊ |
| 103 | SMBIOS=<file> Use an alternate SMBIOS.plist file ␊ |
| 104 | (default paths:␊ |
| 105 | /Extra/SMBIOS.plist bt(0,0)/Extra/SMBIOS.plist).␊ |
| 106 | ␊ |
| 107 | SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding␊ |
| 108 | if smbios.plist doesn't exist, factory␊ |
| 109 | values are kept.␊ |
| 110 | ␊ |
| 111 | "Scan Single Drive" Scan the drive only where the booter got loaded from.␊ |
| 112 | =Yes|No Fix rescan pbs when using a DVD reader in AHCI mode. ␊ |
| 113 | Rescan=Yes Enable CD-ROM rescan mode.␊ |
| 114 | "Rescan Prompt"=Yes Prompts for enable CD-ROM rescan mode.␊ |
| 115 | SystemId=<UUID> Set manually the system id UUID,␊ |
| 116 | SMUUID in smbios config (reserved field) isn't used.␊ |
| 117 | SystemType=<n> Set the system type where n is between 0..6␊ |
| 118 | (default =1 (Desktop)␊ |
| 119 | md0=<file> Load raw img file into memory for use as XNU's md0␊ |
| 120 | ramdisk. /Extra/Postboot.img is used otherwise.␊ |
| 121 | |
