1 |
Release notes for Gavare's eXperimental Emulator (GXemul), 0.3.5 |
Release notes for Gavare's eXperimental Emulator (GXemul), 0.4.2 |
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. It can be used to |
GXemul is an experimental instruction-level machine emulator. Several |
8 |
run binary code for MIPS-based machines, regardless of host platform. Several |
emulation modes are available. In some modes, processors and surrounding |
|
emulation modes are available. For some modes, processors and surrounding |
|
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 |
(Non-MIPS emulation modes are also under development, but so far none of those |
The documentation lists the machines and guest operating systems that can |
13 |
modes has reached the completeness required to run unmodified operating |
be regarded as "working" in GXemul. The best working guest operating |
14 |
systems.) |
systems are probably NetBSD/pmax, NetBSD/cats, and OpenBSD/cats. |
|
|
|
|
I have verified that the following "guest" operating systems can run inside |
|
|
the emulator: |
|
|
|
|
|
Guest operating system Emulated machine |
|
|
---------------------- ---------------- |
|
|
NetBSD/pmax 2.0.2 (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.0.2 NEC MobilePro 770, 780, 800, 880 |
|
|
NetBSD/cobalt 2.0.2 Cobalt |
|
|
NetBSD/evbmips 2.0.2 Malta 5Kc/4Kc evaluation board |
|
|
NetBSD/sgimips 2.0.2 SGI O2 ("IP32") |
|
|
|
|
|
Some of these guest operating systems are easier to install and run than |
|
|
others. The best supported mode is the DECstation 5000/200 emulation mode, with |
|
|
NetBSD/pmax as the guest operating system. |
|
|
|
|
|
A couple of other emulation modes exist. Some of these modes are almost working |
|
|
well enough to run complete guest operating systems, but most are just |
|
|
skeletons. The modes that work are listed in the documentation. |
|
|
|
|
|
The emulator can also be used in other experiments; it does not have to run |
|
|
entire guest operating systems. (However, GXemul 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.) |
|
|
|
|
|
The user-visible changes between release 0.3.4 and 0.3.5 are minor, and |
|
|
can be summarized as follows: |
|
|
|
|
|
o) Updates to the (old) binary translation subsystem, resulting |
|
|
in minor speed improvements. |
|
15 |
|
|
|
o) 64-bit MIPS dmult/dmultu has been fixed. |
|
16 |
|
|
17 |
o) slt* instructions for 64-bit MIPS were incorrectly implemented |
Changes between release 0.4.1 and 0.4.2 include, among other things: |
18 |
in the i386 backend. This has been fixed. |
|
19 |
|
o) The NetWinder emulation mode now works well enough to let |
20 |
|
NetBSD/netwinder run from a disk image. |
21 |
|
|
22 |
|
(NetBSD/netwinder has to be installed manually, though, because |
23 |
|
there is no installation ramdisk kernel. The GXemul documentation |
24 |
|
has an example of how to install NetBSD/netwinder using an emulated |
25 |
|
NetBSD/pmax machine.) |
26 |
|
|
27 |
|
o) Algorithmics P5064 emulation works well enough to let NetBSD/algor |
28 |
|
run from a disk image. (Similar to NetBSD/netwinder, it has to |
29 |
|
be installed manually, using another emulated machine.) |
30 |
|
|
31 |
|
o) PCI configuration register writes can now be handled, which allows |
32 |
|
NetBSD/Malta (evbmips) 3.0.1 and NetBSD/cobalt 3.0.1 to run from |
33 |
|
PCI IDE harddisk images. (Previously, only NetBSD 2.1 worked for |
34 |
|
the Malta and Cobalt emulation modes.) |
35 |
|
|
36 |
|
o) Some performance increases: |
37 |
|
|
38 |
|
The virtual translation table update routine has been simplified |
39 |
|
to work the same way for 32-bit and 64-bit emulation, and this |
40 |
|
apparently results in a speedup for all 64-bit modes. |
41 |
|
|
42 |
|
For 32-bit MIPS, some more instruction combinations have been added. |
43 |
|
|
44 |
|
Please read the HISTORY files for more details. |
45 |
|
|
|
There have been many other bug fixes and updates, most of which are not |
|
|
visible. |
|
46 |
|
|
47 |
Files included in this release are: |
Files included in this release are: |
48 |
|
|
|
BUGS A list of known bugs. |
|
49 |
HISTORY Detailed revision history / changelog. |
HISTORY Detailed revision history / changelog. |
50 |
LICENSE Copyright message / license. |
LICENSE Copyright message / license. |
51 |
README Quick start instructions, for the impatient. |
README Quick start instructions, for the impatient. |
52 |
RELEASE This file. |
RELEASE This file. |
53 |
TODO TODO notes. |
TODO TODO notes. |
54 |
configure, Makefile.skel sh and make scripts for building GXemul. |
configure, Makefile.skel sh and make scripts for building GXemul. |
55 |
|
demos Tutorial-like demos of testmachine functionality. |
56 |
doc Documentation. |
doc Documentation. |
57 |
experiments Experimental code. (Usually not needed.) |
experiments Experimental code. (Usually not needed.) |
58 |
src Source code. |
src Source code. |
59 |
|
|
60 |
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 |
61 |
|
should work on most Unix-like systems. |
62 |
|
|
|
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.) |
|
63 |
|
|
64 |
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 |
65 |
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 |
125 |
|
|
126 |
This product includes software developed by Marc Horowitz. |
This product includes software developed by Marc Horowitz. |
127 |
|
|
128 |
|
This product includes software developed by Brini. |
129 |
|
|
130 |
|
This product includes software developed by Mark Brinicombe |
131 |
|
for the NetBSD Project. |
132 |
|
|
133 |
|
This product includes software developed by TooLs GmbH. |
134 |
|
|
135 |
|
This product includes software developed by Manuel Bouyer. |
136 |
|
|
137 |
|
This product includes software developed by the Alice Group. |
138 |
|
|
139 |
|
This product includes software developed by Ichiro FUKUHARA. |
140 |
|
|
141 |
Also, src/include/alpha_rpb.h requires the following: |
Also, src/include/alpha_rpb.h requires the following: |
142 |
|
|
143 |
Copyright (c) 1994, 1995, 1996 Carnegie-Mellon University. |
Copyright (c) 1994, 1995, 1996 Carnegie-Mellon University. |
151 |
software, derivative works or modified versions, and any portions |
software, derivative works or modified versions, and any portions |
152 |
thereof, and that both notices appear in supporting documentation. |
thereof, and that both notices appear in supporting documentation. |
153 |
|
|
|
|
|
154 |
See individual files for license details, if you plan to redistribute GXemul |
See individual files for license details, if you plan to redistribute GXemul |
155 |
or reuse code. |
or reuse code. |
156 |
|
|
157 |
Thanks to (in no specific order) Joachim Buss, Juli Mallett, Juan RP, Alec |
|
158 |
Voropay, Göran Weinholt, Alexander Yurchenko, and everyone else who has |
Thanks to (in no specific order) Joachim Buss, Olivier Houchard, Juli Mallett, |
159 |
provided me with feedback. |
Juan Romero Pardines, Alec Voropay, Göran Weinholt, Alexander Yurchenko, and |
160 |
|
everyone else who has provided me with feedback. |
161 |
|
|
162 |
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 |
163 |
or feedback in general, then mail me at anders(at)gavare.se. |
or feedback in general, then mail me at anders(at)gavare.se. |