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