/[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 10 by dpavlin,
Mon Oct  8 16:18:27 2007 UTC
+revision 22 by dpavlin,
Mon Oct  8 16:19:37 2007 UTC
 Line 1
- <html>
+ <html><head><title>Gavare's eXperimental Emulator:&nbsp;&nbsp;&nbsp;Configuration files</title>
- <head><title>GXemul documentation: Configuration files</title>
+ <meta name="robots" content="noarchive,nofollow,noindex"></head>
- <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:</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.10 2005/06/21 05:38:05 debug Exp $
+ $Id: configfiles.html,v 1.19 2006/02/18 15:18:15 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 84 
 through an example is good enough:
+Line 82 
 through an example is good enough:
          <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("127.0.0.1:12346")</font>
+         <font color="#2020cf">!  add_remote("localhost:12346")</font>
      <b>)</b>
      <font color="#2020cf">!  This creates a machine:</font>
-Line 138 
 through an example is good enough:
+Line 136 
 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>
 Line 208 
 Here is an example of what a minimal con
  <p><table border="0"><tr><td width="40">&nbsp;</td><td><pre>
  <font color="#2020cf">!!gxemul</font>
  <b>emul(</b>
      <b>machine(</b>
-         <b>type(<font color="#ff003f">"dec"</font>)</b>
          <b>subtype(<font color="#ff003f">"3max"</font>)</b>
          <b>load(<font color="#ff003f">"netbsd-pmax-INSTALL-2.0"</font>)</b>
      <b>)</b>
-Line 219 
 Here is an example of what a minimal con
+Line 217 
 Here is an example of what a minimal con
  </pre>
  </td></tr></table>
- <p>For some machine types, specifying the <tt>subtype</tt> might not even
+ <p>For most machine types, <tt>type</tt> is needed. If only
- be necessary. Also, adding a <tt>net</tt> is quite useful, especially for
+ <tt>subtype</tt> is specified, and the name is unique (i.e. there is only
+ one major type which has such a subtype), then the <tt>type</tt> can be
+ omitted. Also, adding a <tt>net</tt> is quite useful, especially for
  netbooting kernels.
 Line 232 
 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
+ this, which gives higher reliability (stability) and performance, is to
+ have one configuration file per emulated machine.
+ <p><table border="0" width="100%"><tr><td width="40">&nbsp;</td>
+ <td><pre>
+ <font color="#2020cf">!!gxemul
+ !
+ !  Configuration file for a
+ !  "client" machine, netbooting
+ !  of another machine.</font>
- <p>It is possible to add multiple <tt>machine</tt> entries into one
+ <b>emul(</b>
- configuration file. This will cause the emulator to try to run all those
+     <b>net(</b>
- machines simultaneously. An alternative solution for doing this, which
+         <b>local_port(15000)</b>
- gives higher reliability (stability) and performance, is to have one
+         <b>add_remote(<font color="#ff003f">"localhost:15001"</font>)</b>
- configuration file per machine.
+     <b>)</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>
- <p><table border="0"><tr><td width="40">&nbsp;</td><td><pre>
+         <b>type(<font color="#ff003f">"sgi"</font>)</b>
- <font color="#2020cf">!!gxemul</font>
+         <b>subtype(<font color="#ff003f">"o2"</font>)</b>
+         <b>load(<font color="#ff003f">"netbsd-GENERIC32_IP3x.gz"</font>)</b>
+     <b>)</b>
+ <b>)</b></pre></td><td width="20">&nbsp;</td><td><pre>
+ <font color="#2020cf">!!gxemul
+ !
+ !  Configuration file for the
+ !  "server" machine.</font>
+ !
  <b>emul(</b>
      <b>net(</b>
-         <b>local_port(15000)</b>
+         <b>local_port(15001)</b>
-         <b>remote_add(<font color="#ff003f">"127.0.0.1:15001"</font>)</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>
+ <b>)</b></pre></td><td width="20">&nbsp;</td></tr></table>
- </pre>
- </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
  instances. <tt>local_port(15000)</tt> means that anything coming in to
  UDP port 15000 on the host is added to the network. All ethernet packets
  on the network are also sent out to all other connected machines (those
- added with <tt>remote_add()</tt>).
+ 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.10
 


changed lines


 
Added in v.22
 Legend:



Removed from v.10
 


changed lines


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

	ViewVC Help
Powered by ViewVC 1.1.26