add README describing build process for simulator (gdb ppc)
authorLuke Kenneth Casson Leighton <lkcl@lkcl.net>
Thu, 26 Mar 2020 11:08:29 +0000 (11:08 +0000)
committerLuke Kenneth Casson Leighton <lkcl@lkcl.net>
Thu, 26 Mar 2020 11:08:29 +0000 (11:08 +0000)
README.md

index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..beb32519ccd423cc34d34eb368f95348aac00175 100644 (file)
--- a/README.md
+++ b/README.md
@@ -0,0 +1,21 @@
+# Installation
+
+python3 setup.py develop
+
+# Running Simulator tests
+
+qemu and gdb for Power 64 are required.  qemu can be installed with
+"apt-get install qemu-system-ppc64", however gdb needs compiling from
+source.  Obtain the latest tarball, unpack it, then:
+
+    cd gdb-9.1 (or other location)
+    mkdir build
+     ../configure --srcdir=.. --host=x86_64-linux --target=powerpc64-linux-gnu
+    make -j16
+    make install
+
+You will need to have installed the powerpc gnu gcc cross-compiler for
+this to work:
+
+    apt-get install gcc-9-powerpc64-linux-gnu
+