| 1 | ␊ |
| 2 | Chameleon Boot Loader␊ |
| 3 | =====================␊ |
| 4 | ␊ |
| 5 | What is it?␊ |
| 6 | -----------␊ |
| 7 | ␊ |
| 8 | Chameleon is combination of various boot loader components. It is based␊ |
| 9 | on David Elliott's fake EFI implementation added to Apple's boot-132␊ |
| 10 | project. Chameleon is extended with the following key features:␊ |
| 11 | ␊ |
| 12 | ␊ |
| 13 | Features␊ |
| 14 | --------␊ |
| 15 | ␊ |
| 16 | - Device Property Injection via device-properties string in com.apple.Boot.plist␊ |
| 17 | - hybrid boot0+boot1h loaders for both MBR and GPT partitioned disks.␊ |
| 18 | - automatic FSB detection code even for recent AMD CPUs.␊ |
| 19 | - Apple Software RAID support.␊ |
| 20 | - stage2 loader (boot) can be placed as a regular file in the boot␊ |
| 21 | partition's root folder.␊ |
| 22 | ␊ |
| 23 | ␊ |
| 24 | Installation␊ |
| 25 | ============␊ |
| 26 | ␊ |
| 27 | Normal Install (non-RAID):␊ |
| 28 | --------------------------␊ |
| 29 | ␊ |
| 30 | Suppose that your installation is on /dev/disk0s2␊ |
| 31 | ␊ |
| 32 | - Install boot0 to the MBR:␊ |
| 33 | ␉␉sudo ./fdisk440 -f boot0 -u -y /dev/rdisk0␊ |
| 34 | ␊ |
| 35 | - Install boot1h to the partition's bootsector:␊ |
| 36 | ␉␉sudo dd if=boot1h of=/dev/rdisk0s2␊ |
| 37 | ␊ |
| 38 | - Install boot to the partition's root directory:␊ |
| 39 | ␉␉sudo cp boot /␊ |
| 40 | ␉␊ |
| 41 | - Install Symbols and modules to the partition's root directory or the partition's booter (if needed): ␊ |
| 42 | ␉␉* Symbols.dylib is absolutely needed if you plan to use any other module, ␊ |
| 43 | ␉␉* otherwise Symbols.dylib is useless, assume that /Extra is already created (if you need special permissions, use sudo)␊ |
| 44 | ␉␉␊ |
| 45 | ␉␉mkdir /Extra/modules␊ |
| 46 | ␉␉cp Symbols.dylib /Extra/modules ␊ |
| 47 | ␉␉cp "Any other module wanted".dylib /Extra/modules␊ |
| 48 | ␉␉␊ |
| 49 | No need to use startupfiletool anymore!␊ |
| 50 | ␊ |
| 51 | ␊ |
| 52 | RAID Install:␊ |
| 53 | -------------␊ |
| 54 | ␊ |
| 55 | Suppose that your installation is on /dev/disk3, which is either a mirror- or a␊ |
| 56 | stripeset consisting of /dev/disk0 and /dev/disk1␊ |
| 57 | ␊ |
| 58 | Mac OS X creates a small helper partition at the end of each RAID member disk,␊ |
| 59 | namely /dev/disk0s3 and /dev/disk1s3␊ |
| 60 | ␊ |
| 61 | - Install boot0 to the MBR of both disks:␊ |
| 62 | ␉␉sudo ./fdisk440 -f boot0 -u -y /dev/rdisk0␊ |
| 63 | ␉␉sudo ./fdisk440 -f boot0 -u -y /dev/rdisk1␊ |
| 64 | ␊ |
| 65 | - Install boot1h to the bootsector of each boot partition:␊ |
| 66 | ␉␉sudo dd if=boot1h of=/dev/rdisk0s3␊ |
| 67 | ␉␉sudo dd if=boot1h of=/dev/rdisk1s3␊ |
| 68 | ␊ |
| 69 | - Install boot to both helper partition's root directories.␊ |
| 70 | ␉␉diskutil mount disk0s3␊ |
| 71 | ␉␉cp boot /Volumes/Boot\ OSX␊ |
| 72 | ␉␉diskutil unmount disk0s3␊ |
| 73 | ␉␉diskutil mount disk1s3␊ |
| 74 | ␉␉cp boot /Volumes/Boot\ OSX␊ |
| 75 | ␉␉diskutil unmount disk1s3␊ |
| 76 | ␊ |
| 77 | Support:␊ |
| 78 | --------␊ |
| 79 | ␊ |
| 80 | If you have any questions, issues etc. feel free to join us␊ |
| 81 | at irc.voodooprojects.org #chameleon␊ |
| 82 | ␊ |
| 83 | ␊ |
| 84 | Source Code␊ |
| 85 | -----------␊ |
| 86 | ␊ |
| 87 | For downloading the source code please visit the project page at␊ |
| 88 | http://chameleon.osx86.hu␊ |
| 89 | ␊ |
| 90 | ␊ |
| 91 | Licensing␊ |
| 92 | ---------␊ |
| 93 | ␊ |
| 94 | Chameleon is released under the terms and conditions of␊ |
| 95 | Apple Public Source License (see APPLE_LICENSE).␊ |
| 96 | |
