/[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!
ViewVC logotype

Diff of /trunk/doc/configfiles.html

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

revision 23 by dpavlin, Mon Oct 8 16:19:37 2007 UTC revision 24 by dpavlin, Mon Oct 8 16:19:56 2007 UTC
# Line 10  Line 10 
10    
11  <!--  <!--
12    
13  $Id: configfiles.html,v 1.19 2006/02/18 15:18:15 debug Exp $  $Id: configfiles.html,v 1.25 2006/06/22 13:22:40 debug Exp $
14    
15  Copyright (C) 2003-2006  Anders Gavare.  All rights reserved.  Copyright (C) 2003-2006  Anders Gavare.  All rights reserved.
16    
# Line 65  through an example is good enough: Line 65  through an example is good enough:
65  <p>  <p>
66  <table border="0"><tr><td width="40">&nbsp;</td><td>  <table border="0"><tr><td width="40">&nbsp;</td><td>
67  <pre>  <pre>
68  <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.  
69  !  Anything following an exclamation mark (and also the exclamation  !  Anything following an exclamation mark (and also the exclamation
70  !  mark itself) is ignored.  !  mark itself) is ignored.
71  !  !
72  !  Each configuration file should contain one emul entry. Almost  !  Almost all settings are optional.</font>
 !  everything else is optional.</font>  
73    
74  <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>  
75    
76      <font color="#2020cf">!  This creates an ethernet network:</font>  <font color="#2020cf">!  This creates an ethernet network:</font>
77      <b>net(</b>  <b>net(</b>
78          <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>ipv4net(<font color="#ff003f">"10.2.0.0"</font>)</b>  <font color="#2020cf">!  The default is 10.0.0.0/8, but</font>
79          <b>ipv4len(16)</b>          <font color="#2020cf">!  it can be overridden like this.</font>          <b>ipv4len(16)</b>          <font color="#2020cf">!  it can be overridden like this.</font>
80          <font color="#2020cf">!  local_port(12345)</font>          <font color="#2020cf">!  local_port(12345)</font>
81          <font color="#2020cf">!  add_remote("localhost:12346")</font>          <font color="#2020cf">!  add_remote("localhost:12346")</font>
82      <b>)</b>  <b>)</b>
83    
84      <font color="#2020cf">!  This creates a machine:</font>  <font color="#2020cf">!  This creates a machine:</font>
85      <b>machine(</b>  <b>machine(</b>
86          <b>name(<font color="#ff003f">"My test machine"</font>)</b>          <b>name(<font color="#ff003f">"My test machine"</font>)</b>
87    
88          <font color="#2020cf">! serial_nr(123)    ! Useful when emulating multiple machines</font>          <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:
132          <font color="#2020cf">! force_netboot(yes)</font>          <font color="#2020cf">! force_netboot(yes)</font>
133          <font color="#2020cf">! start_paused(yes)</font>          <font color="#2020cf">! start_paused(yes)</font>
134    
         <font color="#2020cf">! max_random_cycles(5)</font>  
   
135          <b>disk(<font color="#ff003f">"nbsd.img"</font>)</b>          <b>disk(<font color="#ff003f">"nbsd.img"</font>)</b>
136          <b>disk(<font color="#ff003f">"6c:cdrom.iso"</font>)</b>          <b>disk(<font color="#ff003f">"6c:cdrom.iso"</font>)</b>
137    
138          <b>use_x11(yes)</b>          <b>use_x11(yes)</b>
139          <b>x11_scaledown(2)</b>          <b>x11_scaledown(2)</b>
140    
         <font color="#2020cf">! bintrans(disable)</font>  
         <font color="#2020cf">! old_bintrans(enable)</font>  
         <font color="#2020cf">! bintrans_size(24)</font>  
   
141          <font color="#2020cf">! slow_serial_interrupts_hack_for_linux(yes)</font>          <font color="#2020cf">! slow_serial_interrupts_hack_for_linux(yes)</font>
142    
         <font color="#2020cf">! debugger_on_badaddr(yes)</font>  
   
143          <font color="#2020cf">{          <font color="#2020cf">{
144              Long comments spanning multiple lines should be surrounded              Long comments spanning multiple lines should be surrounded
145              with tuborg parentheses.              with tuborg parentheses.
# Line 166  through an example is good enough: Line 154  through an example is good enough:
154            -p pc     add a breakpoint (remember to use the '0x' prefix for hex!)            -p pc     add a breakpoint (remember to use the '0x' prefix for hex!)
155            -r        register dumps before every instruction            -r        register dumps before every instruction
156            -t        show function trace tree            -t        show function trace tree
           -y x      set max_random_cycles_per_chunk to x (experimental)  
157          </i></b>-->          </i></b>-->
158          }</font>          }</font>
159    
160      <b>)</b>  <b>)</b>
161    
162      <font color="#2020cf">!  Multiple machine are allowed.</font>  <font color="#2020cf">!  Multiple machine definitions are allowed.</font>
163      <b>machine(</b>  <b>machine(</b>
164          <b>name(<font color="#ff003f">"another machine"</font>)</b>          <b>name(<font color="#ff003f">"another machine"</font>)</b>
165          <b>type(<font color="#ff003f">"hpcmips"</font>)</b>          <b>type(<font color="#ff003f">"hpcmips"</font>)</b>
166          <b>subtype(<font color="#ff003f">"be300"</font>)</b>          <b>subtype(<font color="#ff003f">"be300"</font>)</b>
167    
168          <i>...</i>          <i>...</i>
     <b>)</b>  
169  <b>)</b>  <b>)</b>
170  </pre>  </pre>
171  </td></tr></table>  </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
193  Here is an example of what a minimal configuration file might look like:  Here is an example of what a minimal configuration file might look like:
194    
195  <p><table border="0"><tr><td width="40">&nbsp;</td><td><pre>  <p><table border="0"><tr><td width="40">&nbsp;</td><td><pre>
196  <font color="#2020cf">!!gxemul</font>  <b>machine(</b>
197  <b>emul(</b>      <b>subtype(<font color="#ff003f">"3max"</font>)</b>
198      <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>  
199  <b>)</b>  <b>)</b>
200  </pre>  </pre>
201  </td></tr></table>  </td></tr></table>
# Line 240  have one configuration file per emulated Line 223  have one configuration file per emulated
223    
224  <p><table border="0" width="100%"><tr><td width="40">&nbsp;</td>  <p><table border="0" width="100%"><tr><td width="40">&nbsp;</td>
225  <td><pre>  <td><pre>
226  <font color="#2020cf">!!gxemul  <font color="#2020cf">!  Configuration file for a
 !  
 !  Configuration file for a  
