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 36 - (show annotations)
Mon Oct 8 16:21:34 2007 UTC (14 years, 1 month ago) by dpavlin
File size: 3329 byte(s)
++ trunk/HISTORY	(local)
$Id: HISTORY,v 1.1497 2007/03/18 03:41:36 debug Exp $
20070224	Minor update to the initialization of the ns16550 in
		machine_walnut.c, to allow that machine type to boot with the
		new interrupt system (although it is still a dummy machine).
		Adding a wdc at 0x14000000 to machine_landisk.c, and fixing
		the SCIF serial interrupts of the SH4 cpu enough to get
		NetBSD/landisk booting from a disk image :-)  Adding a
		preliminary install instruction skeleton to guestoses.html.
20070306	Adding SH-IPL+G PROM emulation, and also passing the "end"
		symbol in r5 on bootup, for Landisk emulation. This is enough
		to get OpenBSD/landisk to install :)  Adding a preliminary
		install instruction skeleton to the documentation. SuperH
		emulation is still shaky, though :-/
20070307	Fixed a strangeness in memory_sh.c (read/write was never
		returned for any page). (Unknown whether this fixes any actual
		problems, though.)
20070308	dev_ram.c fix: invalidate code translations on writes to
		RAM, emulated as separate devices. Linux/dreamcast gets
		further in the boot process than before, but still bugs out
		in userland.
		Fixing bugs in the "stc.l gbr,@-rN" and "ldc.l @rN+,gbr" SuperH 
		instructions (they should NOT check the MD bit), allowing the
		Linux/dreamcast Live CD to reach userland correctly :-)
20070310	Changing the cpu name "Alpha" in src/useremul.c to "21364" to
		unbreak userland syscall emulation of FreeBSD/Alpha binaries.
20070314	Applying a patch from Michael Yaroslavtsev which fixes the
		previous Linux lib64 patch to the configure script.
20070315	Adding a (dummy) sun4v machine type, and SPARC T1 cpu type.
20070316	Creating a new directory, src/disk, and moving diskimage.c
		to it. Separating out bootblock loading stuff from emul.c into
		new files in src/disk.
		Adding some more SPARC registers.
20070318	Preparing/testing for a minirelease,

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

1 Gavare's eXperimental Emulator -- GXemul
2 ====================================================
4 Copyright (C) 2003-2007 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, SuperH) are emulated using dynamic
16 translation. Unlike some other dynamically translating emulators, GXemul
17 does not need to generate native code, only a "runnable intermediate
18 representation", and will thus run on any host architecture.
20 The documentation lists the machines and guest operating systems that can
21 be regarded as "working" in GXemul. The best working guest operating
22 systems are probably NetBSD/pmax and NetBSD/cats.
24 Possible uses of the emulator include:
26 o) educational purposes, e.g. to learn how to write code for MIPS
28 o) hobby operating system development; the emulator can be used as a
29 complement to testing your code on real hardware
31 o) running guest operating systems in a "sandboxed" environment
33 o) compiling your source code inside a guest operating system which you
34 otherwise would not have access to (e.g. various exotic ports of
35 NetBSD), to make sure that your source code is portable to those
36 platforms
38 o) simulating (ethernet) networks of computers running various
39 operating systems, to study their interaction with each other
41 o) debugging code in general
43 Use your imagination :-)
46 GXemul's limitations
47 --------------------
49 o) GXemul is not (in general) a cycle-accurate simulator, because it does
50 not simulate things smaller than an instruction. Pipe-line stalls,
51 instruction latency effects etc. are more or less completely ignored.
53 o) Hardware devices have been implemented in an ad-hoc and as-needed
54 manner, usually only enough to fool certain guest operating systems
55 (e.g. NetBSD) that the hardware devices exist and function well
56 enough for those guest operating systems to use them.
58 A consequence of this is that a machine mode may be implemented well
59 enough to run NetBSD for that machine mode, but other guest operating
60 systems may not run at all, or behave strangely.
63 Quick start
64 -----------
66 To compile, type './configure' and then 'make'. This should work on most
67 Unix-like systems. If it does not, then please mail me a bug report.
69 You might want to experiment with various CC and CFLAGS environment
70 variable settings, to get optimum performance.
72 If you are impatient, and want to try out running a guest operating system
73 inside GXemul, read this: doc/guestoses.html#netbsdcatsinstall
75 If you want to use GXemul for experimenting with code of your own,
76 then I suggest you compile a Hello World program according to the tips
77 listed here: doc/experiments.html#hello
79 Please read the rest of the documentation in the doc/ sub-directory for
80 more detailed information on how to use the emulator.
83 Feedback
84 --------
86 If you have found GXemul useful in some way, or feel like sending me
87 comments or feedback in general, then mail me at anders(at)gavare.se.

  ViewVC Help
Powered by ViewVC 1.1.26