/[gxemul]/trunk/doc/misc.html

This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!

Diff of /trunk/doc/misc.html

Parent Directory | Revision Log | View Patch Patch

-revision 10 by dpavlin,
Mon Oct  8 16:18:27 2007 UTC
+revision 12 by dpavlin,
Mon Oct  8 16:18:38 2007 UTC
 Line 1
- <html><head><title>GXemul documentation: Misc.</title>
+ <html><head><title>Gavare's eXperimental Emulator:&nbsp;&nbsp;&nbsp;Miscellaneous</title>
  <meta name="robots" content="noarchive,nofollow,noindex"></head>
  <body bgcolor="#f8f8f8" text="#000000" link="#4040f0" vlink="#404040" alink="#ff0000">
  <table border=0 width=100% bgcolor="#d0d0d0"><tr>
  <td width=100% align=center valign=center><table border=0 width=100%><tr>
  <td align="left" valign=center bgcolor="#d0efff"><font color="#6060e0" size="6">
- <b>GXemul documentation:</b></font>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ <b>Gavare's eXperimental Emulator:&nbsp;&nbsp;&nbsp;</b></font>
- <font color="#000000" size="6"><b>Misc.</b>
+ <font color="#000000" size="6"><b>Miscellaneous</b>
  </font></td></tr></table></td></tr></table><p>
  <!--
- $Id: misc.html,v 1.42 2005/06/26 08:42:26 debug Exp $
+ $Id: misc.html,v 1.50 2005/08/16 05:15:24 debug Exp $
  Copyright (C) 2003-2005  Anders Gavare.  All rights reserved.
 Line 39 
 SUCH DAMAGE.
  -->
  <a href="./">Back to the index</a>
  <p><br>
- <h2>Misc.</h2>
+ <h2>Miscellaneous</h2>
  <p>
  <ul>
    <li><a href="#networking">Networking</a>
-   <li><a href="#portmips">Porting operating systems to MIPS using GXemul</a>
+   <li><a href="#devel">Writing operating system code, or
+         developing firmware, using GXemul</a>
    <li><a href="#compilercontruct">Using GXemul in compiler contruction courses</a>
    <li><a href="#disk">How to start the emulator with a disk image</a>
    <li><a href="#largeimages">How to extract large gzipped disk images</a>
-Line 87 
 activities, but not everything works yet
+Line 89 
 activities, but not everything works yet
  <p><br>
- <a name="portmips"></a>
+ <a name="devel"></a>
- <h3>Porting operating systems to MIPS using GXemul:</h3>
+ <h3>Writing operating system code, or developing firmware, using GXemul:</h3>
+ Is this a good idea?  The answer is yes and no, depending on the level of
+ detail you need in your simulations. If you are developing an operating
+ system or operating system kernel of your own, and wish to target
+ MIPS-like systems in general, then the answer might be yes, for
+ experimental purposes.
- Is this a good idea?  The answer is yes and no, depending on what you are
+ <p>Some examples of things that <i>don't</i> work, that you should keep in
- trying to port to. If you are developing an operating system or operating
+ mind:
- system kernel of your own, and wish to target MIPS-like systems in general,
- then the answer might be yes, for experimental purposes.
+ <ul>
+         <li>Porting code to a specific machine mode, e.g. a Silicon Graphics
- <p>
+         machine, using GXemul, will not necessarily cause the code to
- However, if you think that you can port an operating system
+         work on a real machine. Sometimes code works in GXemul which doesn't
- to, say, the Silicon Graphics machine mode of GXemul and hope that your
+         work on real hardware, sometimes it's the other way around.
- operating system will run on a real SGI machine, then you will most
- likely fail. GXemul simply does not emulate things well enough for that to work.
+         <p>
- Another example would be specific CPU details; if your code depends on,
+         <li>GXemul contains bugs, and many things are not yet implemented.
- say, R10000 specifics, chances are that GXemul will not be sufficient.
+         <p>
- <p>
+         <li>I have only implemented devices in GXemul to the degree that
- In many cases, hardware devices in GXemul are only implemented well
+         NetBSD, OpenBSD, etc, don't complain too much. One way to say it
- enough to fool eg. NetBSD that they are working correctly, while in
+         is that the device implementations are "lazy hacks", based on the
- fact they don't work very much at all.  Please keep this in mind, if you plan
+         assumption that the emulated OS is already developed and bug-free.
- to use GXemul when porting your code to MIPS.
+         They are not intended to be used for development of new OS code,
+         so if you do that, then be prepared for bugs and inconsitencies.
+         <p>
+         <li>CPU details in GXemul are usually wrong. If your code depends
+         on, say, R10000 or MIPS64 specifics, chances are that GXemul will
+         not be sufficient. Again, this was done as "lazy hacks", and pretty
+         much assumes that the OS being emulated is already developed
+         and bug-free.
+         <p>
+         <li>Caches. There is no cache emulation in GXemul right now. Caches
+         for R2000/R3000 are faked well enough to run NetBSD, Ultrix, etc
+         in the DECstation emulation mode, but other than that, cache
+         operations are treated as nops.
+ </ul>
+ <p>The bottom line is that GXemul can be useful as yet another way to test
+ your code during development, but it should not be fully relied on.
-Line 155 
 to get a list of possible options.
