/[gxemul]/trunk/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 /trunk/man/gxemul.1

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

revision 11 by dpavlin, Mon Oct 8 16:18:27 2007 UTC revision 12 by dpavlin, Mon Oct 8 16:18:38 2007 UTC
# Line 1  Line 1 
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  .\"  .\"
# 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 JUNE 2005  .Dd AUGUST 2005
33  .Dt GXEMUL 1  .Dt GXEMUL 1
34  .Os  .Os
35  .Sh NAME  .Sh NAME
# Line 48  Line 48 
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
# Line 97  Machine selection options: Line 101  Machine selection options:
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.)
# Line 110  Use this together with Line 117  Use this together with
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
# Line 300  distribution. Line 311  distribution.
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.
# Line 326  Please read the documentation for more d Line 337  Please read the documentation for more d
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

Legend:
Removed from v.11  
changed lines
  Added in v.12

  ViewVC Help
Powered by ViewVC 1.1.26