/[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

Annotation of /trunk/doc/configfiles.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 6 - (hide annotations)
Mon Oct 8 16:18:11 2007 UTC (16 years, 5 months ago) by dpavlin
File MIME type: text/html
File size: 8052 byte(s)
++ trunk/HISTORY	(local)
$Id: HISTORY,v 1.772 2005/06/04 12:02:16 debug Exp $
20050428	Disabling the "-fmove-all-movables" option in the configure
		script, because it causes the compile to fail on OpenBSD/sgi.
20050502	Minor updates.
20050503	Removing the WRT54G mode (it was bogus anyway), and adding a
		comment about Windows NT for MIPS in doc/experiments.html.
		Minor updates to the x86 instruction decoding.
20050504	Adding some more x86 instructions.
		Adding support for reading files from ISO9660 CDROMs (including
		gzipped files). It's an ugly hack, but it seems to work.
		Various other minor updates (dev_vga.c, pc_bios.c etc).
20050505	Some more x86-related updates.
		Beginning (what I hope will be) a major code cleanup phase.
		"bootris" (an x86 bootsector) runs :-)
20050506	Adding some more x86 instructions.
20050507	tmpnam => mkstemp.
		Working on a hack to allow VGA charcells to be shown even when
		not running with X11.
		Adding more x86 instructions.
20050508	x86 32-bit SIB addressing fix, and more instructions.
20050509	Adding more x86 instructions.
20050510	Minor documentation updates, and other updates (x86 stuff etc.)
20050511	More x86-related updates.
20050513	Various updates, mostly x86-related. (Trying to fix flag 
		calculation, factoring out the ugly shift/rotate code, and
		some other things.)
20050514	Adding support for loading some old i386 a.out executables.
		Finally beginning the cleanup of machine/PROM/bios dependant
		info.
		Some minor documentation updates.
		Trying to clean up ARCBIOS stuff a little.
20050515	Trying to make it possible to actually use more than one disk
		type per machine (floppy, ide, scsi).
		Trying to clean up the kbd vs PROM console stuff. (For PC and
		ARC emulation modes, mostly.)
		Beginning to add an 8259 interrupt controller, and connecting
		it to the x86 emulation.
20050516	The first x86 interrupts seem to work (keyboard stuff).
		Adding a 8253/8254 programmable interval timer skeleton.
		FreeDOS now reaches a command prompt and can be interacted
		with.
20050517	After some bugfixes, MS-DOS also (sometimes) reaches a
		command prompt now.
		Trying to fix the pckbc to work with MS-DOS' keyb.com, but no
		success yet.
20050518	Adding a simple 32-bit x86 MMU skeleton.
20050519	Some more work on the x86 stuff. (Beginning the work on paging,
		and various other fixes).
20050520	More updates. Working on dev_vga (4-bit graphics modes), adding
		40 columns support to the PC bios emulation.
		Trying to add support for resizing windows when switching
		between graphics modes.
20050521	Many more x86-related updates.
20050522	Correcting the initial stack pointer's sign-extension for
		ARCBIOS emulation (thanks to Alec Voropay for noticing the
		error).
		Continuing on the cleanup (ARCBIOS etc).
		dev_vga updates.
20050523	More x86 updates: trying to add some support for protected mode
		interrupts (via gate descriptors) and many other fixes.
		More ARCBIOS cleanup.
		Adding a device flag which indicates that reads cause no
		side-effects. (Useful for the "dump" command in the debugger,
		and other things.)
		Adding support for directly starting up x86 ELFs, skipping the
		bootloader stage. (Most ELFs, however, are not suitable for
		this.)
20050524	Adding simple 32-bit x86 TSS task switching, but no privilege
		level support yet.
		More work on dev_vga. A small "Copper bars" demo works. :-)
		Adding support for Trap Flag (single-step exceptions), at least
		in real mode, and various other x86-related fixes.
20050525	Adding a new disk image prefix (gH;S;) which can be used to
		override the default nr of heads and sectors per track.
20050527	Various bug fixes, more work on the x86 mode (stack change on
		interrupts between different priv.levels), and some minor
		documentation updates.
20050528	Various fixes (x86 stuff).
20050529	More x86 fixes. An OpenBSD/i386 bootfloppy reaches userland
		and can be interacted with (although there are problems with
		key repetition). NetBSD/i386 triggers a serious CISC-related
		problem: instruction fetches across page boundaries, where
		the later part isn't actually part of the instruction.
20050530	Various minor updates. (Documentation updates, etc.)
20050531	Adding some experimental code (experiments/new_test_*) which
		could be useful for dynamic (but not binary) translation in
		the future.
20050602	Adding a dummy ARM skeleton.
		Fixing the pckbc key repetition problem (by adding release
		scancodes for all keypresses).
