
============================================================
                      INSTALLATION
============================================================



1. STANDARD TOOLS
------------------------------------------------------------
Folgende grundlegenden Tools sollten installiert werden, am 
besten die in Klammern angegebenen Versionen
 - gcc        (v4.1.2)
 - binutils   (v2.17)
 - make       (v3.81)
 - subversion (v1.3.2)


2. CHECKOUT
------------------------------------------------------------
Machen Sie ein neues Verzeichnis "Topsy-v3" und checken den Code 
aus dem Repository aus:
  $ mkdir "Topsy-v3"
  $ cd "Topsy-v3"
  $ svn co https://svn.topsy.net:8443/svn/Topsy/Topsy/branches/Topsy-v3_P4/

Der Code ist nun im Unterverzeichnis "Topsy-v3_P4"


3. INSTALLATION DES SIMULATORS
------------------------------------------------------------
Bochs, Qemu und der VMware Player sind alles ia32-PC Emulatoren.
Zum Entwickeln habe ich Bochs verwendet, da er einen eigenen sehr
leistungsfähigen Debugger mitbringt.
Alle Emulatoren sind auf der CD im Verzeichnis "Tools" abgelegt.


3 a) Bochs
------------------------------------------------------------
Auf der CD ist das File bochs-2.3.tar.gz, welches auch von 
http://bochs.sourceforge.net/ heruntergeladen werden kann.
Gehen Sie ins Verzeichnis "Topsy-v3" und entpacken, konfigurieren
und kompilieren Sie bochs:
  $ cd "Topsy-v3"
  $ tar xzf bochs-2.3.tar.gz
  $ cd bochs-2.3
  $ mkdir -p install/pentium
  $ ./configure --enable-cpu-level=6 --enable-mmx --enable-sse=2 --enable-apic --enable-sep --enable-all-optimizations   --with-wx --enable-debugger --enable-disasm --enable-x86-debugger --enable-magic-breakpoints --enable-vbe --enable-idle-hack --with-x11 --enable-fast-function-calls --enable-show-ips --enable-new-pit --prefix="`pwd`"/install/pentium/
  $ make && make install

Weitere Dokumentation zu Bochs:
  http://bochs.sourceforge.net/doc/docbook/


3 b) Qemu
------------------------------------------------------------
Auf der CD ist das File qemu-0.9.0.tar.gz, welches auch von 
http://www.qemu.org/ heruntergeladen werden kann.
Gehen Sie ins Verzeichnis "Topsy-v3" und entpacken, konfigurieren
und kompilieren Sie qemu:
  $ cd "Topsy-v3"
  $ tar xzf qemu-0.9.0.tar.gz
  $ cd qemu-0.9.0
  $ mkdir -p install/pentium
  $ ./configure --prefix="`pwd`"/install/pentium/ --enable-system --target-list=i386-softmmu
  $ make && make install

Weitere Dokumentation zu Qemu:
  http://www.qemu.org/qemu-doc.html


3 c) VMPlayer
------------------------------------------------------------
Für den VMPlayer werden keine speziellen Konfigurations-
Optionen benötigt. Ich empfehle deshalb, den vmplayer über das 
normale Packetmanagement zu installieren.
 Für Gentoo: 
    $ sudo emerge emerge  app-emulation/vmware-player
 Für Ubuntu:
    $ sudo apt-get install vmware-player
 Für alle anderen Distributionen muss das richtige Packet gesucht, 
  oder der vmplayer von http://www.vmware.com/products/player/
  heruntergeladen und gemäss der Anleitung installiert
  werden.
Zudem wird noch das cdrkit (http://cdrkit.org/) benötigt, ich 
verwende die Version 1.1.2. 


3. TOPSY KOMPILIEREN UND STARTEN
------------------------------------------------------------
Wechslen Sie ins Verzeichnis mit dem Source-Code: 
  $ cd Topsy-v3/Topsy-v3_P4/
Kompilieren Topsy und starten Sie Topsy in Ihrem bevorzugten 
Emulator:
  $ make ia32-run 
 oder
  $ make ia32-run-bochs
 oder
  $ make ia32-run-qemu
 oder
  $ make ia32-run-vmplayer




