This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Contents of /trunk/README

Parent Directory Parent Directory | Revision Log Revision Log

Revision 26 - (show annotations)
Mon Oct 8 16:20:10 2007 UTC (13 years, 3 months ago) by dpavlin
File size: 3277 byte(s)
++ trunk/HISTORY	(local)
$Id: HISTORY,v 1.1264 2006/06/25 11:08:04 debug Exp $
20060624	Replacing the error-prone machine type initialization stuff
		with something more reasonable.
		Finally removing the old "cpu_run" kludge; moving around stuff
		in machine.c and emul.c to better suit the dyntrans system.
		Various minor dyntrans cleanups (renaming translate_address to
		translate_v2p, and experimenting with template physpages).
20060625	Removing the speed hack which separated the vph entries into
		two halves (code vs data); things seem a lot more stable now.
		Minor performance hack: R2000/R3000 cache isolation now only
		clears address translations when going into isolation, not
		when going out of it.
		Fixing the MIPS interrupt problems by letting mtc0 immediately
		cause interrupts.

==============  RELEASE  ==============

1 Gavare's eXperimental Emulator -- GXemul
2 ====================================================
4 Copyright (C) 2003-2006 Anders Gavare.
7 Overview -- What is GXemul?
8 -----------------------------
10 GXemul is an experimental instruction-level machine emulator. Several
11 emulation modes are available. In some modes, processors and surrounding
12 hardware components are emulated well enough to let unmodified operating
13 systems (e.g. NetBSD) run as if they were running on a real machine.
15 Processors (ARM, MIPS, PowerPC) are emulated using a kind of dynamic
16 translation system. Performance is somewhere between traditional
17 interpretation and recompilation into native code. However, the dynamic
18 translation system used in GXemul does not (currently) generate native
19 code, and thus does not require platform-specific back-ends. In plain
20 English, this means that the dyntrans system works on any host platform.
22 Possible uses of the emulator include:
24 o) educational purposes, e.g. to learn how to write code for MIPS
26 o) hobby operating system development; the emulator can be used as a
27 complement to testing your code on real hardware
29 o) running guest operating systems in a "sandboxed" environment
31 o) compiling your source code inside a guest operating system which you
32 otherwise would not have access to (e.g. various exotic ports of
33 NetBSD), to make sure that your source code is portable to those
34 platforms
36 o) simulating (ethernet) networks of computers running various
37 operating systems, to study their interaction with each other
39 o) debugging code in general
41 Use your imagination :-)
44 GXemul's limitations
45 --------------------
47 o) GXemul is not (in general) a cycle-accurate simulator, because it does
48 not simulate things smaller than an instruction. Pipe-line stalls,
49 instruction latency effects etc. are more or less completely ignored.
51 o) Hardware devices have been implemented in an ad-hoc and as-needed
52 manner, usually only enough to fool certain guest operating systems
53 (e.g. NetBSD) that the hardware devices exist and function well
54 enough for those guest operating systems to use them.
56 A consequence of this is that a machine mode may be implemented well
57 enough to run NetBSD for that machine mode, but other guest operating
58 systems may not run at all, or behave strangely.
61 Quick start
62 -----------
64 To compile, type './configure' and then 'make'. This should work on most
65 Unix-like systems. If not, then please mail me a bug report.
67 You might want to experiment with various CC and CFLAGS environment
68 variable settings, to get optimum performance.
70 If you are impatient, and want to try out running a guest operating system
71 inside GXemul, read this: doc/guestoses.html#netbsdcatsinstall
73 If you want to use GXemul for experimenting with code of your own,
74 then I suggest you compile a Hello World program according to the tips
75 listed here: doc/experiments.html#hello
77 Please read the rest of the documentation in the doc/ sub-directory for
78 more detailed information on how to use the emulator.
81 Feedback
82 --------
84 If you have found GXemul useful in some way, or feel like sending me
85 comments or feedback in general, then mail me at anders(at)gavare.se.

  ViewVC Help
Powered by ViewVC 1.1.26