/[gxemul]/trunk/doc/configfiles.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/configfiles.html

Parent Directory | Revision Log | View Patch Patch

-revision 12 by dpavlin,
Mon Oct  8 16:18:38 2007 UTC
+revision 24 by dpavlin,
Mon Oct  8 16:19:56 2007 UTC
 Line 4
  <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>Gavare's eXperimental Emulator:&nbsp;&nbsp;&nbsp;</b></font>
+ <b>Gavare's eXperimental Emulator:</b></font><br>
  <font color="#000000" size="6"><b>Configuration files</b>
  </font></td></tr></table></td></tr></table><p>
  <!--
- $Id: configfiles.html,v 1.14 2005/08/12 06:02:55 debug Exp $
+ $Id: configfiles.html,v 1.25 2006/06/22 13:22:40 debug Exp $
- Copyright (C) 2003-2005  Anders Gavare.  All rights reserved.
+ Copyright (C) 2003-2006  Anders Gavare.  All rights reserved.
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions are met:
 Line 65 
 through an example is good enough:
  <p>
  <table border="0"><tr><td width="40">&nbsp;</td><td>
  <pre>
- <font color="#2020cf">!!gxemul     <-- configuration files must start like this
+ <font color="#2020cf">!  This is an example configuration file for GXemul.
- !
- !  This is an example configuration file for GXemul.
  !  Anything following an exclamation mark (and also the exclamation
  !  mark itself) is ignored.
  !
