1===============================================================================
2
3OpenHackWare started as a tiny BIOS that I wrote to launch Linux
4under Qemu-PPC for PREP emulation.
5Then I merged some work I some times ago, which was able to emulate
6some OpenFirmware functionalities to be able to launch some other
7Linux kernels.
8I then tried to improve it to be able to launch MacOSX.
9
10It's released under the GNU General Public License version 2
11
12===============================================================================
13STATUS:
14PowerMac emulation:
15* Linux:
16 - Debian:
17  x 3.0-r1:
18    install & install_safe crash at startup
19    install24 & install24_safe boot but installer crashes.
20  x same goes for 3.0-r4.
21  x same goes for woody.
22  x sarge_netinstall installs with some limitations:
23    if you don't have a DHCP server, expert installation type is needed
24    linux 2.6 framebuffer driver is buggy, so you'd better use a 2.4 kernel
25    top is buggy: it complains it can't read /proc/stat
26     => this seems to be a known propcps bug:
27        "old" top used with recent kernels misunderstand "/proc/stat" format.
28    mol does not display anything
29   + of course, Power3 & Power4 install crashes (unsupported opcodes).
30 - Gentoo:
31  x 1.2-r1 ISO CDROM boots and runs
32  x 1.4.1 live CDROM boots with no problem.
33  x 2004.1 & 2004.3 CROMs use Linux 2.6, then have frame-buffer problems.
34 - Mandrake
35  x 9.1 boots and installer starts
36    Seems to get stuck during some hardware probe
37  x 10.1 starts booting, using 2.6 kernel.
38    Seems to get stuck somewhere inside the kernel.
39  x 10.2 acts the same way.
40 - crux
41  x 1.3 boot but crashes: looks like an i386-only ISOFS bootable CDROM.
42  x 1.3.1 uses Linux 2.6. I guess I'm stuck during hardware probe or
43    it panics.
44  x 2.0 seems to react the same way as 1.3.1.
45 - knoppix
46  x 2003-07-13_4 boots but does not detect the hardware the right way:
47    it wants to use the VESA driver for X. If you are patient,
48    after a few tries, it will fallback to fbdev driver.
49    But then, the mouse is broken (uses the Microsoft serial protocol)
50    and the keyboard is set to german.
51  x k-mib-ppc-beta uses 2.6 kernel.
52 - gnoppix hoary boots kernel 2.6, then framebuffer is buggy
53   (colors are broken: should detect 15 bpp fb, but uses 16 bpp).
54 - sysrescue boots kernel 2.6 so framebuffer is buggy
55   (no output but the penguin).
56 - Fedora Core 3 uses 2.6 kernel then ...
57   ... seems to stay stuck into a small infinite loop inside the kernel.
58 - Fedora Core 4 does the same.
59 - unbuntu does not load: we don't find any bootable file on the HFS partition.
60 - yellow dog 4.0 boots with 2.6 kernel.
61 - rock linux: it boots and installs. Unfortunatelly, there seem to be some
62   bugs in this distribution: I did select the minimal installation,
63   then it forgot the "hfsutils" package and so yaboot did not install itself.
64* NetBSD:
65 - 1.5.2 fails to boot.
66 - 1.6.1, 1.6.2 & 2.0 boot-loader loads but stops
67  (missing available memory property).
68* OpenBSD:
69 - boot-loader cannot run because it's a gzipped ELF file.
70  (tried 3.4, 3.5 & 3.6 macppc CDROMs).
71* Darwin:
72 - Darwin 7.01 and gnuDarwin 2.3 beta dont run: boot-loader crashes:
73   seems to rely on special values in registers (or entry point is false...).
74   looks like Mach-O embedded in XCOFF (?).
75 - Darwin 6.02 and OpenDarwin 6.6.1, 6.6.2 & 20030212 load
76   but seem not to like the OF tree as it's shown then crash.
77 - Darwin 1.41, MacOS X 10.2 & gnuDarwin 2.3 boot
78   but fail to mount the boot device. Seems related to the OF tree.
79 - gnuDarwin 7.01 does not boot at all (cannot find the boot file).
80 - OpenDarwin 7.2.1 does not boot (no boot partition found).
81* MacOS:
82 - Mac OS X 10.2: fails to mount its root device.
83 - Mac OS X 10.3 crashes:
84   seems to try to use Altivec instructions. As my CDROM is one for G5,
85   this may be normal.
86 - Mac OS 9.2 installation CDROM starts to load then crashes.
87 - Ibook Restore CDROM loads & starts booting but crashes
88 - Ibook OS Restore CDROM does not boot (Mac OS X 10.2):
89   does not find any boot partition.
90 - Ibook hw check CDROM boots but crashes:
91   boot loader need its relocations to be resolved by OHW.
92 - IMac G5 hw check CDROM does not boot:
93   OHW is unable to find any boot file in the boot directory.
94* BeOS:
95 - not tested for now. Should not load, as fs may be ISOFS.
96
97PREP emulation:
98* Linux:
99 XXX: to be completed
100* Windows NT 4:
101 - XCoff file loader merges to be done for Microsoft format to be understood.
102* AIX:
103 - The PREP boot image is well located at startup but it seems there are
104   "magic" values to put in registers. Then, for now, it crashes.
105   Seeking for informations about this executable format (starting with
106   "AIXM").
107   Tested 4.3.3 and 5.1. I don't even know if they would run on a real PREP ;-)
108
109CHRP emulation:
110 TODO (no support in qemu).
111
112MVME emulation:
113 TODO (no support in qemu).
114
115Pegasos emulation:
116 TODO (no support in qemu).
117
118===============================================================================
119
120Known problems:
121
122---
123RedHat make 3.79 is fully buggy. You may have several problems trying to build
124OpenHackWare using it. You'd better update to make 3.80 or recompile it from
125regular sources (ie not RedHat sources). Please don't complain if you aren't
126able to build the BIOS using this package.
127
128===============================================================================
129