1 |
Release notes for Gavare's eXperimental Emulator (GXemul), 0.3.7 |
Release notes for Gavare's eXperimental Emulator (GXemul), 0.4.0.1 |
2 |
================================================================ |
================================================================== |
3 |
|
|
4 |
Copyright (C) 2003-2005 Anders Gavare. |
Copyright (C) 2003-2006 Anders Gavare. |
5 |
|
|
6 |
|
|
7 |
GXemul is an experimental instruction-level machine emulator. Several |
GXemul is an experimental instruction-level machine emulator. Several |
9 |
hardware components are emulated well enough to let unmodified operating |
hardware components are emulated well enough to let unmodified operating |
10 |
systems (e.g. NetBSD) run as if they were running on a real machine. |
systems (e.g. NetBSD) run as if they were running on a real machine. |
11 |
|
|
12 |
MIPS processors are emulated using either a simple binary translation |
The documentation lists the machines and guest operating systems that can |
13 |
layer ("recompilation"), which is used on Alpha and i386 hosts, or by |
be regarded as "working" in GXemul. The best supported guest operating |
14 |
traditional interpretation (very very slow, but works on any host platform). |
systems are probably NetBSD/pmax, NetBSD/cats, and OpenBSD/cats. |
|
|
|
|
ARM and PowerPC processors are emulated using a newer dynamic translation |
|
|
system. Performance is somewhere between traditional interpretation and |
|
|
dynamic recompilation; however, the dynamic translation system used in |
|
|
GXemul does NOT require platform-specific back-end code. In plain English, |
|
|
this means that the dyntrans system works on any host platform. |
|
|
|
|
|
I have verified that the following "guest" operating systems can run inside |
|
|
the emulator. Instructions on how to install and run these can be found in |
|
|
the documentation. |
|
|
|
|
|
Guest operating system Emulated machine |
|
|
---------------------- ---------------- |
|
|
NetBSD/pmax 2.1 (and 1.6.2) DECstation 5000/200 |
|
|
OpenBSD/pmax 2.8-BETA DECstation 5000/200 |
|
|
Ultrix 4.2-4.5 DECstation 5000/200 |
|
|
Sprite demo harddisk image DECstation 5000/200 |
|
|
Debian GNU/Linux for DECstation DECstation 5000/200 |
|
|
Redhat Linux 7.1 for mips DECstation 5000/200 |
|
|
NetBSD/arc 1.6.2 Acer PICA-61 |
|
|
OpenBSD/arc 2.3 Acer PICA-61 |
|
|
NetBSD/hpcmips 2.1 NEC MobilePro 770, 780, 800, 880 |
|
|
NetBSD/cobalt 2.1 Cobalt |
|
|
NetBSD/evbmips 2.1 Malta 5Kc/4Kc evaluation board |
|
|
NetBSD/sgimips 2.1 SGI O2 ("IP32") |
|
|
NetBSD/cats 2.1 CATS (ARM) |
|
|
OpenBSD/cats 3.8 CATS (ARM) |
|
|
NetBSD/prep 2.1 PReP (PowerPC Reference Platform) |
|
|
|
|
|
Some of these guest operating systems are easier to install and run than |
|
|
others. The best supported guest operating systems are probably NetBSD/pmax, |
|
|
NetBSD/cats and OpenBSD/cats. |
|
|
|
|
|
The emulator can also be used in other experiments; it does not have to run |
|
|
entire guest operating systems. However, as GXemul is an instruction-level |
|
|
emulator, it does not simulate things smaller than an instruction. What this |
|
|
means is that pipe-line stalls, penalties caused by branch-prediction misses |
|
|
or cache misses, and other micro-architectural effects are not simulated. |
|
|
|
|
|
User-visible change between release 0.3.6.2 and 0.3.7 include: |
|
|
|
|
|
o) The experimental PowerPC emulation mode is now working well enough |
|
|
to allow NetBSD/prep 2.1 to be installed and run inside the emulator. |
|
|
It is not 100% stable, and it is not optimized for performance yet, |
|
|
but hopefully enough for simple experiments. |
|
|
|
|
|
o) I finally took the time to implement a DEC 21143 NIC; this brings |
|
|
network connectivity to NetBSD/cats. (The userland "NAT"-like |
|
|
networking layer is still a bit buggy, and does not work with |
|
|
everything. However, NetBSD/cats can now be installed via ftp.) |
|
|
|
|
|
o) CD-ROM images can now in some cases be detected as ATAPI CD-ROMs |
|
|
instead of IDE harddisks. It works for at least NetBSD, OpenBSD, |
|
|
and Linux on CATS, and NetBSD on hpcmips. |
|
|
|
|
|
Internal (code related) changes include: |
|
|
|
|
|
o) Cleanup of the PCI and ISA bus frameworks; in practice this means |
|
|
that more code can be shared between different emulated machine |
|
|
models than before, and that adding new machine types will become |
|
|
easier. |
|
15 |
|
|
|
o) Dyntrans updates; 32-bit PowerPC mostly, but also many performance |
|
|
related updates for ARM. |
|
16 |
|
|
17 |
There have also been lots of other changes, too many and small to mention here. |
The most important change between release 0.3.8 and 0.4.0.1 is: |
18 |
|
|
19 |
|
o) The emulation of MIPS processors has been completely rewritten; |
20 |
|
it now uses the same portable dynamic translation system as the |
21 |
|
ARM and PowerPC emulation modes. |
22 |
|
|
23 |
|
On Alpha and i386 hosts (and AMD64 hosts running in 32-bit mode), |
24 |
|
GXemul previously used translation into native code. This release |
25 |
|
will perform worse than 0.3.8 on those host architectures. |
26 |
|
|
27 |
|
On all other hosts (including AMD64 running in native 64-bit mode), |
28 |
|
0.4.0 is likely to be faster than 0.3.8, when emulating MIPS. |
29 |
|
|
30 |
|
I think that in the long term, moving towards full portability like |
31 |
|
this is a good idea. |
32 |
|
|
33 |
|
(0.4.0 was a bit buggy and unstable; 0.4.0.1 is a quick-fix release.) |
34 |
|
|
35 |
|
There have also been many other changes, including, but not limited to: |
36 |
|
|
37 |
|
o) The "test machine" functionality is more well-defined than before, |
38 |
|
and some tutorial-like demos have been added. These could be useful |
39 |
|
e.g. in operating system construction courses. |
40 |
|
|
41 |
|
o) NetBSD/sgimips 3.0 works now. This is most likely due to the rewrite |
42 |
|
of the MIPS emulation mode. Previous releases of GXemul only worked |
43 |
|
with NetBSD/sgimips 2.1. |
44 |
|
|
45 |
|
o) I have begun implementing rudimentary support for GDB remote serial |
46 |
|
protocol connections. This means that you can run e.g. the Data |
47 |
|
Display Debugger, and connect it to a GXemul instance. |
48 |
|
|
49 |
|
No advanced GDB functionality is working yet, but starting and |
50 |
|
stopping the emulated machine and single-stepping should work. |
51 |
|
|
52 |
|
Please read the HISTORY files for more details. |
53 |
|
|
54 |
|
|
55 |
Files included in this release are: |
Files included in this release are: |
56 |
|
|
|
BUGS A list of known bugs. |
|
57 |
HISTORY Detailed revision history / changelog. |
HISTORY Detailed revision history / changelog. |
58 |
LICENSE Copyright message / license. |
LICENSE Copyright message / license. |
59 |
README Quick start instructions, for the impatient. |
README Quick start instructions, for the impatient. |
60 |
RELEASE This file. |
RELEASE This file. |
61 |
TODO TODO notes. |
TODO TODO notes. |
62 |
configure, Makefile.skel sh and make scripts for building GXemul. |
configure, Makefile.skel sh and make scripts for building GXemul. |
63 |
|
demos Tutorial-like demos of testmachine functionality. |
64 |
doc Documentation. |
doc Documentation. |
65 |
experiments Experimental code. (Usually not needed.) |
experiments Experimental code. (Usually not needed.) |
66 |
src Source code. |
src Source code. |
67 |
|
|
68 |
To build the emulator, run the ./configure script, and then run make. |
To build the emulator, run the configure script, and then run make. This |
69 |
|
should work on most Unix-like systems. |
70 |
|
|
|
Building the emulator should work on most Unix-like systems. (One system which |
|
|
is specifically known to NOT work is Ultrix/RISC inside the emulator; Ultrix |
|
|
chokes on the configure script and the default cc in Ultrix doesn't work.) |
|
71 |
|
|
72 |
Regarding files in the src/include/ directory: only some of these are written |
Regarding files in the src/include/ directory: only some of these are written |
73 |
by me, the rest are from other sources (such as NetBSD). The license text says |
by me, the rest are from other sources (such as NetBSD). The license text says |
142 |
|
|
143 |
This product includes software developed by Manuel Bouyer. |
This product includes software developed by Manuel Bouyer. |
144 |
|
|
145 |
|
This product includes software developed by the Alice Group. |
146 |
|
|
147 |
|
This product includes software developed by Ichiro FUKUHARA. |
148 |
|
|
149 |
Also, src/include/alpha_rpb.h requires the following: |
Also, src/include/alpha_rpb.h requires the following: |
150 |
|
|
151 |
Copyright (c) 1994, 1995, 1996 Carnegie-Mellon University. |
Copyright (c) 1994, 1995, 1996 Carnegie-Mellon University. |
162 |
See individual files for license details, if you plan to redistribute GXemul |
See individual files for license details, if you plan to redistribute GXemul |
163 |
or reuse code. |
or reuse code. |
164 |
|
|
165 |
Thanks to (in no specific order) Joachim Buss, Juli Mallett, Juan Romero |
|
166 |
Pardines, Alec Voropay, Göran Weinholt, Alexander Yurchenko, and everyone |
Thanks to (in no specific order) Joachim Buss, Olivier Houchard, Juli Mallett, |
167 |
else who has provided me with feedback. |
Juan Romero Pardines, Alec Voropay, Göran Weinholt, Alexander Yurchenko, and |
168 |
|
everyone else who has provided me with feedback. |
169 |
|
|
170 |
|
Special thanks to Alec Voropay for testing this release with Linux |
171 |
|
kernels, and on Cygwin, and also thanks to Ondrej Palkovsky for testing |
172 |
|
with HelenOS. |
173 |
|
|
174 |
If you have found GXemul useful in some way, or feel like sending me comments |
If you have found GXemul useful in some way, or feel like sending me comments |
175 |
or feedback in general, then mail me at anders(at)gavare.se. |
or feedback in general, then mail me at anders(at)gavare.se. |