- !  Each configuration file should contain one emul entry. Almost
+ !  Almost all settings are optional.</font>
- !  everything else is optional.</font>
- <b>emul(</b>
+ <b>name(<font color="#ff003f">"my test emul"</font>)</b>         <font color="#2020cf">!  Optional name of this emulation</font>
-     <b>name(<font color="#ff003f">"my test emul"</font>)</b>     <font color="#2020cf">!  Optional name of this emulation</font>
-     <font color="#2020cf">!  This creates an ethernet network:</font>
+ <font color="#2020cf">!  This creates an ethernet network:</font>
-     <b>net(</b>
+ <b>net(</b>
          <b>ipv4net(<font color="#ff003f">"10.2.0.0"</font>)</b>  <font color="#2020cf">!  The default is 10.0.0.0/8, but</font>
          <b>ipv4len(16)</b>          <font color="#2020cf">!  it can be overridden like this.</font>
          <font color="#2020cf">!  local_port(12345)</font>
          <font color="#2020cf">!  add_remote("localhost:12346")</font>
-     <b>)</b>
+ <b>)</b>
-     <font color="#2020cf">!  This creates a machine:</font>
+ <font color="#2020cf">!  This creates a machine:</font>
-     <b>machine(</b>
+ <b>machine(</b>
          <b>name(<font color="#ff003f">"My test machine"</font>)</b>
          <font color="#2020cf">! serial_nr(123)    ! Useful when emulating multiple machines</font>
-Line 136 
 through an example is good enough:
+Line 132 
 through an example is good enough:
          <font color="#2020cf">! force_netboot(yes)</font>
          <font color="#2020cf">! start_paused(yes)</font>
-         <font color="#2020cf">! max_random_cycles(5)</font>
          <b>disk(<font color="#ff003f">"nbsd.img"</font>)</b>
          <b>disk(<font color="#ff003f">"6c:cdrom.iso"</font>)</b>
          <b>use_x11(yes)</b>
          <b>x11_scaledown(2)</b>
-         <font color="#2020cf">! bintrans(disable)</font>
-         <font color="#2020cf">! old_bintrans(enable)</font>
-         <font color="#2020cf">! bintrans_size(24)</font>
          <font color="#2020cf">! slow_serial_interrupts_hack_for_linux(yes)</font>
-         <font color="#2020cf">! debugger_on_badaddr(yes)</font>
          <font color="#2020cf">{
              Long comments spanning multiple lines should be surrounded
              with tuborg parentheses.
-Line 166 
 through an example is good enough:
+Line 154 
 through an example is good enough:
            -p pc     add a breakpoint (remember to use the '0x' prefix for hex!)
            -r        register dumps before every instruction
            -t        show function trace tree
-           -y x      set max_random_cycles_per_chunk to x (experimental)
          </i></b>-->
          }</font>
-     <b>)</b>
+ <b>)</b>
-     <font color="#2020cf">!  Multiple machine are allowed.</font>
+ <font color="#2020cf">!  Multiple machine definitions are allowed.</font>
-     <b>machine(</b>
+ <b>machine(</b>
          <b>name(<font color="#ff003f">"another machine"</font>)</b>
          <b>type(<font color="#ff003f">"hpcmips"</font>)</b>
          <b>subtype(<font color="#ff003f">"be300"</font>)</b>
          <i>...</i>
-     <b>)</b>
  <b>)</b>
  </pre>
  </td></tr></table>
-Line 207 
 if <b>myconfig</b> is the name of the co
+Line 193 
 if <b>myconfig</b> is the name of the co
  Here is an example of what a minimal configuration file might look like:
  <p><table border="0"><tr><td width="40">&nbsp;</td><td><pre>
- <font color="#2020cf">!!gxemul</font>
+ <b>machine(</b>
- <b>emul(</b>
+     <b>subtype(<font color="#ff003f">"3max"</font>)</b>
-     <b>machine(</b>
+     <b>load(<font color="#ff003f">"netbsd-pmax-INSTALL-2.0"</font>)</b>
-         <b>subtype(<font color="#ff003f">"3max"</font>)</b>
-         <b>load(<font color="#ff003f">"netbsd-pmax-INSTALL-2.0"</font>)</b>
-     <b>)</b>
  <b>)</b>
  </pre>
  </td></tr></table>
-Line 232 
 netbooting kernels.
+Line 215 
 netbooting kernels.
  <a name="multihost"></a>
  <h3>Network across multiple hosts:</h3>
- <font color="#ff0000">2005-06-21: This a very new feature, so it might not
+ <p>It is possible to add multiple <tt>machine</tt> entries into one
- be totally stable yet.</font>
+ configuration file. This will cause the emulator to try to run all those
+ machines simultaneously. An alternative (and better) solution for doing
- <p>It is possible to add multiple <tt>machine</tt> entries into one
+ this, which gives higher reliability (stability) and performance, is to
- configuration file. This will cause the emulator to try to run all those
+ have one configuration file per emulated machine.
- machines simultaneously. An alternative solution for doing this, which
- gives higher reliability (stability) and performance, is to have one
+ <p><table border="0" width="100%"><tr><td width="40">&nbsp;</td>
- configuration file per machine.
+ <td><pre>
+ <font color="#2020cf">!  Configuration file for a
+ !  "client" machine, netbooting
+ !  of another machine.</font>
- <p><table border="0"><tr><td width="40">&nbsp;</td><td><pre>
+ <b>net(</b>
- <font color="#2020cf">!!gxemul</font>
- <b>emul(</b>
-     <b>net(</b>
          <b>local_port(15000)</b>
          <b>add_remote(<font color="#ff003f">"localhost:15001"</font>)</b>
-     <b>)</b>
+ <b>)</b>
-     <b>machine(</b>
+ <b>machine(</b>
+         <b>name(<font color="#ff003f">"client machine"</font>)</b>
+         <b>serial_nr(1)</b>     <font color="#2020cf">!  10.0.0.1</font>
+         <b>type(<font color="#ff003f">"sgi"</font>)</b>
+         <b>subtype(<font color="#ff003f">"o2"</font>)</b>
+         <b>load(<font color="#ff003f">"netbsd-GENERIC32_IP3x.gz"</font>)</b>
+ <b>)</b>
+ </pre></td><td width="20">&nbsp;</td><td><pre>
+ <font color="#2020cf">!  Configuration file for the
+ !  "server" machine.</font>
+ <b>net(</b>
+         <b>local_port(15001)</b>
+         <b>add_remote(<font color="#ff003f">"localhost:15000"</font>)</b>
+ <b>)</b>
+ <b>machine(</b>
+         <b>name(<font color="#ff003f">"nfs server"</font>)</b>
+         <b>serial_nr(2)</b>     <font color="#2020cf">!  10.0.0.2</font>
          <b>type(<font color="#ff003f">"dec"</font>)</b>
          <b>subtype(<font color="#ff003f">"3max"</font>)</b>
-         <b>load(<font color="#ff003f">"netbsd-pmax-2.0-GENERIC"</font>)</b>
+         <b>disk(<font color="#ff003f">"nbsd_pmax.img"</font>)</b>
-     <b>)</b>
  <b>)</b>
- </pre>
+ </pre></td><td width="20">&nbsp;</td></tr></table>
- </td></tr></table>
  <p>This example creates a network using the default settings (10.0.0.0/8),
  but it also allows the network to be connected to other emulator
-Line 265 
 UDP port 15000 on the host is added to t
+Line 264 
 UDP port 15000 on the host is added to t
  on the network are also sent out to all other connected machines (those
  added with <tt>add_remote()</tt>).
- <p>As you can see in the example, this is a configuration file for running
+ <p>As you can see in the example, this is a configuration file for
- NetBSD/pmax 2.0, with a netbooting GENERIC kernel. (Netbooting because
+ netbooting a NetBSD/sgimips diskless machine, with a NetBSD/pmax machine
- there is no disk image.) Another emulator instance (which must have
+ acting as the nfs server. Note that the nfs server has ports 15000 and
- the same kind of <tt>net()</tt>, except that it listens to port 15001)
+reversed!
- emulates the nfs server.
+ <p>"<tt>localhost</tt>" can be changed to the Internet hostname of a
- <p>There is no error checking or security checking of any kind. All UDP
+ remote machine, to run the simulation across a physical network.
- packets arriving at the input port are added to the emulated ethernet.
- <font color="#ff0000">This is not very good, and is the primary
+ <p><font color="#ff0000"><b>NOTE:</b> There is no error checking or
- reason why there needs to be some kind of rewrite before this
+ security checking of any kind. All UDP packets arriving at the input port
- is to be considered stable.</font>
+ are added to the emulated ethernet. This is not very good of course; use
+ this feature at your own risk.</font>

 Legend:



Removed from v.12
 


changed lines


 
Added in v.24
 Legend:



Removed from v.12
 


changed lines


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

	ViewVC Help
Powered by ViewVC 1.1.26