/[gxemul]/upstream/0.3.5/man/gxemul.1
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /upstream/0.3.5/man/gxemul.1

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 4 by dpavlin, Mon Oct 8 16:18:00 2007 UTC revision 6 by dpavlin, Mon Oct 8 16:18:11 2007 UTC
# Line 1  Line 1 
1  .\" $Id: gxemul.1,v 1.14 2005/04/16 02:38:21 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  .\"  .\"
# Line 29  Line 29 
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
# Line 51  is an experimental instruction-level mac Line 51  is an experimental instruction-level mac
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
# Line 78  from SGI. Use Line 78  from SGI. Use
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
# Line 108  Other options: Line 113  Other options:
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
# Line 126  Add Line 131  Add
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.
# Line 136  CD-ROM. Line 141  CD-ROM.
141  DISK (this is the default).  DISK (this is the default).
142  .It f  .It f
143  FLOPPY.  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.  IDE.
149  .It r  .It r
# Line 145  SCSI (this is the default for most machi Line 153  SCSI (this is the default for most machi
153  .It t  .It t
154  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. Files with a  Unless otherwise specified, filenames ending with ".iso" are assumed to be
160  size of exactly 1.44 MB are assumed to be floppy images. All others  CDROM images. Most others are assumed to be disks. Depending on which
161  are assumed to be disks.  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
# Line 164  Disable some speed tricks. Line 180  Disable some speed tricks.
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
# Line 186  present (for DECstation, SGI, and ARC em Line 204  present (for DECstation, SGI, and ARC em
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.
# Line 242  emulation. Line 260  emulation.
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
# Line 313  file in the Line 332  file in the
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
# Line 322  to select the old bintrans system, if yo Line 340  to select the old bintrans system, if yo
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

Legend:
Removed from v.4  
changed lines
  Added in v.6

  ViewVC Help
Powered by ViewVC 1.1.26