Fixed compilation error
[bochs-mirror.git] / .bochsrc
blob9459aa5391733db65e0808bf7827c26e092e0314
1 # You may now use double quotes around pathnames, in case
2 # your pathname includes spaces.
4 #=======================================================================
5 # CONFIG_INTERFACE
7 # The configuration interface is a series of menus or dialog boxes that
8 # allows you to change all the settings that control Bochs's behavior.
9 # There are two choices of configuration interface: a text mode version
10 # called "textconfig" and a graphical version called "wx".  The text
11 # mode version uses stdin/stdout and is always compiled in.  The graphical
12 # version is only available when you use "--with-wx" on the configure 
13 # command.  If you do not write a config_interface line, Bochs will 
14 # choose a default for you.
16 # NOTE: if you use the "wx" configuration interface, you must also use
17 # the "wx" display library.
18 #=======================================================================
19 #config_interface: textconfig
20 #config_interface: wx
22 #=======================================================================
23 # DISPLAY_LIBRARY
25 # The display library is the code that displays the Bochs VGA screen.  Bochs 
26 # has a selection of about 10 different display library implementations for 
27 # different platforms.  If you run configure with multiple --with-* options, 
28 # the display_library command lets you choose which one you want to run with.
29 # If you do not write a display_library line, Bochs will choose a default for
30 # you.
32 # The choices are: 
33 #   x              use X windows interface, cross platform
34 #   win32          use native win32 libraries
35 #   carbon         use Carbon library (for MacOS X)
36 #   beos           use native BeOS libraries
37 #   macintosh      use MacOS pre-10
38 #   amigaos        use native AmigaOS libraries
39 #   sdl            use SDL library, cross platform
40 #   svga           use SVGALIB library for Linux, allows graphics without X11
41 #   term           text only, uses curses/ncurses library, cross platform
42 #   rfb            provides an interface to AT&T's VNC viewer, cross platform
43 #   wx             use wxWidgets library, cross platform
44 #   nogui          no display at all
46 # NOTE: if you use the "wx" configuration interface, you must also use
47 # the "wx" display library.
49 # Specific options:
50 # Some display libraries now support specific option to control their
51 # behaviour. See the examples below for currently supported options.
52 #=======================================================================
53 #display_library: amigaos
54 #display_library: beos
55 #display_library: carbon
56 #display_library: macintosh
57 #display_library: nogui
58 #display_library: rfb, options="timeout=60" # time to wait for client
59 #display_library: sdl, options="fullscreen" # startup in fullscreen mode
60 #display_library: term
61 #display_library: win32, options="legacyF12" # use F12 to toggle mouse
62 #display_library: win32, options="windebug"  # use Win32 debugger gui
63 #display_library: wx
64 #display_library: x, options="hideIPS" # disable IPS output in status bar
66 #=======================================================================
67 # ROMIMAGE:
68 # The ROM BIOS controls what the PC does when it first powers on.
69 # Normally, you can use a precompiled BIOS in the source or binary
70 # distribution called BIOS-bochs-latest. The ROM BIOS is usually loaded
71 # starting at address 0xf0000, and it is exactly 64k long. Another option
72 # is 128k BIOS which is loaded at address 0xe0000.
73 # You can also use the environment variable $BXSHARE to specify the
74 # location of the BIOS.
75 # The usage of external large BIOS images (up to 512k) at memory top is
76 # now supported, but we still recommend to use the BIOS distributed with
77 # Bochs. The start address optional, since it can be calculated from image size.
78 #=======================================================================
79 romimage: file=$BXSHARE/BIOS-bochs-latest 
80 #romimage: file=mybios.bin, address=0xfff80000 # 512k at memory top
82 #=======================================================================
83 # CPU:
84 # This defines cpu-related parameters inside Bochs:
86 #  COUNT:
87 #  Set the number of processors:cores per processor:threads per core 
88 #  when Bochs is compiled for SMP emulation.
89 #  Bochs currently supports up to 8 threads running simultaniosly. 
90 #  If Bochs is compiled without SMP support, it won't accept values 
91 #  different from 1.
93 #  QUANTUM:
94 #  Maximum amount of instructions allowed to execute by processor before
95 #  returning control to another cpu. This option exists only in Bochs 
96 #  binary compiled with SMP support.
98 #  RESET_ON_TRIPLE_FAULT:
99 #  Reset the CPU when triple fault occur (highly recommended) rather than
100 #  PANIC. Remember that if you trying to continue after triple fault the 
101 #  simulation will be completely bogus !
103 #  CPUID_LIMIT_WINNT:
104 #  Determine whether to limit maximum CPUID function to 3. This mode is
105 #  required to workaround WinNT installation and boot issues.
107 #  VENDOR_STRING:
108 #  Set the CPUID vendor string returned by CPUID(0x0). This should be a
109 #  twelve-character ASCII string.  
111 #  BRAND_STRING:
112 #  Set the CPUID vendor string returned by CPUID(0x80000002 .. 0x80000004).  
113 #  This should be at most a forty-eight-character ASCII string.  
115 #  IPS:
116 #  Emulated Instructions Per Second. This is the number of IPS that bochs
117 #  is capable of running on your machine. You can recompile Bochs with
118 #  --enable-show-ips option enabled, to find your host's capability.
119 #  Measured IPS value will then be logged into your log file or shown
120 #  in the status bar (if supported by the gui).
122 #  IPS is used to calibrate many time-dependent events within the bochs 
123 #  simulation.  For example, changing IPS affects the frequency of VGA
124 #  updates, the duration of time before a key starts to autorepeat, and
125 #  the measurement of BogoMips and other benchmarks.
127 #  Examples:
129 #  Bochs Machine/Compiler                                 Mips
130 # ____________________________________________________________________
131 #  2.3.7 3.2Ghz Intel Core 2 Q9770 with WinXP/g++ 3.4    50 to 55 Mips
132 #  2.3.7 2.6Ghz Intel Core 2 Duo with WinXP/g++ 3.4      38 to 43 Mips
133 #  2.2.6 2.6Ghz Intel Core 2 Duo with WinXP/g++ 3.4      21 to 25 Mips
134 #  2.2.6 2.1Ghz Athlon XP with Linux 2.6/g++ 3.4         12 to 15 Mips
135 #  2.0.1 1.6Ghz Intel P4 with Win2000/g++ 3.3             5 to  7 Mips
136 #=======================================================================
137 cpu: count=1, ips=10000000, reset_on_triple_fault=1, cpuid_limit_winnt=0
139 #=======================================================================
140 # MEGS
141 # Set the number of Megabytes of physical memory you want to emulate. 
142 # The default is 32MB, most OS's won't need more than that.
143 # The maximum amount of memory supported is 2048Mb.
144 #=======================================================================
145 #megs: 256
146 #megs: 128
147 #megs: 64
148 megs: 32
149 #megs: 16
150 #megs: 8
152 #=======================================================================
153 # OPTROMIMAGE[1-4]:
154 # You may now load up to 4 optional ROM images. Be sure to use a 
155 # read-only area, typically between C8000 and EFFFF. These optional
156 # ROM images should not overwrite the rombios (located at
157 # F0000-FFFFF) and the videobios (located at C0000-C7FFF).
158 # Those ROM images will be initialized by the bios if they contain 
159 # the right signature (0x55AA) and a valid checksum.
160 # It can also be a convenient way to upload some arbitrary code/data
161 # in the simulation, that can be retrieved by the boot loader
162 #=======================================================================
163 #optromimage1: file=optionalrom.bin, address=0xd0000
164 #optromimage2: file=optionalrom.bin, address=0xd1000
165 #optromimage3: file=optionalrom.bin, address=0xd2000
166 #optromimage4: file=optionalrom.bin, address=0xd3000
168 #optramimage1: file=/path/file1.img, address=0x0010000
169 #optramimage2: file=/path/file2.img, address=0x0020000
170 #optramimage3: file=/path/file3.img, address=0x0030000
171 #optramimage4: file=/path/file4.img, address=0x0040000
173 #=======================================================================
174 # VGAROMIMAGE
175 # You now need to load a VGA ROM BIOS into C0000.
176 #=======================================================================
177 #vgaromimage: file=bios/VGABIOS-elpin-2.40
178 vgaromimage: file=$BXSHARE/VGABIOS-lgpl-latest
179 #vgaromimage: file=bios/VGABIOS-lgpl-latest-cirrus
181 #=======================================================================
182 # VGA:
183 # Here you can specify the display extension to be used. With the value
184 # 'none' you can use standard VGA with no extension. Other supported
185 # values are 'vbe' for Bochs VBE and 'cirrus' for Cirrus SVGA support.
186 #=======================================================================
187 #vga: extension=cirrus
188 vga: extension=vbe
190 #=======================================================================
191 # FLOPPYA:
192 # Point this to pathname of floppy image file or device
193 # This should be of a bootable floppy(image/device) if you're
194 # booting from 'a' (or 'floppy').
196 # You can set the initial status of the media to 'ejected' or 'inserted'.
197 #   floppya: 2_88=path, status=ejected             (2.88M 3.5" floppy)
198 #   floppya: 1_44=path, status=inserted            (1.44M 3.5" floppy)
199 #   floppya: 1_2=path, status=ejected              (1.2M  5.25" floppy)
200 #   floppya: 720k=path, status=inserted            (720K  3.5" floppy)
201 #   floppya: 360k=path, status=inserted            (360K  5.25" floppy)
202 #   floppya: 320k=path, status=inserted            (320K  5.25" floppy)
203 #   floppya: 180k=path, status=inserted            (180K  5.25" floppy)
204 #   floppya: 160k=path, status=inserted            (160K  5.25" floppy)
205 #   floppya: image=path, status=inserted           (guess type from image size)
207 # The path should be the name of a disk image file.  On Unix, you can use a raw
208 # device name such as /dev/fd0 on Linux.  On win32 platforms, use drive letters
209 # such as a: or b: as the path.  The parameter 'image' works with image files
210 # only. In that case the size must match one of the supported types.
211 #=======================================================================
212 floppya: 1_44=/dev/fd0, status=inserted
213 #floppya: image=../1.44, status=inserted
214 #floppya: 1_44=/dev/fd0H1440, status=inserted
215 #floppya: 1_2=../1_2, status=inserted
216 #floppya: 1_44=a:, status=inserted
217 #floppya: 1_44=a.img, status=inserted
218 #floppya: 1_44=/dev/rfd0a, status=inserted
220 #=======================================================================
221 # FLOPPYB:
222 # See FLOPPYA above for syntax
223 #=======================================================================
224 #floppyb: 1_44=b:, status=inserted
225 #floppyb: 1_44=b.img, status=inserted
227 #=======================================================================
228 # ATA0, ATA1, ATA2, ATA3
229 # ATA controller for hard disks and cdroms
231 # ata[0-3]: enabled=[0|1], ioaddr1=addr, ioaddr2=addr, irq=number
233 # These options enables up to 4 ata channels. For each channel
234 # the two base io addresses and the irq must be specified.
236 # ata0 and ata1 are enabled by default with the values shown below
238 # Examples:
239 #   ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
240 #   ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
241 #   ata2: enabled=1, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
242 #   ata3: enabled=1, ioaddr1=0x168, ioaddr2=0x360, irq=9
243 #=======================================================================
244 ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
245 ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
246 ata2: enabled=0, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
247 ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x360, irq=9
249 #=======================================================================
250 # ATA[0-3]-MASTER, ATA[0-3]-SLAVE
252 # This defines the type and characteristics of all attached ata devices:
253 #   type=       type of attached device [disk|cdrom] 
254 #   mode=       only valid for disks [flat|concat|external|dll|sparse|vmware3]
255 #   mode=       only valid for disks [undoable|growing|volatile]
256 #   path=       path of the image
257 #   cylinders=  only valid for disks
258 #   heads=      only valid for disks
259 #   spt=        only valid for disks
260 #   status=     only valid for cdroms [inserted|ejected]
261 #   biosdetect= type of biosdetection [none|auto], only for disks on ata0 [cmos]
262 #   translation=type of translation of the bios, only for disks [none|lba|large|rechs|auto]
263 #   model=      string returned by identify device command
264 #   journal=    optional filename of the redolog for undoable and volatile disks
265 #   
266 # Point this at a hard disk image file, cdrom iso file, or physical cdrom
267 # device.  To create a hard disk image, try running bximage.  It will help you
268 # choose the size and then suggest a line that works with it.
270 # In UNIX it may be possible to use a raw device as a Bochs hard disk, 
271 # but WE DON'T RECOMMEND IT.  In Windows there is no easy way.
273 # In windows, the drive letter + colon notation should be used for cdroms.
274 # Depending on versions of windows and drivers, you may only be able to 
275 # access the "first" cdrom in the system.  On MacOSX, use path="drive"
276 # to access the physical drive.
278 # The path is always mandatory. Disk geometry autodetection works with images
279 # created by bximage if CHS is set to 0/0/0 (cylinders are calculated using
280 # heads=16 and spt=63). For other hard disk images and modes the cylinders,
281 # heads, and spt are mandatory.
283 # Default values are:
284 #   mode=flat, biosdetect=auto, translation=auto, model="Generic 1234"
286 # The biosdetect option has currently no effect on the bios
288 # Examples:
289 #   ata0-master: type=disk, mode=flat, path=10M.sample, cylinders=306, heads=4, spt=17
290 #   ata0-slave:  type=disk, mode=flat, path=20M.sample, cylinders=615, heads=4, spt=17
291 #   ata1-master: type=disk, mode=flat, path=30M.sample, cylinders=615, heads=6, spt=17
292 #   ata1-slave:  type=disk, mode=flat, path=46M.sample, cylinders=940, heads=6, spt=17
293 #   ata2-master: type=disk, mode=flat, path=62M.sample, cylinders=940, heads=8, spt=17
294 #   ata2-slave:  type=disk, mode=flat, path=112M.sample, cylinders=900, heads=15, spt=17
295 #   ata3-master: type=disk, mode=flat, path=483M.sample, cylinders=1024, heads=15, spt=63
296 #   ata3-slave:  type=cdrom, path=iso.sample, status=inserted
297 #=======================================================================
298 ata0-master: type=disk, mode=flat, path="30M.sample"
299 #ata0-master: type=disk, mode=flat, path="30M.sample", cylinders=615, heads=6, spt=17
300 #ata0-master: type=disk, mode=flat, path="c.img", cylinders=0 # autodetect
301 #ata0-slave: type=cdrom, path=D:, status=inserted
302 #ata0-slave: type=cdrom, path=/dev/cdrom, status=inserted
303 #ata0-slave: type=cdrom, path="drive", status=inserted
304 #ata0-slave: type=cdrom, path=/dev/rcd0d, status=inserted 
306 #=======================================================================
307 # BOOT:
308 # This defines the boot sequence. Now you can specify up to 3 boot drives,
309 # which can be 'floppy', 'disk', 'cdrom' or 'network' (boot ROM).
310 # Legacy 'a' and 'c' are also supported.
311 # Examples:
312 #   boot: floppy
313 #   boot: cdrom, disk
314 #   boot: network, disk
315 #   boot: cdrom, floppy, disk
316 #=======================================================================
317 #boot: floppy
318 boot: disk
320 #=======================================================================
321 # CLOCK:
322 # This defines the parameters of the clock inside Bochs:
324 #  SYNC:
325 #  TO BE COMPLETED (see Greg explanation in feature request #536329)
327 #  TIME0:
328 #  Specifies the start (boot) time of the virtual machine. Use a time 
329 #  value as returned by the time(2) system call. If no time0 value is 
330 #  set or if time0 equal to 1 (special case) or if time0 equal 'local', 
331 #  the simulation will be started at the current local host time.
332 #  If time0 equal to 2 (special case) or if time0 equal 'utc',
333 #  the simulation will be started at the current utc time.
335 # Syntax:
336 #  clock: sync=[none|slowdown|realtime|both], time0=[timeValue|local|utc]
338 # Example:
339 #   clock: sync=none,     time0=local       # Now (localtime)
340 #   clock: sync=slowdown, time0=315529200   # Tue Jan  1 00:00:00 1980
341 #   clock: sync=none,     time0=631148400   # Mon Jan  1 00:00:00 1990
342 #   clock: sync=realtime, time0=938581955   # Wed Sep 29 07:12:35 1999
343 #   clock: sync=realtime, time0=946681200   # Sat Jan  1 00:00:00 2000
344 #   clock: sync=none,     time0=1           # Now (localtime)
345 #   clock: sync=none,     time0=utc         # Now (utc/gmt)
347 # Default value are sync=none, time0=local
348 #=======================================================================
349 #clock: sync=none, time0=local
352 #=======================================================================
353 # FLOPPY_BOOTSIG_CHECK: disabled=[0|1]
354 # Enables or disables the 0xaa55 signature check on boot floppies
355 # Defaults to disabled=0
356 # Examples:
357 #   floppy_bootsig_check: disabled=0
358 #   floppy_bootsig_check: disabled=1
359 #=======================================================================
360 floppy_bootsig_check: disabled=0
362 #=======================================================================
363 # LOG:
364 # Give the path of the log file you'd like Bochs debug and misc. verbiage
365 # to be written to. If you don't use this option or set the filename to
366 # '-' the output is written to the console. If you really don't want it,
367 # make it "/dev/null" (Unix) or "nul" (win32). :^(
369 # Examples:
370 #   log: ./bochs.out
371 #   log: /dev/tty
372 #=======================================================================
373 #log: /dev/null
374 log: bochsout.txt
376 #=======================================================================
377 # LOGPREFIX:
378 # This handles the format of the string prepended to each log line.
379 # You may use those special tokens :
380 #   %t : 11 decimal digits timer tick
381 #   %i : 8 hexadecimal digits of cpu current eip (ignored in SMP configuration)
382 #   %e : 1 character event type ('i'nfo, 'd'ebug, 'p'anic, 'e'rror)
383 #   %d : 5 characters string of the device, between brackets
385 # Default : %t%e%d
386 # Examples:
387 #   logprefix: %t-%e-@%i-%d
388 #   logprefix: %i%e%d
389 #=======================================================================
390 #logprefix: %t%e%d
392 #=======================================================================
393 # LOG CONTROLS
395 # Bochs now has four severity levels for event logging.
396 #   panic: cannot proceed.  If you choose to continue after a panic, 
397 #          don't be surprised if you get strange behavior or crashes.
398 #   error: something went wrong, but it is probably safe to continue the
399 #          simulation.
400 #   info: interesting or useful messages.
401 #   debug: messages useful only when debugging the code.  This may
402 #          spit out thousands per second.
404 # For events of each level, you can choose to crash, report, or ignore.
405 # TODO: allow choice based on the facility: e.g. crash on panics from
406 #       everything except the cdrom, and only report those.
408 # If you are experiencing many panics, it can be helpful to change
409 # the panic action to report instead of fatal.  However, be aware
410 # that anything executed after a panic is uncharted territory and can 
411 # cause bochs to become unstable.  The panic is a "graceful exit," so
412 # if you disable it you may get a spectacular disaster instead.
413 #=======================================================================
414 panic: action=ask
415 error: action=report
416 info: action=report
417 debug: action=ignore
418 #pass: action=fatal
420 #=======================================================================
421 # DEBUGGER_LOG:
422 # Give the path of the log file you'd like Bochs to log debugger output.
423 # If you really don't want it, make it /dev/null or '-'. :^(
425 # Examples:
426 #   debugger_log: ./debugger.out
427 #=======================================================================
428 #debugger_log: /dev/null
429 #debugger_log: debugger.out
430 debugger_log: -
432 #=======================================================================
433 # COM1, COM2, COM3, COM4:
434 # This defines a serial port (UART type 16550A). In the 'term' you can specify
435 # a device to use as com1. This can be a real serial line, or a pty.  To use
436 # a pty (under X/Unix), create two windows (xterms, usually).  One of them will
437 # run bochs, and the other will act as com1. Find out the tty the com1
438 # window using the `tty' command, and use that as the `dev' parameter.
439 # Then do `sleep 1000000' in the com1 window to keep the shell from
440 # messing with things, and run bochs in the other window.  Serial I/O to
441 # com1 (port 0x3f8) will all go to the other window.
442 # In socket* and pipe* (win32 only) modes Bochs becomes either socket/named pipe
443 # client or server. In client mode it connects to an already running server (if
444 # connection fails Bochs treats com port as not connected). In server mode it
445 # opens socket/named pipe and waits until a client application connects to it
446 # before starting simulation. This mode is useful for remote debugging (e.g.
447 # with gdb's "target remote host:port" command or windbg's command line option
448 # -k com:pipe,port=\\.\pipe\pipename). Note: 'socket' is a shorthand for
449 # 'socket-client' and 'pipe' for 'pipe-client'. Socket modes use simple TCP
450 # communication, pipe modes use duplex byte mode pipes.
451 # Other serial modes are 'null' (no input/output), 'file' (output to a file
452 # specified as the 'dev' parameter), 'raw' (use the real serial port - under
453 # construction for win32), 'mouse' (standard serial mouse - requires
454 # mouse option setting 'type=serial', 'type=serial_wheel' or 'type=serial_msys').
456 # Examples:
457 #   com1: enabled=1, mode=null
458 #   com1: enabled=1, mode=mouse
459 #   com2: enabled=1, mode=file, dev=serial.out
460 #   com3: enabled=1, mode=raw, dev=com1
461 #   com3: enabled=1, mode=socket-client, dev=localhost:8888
462 #   com3: enabled=1, mode=socket-server, dev=localhost:8888
463 #   com4: enabled=1, mode=pipe-client, dev=\\.\pipe\mypipe
464 #   com4: enabled=1, mode=pipe-server, dev=\\.\pipe\mypipe
465 #=======================================================================
466 #com1: enabled=1, mode=term, dev=/dev/ttyp9
469 #=======================================================================
470 # PARPORT1, PARPORT2:
471 # This defines a parallel (printer) port. When turned on and an output file is
472 # defined the emulated printer port sends characters printed by the guest OS
473 # into the output file. On some platforms a device filename can be used to
474 # send the data to the real parallel port (e.g. "/dev/lp0" on Linux, "lpt1" on
475 # win32 platforms).
477 # Examples:
478 #   parport1: enabled=1, file="parport.out"
479 #   parport2: enabled=1, file="/dev/lp0"
480 #   parport1: enabled=0
481 #=======================================================================
482 parport1: enabled=1, file="parport.out"
484 #=======================================================================
485 # SB16:
486 # This defines the SB16 sound emulation. It can have several of the
487 # following properties.
488 # All properties are in the format sb16: property=value
489 # midi: The filename is where the midi data is sent. This can be a
490 #       device or just a file if you want to record the midi data.
491 # midimode:
492 #      0=no data
493 #      1=output to device (system dependent. midi denotes the device driver)
494 #      2=SMF file output, including headers
495 #      3=output the midi data stream to the file (no midi headers and no
496 #        delta times, just command and data bytes)
497 # wave: This is the device/file where wave output is stored
498 # wavemode:
499 #      0=no data
500 #      1=output to device (system dependent. wave denotes the device driver)
501 #      2=VOC file output, incl. headers
502 #      3=output the raw wave stream to the file
503 # log:  The file to write the sb16 emulator messages to.
504 # loglevel:
505 #      0=no log
506 #      1=resource changes, midi program and bank changes
507 #      2=severe errors
508 #      3=all errors
509 #      4=all errors plus all port accesses
510 #      5=all errors and port accesses plus a lot of extra info
511 # dmatimer:
512 #      microseconds per second for a DMA cycle.  Make it smaller to fix
513 #      non-continuous sound.  750000 is usually a good value.  This needs a
514 #      reasonably correct setting for the IPS parameter of the CPU option.
516 # Examples for output devices:
517 #   sb16: midimode=1, midi="", wavemode=1, wave=""           # win32
518 #   sb16: midimode=1, midi=alsa:128:0, wavemode=1, wave=alsa # Linux with ALSA
519 #=======================================================================
520 #sb16: midimode=1, midi=/dev/midi00, wavemode=1, wave=/dev/dsp, loglevel=2, log=sb16.log, dmatimer=600000
522 #=======================================================================
523 # VGA_UPDATE_INTERVAL:
524 # Video memory is scanned for updates and screen updated every so many
525 # virtual seconds.  The default is 40000, about 25Hz. Keep in mind that
526 # you must tweak the 'cpu: ips=N' directive to be as close to the number
527 # of emulated instructions-per-second your workstation can do, for this
528 # to be accurate.
530 # Examples:
531 #   vga_update_interval: 250000
532 #=======================================================================
533 vga_update_interval: 300000
535 # using for Winstone '98 tests
536 #vga_update_interval:  100000
538 #=======================================================================
539 # KEYBOARD_SERIAL_DELAY:
540 # Approximate time in microseconds that it takes one character to
541 # be transfered from the keyboard to controller over the serial path.
542 # Examples:
543 #   keyboard_serial_delay: 200
544 #=======================================================================
545 keyboard_serial_delay: 250
547 #=======================================================================
548 # KEYBOARD_PASTE_DELAY:
549 # Approximate time in microseconds between attempts to paste
550 # characters to the keyboard controller. This leaves time for the
551 # guest os to deal with the flow of characters.  The ideal setting
552 # depends on how your operating system processes characters.  The
553 # default of 100000 usec (.1 seconds) was chosen because it works 
554 # consistently in Windows.
556 # If your OS is losing characters during a paste, increase the paste
557 # delay until it stops losing characters.
559 # Examples:
560 #   keyboard_paste_delay: 100000
561 #=======================================================================
562 keyboard_paste_delay: 100000
564 #=======================================================================
565 # MOUSE: 
566 # This option prevents Bochs from creating mouse "events" unless a mouse
567 # is  enabled. The hardware emulation itself is not disabled by this.
568 # You can turn the mouse on by setting enabled to 1, or turn it off by
569 # setting enabled to 0. Unless you have a particular reason for enabling
570 # the mouse by default, it is recommended that you leave it off.
571 # You can also toggle the mouse usage at runtime (control key + middle
572 # mouse button on X11, SDL, wxWidgets and Win32).
573 # With the mouse type option you can select the type of mouse to emulate.
574 # The default value is 'ps2'. The other choices are 'imps2' (wheel mouse
575 # on PS/2), 'serial', 'serial_wheel' and 'serial_msys' (one com port requires
576 # setting 'mode=mouse'). To connect a mouse to an USB port, see the 'usb1'
577 # option (requires PCI and USB support).
579 # Examples:
580 #   mouse: enabled=1
581 #   mouse: enabled=1, type=imps2
582 #   mouse: enabled=1, type=serial
583 #   mouse: enabled=0
584 #=======================================================================
585 mouse: enabled=0
587 #=======================================================================
588 # private_colormap: Request that the GUI create and use it's own
589 #                   non-shared colormap.  This colormap will be used
590 #                   when in the bochs window.  If not enabled, a
591 #                   shared colormap scheme may be used.  Not implemented
592 #                   on all GUI's.
594 # Examples:
595 #   private_colormap: enabled=1
596 #   private_colormap: enabled=0
597 #=======================================================================
598 private_colormap: enabled=0
600 #=======================================================================
601 # fullscreen: ONLY IMPLEMENTED ON AMIGA
602 #             Request that Bochs occupy the entire screen instead of a 
603 #             window.
605 # Examples:
606 #   fullscreen: enabled=0
607 #   fullscreen: enabled=1
608 #=======================================================================
609 #fullscreen: enabled=0
610 #screenmode: name="sample"
612 #=======================================================================
613 # ne2k: NE2000 compatible ethernet adapter
615 # Examples:
616 # ne2k: ioaddr=IOADDR, irq=IRQ, mac=MACADDR, ethmod=MODULE, ethdev=DEVICE, script=SCRIPT
618 # ioaddr, irq: You probably won't need to change ioaddr and irq, unless there
619 # are IRQ conflicts.
621 # mac: The MAC address MUST NOT match the address of any machine on the net.
622 # Also, the first byte must be an even number (bit 0 set means a multicast
623 # address), and you cannot use ff:ff:ff:ff:ff:ff because that's the broadcast
624 # address.  For the ethertap module, you must use fe:fd:00:00:00:01.  There may
625 # be other restrictions too.  To be safe, just use the b0:c4... address.
627 # ethdev: The ethdev value is the name of the network interface on your host
628 # platform.  On UNIX machines, you can get the name by running ifconfig.  On
629 # Windows machines, you must run niclist to get the name of the ethdev.
630 # Niclist source code is in misc/niclist.c and it is included in Windows 
631 # binary releases.
633 # script: The script value is optional, and is the name of a script that 
634 # is executed after bochs initialize the network interface. You can use 
635 # this script to configure this network interface, or enable masquerading.
636 # This is mainly useful for the tun/tap devices that only exist during
637 # Bochs execution. The network interface name is supplied to the script
638 # as first parameter
640 # If you don't want to make connections to any physical networks,
641 # you can use the following 'ethmod's to simulate a virtual network.
642 #   null: All packets are discarded, but logged to a few files.
643 #   arpback: ARP is simulated. Disabled by default.
644 #   vde:  Virtual Distributed Ethernet
645 #   vnet: ARP, ICMP-echo(ping), DHCP and read/write TFTP are simulated.
646 #         The virtual host uses 192.168.10.1.
647 #         DHCP assigns 192.168.10.2 to the guest.
648 #         TFTP uses the ethdev value for the root directory and doesn't
649 #         overwrite files.
651 #=======================================================================
652 # ne2k: ioaddr=0x300, irq=9, mac=fe:fd:00:00:00:01, ethmod=fbsd, ethdev=en0 #macosx
653 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:00, ethmod=fbsd, ethdev=xl0
654 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:00, ethmod=linux, ethdev=eth0
655 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=win32, ethdev=MYCARD
656 # ne2k: ioaddr=0x300, irq=9, mac=fe:fd:00:00:00:01, ethmod=tap, ethdev=tap0
657 # ne2k: ioaddr=0x300, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=/dev/net/tun0, script=./tunconfig
658 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=null, ethdev=eth0
659 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=vde, ethdev="/tmp/vde.ctl"
660 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=vnet, ethdev="c:/temp"
662 #=======================================================================
663 # KEYBOARD_MAPPING:
664 # This enables a remap of a physical localized keyboard to a 
665 # virtualized us keyboard, as the PC architecture expects.
666 # If enabled, the keymap file must be specified.
668 # Examples:
669 #   keyboard_mapping: enabled=1, map=gui/keymaps/x11-pc-de.map
670 #=======================================================================
671 keyboard_mapping: enabled=0, map=
673 #=======================================================================
674 # KEYBOARD_TYPE:
675 # Type of keyboard return by a "identify keyboard" command to the
676 # keyboard controler. It must be one of "xt", "at" or "mf".
677 # Defaults to "mf". It should be ok for almost everybody. A known
678 # exception is french macs, that do have a "at"-like keyboard.
680 # Examples:
681 #   keyboard_type: mf
682 #=======================================================================
683 #keyboard_type: mf
685 #=======================================================================
686 # USER_SHORTCUT:
687 # This defines the keyboard shortcut to be sent when you press the "user"
688 # button in the headerbar. The shortcut string is a combination of maximum
689 # 3 key names (listed below) separated with a '-' character.
690 # Valid key names:
691 # "alt", "bksl", "bksp", "ctrl", "del", "down", "end", "enter", "esc",
692 # "f1", ... "f12", "home", "ins", "left", "menu", "minus", "pgdwn", "pgup",
693 # "plus", "right", "shift", "space", "tab", "up", "win", "print" and "power".
695 # Example:
696 #   user_shortcut: keys=ctrl-alt-del
697 #=======================================================================
698 #user_shortcut: keys=ctrl-alt-del
700 #=======================================================================
701 # I440FXSUPPORT:
702 # This option controls the presence of the i440FX PCI chipset. You can
703 # also specify the devices connected to PCI slots. Up to 5 slots are
704 # available now. These devices are currently supported: ne2k, pcivga,
705 # pcidev and pcipnic. If Bochs is compiled with Cirrus SVGA support
706 # you'll have the additional choice 'cirrus'.
708 # Example:
709 #   i440fxsupport: enabled=1, slot1=pcivga, slot2=ne2k
710 #=======================================================================
711 i440fxsupport: enabled=1
713 #=======================================================================
714 # USB1:
715 # This option controls the presence of the USB root hub which is a part
716 # of the i440FX PCI chipset. With the portX option you can connect devices
717 # to the hub (currently supported: 'mouse', 'tablet', 'keypad' and 'disk').
718 # If you connect the mouse or tablet to one of the ports, Bochs forwards the
719 # mouse movement data to the USB device instead of the selected mouse type.
720 # When connecting the keypad to one of the ports, Bochs forwards the input of
721 # the numeric keypad to the USB device instead of the PS/2 keyboard.
722 # To connect a flat image as an USB hardisk you can use the 'disk' device with
723 # the path to the image separated with a colon (see below).
724 #=======================================================================
725 #usb1: enabled=1
726 #usb1: enabled=1, port1=mouse, port2=disk:usbdisk.img
728 #=======================================================================
729 # CMOSIMAGE:
730 # This defines image file that can be loaded into the CMOS RAM at startup.
731 # The rtc_init parameter controls whether initialize the RTC with values stored
732 # in the image. By default the time0 argument given to the clock option is used.
733 # With 'rtc_init=image' the image is the source for the initial time.
735 # Example:
736 #   cmosimage: file=cmos.img, rtc_init=image
737 #=======================================================================
738 #cmosimage: file=cmos.img, rtc_init=time0
740 #=======================================================================
741 # MAGIC_BREAK:
742 # This enables the "magic breakpoint" feature when using the debugger.
743 # The useless cpu instruction XCHG BX, BX causes Bochs to enter the
744 # debugger mode. This might be useful for software development.
746 # Example:
747 #   magic_break: enabled=1
748 #=======================================================================
749 #magic_break: enabled=1
751 #=======================================================================
752 # DEBUG_SYMBOLS:
753 # This loads symbols from the specified file for use in Bochs' internal
754 # debugger. Symbols are loaded into global context. This is equivalent to
755 # issuing ldsym debugger command at start up.
757 # Example:
758 #   debug_symbols: file="kernel.sym"
759 #   debug_symbols: file="kernel.sym", offset=0x80000000
760 #=======================================================================
761 #debug_symbols: file="kernel.sym"
763 #=======================================================================
764 # other stuff
765 #=======================================================================
766 #load32bitOSImage: os=nullkernel, path=../kernel.img, iolog=../vga_io.log
767 #load32bitOSImage: os=linux, path=../linux.img, iolog=../vga_io.log, initrd=../initrd.img
768 #text_snapshot_check: enabled=1
769 #print_timestamps: enabled=1
771 #-------------------------
772 # PCI host device mapping
773 #-------------------------
774 #pcidev: vendor=0x1234, device=0x5678
776 #=======================================================================
777 # GDBSTUB:
778 # Enable GDB stub. See user documentation for details.
779 # Default value is enabled=0.
780 #=======================================================================
781 #gdbstub: enabled=0, port=1234, text_base=0, data_base=0, bss_base=0
783 #=======================================================================
784 # for Macintosh, use the style of pathnames in the following
785 # examples.
787 # vgaromimage: :bios:VGABIOS-elpin-2.40
788 # romimage: file=:bios:BIOS-bochs-latest, address=0xf0000
789 # floppya: 1_44=[fd:], status=inserted
790 #=======================================================================