Commit yaboot 1.3.0
[yaboot.git] / doc / examples / README.simpleboot.chrp
1 This is the old basic ofboot.b wrapper, it has been replaced by a more
2 robust CHRP script that is able to dual or tri-boot GNU/Linux, MacOS,
3 and MacOS X.  See README.ofboot.b for more information.
4
5 OpenFirmware on newworld macs by default searches for HFS partitions
6 with a `blessed' directory, and then checks for a file with an HFS
7 filetype of `tbxi' if found it loads this file. Unfortunately OF is
8 being far to picky about the format of this file, while it will load a
9 ELF executable just fine when directed to, if the tbxi file it finds
10 is just a plain ELF executable, as yaboot is, then it refuses to load
11 it.  
12
13 The best longterm solution is to embed a small CHRP boot script to the
14 head of of the yaboot executable, but until we can find the right way
15 to do that we can use a small wrapper instead. The file included
16 called simple_ofboot.b does nothing more then run the OF command "boot
17 hd:,\\yaboot" which should load the yaboot executable on most machines
18 if you use the stock internal hard disk.  You might have to change
19 that device path (hd:) to match the device path to your bootstrap
20 partition, such as hd:2,\\yaboot.  Or you can dispense with the
21 wrapper altogether and reset the boot-device variable in OF to point
22 directly at the yaboot executable and that will work too.  This
23 wrapper just allows for most (hopefully) machines to boot
24 transparently without any OF reconfiguration.
25
26 If you have G4 hardware then your OpenFirmware may already have a
27 graphical boot selector built in, this selector can be accessed by
28 holding down the option key when booting the machine.  You should see
29 a screen with buttons for each bootable partition.  This version of
30 ofboot.b includes a badge icon, the button with a penguin icon is your
31 bootstrap partition.  If you decide to use this built in selector you
32 really do not need to use the menu_ofboot.b script provided in this
33 package. Thanks to Nicholas Humfrey for creating the Badge icon.
34
35 Hopefully soon these problems will have better solutions at some
36 point. If you happen to know OF well and have any suggestions they are
37 most welcome!