README

   1 ===============================================================================
   2
   3 OpenHackWare started as a tiny BIOS that I wrote to launch Linux
   4 under Qemu-PPC for PREP emulation.
   5 Then I merged some work I some times ago, which was able to emulate
   6 some OpenFirmware functionalities to be able to launch some other
   7 Linux kernels.
   8 I then tried to improve it to be able to launch MacOSX.
   9
  10 It's released under the GNU General Public License version 2
  11
  12 ===============================================================================
  13 STATUS:
  14 PowerMac 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
  97 PREP 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
 109 CHRP emulation:
 110  TODO (no support in qemu).
 111
 112 MVME emulation:
 113  TODO (no support in qemu).
 114
 115 Pegasos emulation:
 116  TODO (no support in qemu).
 117
 118 ===============================================================================
 119
 120 Known problems:
 121
 122 ---
 123 RedHat make 3.79 is fully buggy. You may have several problems trying to build
 124 OpenHackWare using it. You'd better update to make 3.80 or recompile it from
 125 regular sources (ie not RedHat sources). Please don't complain if you aren't
 126 able to build the BIOS using this package.
 127
 128 ===============================================================================