Chameleon

Chameleon Svn Source Tree

Root/branches/azimutz/Chazileon/doc/BootHelp.txt

1TODO:
2- add TAB, change between textmode/gui??
3- add ramdisk stuff
4
5The boot: prompt waits for you to type advanced startup options.
6If you don't type anything, the computer continues starting up normally. It
7uses the kernel and configuration files on the startup device, which it also
8uses as the root device.
9
10Advanced startup options use the following syntax:
11
12 [device]<kernel> [arguments]
13
14Example 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
32Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="1920x1200x32"
33
34If the computer won't start up properly, you may be able to start it up
35using safe mode. Type -x to start up in safe mode, which ignores all
36cached driver files.
37
38Special booter hotkeys:
39 F5 Rescans optical drive.
40 F10 Scans and displays all BIOS accessible drives.
41
42Special 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
47Additional 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
51Options 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)| where 'x' & 'y' are the disk and partition numbers
59 =<UUID> or specify the selected volume UUID string.
60 Hide Partition Remove unwanted partition(s) from the boot menu.
61 =hd(x,y) [hd(m,n)] only non mac osx boot partitions can be hidden.
62
63 Rename Partition Rename partition(s) for the boot menu.
64 =hd(x,y) <alias> [;hd(m,n) <alias2> ...]
65
66 GUI=No Disable the GUI (enabled by default).
67 Boot Banner=Yes|No Show boot banner in GUI mode (enabled by default).
68 Legacy Logo=Yes|No Use the legacy grey apple logo (disabled by default).
69
70 PciRoot=<value> Use an alternate value for PciRoot (default value 0).
71
72 GraphicsEnabler=Yes|No Automatic device-properties generation for gfx cards.
73 UseAtiROM=Yes|No Use an alternate Ati ROM image
74 (path: /Extra/<vendorid>_<devid>.rom)
75 UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image
76 (path: /Extra/<vendorid>_<devid>.rom)
77 VBIOS=Yes|No Inject VBIOS to device-properties.
78
79 EthernetBuiltIn=Yes|No Automatic "built-in"=yes device-properties generation
80 for ethernet interfaces.
81
82 USBBusFix=Yes Enable all USB fixes below:
83 EHCIacquire=Yes Enable the EHCI fix (disabled by default).
84 UHCIreset=Yes Enable the UHCI fix (disabled by default).
85 USBLegacyOff=Yes Enable the USB Legacy fix (disabled by default).
86
87 ForceHPET=Yes|No Force Enable HPET.
88
89 Wake=No Disable wake up after hibernation (default: enabled).
90 ForceWake=Yes Force using the sleepimage (disabled by default).
91 WakeImage=<file> Use an alternate sleepimage file.
92 (default path is /private/var/vm/sleepimage).
93
94 DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.
95 DSDT=<file> Use an alternate DSDT.aml file
96 (default path: /DSDT.aml /Extra/DSDT.aml).
97
98 SMBIOS=<file> Use an alternate smbios.plist file
99 (default path: /smbios.plist /Extra/smbios.plist
100 bt(0,0)/Extra/smbios.plist).
101
102 SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding
103 if smbios.plist doesn't exist, factory
104 values are kept.
105
106 Scan Single Drive Scan the drive only where the booter got loaded from.
107 =Yes|No Fix rescan pbs when using a DVD reader in AHCI mode.
108 Rescan=Yes Enable CD-ROM rescan mode.
109 Rescan Prompt=Yes Prompts for enable CD-ROM rescan mode.
110 SystemId=<UUID> Set manually the system id UUID,
111 SMUUID in smbios config (reserved field) isn't used.
112 SystemType=<n> Set the system type where n is between 0..6
113 (default =1 (Desktop)
114 md0=<file> Load raw img file into memory for use as XNU's md0
115 ramdisk. /Extra/Postboot.img is used otherwise.
116

Archive Download this file

Revision: 403