1 |
.\" $Id: gxemul.1,v 1.34 2005/10/11 03:53:58 debug Exp $ |
.\" $Id: gxemul.1,v 1.35 2005/10/27 14:01:11 debug Exp $ |
2 |
.\" |
.\" |
3 |
.\" Copyright (C) 2004-2005 Anders Gavare. All rights reserved. |
.\" Copyright (C) 2004-2005 Anders Gavare. All rights reserved. |
4 |
.\" |
.\" |
55 |
The processor architecture best emulated by GXemul is MIPS, but other |
The processor architecture best emulated by GXemul is MIPS, but other |
56 |
architectures are also partially emulated. |
architectures are also partially emulated. |
57 |
.Pp |
.Pp |
58 |
|
MIPS processors are emulated either using a simple type of binary |
59 |
|
translator (on Alpha and i386 hosts), or using traditional slow |
60 |
|
interpretation (all other hosts, including amd64 machines running in |
61 |
|
64-bit mode). |
62 |
|
.Pp |
63 |
|
Non-MIPS processors (e.g. ARM) are emulated using a newer dynamic |
64 |
|
translation system (called dyntrans in the rest of this man page); |
65 |
|
dyntrans does not require any host-specific code, so it should work on any |
66 |
|
platform. Performance is somewhere between binary translation and |
67 |
|
traditional interpretation. |
68 |
|
.Pp |
69 |
There are three ways to invoke the emulator: |
There are three ways to invoke the emulator: |
70 |
.Pp |
.Pp |
71 |
1. When emulating a complete machine, configuration options can be entered |
1. When emulating a complete machine, configuration options can be entered |
198 |
.It Fl i |
.It Fl i |
199 |
Display each instruction as it is being executed. |
Display each instruction as it is being executed. |
200 |
.It Fl J |
.It Fl J |
201 |
Disable some speed tricks. |
Disable some speed tricks. For MIPS emulation, these are mostly |
202 |
|
timing-related. For non-MIPS emulation (i.e. those modes using dyntrans), |
203 |
|
this flag disables the use of "instruction combinations". |
204 |
.It Fl j Ar n |
.It Fl j Ar n |
205 |
Set the name of the kernel to |
Set the name of the kernel to |
206 |
.Ar "n". |
.Ar "n". |
306 |
.It Fl q |
.It Fl q |
307 |
Quiet mode; this suppresses startup messages. |
Quiet mode; this suppresses startup messages. |
308 |
.It Fl s |
.It Fl s |
309 |
Show opcode usage statistics after the simulation. |
For MIPS emulation: Show opcode usage statistics after the simulation. |
310 |
|
For non-MIPS emulation (i.e. using dyntrans): Save statistics to a file at |
311 |
|
regular intervals of which physical addresses that were executed. |
312 |
.It Fl V |
.It Fl V |
313 |
Start up in the single-step debugger, paused. |
Start up in the single-step debugger, paused. |
314 |
.It Fl v |
.It Fl v |