/[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 13 by dpavlin, Mon Oct 8 16:18:38 2007 UTC revision 14 by dpavlin, Mon Oct 8 16:18:51 2007 UTC
# Line 1  Line 1 
1  .\" $Id: gxemul.1,v 1.29 2005/08/10 15:51:09 debug Exp $  .\" $Id: gxemul.1,v 1.33 2005/10/07 22:45:34 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 AUGUST 2005  .Dd OCTOBER 2005
33  .Dt GXEMUL 1  .Dt GXEMUL 1
34  .Os  .Os
35  .Sh NAME  .Sh NAME
# Line 41  Line 41 
41  .Op file Ar ...  .Op file Ar ...
42  .Nm  .Nm
43  .Op general options  .Op general options
44  .Op Ar @configfile ...  .Ar @configfile
45  .Nm  .Nm
46  .Op userland, other, and general options  .Op userland, other, and general options
47  .Ar file Op Ar args ...  .Ar file Op Ar args ...
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. Several
51  run binary code for MIPS-based machines, regardless of host  emulation modes are available. In some modes, processors and surrounding
52  platform. Several emulation modes are available. For some modes,  hardware components are emulated well enough to let unmodified operating
53  processors and surrounding hardware components are emulated well enough to  systems (e.g. NetBSD) run as if they were running on a real machine.
54  let unmodified operating systems (e.g. NetBSD) run as if they were running  .Pp
55  on a real machine.  The processor architecture best emulated by GXemul is MIPS, but other
56  .Pp  architectures are also partially emulated.
57  (Non-MIPS emulation modes are also under development, but so far none of  .Pp
58  those modes has reached the completeness required to run unmodified  There are three ways to invoke the emulator:
59  operating systems.)  .Pp
60  .Pp  1. When emulating a complete machine, configuration options can be entered
61  There are three ways to invoke the emulator. When emulating a  directly on the command line.
62  complete machine, settings can be entered directly on the command line, or  .Pp
63  they can be read from a configuration file. When emulating a userland  2. Options can be read from a configuration file.
64  environment (syscall-only emulation, not emulating complete machines),  .Pp
65  then the program name and its argument should be given on the command  3. When emulating a userland environment (syscall-only emulation, not
66  line.  emulating complete machines), then the program name and its argument
67    should be given on the command line. (This mode doesn't really work yet.)
68  .Pp  .Pp
69  The easiest way to use the emulator is to supply settings directly on the  The easiest way to use the emulator is to supply settings directly on the
70  command line. The most important thing you need to supply is the  command line. The most important thing you need to supply is the
71  file argument. This is the name of a binary file (an ELF, a.out, ECOFF,  file argument. This is the name of a binary file (an ELF, a.out, COFF/ECOFF,
72  SREC, or a raw binary image) which you wish to run in the emulator. This file  SREC, or a raw binary image) which you wish to run in the emulator. This file
73  might be an operating system kernel, or perhaps a ROM image file.  might be an operating system kernel, or perhaps a ROM image file.
74  .Pp  .Pp
# Line 163  Tape. Line 164  Tape.
164  Force a specific ID number.  Force a specific ID number.
165  .El  .El
166  .Pp  .Pp
167  Unless otherwise specified, filenames ending with ".iso" are assumed to be  Unless otherwise specified, filenames ending with ".iso" or ".cdr" are
168  CDROM images. Most others are assumed to be disks. Depending on which  assumed to be CDROM images. Most others are assumed to be disks. Depending
169  machine is being emulated, the default for disks can be either SCSI or  on which machine is being emulated, the default for disks can be either
170  IDE. Some disk images that are very small are assumed to be floppy disks.  SCSI or IDE. Some disk images that are very small are assumed to be floppy
171  (If you are not happy with the way a disk image is detected, then you need  disks. (If you are not happy with the way a disk image is detected, then
172  to use explicit prefixes to force a specific type.)  you need to use explicit prefixes to force a specific type.)
173  .Pp  .Pp
174  For floppies, the gH;S; prefix is ignored. Instead, the number of  For floppies, the gH;S; prefix is ignored. Instead, the number of
175  heads and cylinders are assumed to be 2 and 80, respectively, and the  heads and cylinders are assumed to be 2 and 80, respectively, and the
# Line 347  Userland (syscall-only) emulation doesn' Line 348  Userland (syscall-only) emulation doesn'
348  .Pp  .Pp
349  .Nm  .Nm
350  does not simulate individual pipe-line stages or penalties caused by  does not simulate individual pipe-line stages or penalties caused by
351  branch-prediction misses or cache misses, so it cannot be used for  branch-prediction misses or cache misses, so it cannot be used for
352  accurate performance measurement.  accurate simulation of any actual real-world processor.
353  .Pp  .Pp
354  .Nm  .Nm
355  is not timing-accurate.  is not timing-accurate.

Legend:
Removed from v.13  
changed lines
  Added in v.14

  ViewVC Help
Powered by ViewVC 1.1.26