Chameleon

Chameleon Svn Source Tree

Root/branches/meklort/doc/BootHelp.txt

Source at commit 335 created 13 years 9 months ago.
By azimutz, Ok, this were the fun stops :) - two keys to do the same thing, two keys to remember... thought it was a good idea to merge the best of the two, the educational side of arch=i386 + the practical one of -x32. And while i'm at it, why not make it even more practical!? Typing just 32 to get i386 arch. - -legacy kernel flag was not being passed on 10.6.x; the reason why is on the kernel code, Legacy mode is only available when i386 arch is specified (makes sense). So, while testing Meklort's kernel patcher, i felt the need to add the key. -legacy flag, sets i386 arch on the booter side & Legacy mode on the kernel side. - and how do we override the last two if they are flagged on Boot.plist? Typing just 64 to get x86_64 arch. - changed the code so x86_64 arch becomes default, seems more natural. And also added these flags to 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
28using safe mode. Type -x to start up in safe mode, which ignores all
29cached driver 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' & 'y' are the disk and partition numbers.
51 "Hide Partition" Remove unwanted partition(s) from the boot menu.
52 =hd(x,y) [hd(m,n)] only non mac osx boot partitions can be hidden.
53
54 "Rename Partition" Rename partition(s) for the boot menu.
55 =hd(x,y) <alias> [;hd(m,n) <alias2> ...]
56
57 GUI=No Disable the GUI (enabled by default).
58 "Boot Banner"=Yes|No Show boot banner in GUI mode (enabled by default).
59 "Legacy Logo"=Yes|No Use the legacy grey apple logo (disabled by default).
60
61 PciRoot=<value> Use an alternate value for PciRoot (default value 0).
62
63 GraphicsEnabler=Yes|No Automatic device-properties generation for gfx cards.
64 UseAtiROM=Yes|No Use an alternate Ati ROM image
65 (path: /Extra/<vendorid>_<devid>.rom)
66 UseNvidiaROM=Yes|No Use an alternate Nvidia ROM image
67 (path: /Extra/<vendorid>_<devid>.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
73 USBBusFix=Yes Enable the EHCI and UHCI fixes (disabled by default).
74 EHCIacquire=Yes Enable the EHCI fix (disabled by default).
75 UHCIreset=Yes Enable the UHCI fix (disabled by default).
76 ForceHPET=Yes|No Force Enable HPET.
77
78 Wake=No Disable wake up after hibernation (default: enabled).
79 ForceWake=Yes Force using the sleepimage (disabled by default).
80 WakeImage=<file> Use an alternate sleepimage file.
81 (default path is /private/var/vm/sleepimage).
82
83 DropSSDT=Yes Skip the SSDT tables while relocating the ACPI tables.
84 DSDT=<file> Use an alternate DSDT.aml file
85 (default path: /DSDT.aml /Extra/DSDT.aml).
86
87 SMBIOS=<file> Use an alternate smbios.plist file
88 (default path: /smbios.plist /Extra/smbios.plist
89 bt(0,0)/Extra/smbios.plist).
90
91 SMBIOSdefaults=No Don't use the Default values for SMBIOS overriding
92 if smbios.plist doesn't exist, factory
93 values are kept.
94
95 "Scan Single Drive" Scan the drive only where the booter got loaded from.
96 =Yes|No Fix rescan pbs when using a DVD reader in AHCI mode.
97 Rescan=Yes Enable CD-ROM rescan mode.
98 "Rescan Prompt"=Yes Prompts for enable CD-ROM rescan mode.
99 SystemId=<UUID> Set manually the system id UUID,
100 SMUUID in smbios config (reserved field) isn't used.
101 SystemType=<n> Set the system type where n is between 0..6
102 (default =1 (Desktop)
103

Archive Download this file

Revision: 335