1 |
Release notes for Gavare's eXperimental Emulator (GXemul), 0.4.4.1 |
2 |
================================================================== |
3 |
|
4 |
Copyright (C) 2003-2007 Anders Gavare. |
5 |
|
6 |
|
7 |
GXemul is an experimental instruction-level machine emulator. Several |
8 |
emulation modes are available. In some modes, processors and surrounding |
9 |
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. |
11 |
|
12 |
Processors (ARM, MIPS, PowerPC, SuperH) are emulated using dynamic |
13 |
translation. Unlike some other dynamically translating emulators, GXemul |
14 |
does not need to generate native code, only a "runnable intermediate |
15 |
representation", and will thus run on any host architecture. |
16 |
|
17 |
The documentation lists the machines and guest operating systems that can |
18 |
be regarded as "working" in GXemul. The best working guest operating |
19 |
systems are probably NetBSD/pmax and NetBSD/cats. |
20 |
|
21 |
|
22 |
Changes between release 0.4.3 and 0.4.4.1 include, among other things: |
23 |
|
24 |
o) The interrupt subsystem has been redesigned. This means two things: |
25 |
|
26 |
x) Internal code cleanup, which makes the whole emulator more |
27 |
maintainable. Instead of using magically encoded integers |
28 |
for interrupts, strings are now used. These strings are in |
29 |
the form of "paths", so that devices and busses can more |
30 |
easily be connected to other busses, devices, or CPUs. |
31 |
|
32 |
x) Some machine types which happened to work in release 0.4.3, |
33 |
but were not listed in the documentation as working, may |
34 |
have stopped working now. As always, the documentation should |
35 |
indicate the combinations of machine modes and guest OSes that |
36 |
are supposed to work. |
37 |
|
38 |
o) SuperH (SH4) emulation is now somewhat more stable. |
39 |
|
40 |
x) GXemul 0.4.4: A NetBSD/dreamcast Live CD works. |
41 |
x) GXemul 0.4.4.1: A Linux/dreamcast Live CD also works. |
42 |
|
43 |
o) PowerPC "G4" emulation is now stable enough to let NetBSD/macppc |
44 |
run from a disk image. (Installing actually worked before, but the |
45 |
NetBSD/macppc GENERIC kernel uses AltiVec instructions which were |
46 |
not implemented correctly.) |
47 |
|
48 |
o) The PICA-61 (arc) and i80321 (evbarm) emulation modes now have their |
49 |
timers fixed at 100 Hz. A hardcoded speed like this is very ugly, but |
50 |
it is at least better than before (when the timer wasn't really |
51 |
running at any specific speed at all). |
52 |
|
53 |
Please read the HISTORY files for more details. |
54 |
|
55 |
|
56 |
Files included in this release are: |
57 |
|
58 |
HISTORY Detailed revision history / changelog. |
59 |
LICENSE Copyright message / license. |
60 |
README Quick start instructions, for the impatient. |
61 |
RELEASE This file. |
62 |
TODO TODO notes. |
63 |
configure, Makefile.skel sh and make scripts for building GXemul. |
64 |
demos Tutorial-like demos of testmachine functionality. |
65 |
doc Documentation. |
66 |
experiments Experimental code. (Usually not needed.) |
67 |
src Source code. |
68 |
|
69 |
To build the emulator, run the configure script, and then run make. This |
70 |
should work on most Unix-like systems. |
71 |
|
72 |
|
73 |
Regarding files in the src/include/ directory: only some of these are written |
74 |
by me, the rest are from other sources (such as NetBSD). The license text says |
75 |
that "All advertising materials mentioning features or use of this software" |
76 |
must display acknowledgements. Even though I do NOT feel I mention features or |
77 |
use of the header files (the "software") in any advertising materials, I am |
78 |
still very grateful for the fact that these people have made their files |
79 |
available for re-use, so regardless of legal requirements, I guess thanking |
80 |
them like this is in order: |
81 |
|
82 |
This product includes software developed by the University of |
83 |
California, Berkeley and its contributors. |
84 |
|
85 |
This product includes software developed for the |
86 |
NetBSD Project. See http://www.netbsd.org/ for |
87 |
information about NetBSD. |
88 |
|
89 |
This product includes software developed by Jonathan Stone for |
90 |
the NetBSD Project. |
91 |
|
92 |
This product includes software developed for the NetBSD Project |
93 |
by Matthias Drochner. |
94 |
|
95 |
This product includes software developed by the NetBSD |
96 |
Foundation, Inc. and its contributors. |
97 |
|
98 |
This product includes software developed by Christopher G. Demetriou. |
99 |
[for the NetBSD Project.] |
100 |
|
101 |
This product includes software developed by Adam Glass. |
102 |
|
103 |
This product includes software developed by the PocketBSD project |
104 |
and its contributors. |
105 |
|
106 |
This product includes software developed by Peter Galbavy. |
107 |
|
108 |
Carnegie Mellon University (multiple header files, |
109 |
no specific advertisement text required) |
110 |
|
111 |
This product includes software developed by Charles M. Hannum. |
112 |
|
113 |
This product includes software developed under OpenBSD by Per Fogelström. |
114 |
|
115 |
This product includes software developed by Per Fogelström. |
116 |
|
117 |
This product includes software developed at Ludd, University of |
118 |
Luleå, Sweden and its contributors. |
119 |
|
120 |
This product includes software developed by Hellmuth Michaelis |
121 |
and Joerg Wunsch |
122 |
|
123 |
The font(s) in devices/fonts are Copyright (c) 1992, 1993, 1994 |
124 |
by Hellmuth Michaelis and Joerg Wunsch. ("This product includes software |
125 |
developed by Hellmuth Michaelis and Joerg Wunsch", well, the font |
126 |
is maybe not software, but still...) |
127 |
|
128 |
impactsr-bsd.h is Copyright (C) 2004 by Stanislaw Skowronek. |
129 |
|
130 |
This product includes software developed for the NetBSD Project by |
131 |
Wasabi Systems, Inc. [by Simon Burge] |
132 |
|
133 |
arcbios_other.h is Copyright (c) 1996 M. Warner Losh. |
134 |
|
135 |
This product includes software developed by Marc Horowitz. |
136 |
|
137 |
This product includes software developed by Brini. |
138 |
|
139 |
This product includes software developed by Mark Brinicombe |
140 |
for the NetBSD Project. |
141 |
|
142 |
This product includes software developed by TooLs GmbH. |
143 |
|
144 |
This product includes software developed by Manuel Bouyer. |
145 |
|
146 |
This product includes software developed by the Alice Group. |
147 |
|
148 |
This product includes software developed by Ichiro FUKUHARA. |
149 |
|
150 |
This product includes software developed by Marcus Comstedt. |
151 |
|
152 |
Also, src/include/alpha_rpb.h requires the following: |
153 |
|
154 |
Copyright (c) 1994, 1995, 1996 Carnegie-Mellon University. |
155 |
All rights reserved. |
156 |
|
157 |
Author: Keith Bostic, Chris G. Demetriou |
158 |
|
159 |
Permission to use, copy, modify and distribute this software and |
160 |
its documentation is hereby granted, provided that both the copyright |
161 |
notice and this permission notice appear in all copies of the |
162 |
software, derivative works or modified versions, and any portions |
163 |
thereof, and that both notices appear in supporting documentation. |
164 |
|
165 |
See individual files for license details, if you plan to redistribute GXemul |
166 |
or reuse code. |
167 |
|
168 |
|
169 |
If you have found GXemul useful in some way, or feel like sending me comments |
170 |
or feedback in general, then mail me at anders(at)gavare.se. |
171 |
|