upstream/0.3.4/README

Gavare's eXperimental Emulator   --   GXemul 0.3.4
==================================================

Copyright (C) 2003-2005  Anders Gavare.


Overview
--------

GXemul is an experimental instruction-level machine emulator. It can be
used to run binary code for (among others) MIPS-based machines, regardless
of host platform. Several emulation modes are available. For some modes,
processors and surrounding hardware components are emulated well enough to
let unmodified operating systems (e.g. NetBSD) run as if they were running
on a real machine.


Quick start
-----------

To compile, type './configure' and then 'make'. This should work on most
Unix-like systems. If not, then please mail me a bug report.

If you are impatient, and want to try out running a guest operating system 
inside GXemul, please read this:  doc/guestoses.html#netbsdinstall

If you want to use GXemul for experimenting with code of your own, 
then I suggest you compile a Hello World program according to the tips 
listed here:  doc/experiments.html#hello

Please read the rest of the documentation in the doc/ sub-directory for
more detailed information on how to use the emulator.


Feedback
--------

If you have found GXemul useful in some way, or feel like sending me
comments or feedback in general, then mail me at anders(at)gavare.se.

1	dpavlin	10	Gavare's eXperimental Emulator -- GXemul 0.3.4
2			==================================================
3	dpavlin	2
4			Copyright (C) 2003-2005 Anders Gavare.
5
6
7			Overview
8			--------
9
10			GXemul is an experimental instruction-level machine emulator. It can be
11	dpavlin	10	used to run binary code for (among others) MIPS-based machines, regardless
12			of host platform. Several emulation modes are available. For some modes,
13			processors and surrounding hardware components are emulated well enough to
14			let unmodified operating systems (e.g. NetBSD) run as if they were running
15			on a real machine.
16	dpavlin	2
17
18			Quick start
19			-----------
20
21	dpavlin	4	To compile, type './configure' and then 'make'. This should work on most
22			Unix-like systems. If not, then please mail me a bug report.
23	dpavlin	2
24	dpavlin	10	If you are impatient, and want to try out running a guest operating system
25			inside GXemul, please read this: doc/guestoses.html#netbsdinstall
26	dpavlin	2
27	dpavlin	10	If you want to use GXemul for experimenting with code of your own,
28			then I suggest you compile a Hello World program according to the tips
29			listed here: doc/experiments.html#hello
30	dpavlin	2
31	dpavlin	10	Please read the rest of the documentation in the doc/ sub-directory for
32			more detailed information on how to use the emulator.
33
34
35	dpavlin	2	Feedback
36			--------
37
38			If you have found GXemul useful in some way, or feel like sending me
39			comments or feedback in general, then mail me at anders(at)gavare.se.
40