File: RELEASE

package info (click to toggle)
mips64emul 0.2.4-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 3,260 kB
  • ctags: 11,173
  • sloc: ansic: 43,056; sh: 535; asm: 326; makefile: 58
file content (161 lines) | stat: -rw-r--r-- 6,188 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
Release notes for mips64emul 0.2.4
==================================

Copyright (C) 2003-2005  Anders Gavare.


mips64emul is a free MIPS machine emulator. The goals are to emulate
MIPS-like CPUs and enough surrounding hardware to let unmodified operating
systems run as if they were running on a real machine, and to assist in
experiments involving MIPS-like code in general.

(MIPS is a registered trademark of MIPS Technologies. mips64emul is 
developed as a spare-time hobby, and there is no affiliation with MIPS 
Technologies in any way whatsoever.)


In its current form, it is possible to use the emulator to install an
operating systems onto a harddisk image; the "guest" operating system will run
similar to how it would run on a real physical machine.

The following guest operating systems have been verified to work:


    Operating system                   Emulated machine
    ----------------                   ----------------

    NetBSD/pmax 2.0 (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


(*) = not very stable yet, but it sometimes works.

A couple of other emulation modes exist (for SGI's MIPS-based machines,
Playstation 2, Cobalt, some other ARC machines, etc) but these modes are more
of a curiosity, and should not be considered working yet.


Here is a short summary of the changes from version 0.2.3 to 0.2.4:

	x)  Debian GNU/Linux can now be installed. However, it is VERY
	    unstable, and Linux Oopses when there is heavy serial console
	    output. A '-U' command line option reduces the risk, but doesn't
	    fix the problem.

	x)  When emulating framebuffers for machines like the DECstation
	    5000/200, that have a hardware mouse cursor, the host machine's
	    X cursor is now invisible. (This might not sound like a very
	    exiting change, but it "feels" a lot better than before.)

	x)  Improvements to the experimental dynamic binary translation
	    subsystem.

	x)  Many improvements to the single-step debugger.

	x)  Various other bugfixes and updates.


This release has a number of known bugs, listed in the BUGS file, but feel
free to drop me an email regarding other bugs.


Files included in this release are:

  BUGS                        A list of known bugs.
  HISTORY                     Detailed revision history / changelog.
  LICENSE                     Copyright message / license.
  README                      Quick start instructions, for the impatient.
  RELEASE                     This file.
  TODO                        TODO notes.
  doc                         Documentation.
  experiments                 Experimental code (not usually needed).
  src, devices, and include   Source code.
  tests                       Regression tests.


To build the emulator, run the ./configure script, and then run make.

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.)


Regarding files in the include/ directory:  only some of these are
written by me, the rest are from other sources (such as NetBSD).  The
license text says that "All advertising materials mentioning features or
use of this software" must display acknowledgements.  Even though I do NOT
feel I mention features or use of the header files (the "software") in any
advertising materials, I am still very greatful for the fact that these
people have made their files available for re-use, so I guess thanking
them like this is in order:

    This product includes software developed by the University of
    California, Berkeley and its contributors.

    This product includes software developed for the
    NetBSD Project.  See http://www.netbsd.org/ for
    information about NetBSD.

    This product includes software developed by Jonathan Stone for
    the NetBSD Project.

    This product includes software developed for the NetBSD Project
    by Matthias Drochner.

    This product includes software developed by the NetBSD
    Foundation, Inc. and its contributors.

    This product includes software developed by Christopher G. Demetriou.
    [for the NetBSD Project.]

    This product includes software developed by Adam Glass.

    This product includes software developed by the PocketBSD project
    and its contributors.

    This product includes software developed by Peter Galbavy.

    Carnegie Mellon University   (multiple header files,
    no specific advertisement text required)

    This product includes software developed by Charles M. Hannum.

    This product includes software developed under OpenBSD by Per Fogelstrm.

    This product includes software developed by Per Fogelstrm.

    This product includes software developed at Ludd, University of
    Lule, Sweden and its contributors.

    This product includes software developed by Hellmuth Michaelis
    and Joerg Wunsch

    The font(s) in devices/fonts are Copyright (c) 1992, 1993, 1994
    by Hellmuth Michaelis and Joerg Wunsch.  ("This product includes software
    developed by Hellmuth Michaelis and Joerg Wunsch", well, the font
    is maybe not software, but still...)

    impactsr-bsd.h is Copyright (C) 2004 by Stanislaw Skowronek.

    This product includes software developed for the NetBSD Project by
    Wasabi Systems, Inc.  [by Simon Burge]

    arcbios_other.h is Copyright (c) 1996 M. Warner Losh.


See individual files for license details, if you plan to redistribute
mips64emul or reuse code.

And thanks to everyone who has provided me with feedback, ideas, patches,
or encouraged me to work on specific issues.

Don't hesitate to send feedback to me (Anders Gavare, anders(at)gavare.se)
if you have found mips64emul useful or if you have found a bug.