1 |
.\" $Id: gxemul.1,v 1.24 2005/06/26 10:05:02 debug Exp $ |
.\" $Id: gxemul.1,v 1.29 2005/08/10 15:51:09 debug Exp $ |
2 |
.\" |
.\" |
3 |
.\" Copyright (C) 2004-2005 Anders Gavare. All rights reserved. |
.\" Copyright (C) 2004-2005 Anders Gavare. All rights reserved. |
4 |
.\" |
.\" |
29 |
.\" This is a minimal man page for GXemul. Process this file with |
.\" This is a minimal man page for GXemul. Process this file with |
30 |
.\" groff -man -Tascii gxemul.1 or nroff -man gxemul.1 |
.\" groff -man -Tascii gxemul.1 or nroff -man gxemul.1 |
31 |
.\" |
.\" |
32 |
.Dd JUNE 2005 |
.Dd AUGUST 2005 |
33 |
.Dt GXEMUL 1 |
.Dt GXEMUL 1 |
34 |
.Os |
.Os |
35 |
.Sh NAME |
.Sh NAME |
48 |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
49 |
.Nm |
.Nm |
50 |
is an experimental instruction-level machine emulator. It can be used to |
is an experimental instruction-level machine emulator. It can be used to |
51 |
run binary code for (among others) MIPS-based machines, regardless of host |
run binary code for MIPS-based machines, regardless of host |
52 |
platform. Several emulation modes are available. For some modes, |
platform. Several emulation modes are available. For some modes, |
53 |
processors and surrounding hardware components are emulated well enough to |
processors and surrounding hardware components are emulated well enough to |
54 |
let unmodified operating systems (e.g. NetBSD) run as if they were running |
let unmodified operating systems (e.g. NetBSD) run as if they were running |
55 |
on a real machine. |
on a real machine. |
56 |
.Pp |
.Pp |
57 |
|
(Non-MIPS emulation modes are also under development, but so far none of |
58 |
|
those modes has reached the completeness required to run unmodified |
59 |
|
operating systems.) |
60 |
|
.Pp |
61 |
There are three ways to invoke the emulator. When emulating a |
There are three ways to invoke the emulator. When emulating a |
62 |
complete machine, settings can be entered directly on the command line, or |
complete machine, settings can be entered directly on the command line, or |
63 |
they can be read from a configuration file. When emulating a userland |
they can be read from a configuration file. When emulating a userland |
101 |
.It Fl E Ar t |
.It Fl E Ar t |
102 |
Try to emulate machine type |
Try to emulate machine type |
103 |
.Ar "t". |
.Ar "t". |
104 |
|
This option is not always needed, if the |
105 |
|
.Fl e |
106 |
|
option uniquely selects a machine. |
107 |
(Use |
(Use |
108 |
.Fl H |
.Fl H |
109 |
to get a list of types.) |
to get a list of types.) |
117 |
.Pp |
.Pp |
118 |
Other options: |
Other options: |
119 |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
120 |
|
.It Fl A |
121 |
|
Disable load/store alignment checks in some cases. This might give a small |
122 |
|
increase in performance, but the emulator will not run correctly if the |
123 |
|
emulated code actually tries to do unaligned loads or stores. |
124 |
.It Fl B |
.It Fl B |
125 |
Disable dynamic binary translation. By default, bintrans |
Disable dynamic binary translation. By default, bintrans |
126 |
will be turned on if the host+target architecture combination is |
will be turned on if the host+target architecture combination is |
311 |
The following command will start NetBSD/pmax on an emulated DECstation |
The following command will start NetBSD/pmax on an emulated DECstation |
312 |
5000/200 (3MAX): |
5000/200 (3MAX): |
313 |
.Pp |
.Pp |
314 |
.Dl "gxemul -E dec -e 3max -d nbsd_pmax.img" |
.Dl "gxemul -e 3max -d nbsd_pmax.img" |
315 |
.Pp |
.Pp |
316 |
nbsd_pmax.img should be a raw disk image containing a bootable |
nbsd_pmax.img should be a raw disk image containing a bootable |
317 |
NetBSD/pmax filesystem. |
NetBSD/pmax filesystem. |
337 |
There are many bugs. Some of the known bugs are listed in the BUGS |
There are many bugs. Some of the known bugs are listed in the BUGS |
338 |
file in the |
file in the |
339 |
.Nm |
.Nm |
340 |
source distribution, some are indirectly mentioned in the TODO file. |
source distribution, some are indirectly mentioned in the TODO file, |
341 |
|
and some are mentioned in the source code itself. |
342 |
.Pp |
.Pp |
343 |
The binary translation subsystem is really terrible, but it is less |
The binary translation subsystem is really terrible, but it is less |
344 |
terrible than running without it. |
terrible than running without it. |
345 |
.Pp |
.Pp |
346 |
|
Userland (syscall-only) emulation doesn't really work yet. |
347 |
|
.Pp |
348 |
.Nm |
.Nm |
349 |
does not simulate individual pipe-line stages or penalties caused by |
does not simulate individual pipe-line stages or penalties caused by |
350 |
branch-prediction misses or cache misses, so it cannot be used for |
branch-prediction misses or cache misses, so it cannot be used for |