20050603	Minor updates for the next release.
20050604	Release testing. Minor updates.

==============  RELEASE 0.3.3  ==============

20050604	There'll probably be a 0.3.3.1 release soon, with some very
		very tiny updates.


1 dpavlin 2 <html>
2     <head><title>GXemul documentation: Configuration files</title>
3     </head>
4 dpavlin 4 <body bgcolor="#f8f8f8" text="#000000" link="#4040f0" vlink="#404040" alink="#ff0000">
5     <table border=0 width=100% bgcolor="#d0d0d0"><tr>
6     <td width=100% align=center valign=center><table border=0 width=100%><tr>
7     <td align="left" valign=center bgcolor="#d0efff"><font color="#6060e0" size="6">
8     <b>GXemul documentation:</b></font>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
9     <font color="#000000" size="6"><b>Configuration files</b>
10     </font></td></tr></table></td></tr></table><p>
11 dpavlin 2 <!-- The first 10 lines are cut away by the homepage updating script. -->
12    
13    
14     <!--
15    
16 dpavlin 6 $Id: configfiles.html,v 1.7 2005/05/31 06:20:37 debug Exp $
17 dpavlin 2
18     Copyright (C) 2003-2005 Anders Gavare. All rights reserved.
19    
20     Redistribution and use in source and binary forms, with or without
21     modification, are permitted provided that the following conditions are met:
22    
23     1. Redistributions of source code must retain the above copyright
24     notice, this list of conditions and the following disclaimer.
25     2. Redistributions in binary form must reproduce the above copyright
26     notice, this list of conditions and the following disclaimer in the
27     documentation and/or other materials provided with the distribution.
28     3. The name of the author may not be used to endorse or promote products
29     derived from this software without specific prior written permission.
30    
31     THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
32     ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
33     IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
34     ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
35     FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36     DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37     OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38     HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
39     LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
40     OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
41     SUCH DAMAGE.
42    
43     -->
44    
45     <a href="./">Back to the index</a>
46    
47     <p><br>
48     <h2>Configuration files</h2>
49    
50     <p>
51     <ul>
52     <li><a href="#config">Configuration file syntax</a>
53     <li><a href="#minimal">A minimal example</a>
54     </ul>
55    
56    
57    
58    
59     <p><br>
60     <a name="config"></a>
61     <h3>Configuration file syntax:</h3>
62    
63     Configuration files are simple text files. I don't have time to write
64     down a formal syntax right now, so I hope that conveying the syntax
65     through an example is good enough:
66    
67     <p>
68     <table border="0"><tr><td width="40">&nbsp;</td><td>
69     <pre>
70     <font color="#2020cf">!!gxemul <-- configuration files must start like this
71     !
72     ! This is an example configuration file for GXemul.
73     ! Anything following an exclamation mark (and also the exclamation
74     ! mark itself) is ignored.
75     !
76     ! Each configuration file should contain one emul entry. Almost
77     ! everything else is optional.</font>
78    
79     <b>emul(</b>
80     <b>name(<font color="#ff003f">"my test emul"</font>)</b> <font color="#2020cf">! Optional name of this emulation</font>
81    
82     <font color="#2020cf">! This creates a network (ethernet):</font>
83     <b>net(</b>
84     <b>ipv4net(<font color="#ff003f">"10.2.0.0"</font>)</b> <font color="#2020cf">! The default is 10.0.0.0/8, but</font>
85     <b>ipv4len(16)</b> <font color="#2020cf">! it can be overridden like this.</font>
86     <b>)</b>
87    
88     <font color="#2020cf">! This creates a machine:</font>
89     <b>machine(</b>
90     <b>name(<font color="#ff003f">"My test machine"</font>)</b>
91    
92     <font color="#2020cf">! serial_nr(123) ! Useful when emulating multiple machines</font>
93     <font color="#2020cf"> ! on multiple hosts, and they need to have</font>
94     <font color="#2020cf"> ! unique MAC addresses, etc.</font>
95    
96     <b>type(<font color="#ff003f">"dec"</font>)</b> <font color="#2020cf">! This is actually not optional</font>
97     <b>subtype(<font color="#ff003f">"5000/200"</font>)</b>
98    
99 dpavlin 6 <b>cpu(<font color="#ff003f">"R3000"</font>)</b> <font color="#2020cf">! Normally set implicitly to a reasonable</font>
100 dpavlin 2 <font color="#2020cf">! value, depending on <i>type</i> and <i>subtype</i></font>
101    
102     <font color="#2020cf">! ncpus(4)</font>
103     <font color="#2020cf">! use_random_bootstrap_cpu(yes)</font>
104    
105     <b>memory(128)</b> <font color="#2020cf">! 128 MB memory. This overrides</font>
106     <font color="#2020cf">! the default amount of memory for</font>
107     <font color="#2020cf">! this machine type.</font>
108    
109     <font color="#2020cf">! random_mem_contents(yes)</font>
110    
111     <font color="#2020cf">! prom_emulation(no)</font>
112    
113     <font color="#2020cf">! byte_order(big) ! Normally set implicitly (because</font>
114     <font color="#2020cf">! of <i>type</i> and <i>subtype</i>, or decided</font>
115     <font color="#2020cf">! from the file loaded with <i>load</i></font>
116    
117     <b>load(<font color="#ff003f">"netbsd-INSTALL"</font>)</b>
118     <b>bootname(<font color="#ff003f">"netbsd"</font>)</b>
119     <b>bootarg(<font color="#ff003f">"-a"</font>)</b>
120    
121     <font color="#2020cf">! n_gfx_cards(2) ! for DECstation dual/tripple-head</font>
122     <font color="#2020cf">! emulated_hz(10000000) ! for fixing the emulated clock speed</font>
123    
124     <font color="#2020cf">! add_x11_display("otherbox:0") ! for dual/tripple-head etc</font>
125     <font color="#2020cf">! add_x11_display("thisbox:0")</font>
126    
127     <font color="#2020cf">{
128     Devices can be added like this:
129    
130     device("8250 addr=0x18000800 addr_mult=4")
131    
132     The name comes first, followed by optional parameters.
133     Remember to use 0x for hexadecimal values.
134     }</font>
135    
136     <font color="#2020cf">! force_netboot(yes)</font>
137     <font color="#2020cf">! start_paused(yes)</font>
138    
139     <b>disk(<font color="#ff003f">"nbsd.img"</font>)</b>
140     <b>disk(<font color="#ff003f">"6c:cdrom.iso"</font>)</b>
141    
142     <b>use_x11(yes)</b>
143     <b>x11_scaledown(2)</b>
144    
145     <font color="#2020cf">! bintrans(disable)</font>
146     <font color="#2020cf">! old_bintrans(enable)</font>
147     <font color="#2020cf">! bintrans_size(24)</font>
148    
149     <font color="#2020cf">! slow_serial_interrupts_hack_for_linux(yes)</font>
150    
151     <font color="#2020cf">! debugger_on_badaddr(yes)</font>
152    
153     <font color="#2020cf">{
154     Long comments spanning multiple lines should be surrounded
155     with tuborg parentheses.
156    
157     { Long comments can be nested. }
158     <!--
159     <b><i>... TODO ...
160     -i display each instruction as it is executed
161     -J disable some speed tricks
162     -m nr run at most nr instructions (on any cpu)
163     -N display nr of instructions/second average, at regular intervals
164     -p pc add a breakpoint (remember to use the '0x' prefix for hex!)
165     -r register dumps before every instruction
166     -t show function trace tree
167     -y x set max_random_cycles_per_chunk to x (experimental)
168     </i></b>-->
169     }</font>
170    
171     <b>)</b>
172    
173     <font color="#2020cf">! Multiple machine are allowed.</font>
174     <b>machine(</b>
175     <b>name(<font color="#ff003f">"another machine"</font>)</b>
176     <b>type(<font color="#ff003f">"hpcmips"</font>)</b>
177     <b>subtype(<font color="#ff003f">"be300"</font>)</b>
178    
179     <i>...</i>
180     <b>)</b>
181     <b>)</b>
182     </pre>
183     </td></tr></table>
184    
185     <p>
186     Starting the emulator with a configuration file is as simple as
187    
188     <pre>
189     $ <b>./gxemul @myconfig</b>
190     </pre>
191    
192     if <b>myconfig</b> is the name of the configuration file.
193    
194    
195    
196    
197    
198    
199     <p><br>
200     <a name="minimal"></a>
201     <h3>A minimal example:</h3>
202    
203     Here is an example of what a minimal configuration file might look like:
204    
205     <p>
206     <table border="0"><tr><td width="40">&nbsp;</td><td>
207     <pre>
208     <font color="#2020cf">!!gxemul</font>
209    
210     <b>emul(</b>
211     <b>machine(</b>
212     <b>type(<font color="#ff003f">"dec"</font>)</b>
213     <b>subtype(<font color="#ff003f">"3max"</font>)</b>
214     <b>load(<font color="#ff003f">"netbsd-pmax-INSTALL-2.0"</font>)</b>
215     <b>)</b>
216     <b>)</b>
217     </pre>
218     </td></tr></table>
219    
220     <p>
221     For some machine types, specifying the <b>subtype</b> might not even be
222     necessary. Also, adding a <b>net</b> is quite useful, especially for
223     netbooting kernels.
224    
225    
226    
227    
228    
229     </p>
230    
231     </body>
232     </html>

  ViewVC Help
Powered by ViewVC 1.1.26