+Line 180 
 to get a list of possible options.
  Here are some examples. If you want to run a NetBSD/pmax kernel on an
  emulated DECstation machine, you would use a command line such as this:
  <pre>
-         $ <b>gxemul -E dec -e 3max -d pmax_diskimage.fs netbsd-pmax-INSTALL</b>
+         $ <b>gxemul -e 3max -d pmax_diskimage.fs netbsd-pmax-INSTALL</b>
  </pre>
  <p>
  NOTE: For some emulation modes, such as the DECstation mode, you do
-Line 166 
 It is possible to have more than one dis
+Line 191 
 It is possible to have more than one dis
  image is added; the first will be SCSI target 0, the second will be target 1, and so on,
  unless you specify explicitly which ID number the devices should have.
  <pre>
-         $ <b>gxemul -E dec -e 3max -d disk0.raw -d disk1.raw -d 5:disk2.raw netbsd-pmax-INSTALL</b>
+         $ <b>gxemul -e 3max -d disk0.raw -d disk1.raw -d 5:disk2.raw netbsd-pmax-INSTALL</b>
  </pre>
  Note: In the example above, disk2.raw will get scsi id 5.
  <p>
-Line 175 
 a CDROM device (this can be overridden w
+Line 200 
 a CDROM device (this can be overridden w
  For example, the following command would start the emulator with two
  CDROM images, and one harddisk image:
  <pre>
-         $ <b>gxemul -E dec -e 3max -d image.iso -d disk0.img -d c:second_cdrom.img netbsd-pmax-INSTALL</b>
+         $ <b>gxemul -e 3max -d image.iso -d disk0.img -d c:second_cdrom.img netbsd-pmax-INSTALL</b>
  </pre>
  Usually, the device with the lowest id becomes the boot device. To override
  this, add a 'b' prefix to one of the devices:
  <pre>
-         $ <b>gxemul -E dec -e 3max -d rootdisk.img -d bc:install-cd.iso name_of_kernel</b>
+         $ <b>gxemul -e 3max -d rootdisk.img -d bc:install-cd.iso name_of_kernel</b>
  </pre>
  If you have a physical CD-ROM drive on the host machine, say /dev/cd0c, you can
  use it as a CD-ROM directly accessible from within the emulator:
  <pre>
-         $ <b>gxemul -E dec -e 3max -d rootdisk.img -d bc:/dev/cd0c name_of_kernel</b>
+         $ <b>gxemul -e 3max -d rootdisk.img -d bc:/dev/cd0c name_of_kernel</b>
  </pre>
  It is probably possible to use harddisks as well this way, but I would not
  recommend it.
-Line 285 
 count.)
+Line 310 
 count.)
  <a name="userland"></a>
  <h3>Running userland binaries:</h3>
- You can run (some) userland programs as well. This will not emulate any
+ <font color="#ff0000">Note: This does not really work yet.</font>
- particular machine, but instead try to translate syscalls from for example
- NetBSD/pmax into the host's OS' syscalls. Right now, this is just a
+ <p>There is some skeleton code for running userland programs as well. This
- proof-of-concept, to show that it would work; there's lots of work left to
+ will not emulate any particular machine, but instead try to translate
- do to make it actually run useful programs (for example dynamically linked
+ syscalls from e.g. NetBSD/pmax into the host's OS' syscalls. Right now,
- programs).
+ this is just a proof-of-concept, to show that it could work; there's lots
+ of work left to do to make it actually run useful programs.
  <p>
-Line 321 
 programs).
+Line 347 
 programs).
          tab.csbnet.se
  </pre>
+ <!--
    <p>
    <li><b>NetBSD/powerpc:</b>
          <br>
-Line 344 
 programs).
+Line 371 
 programs).
          Hello, world!
  </pre>
+ -->
  </ul>
-Line 411 
 and store in a file. Let's call this fil
+Line 439 
 and store in a file. Let's call this fil
  </pre>
  This binary image can now be used in the emulator:
  <pre>
-         $ <b>gxemul -E dec -e 3min -Q -M128 -q 0xbfc00000:DECstation5000_125_promdump.bin</b>
+         $ <b>gxemul -e 3min -Q -M128 -q 0xbfc00000:DECstation5000_125_promdump.bin</b>
          KN02-BA V5.7e
          ?TFL:  3/scc/access (1:Ln1 reg-12: actual=0x00 xpctd=0x01) [KN02-BA]
-Line 458 
 fixing something else, but this is what
+Line 486 
 fixing something else, but this is what
  During bootup, the PROM complains <i>a lot</i> about hardware failures.
  That's because the emulator doesn't emulate the hardware well enough yet.
  <p>
- The command line options used are: -E dec for DECstation, -e 3min for
+ The command line options used are: -e 3min for
- "model 3" (5000/1xx), -Q to supress the emulator's own PROM
+ "DECstation 3min" (5000/1xx), -Q to supress the emulator's own PROM
  call emulation, -M128 for 128MB RAM (because GXemul doesn't correctly
  emulate memory detection well enough for the PROM to accept, so it will
  always believe there is 128MB ram anyway), and -q to supress debug messages.

 Legend:



Removed from v.10
 


changed lines


 
Added in v.12
 Legend:



Removed from v.10
 


changed lines


 
Added in v.12
-Removed from v.10
+Added in v.12

	ViewVC Help
Powered by ViewVC 1.1.26