227  !  "client" machine, netbooting  !  "client" machine, netbooting
228  !  of another machine.</font>  !  of another machine.</font>
229    
230  <b>emul(</b>  <b>net(</b>
     <b>net(</b>  
231          <b>local_port(15000)</b>          <b>local_port(15000)</b>
232          <b>add_remote(<font color="#ff003f">"localhost:15001"</font>)</b>          <b>add_remote(<font color="#ff003f">"localhost:15001"</font>)</b>
233      <b>)</b>  <b>)</b>
234      <b>machine(</b>  <b>machine(</b>
235          <b>name(<font color="#ff003f">"client machine"</font>)</b>          <b>name(<font color="#ff003f">"client machine"</font>)</b>
236          <b>serial_nr(1)</b>     <font color="#2020cf">!  10.0.0.1</font>          <b>serial_nr(1)</b>     <font color="#2020cf">!  10.0.0.1</font>
237    
238          <b>type(<font color="#ff003f">"sgi"</font>)</b>          <b>type(<font color="#ff003f">"sgi"</font>)</b>
239          <b>subtype(<font color="#ff003f">"o2"</font>)</b>          <b>subtype(<font color="#ff003f">"o2"</font>)</b>
240          <b>load(<font color="#ff003f">"netbsd-GENERIC32_IP3x.gz"</font>)</b>          <b>load(<font color="#ff003f">"netbsd-GENERIC32_IP3x.gz"</font>)</b>
241      <b>)</b>  <b>)</b>
242  <b>)</b></pre></td><td width="20">&nbsp;</td><td><pre>  </pre></td><td width="20">&nbsp;</td><td><pre>
243  <font color="#2020cf">!!gxemul  <font color="#2020cf">!  Configuration file for the
 !  
 !  Configuration file for the  
244  !  "server" machine.</font>  !  "server" machine.</font>
 !  
245    
246  <b>emul(</b>  <b>net(</b>
     <b>net(</b>  
247          <b>local_port(15001)</b>          <b>local_port(15001)</b>
248          <b>add_remote(<font color="#ff003f">"localhost:15000"</font>)</b>          <b>add_remote(<font color="#ff003f">"localhost:15000"</font>)</b>
249      <b>)</b>  <b>)</b>
250      <b>machine(</b>  <b>machine(</b>
251          <b>name(<font color="#ff003f">"nfs server"</font>)</b>          <b>name(<font color="#ff003f">"nfs server"</font>)</b>
252          <b>serial_nr(2)</b>     <font color="#2020cf">!  10.0.0.2</font>          <b>serial_nr(2)</b>     <font color="#2020cf">!  10.0.0.2</font>
253    
254          <b>type(<font color="#ff003f">"dec"</font>)</b>          <b>type(<font color="#ff003f">"dec"</font>)</b>
255          <b>subtype(<font color="#ff003f">"3max"</font>)</b>          <b>subtype(<font color="#ff003f">"3max"</font>)</b>
256          <b>disk(<font color="#ff003f">"nbsd_pmax.img"</font>)</b>          <b>disk(<font color="#ff003f">"nbsd_pmax.img"</font>)</b>
257      <b>)</b>  <b>)</b>
258  <b>)</b></pre></td><td width="20">&nbsp;</td></tr></table>  </pre></td><td width="20">&nbsp;</td></tr></table>
259    
260  <p>This example creates a network using the default settings (10.0.0.0/8),  <p>This example creates a network using the default settings (10.0.0.0/8),
261  but it also allows the network to be connected to other emulator  but it also allows the network to be connected to other emulator
Legend:
Removed from v.23  
changed lines
  Added in v.24
  ViewVC Help
Powered by ViewVC 1.1.26