1 |
.\" $Id: gxemul.1,v 1.12 2005/04/07 16:00:24 debug Exp $ |
.\" $Id: gxemul.1,v 1.21 2005/06/03 23:14:52 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 APRIL 2005 |
.Dd JUNE 2005 |
33 |
.Dt GXEMUL 1 |
.Dt GXEMUL 1 |
34 |
.Os |
.Os |
35 |
.Sh NAME |
.Sh NAME |
51 |
to run binary code for (among others) MIPS-based machines. |
to run binary code for (among others) MIPS-based machines. |
52 |
Several emulation modes are available. For some emulation modes, processors |
Several emulation modes are available. For some emulation modes, processors |
53 |
and surrounding hardware components are emulated well enough to let |
and surrounding hardware components are emulated well enough to let |
54 |
unmodified operating systems (eg NetBSD) run as if they were running on a |
unmodified operating systems (eg. NetBSD) run as if they were running on a |
55 |
real machine. |
real machine. |
56 |
.Pp |
.Pp |
57 |
There are three ways to invoke the emulator. When emulating a |
There are three ways to invoke the emulator. When emulating a |
78 |
.Fl H |
.Fl H |
79 |
to get a list of available emulation modes. |
to get a list of available emulation modes. |
80 |
.Pp |
.Pp |
81 |
(There is an exception to the normal invocation usage mentioned above; |
There are two exceptions to the normal invocation usage mentioned above. |
82 |
if you want to use the DECstation emulation mode, and have a bootable |
The first is for DECstation emulation: if you have a bootable |
83 |
DECstation harddisk or CDROM image, then just supplying the diskimage via |
DECstation harddisk or CDROM image, then just supplying the diskimage via |
84 |
the |
the |
85 |
.Fl d |
.Fl d |
86 |
option is sufficient. The filename of the kernel can then be |
option is sufficient. (The filename of the kernel can then be |
87 |
skipped, as the emulator runs the bootblocks from the diskimage directly and |
skipped, as the emulator runs the bootblocks from the diskimage directly and |
88 |
doesn't need the kernel as a separate file.) |
doesn't need the kernel as a separate file.) |
89 |
|
The second is if you supply an ISO9660 CDROM disk image. You may then use |
90 |
|
the |
91 |
|
.Fl j |
92 |
|
option to indicate which file on the CDROM filesystem that should be |
93 |
|
loaded into emulated memory. |
94 |
.Pp |
.Pp |
95 |
Machine selection options: |
Machine selection options: |
96 |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
113 |
.It Fl B |
.It Fl B |
114 |
Disable dynamic binary translation completely. By default, bintrans |
Disable dynamic binary translation completely. By default, bintrans |
115 |
will be turned on if the host architecture supports it. |
will be turned on if the host architecture supports it. |
116 |
However, in this release (0.3.1), there is no new bintrans system. |
However, in this release (0.3.X), there is no new bintrans system. |
117 |
If you want to enable binary translation, use |
If you want to enable binary translation, use |
118 |
.Fl "b". |
.Fl "b". |
119 |
.It Fl b |
.It Fl b |
131 |
as a disk image. By adding one or more modifier characters and then a |
as a disk image. By adding one or more modifier characters and then a |
132 |
colon (":") as a prefix to |
colon (":") as a prefix to |
133 |
.Ar "name", |
.Ar "name", |
134 |
you can modify the disk image's behaviour. Available modifiers are: |
you can modify the way the disk image is treated. Available modifiers are: |
135 |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
136 |
.It b |
.It b |
137 |
Specifies that this is a boot device. |
Specifies that this is a boot device. |
138 |
.It c |
.It c |
139 |
CD-ROM (instead of a normal SCSI DISK). |
CD-ROM. |
140 |
.It d |
.It d |
141 |
SCSI DISK (this is the default). |
DISK (this is the default). |
142 |
|
.It f |
143 |
|
FLOPPY. |
144 |
|
.It gH;S; |
145 |
|
Override the default geometry; use H heads and S sectors-per-track. |
146 |
|
(The number of cylinders is calculated automatically.) |
147 |
.It i |
.It i |
148 |
IDE (instead of SCSI). |
IDE. |
149 |
.It r |
.It r |
150 |
Read-only (don't allow changes to be written to the file). |
Read-only (don't allow changes to be written to the file). |
151 |
|
.It s |
152 |
|
SCSI (this is the default for most machine types). |
153 |
.It t |
.It t |
154 |
SCSI tape. |
Tape. |
155 |
.It 0-7 |
.It 0-7 |
156 |
Force a specific SCSI ID number. |
Force a specific ID number. |
157 |
.El |
.El |
158 |
.Pp |
.Pp |
159 |
Filenames ending with ".iso" are assumed to be CDROM images, all others |
Unless otherwise specified, filenames ending with ".iso" are assumed to be |
160 |
are assumed to be normal SCSI disks. |
CDROM images. Most others are assumed to be disks. Depending on which |
161 |
|
machine is being emulated, the default for disks can be either SCSI or |
162 |
|
IDE. Some disk images that are very small are assumed to be floppy disks. |
163 |
|
(If you are not happy with the way a disk image is detected, then you need |
164 |
|
to use explicit prefixes to force a specific type.) |
165 |
|
.Pp |
166 |
|
For floppies, the gH;S; prefix is ignored. Instead, the number of |
167 |
|
heads and cylinders are assumed to be 2 and 80, respectively, and the |
168 |
|
number of sectors per track is calculated automatically. (This works for |
169 |
|
720KB, 1.2MB, 1.44MB, and 2.88MB floppies.) |
170 |
.It Fl I Ar x |
.It Fl I Ar x |
171 |
Emulate clock interrupts at |
Emulate clock interrupts at |
172 |
.Ar x |
.Ar x |
180 |
.It Fl j Ar n |
.It Fl j Ar n |
181 |
Set the name of the kernel to |
Set the name of the kernel to |
182 |
.Ar "n". |
.Ar "n". |
183 |
Useful names are "bsd" for OpenBSD/pmax, or "vmunix" for Ultrix. |
When booting from an ISO9660 filesystem, the kernel will try to boot from |
184 |
("netbsd" is usually the default value.) |
this file. (In some emulation modes, eg. DECstation, this name is passed |
185 |
|
along to the boot program. Useful names are "bsd" for OpenBSD/pmax, |
186 |
|
or "vmunix" for Ultrix.) |
187 |
.It Fl M Ar m |
.It Fl M Ar m |
188 |
Emulate |
Emulate |
189 |
.Ar m |
.Ar m |
204 |
Set the boot argument (for DEC, ARC, or SGI emulation). |
Set the boot argument (for DEC, ARC, or SGI emulation). |
205 |
Default |
Default |
206 |
.Ar arg |
.Ar arg |
207 |
for DEC is '-a', for ARC '-aN'. |
for DEC is "-a", for ARC "-aN". |
208 |
.It Fl p Ar pc |
.It Fl p Ar pc |
209 |
Add a breakpoint (remember to use the '0x' prefix for hex). |
Add a breakpoint. (Remember to use the "0x" prefix for hex.) |
210 |
.It Fl Q |
.It Fl Q |
211 |
Disable the built-in PROM emulation. This is useful for running raw ROM |
Disable the built-in PROM emulation. This is useful for running raw ROM |
212 |
images from real machines. |
images from real machines. |
260 |
General options: |
General options: |
261 |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
262 |
.It Fl D |
.It Fl D |
263 |
Guarantee fully deterministic behaviour. Normally, the emulator calls |
Guarantee fully deterministic behavior. Normally, the emulator calls |
264 |
srandom() with a seed based on the current time at startup. When the |
srandom() with a seed based on the current time at startup. When the |
265 |
.Fl D |
.Fl D |
266 |
option is used, the srandom() call is skipped, which should cause two |
option is used, the srandom() call is skipped, which should cause two |
267 |
subsequent invokations of the emulator to be identical, if all other |
subsequent invocations of the emulator to be identical, if all other |
268 |
settings are identical. (If this option is used, then |
settings are identical and no user input is taking place. (If this option |
269 |
|
is used, then |
270 |
.Fl I |
.Fl I |
271 |
must also be used.) |
must also be used.) |
272 |
.It Fl H |
.It Fl H |
332 |
.Nm |
.Nm |
333 |
source distribution, some are indirectly mentioned in the TODO file. |
source distribution, some are indirectly mentioned in the TODO file. |
334 |
.Pp |
.Pp |
335 |
There is no new bintrans system in this release (0.3.1), so you will |
There is no new bintrans system in this release, so you will need to add |
|
need to add |
|
336 |
.Fl b |
.Fl b |
337 |
to select the old bintrans system, if you want speed. |
to select the old bintrans system, if you want speed. |
338 |
.Pp |
.Pp |
340 |
does not simulate individual pipe-line stages or penalties caused by |
does not simulate individual pipe-line stages or penalties caused by |
341 |
branch-prediction misses, so it cannot be used for accurate performance |
branch-prediction misses, so it cannot be used for accurate performance |
342 |
measurement. |
measurement. |
343 |
|
.Pp |
344 |
|
.Nm |
345 |
|
is not timing-accurate. |
346 |
.Sh AUTHOR |
.Sh AUTHOR |
347 |
Anders Gavare <anders@gavare.se> |
Anders Gavare <anders@gavare.se> |
348 |
.Pp |
.Pp |