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	Gavare's eXperimental Emulator -- GXemul 0.3.4
2	==================================================
3
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	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
17
18	Quick start
19	-----------
20
21	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
24	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
27	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
31	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	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