Updated to current bochs CVS

contrib/bochs/bochsrc.txt

@@ -1,4 +1,4 @@
-# You many now use double quotes around pathnames, in case
+# You may now use double quotes around pathnames, in case
 # your pathname includes spaces.
 
 #=======================================================================
@@ -40,44 +40,87 @@
 #   svga           use SVGALIB library for Linux, allows graphics without X11
 #   term           text only, uses curses/ncurses library, cross platform
 #   rfb            provides an interface to AT&T's VNC viewer, cross platform
-#   wx             use wxWindows library, cross platform
+#   wx             use wxWidgets library, cross platform
 #   nogui          no display at all
 #
 # NOTE: if you use the "wx" configuration interface, you must also use
 # the "wx" display library.
+#
+# Specific options:
+# Some display libraries now support specific option to control their
+# behaviour. See the examples below for currently supported options.
 #=======================================================================
 #display_library: amigaos
 #display_library: beos
 #display_library: carbon
 #display_library: macintosh
 #display_library: nogui
-#display_library: rfb
+#display_library: rfb, options="timeout=60" # time to wait for client
-#display_library: sdl
+#display_library: sdl, options="fullscreen" # startup in fullscreen mode
 #display_library: term
-#display_library: win32
+#display_library: win32, options="legacyF12" # use F12 to toggle mouse
 #display_library: wx
 #display_library: x
 
 #=======================================================================
 # ROMIMAGE:
-# You now need to load a ROM BIOS into F0000-FFFFF.  I've wiped
+# The ROM BIOS controls what the PC does when it first powers on.
-# out most of the BIOS hooks, and replace them with real BIOS
+# Normally, you can use a precompiled BIOS in the source or binary
-# support.  Normally, you can use a precompiled BIOS in the bios/
+# distribution called BIOS-bochs-latest. The ROM BIOS is usually loaded
-# directory, named BIOS-bochs-latest. 
+# starting at address 0xf0000, and it is exactly 64k long.
+# You can also use the environment variable $BXSHARE to specify the
+# location of the BIOS.
+# The usage of external large BIOS images (up to 512k) at memory top is
+# now supported, but we still recommend to use the BIOS distributed with
+# Bochs. Now the start address can be calculated from image size.
 #=======================================================================
-#romimage: bios/BIOS-bochs-970717a
+romimage: file=bios/BIOS-bochs-latest, address=0xf0000
-#romimage: file=bios/BIOS-bochs-latest, address=0xf0000
+#romimage: file=mybios.bin, address=0xfff80000 # 512k at memory top
-romimage: file=$BXSHARE/BIOS-bochs-latest, address=0xf0000
+#romimage: file=mybios.bin # calculate start address from image size
-#romimage: file=bios/BIOS-bochs-2-processors, address=0xf0000
+
-#romimage: file=bios/BIOS-bochs-4-processors, address=0xf0000
+#=======================================================================
-#romimage: file=bios/rombios.bin, address=0xf0000
+# CPU:
+# This defines cpu-related parameters inside Bochs:
+#
+#  COUNT:
+#  Set the number of processors:cores per processor:threads per core 
+#  when Bochs is compiled for SMP emulation.
+#  Bochs currently supports up to 8 threads running simultaniosly. 
+#  If Bochs is compiled without SMP support, it won't accept values 
+#  different from 1.
+#
+#  RESET_ON_TRIPLE_FAULT:
+#  Reset the CPU when triple fault occur (highly recommended) rather than
+#  PANIC. Remember that if you trying to continue after triple fault the 
+#  simulation will be completely bogus !
+#
+#  IPS:
+#  Emulated Instructions Per Second.  This is the number of IPS that bochs
+#  is capable of running on your machine. You can recompile Bochs with
+#  --enable-show-ips option enabled, to find your workstation's capability.
+#  Measured IPS value will then be logged into your log file or status bar
+#  (if supported by the gui).
+#
+#  IPS is used to calibrate many time-dependent events within the bochs 
+#  simulation.  For example, changing IPS affects the frequency of VGA
+#  updates, the duration of time before a key starts to autorepeat, and
+#  the measurement of BogoMips and other benchmarks.
+#
+#  Examples:
+#  Machine                                         Mips
+# ________________________________________________________________
+#  2.1Ghz Athlon XP with Linux 2.6/g++ 3.4         12 to 15 Mips
+#  1.6Ghz Intel P4 with Win2000/g++ 3.3             5 to  7 Mips
+#  650Mhz Athlon K-7 with Linux 2.4.4/egcs-2.91.66  2 to  2.5 Mips
+#  400Mhz Pentium II with Linux 2.0.36/egcs-1.0.3   1 to  1.8 Mips
+#=======================================================================
+cpu: count=1, ips=10000000, reset_on_triple_fault=1
 
 #=======================================================================
 # MEGS
-# set this to the default number of Megabytes of memory you want
+# Set the number of Megabytes of physical memory you want to emulate. 
-# to emulate.  You may also pass the '-megs xyz' option to bochs
-#
 # The default is 32MB, most OS's won't need more than that.
+# The maximum amount of memory supported is 2048Mb.
 #=======================================================================
 #megs: 256
 #megs: 128
@@ -93,30 +136,44 @@ megs: 32
 # ROM images should not overwrite the rombios (located at
 # F0000-FFFFF) and the videobios (located at C0000-C7FFF).
 # Those ROM images will be initialized by the bios if they contain 
-# the right signature (0x55AA).
+# the right signature (0x55AA) and a valid checksum.
-# It can also be a convenient way to upload some arbitary code/data
+# It can also be a convenient way to upload some arbitrary code/data
 # in the simulation, that can be retrieved by the boot loader
 #=======================================================================
 #optromimage1: file=optionalrom.bin, address=0xd0000
 #optromimage2: file=optionalrom.bin, address=0xd1000
 #optromimage3: file=optionalrom.bin, address=0xd2000
 #optromimage4: file=optionalrom.bin, address=0xd3000
-#optromimage1: file=../../src/bin/ne.zrom, address=0xd0000
+optromimage1: file=rom.img, address=0xd0000
-optromimage1: file=../../src/bin/pnic.zrom, address=0xd0000
+
+#optramimage1: file=/path/file1.img, address=0x0010000
+#optramimage2: file=/path/file2.img, address=0x0020000
+#optramimage3: file=/path/file3.img, address=0x0030000
+#optramimage4: file=/path/file4.img, address=0x0040000
 
 #=======================================================================
 # VGAROMIMAGE
 # You now need to load a VGA ROM BIOS into C0000.
 #=======================================================================
-#vgaromimage: bios/VGABIOS-lgpl-latest
+#vgaromimage: file=bios/VGABIOS-elpin-2.40
-#vgaromimage: bios/VGABIOS-elpin-2.40
+vgaromimage: file=bios/VGABIOS-lgpl-latest
-vgaromimage: $BXSHARE/VGABIOS-elpin-2.40
+#vgaromimage: file=bios/VGABIOS-lgpl-latest-cirrus
+
+#=======================================================================
+# VGA:
+# Here you can specify the display extension to be used. With the value
+# 'none' you can use standard VGA with no extension. Other supported
+# values are 'vbe' for Bochs VBE and 'cirrus' for Cirrus SVGA support.
+#=======================================================================
+#vga: extension=cirrus
+#vga: extension=vbe
+vga: extension=none
 
 #=======================================================================
 # FLOPPYA:
 # Point this to pathname of floppy image file or device
 # This should be of a bootable floppy(image/device) if you're
-# booting from 'a'.
+# booting from 'a' (or 'floppy').
 #
 # You can set the initial status of the media to 'ejected' or 'inserted'.
 #   floppya: 2_88=path, status=ejected             (2.88M 3.5" floppy)
@@ -124,18 +181,24 @@ vgaromimage: $BXSHARE/VGABIOS-elpin-2.40
 #   floppya: 1_2=path, status=ejected              (1.2M  5.25" floppy)
 #   floppya: 720k=path, status=inserted            (720K  3.5" floppy)
 #   floppya: 360k=path, status=inserted            (360K  5.25" floppy)
+#   floppya: 320k=path, status=inserted            (320K  5.25" floppy)
+#   floppya: 180k=path, status=inserted            (180K  5.25" floppy)
+#   floppya: 160k=path, status=inserted            (160K  5.25" floppy)
+#   floppya: image=path, status=inserted           (guess type from image size)
 #
-# The path should be the name of a disk image file.  On unix, you can use
+# The path should be the name of a disk image file.  On Unix, you can use a raw
-# a raw device name such as /dev/fd0 on Linux.  On WinNT and Win2k, use
+# device name such as /dev/fd0 on Linux.  On win32 platforms, use drive letters
-# drive letters such as a: or b: as the path.  Raw floppy access is not
+# such as a: or b: as the path.  The parameter 'image' works with image files
-# supported on Windows 95 and 98.
+# only. In that case the size must match one of the supported types.
 #=======================================================================
-floppya: 1_44=/dev/fd0, status=inserted
+#floppya: 1_44=/dev/fd0, status=inserted
-#floppya: file=../1.44, status=inserted
+#floppya: image=../1.44, status=inserted
 #floppya: 1_44=/dev/fd0H1440, status=inserted
 #floppya: 1_2=../1_2, status=inserted
 #floppya: 1_44=a:, status=inserted
 #floppya: 1_44=a.img, status=inserted
+#floppya: 1_44=/dev/rfd0a, status=inserted
+floppya: 1_44=floppy.img, status=inserted
 
 #=======================================================================
 # FLOPPYB:
@@ -151,34 +214,37 @@ floppyb: 1_44=b.img, status=inserted
 # ata[0-3]: enabled=[0|1], ioaddr1=addr, ioaddr2=addr, irq=number
 # 
 # These options enables up to 4 ata channels. For each channel
-# the two base io address and the irq must be specified.
+# the two base io addresses and the irq must be specified.
 # 
-# ata0 is enabled by default, with ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
+# ata0 and ata1 are enabled by default with the values shown below
 #
 # Examples:
 #   ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
 #   ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
-#   ata2: enabled=1, ioaddr1=0x1e8, ioaddr2=0x3e8, irq=11
+#   ata2: enabled=1, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
-#   ata3: enabled=1, ioaddr1=0x168, ioaddr2=0x368, irq=9
+#   ata3: enabled=1, ioaddr1=0x168, ioaddr2=0x360, irq=9
 #=======================================================================
 ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
-ata1: enabled=0, ioaddr1=0x170, ioaddr2=0x370, irq=15
+ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
-ata2: enabled=0, ioaddr1=0x1e8, ioaddr2=0x3e8, irq=11
+ata2: enabled=0, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
-ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x368, irq=9
+ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x360, irq=9
 
 #=======================================================================
 # ATA[0-3]-MASTER, ATA[0-3]-SLAVE
 #
 # This defines the type and characteristics of all attached ata devices:
 #   type=       type of attached device [disk|cdrom] 
+#   mode=       only valid for disks [flat|concat|external|dll|sparse|vmware3]
+#   mode=       only valid for disks [undoable|growing|volatile]
 #   path=       path of the image
 #   cylinders=  only valid for disks
 #   heads=      only valid for disks
 #   spt=        only valid for disks
 #   status=     only valid for cdroms [inserted|ejected]
 #   biosdetect= type of biosdetection [none|auto], only for disks on ata0 [cmos]
-#   translation=type of transation of the bios, only for disks [none|lba|large|rechs|auto]
+#   translation=type of translation of the bios, only for disks [none|lba|large|rechs|auto]
 #   model=      string returned by identify device command
+#   journal=    optional filename of the redolog for undoable and volatile disks
 #   
 # Point this at a hard disk image file, cdrom iso file, or physical cdrom
 # device.  To create a hard disk image, try running bximage.  It will help you
@@ -192,93 +258,35 @@ ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x368, irq=9
 # access the "first" cdrom in the system.  On MacOSX, use path="drive"
 # to access the physical drive.
 #
-# The path, cylinders, heads, and spt are mandatory for type=disk
+# The path is always mandatory. For flat hard disk images created with
-# The path is mandatory for type=cdrom
+# bximage geometry autodetection can be used (cylinders=0 -> cylinders are
+# calculated using heads=16 and spt=63). For other hard disk images and modes
+# the cylinders, heads, and spt are mandatory.
 #
 # Default values are:
-#   biosdetect=auto, translation=auto, model="Generic 1234"
+#   mode=flat, biosdetect=auto, translation=auto, model="Generic 1234"
 #
 # The biosdetect option has currently no effect on the bios
 #
 # Examples:
-#   ata0-master: type=disk, path=10M.sample, cylinders=306, heads=4, spt=17
+#   ata0-master: type=disk, mode=flat, path=10M.sample, cylinders=306, heads=4, spt=17
-#   ata0-slave:  type=disk, path=20M.sample, cylinders=615, heads=4, spt=17
+#   ata0-slave:  type=disk, mode=flat, path=20M.sample, cylinders=615, heads=4, spt=17
-#   ata1-master: type=disk, path=30M.sample, cylinders=615, heads=6, spt=17
+#   ata1-master: type=disk, mode=flat, path=30M.sample, cylinders=615, heads=6, spt=17
-#   ata1-slave:  type=disk, path=46M.sample, cylinders=940, heads=6, spt=17
+#   ata1-slave:  type=disk, mode=flat, path=46M.sample, cylinders=940, heads=6, spt=17
-#   ata2-master: type=disk, path=62M.sample, cylinders=940, heads=8, spt=17
+#   ata2-master: type=disk, mode=flat, path=62M.sample, cylinders=940, heads=8, spt=17
-#   ata2-slave:  type=disk, path=112M.sample, cylinders=900, heads=15, spt=17
+#   ata2-slave:  type=disk, mode=flat, path=112M.sample, cylinders=900, heads=15, spt=17
-#   ata3-master: type=disk, path=483M.sample, cylinders=1024, heads=15, spt=63
+#   ata3-master: type=disk, mode=flat, path=483M.sample, cylinders=1024, heads=15, spt=63
 #   ata3-slave:  type=cdrom, path=iso.sample, status=inserted
 #=======================================================================
-#ata0-master: type=disk, path="30M.sample", cylinders=615, heads=6, spt=17
+#ata0-master: type=disk, mode=flat, path="30M.sample", cylinders=615, heads=6, spt=17
 #ata0-slave: type=cdrom, path=D:, status=inserted
 #ata0-slave: type=cdrom, path=/dev/cdrom, status=inserted
 #ata0-slave: type=cdrom, path="drive", status=inserted
-
+#ata0-slave: type=cdrom, path=/dev/rcd0d, status=inserted 
-#=======================================================================
-#
-# The DISKC option is deprecated. Use ATA* options instead.
-#
-# DISKC: file=, cyl=, heads=, spt=
-# Point this at a hard disk image file.  To create 
-# a hard disk image, try running bximage.  It will help you choose the
-# size and then suggest a diskc line that works with it.
-#
-# In UNIX it may be possible to use a raw device as a Bochs hard disk, 
-# but WE DON'T RECOMMEND IT.  In Windows there is no easy way.
-#
-# Examples:
-#   diskc: file=10M.sample, cyl=306, heads=4, spt=17
-#   diskc: file=20M.sample, cyl=615, heads=4, spt=17
-#   diskc: file=30M.sample, cyl=615, heads=6, spt=17
-#   diskc: file=46M.sample, cyl=940, heads=6, spt=17
-#   diskc: file=62M.sample, cyl=940, heads=8, spt=17
-#   diskc: file=112M.sample, cyl=900, heads=15, spt=17
-#   diskc: file=483M.sample, cyl=1024, heads=15, spt=63
-#=======================================================================
-#diskc: file="30M.sample", cyl=615, heads=6, spt=17
-
-#=======================================================================
-#
-# The DISKD option is deprecated. Use ATA* options instead.
-#
-# DISKD:
-# See DISKC above for syntax
-#
-# NOTE: diskd and cdromd must not be used together!
-#=======================================================================
-#diskd: file="diskd.img", cyl=615, heads=6, spt=17
-
-#=======================================================================
-#
-# The CDROMD option is deprecated. Use ATA* options instead.
-#
-# CDROMD:
-#
-# cdromd: dev=/dev/cdrom, status=inserted
-# cdromd: dev=/dev/cdrom, status=ejected
-# cdromd: dev=e:, status=ejected
-#
-# In windows, the drive letter + colon notation should be used for cdroms.
-# Depending on versions of windows and drivers, you may only be able to 
-# access the "first" cdrom in the system.  On MacOSX, use path="drive"
-# to access the physical drive.
-#
-# NOTE: diskd and cdromd must not be used together!
-#=======================================================================
-#cdromd: dev=D:, status=inserted
-#cdromd: dev=/dev/cdrom, status=inserted
-#cdromd: dev="drive", status=inserted
-
-#=======================================================================
-# NEWHARDDRIVESUPPORT: enabled=[0|1]
-# As of cvs version on 5/17/2001, newharddrivesupport is on by default.
-#=======================================================================
-#newharddrivesupport: enabled=1
 
 #=======================================================================
 # BOOT:
-# This defines your boot drive.  
+# This defines the boot sequence. Now you can specify up to 3 boot drives.
 # You can either boot from 'floppy', 'disk' or 'cdrom'
 # legacy 'a' and 'c' are also supported
 # Examples:
@@ -287,10 +295,43 @@ ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x368, irq=9
 #   boot: cdrom
 #   boot: c
 #   boot: a
+#   boot: cdrom, floppy, disk
 #=======================================================================
 #boot: floppy
 #boot: disk
 
+#=======================================================================
+# CLOCK:
+# This defines the parameters of the clock inside Bochs:
+#
+#  SYNC:
+#  TO BE COMPLETED (see Greg explanation in feature request #536329)
+#
+#  TIME0:
+#  Specifies the start (boot) time of the virtual machine. Use a time 
+#  value as returned by the time(2) system call. If no time0 value is 
+#  set or if time0 equal to 1 (special case) or if time0 equal 'local', 
+#  the simulation will be started at the current local host time.
+#  If time0 equal to 2 (special case) or if time0 equal 'utc',
+#  the simulation will be started at the current utc time.
+#
+# Syntax:
+#  clock: sync=[none|slowdown|realtime|both], time0=[timeValue|local|utc]
+#
+# Example:
+#   clock: sync=none,     time0=local       # Now (localtime)
+#   clock: sync=slowdown, time0=315529200   # Tue Jan  1 00:00:00 1980
+#   clock: sync=none,     time0=631148400   # Mon Jan  1 00:00:00 1990
+#   clock: sync=realtime, time0=938581955   # Wed Sep 29 07:12:35 1999
+#   clock: sync=realtime, time0=946681200   # Sat Jan  1 00:00:00 2000
+#   clock: sync=none,     time0=1           # Now (localtime)
+#   clock: sync=none,     time0=utc         # Now (utc/gmt)
+# 
+# Default value are sync=none, time0=local
+#=======================================================================
+#clock: sync=none, time0=local
+
+
 #=======================================================================
 # FLOPPY_BOOTSIG_CHECK: disabled=[0|1]
 # Enables or disables the 0xaa55 signature check on boot floppies
@@ -304,8 +345,10 @@ floppy_bootsig_check: disabled=0
 
 #=======================================================================
 # LOG:
-# Give the path of the log file you'd like Bochs debug and misc. verbage
+# Give the path of the log file you'd like Bochs debug and misc. verbiage
-# to be written to.  If you really don't want it, make it /dev/null. :^(
+# to be written to. If you don't use this option or set the filename to
+# '-' the output is written to the console. If you really don't want it,
+# make it "/dev/null" (Unix) or "nul" (win32). :^(
 #
 # Examples:
 #   log: ./bochs.out
@@ -319,7 +362,7 @@ log: bochsout.txt
 # This handles the format of the string prepended to each log line.
 # You may use those special tokens :
 #   %t : 11 decimal digits timer tick
-#   %i : 8 hexadecimal digits of cpu0 current eip
+#   %i : 8 hexadecimal digits of cpu current eip (ignored in SMP configuration)
 #   %e : 1 character event type ('i'nfo, 'd'ebug, 'p'anic, 'e'rror)
 #   %d : 5 characters string of the device, between brackets
 # 
@@ -356,6 +399,7 @@ panic: action=ask
 error: action=report
 info: action=report
 debug: action=ignore
+#pass: action=fatal
 
 #=======================================================================
 # DEBUGGER_LOG:
@@ -370,22 +414,33 @@ debug: action=ignore
 debugger_log: -
 
 #=======================================================================
-# com1:
+# COM1, COM2, COM3, COM4:
-# This defines a serial (COM) port. You can specify a device to use as com1.
+# This defines a serial port (UART type 16550A). In the 'term' you can specify
-# This can be a real serial line, or a pty.  To use a pty (under X/Unix),
+# a device to use as com1. This can be a real serial line, or a pty.  To use
-# create two windows (xterms, usually).  One of them will run bochs, and the
+# a pty (under X/Unix), create two windows (xterms, usually).  One of them will
-# other will act as com1. Find out the tty the com1 window using the `tty'
+# run bochs, and the other will act as com1. Find out the tty the com1
-# command, and use that as the `dev' parameter.  Then do `sleep 1000000' in
+# window using the `tty' command, and use that as the `dev' parameter.
-# the com1 window to keep the shell from messing with things, and run bochs in
+# Then do `sleep 1000000' in the com1 window to keep the shell from
-# the other window.  Serial I/O to com1 (port 0x3f8) will all go to the other
+# messing with things, and run bochs in the other window.  Serial I/O to
-# window.
+# com1 (port 0x3f8) will all go to the other window.
+# Other serial modes are 'null' (no input/output), 'file' (output to a file
+# specified as the 'dev' parameter), 'raw' (use the real serial port - under
+# construction for win32), 'mouse' (standard serial mouse - requires
+# mouse option setting 'type=serial' or 'type=serial_wheel') and 'socket'
+# (connect a networking socket).
+#
+# Examples:
+#   com1: enabled=1, mode=null
+#   com1: enabled=1, mode=mouse
+#   com2: enabled=1, mode=file, dev=serial.out
+#   com3: enabled=1, mode=raw, dev=com1
+#   com3: enabled=1, mode=socket, dev=localhost:8888
 #=======================================================================
-#com1: enabled=1, dev=/dev/ttyp9
+#com1: enabled=1, mode=term, dev=/dev/ttyp9
-#com1: enabled=1, dev=/tmp/serial.log
 
 
 #=======================================================================
-# PARPORT1:
+# PARPORT1, PARPORT2:
 # This defines a parallel (printer) port. When turned on and an output file is
 # defined the emulated printer port sends characters printed by the guest OS
 # into the output file. On some platforms a device filename can be used to
@@ -394,7 +449,7 @@ debugger_log: -
 #
 # Examples:
 #   parport1: enabled=1, file="parport.out"
-#   parport1: enabled=1, file="/dev/lp0"
+#   parport2: enabled=1, file="/dev/lp0"
 #   parport1: enabled=0
 #=======================================================================
 parport1: enabled=1, file="parport.out"
@@ -421,15 +476,15 @@ parport1: enabled=1, file="parport.out"
 # log:  The file to write the sb16 emulator messages to.
 # loglevel:
 #      0=no log
-#      1=only midi program and bank changes
+#      1=resource changes, midi program and bank changes
 #      2=severe errors
 #      3=all errors
 #      4=all errors plus all port accesses
 #      5=all errors and port accesses plus a lot of extra info
 # dmatimer:
 #      microseconds per second for a DMA cycle.  Make it smaller to fix
-#      non-continous sound.  750000 is usually a good value.  This needs a
+#      non-continuous sound.  750000 is usually a good value.  This needs a
-#      reasonably correct setting for IPS.
+#      reasonably correct setting for the IPS parameter of the CPU option.
 #
 # For an example look at the next line:
 #=======================================================================
@@ -439,10 +494,10 @@ parport1: enabled=1, file="parport.out"
 #=======================================================================
 # VGA_UPDATE_INTERVAL:
 # Video memory is scanned for updates and screen updated every so many
-# virtual seconds.  The default is 300000, about 3Hz.  This is generally
+# virtual seconds.  The default is 40000, about 25Hz. Keep in mind that
-# plenty.  Keep in mind that you must tweak the 'ips:' directive
+# you must tweak the 'cpu: ips=N' directive to be as close to the number
-# to be as close to the number of emulated instructions-per-second
+# of emulated instructions-per-second your workstation can do, for this
-# your workstation can do, for this to be accurate.
+# to be accurate.
 #
 # Examples:
 #   vga_update_interval: 250000
@@ -479,61 +534,25 @@ keyboard_serial_delay: 250
 keyboard_paste_delay: 100000
 
 #=======================================================================
-# FLOPPY_COMMAND_DELAY:
+# MOUSE: 
-# Time in microseconds to wait before completing some floppy commands
+# This option prevents Bochs from creating mouse "events" unless a mouse
-# such as read/write/seek/etc, which normally have a delay associated.
+# is  enabled. The hardware emulation itself is not disabled by this.
-# I had this hardwired to 50,000 before.
+# You can turn the mouse on by setting enabled to 1, or turn it off by
-#
+# setting enabled to 0. Unless you have a particular reason for enabling
-# Examples:
+# the mouse by default, it is recommended that you leave it off.
-#   floppy_command_delay: 50000
+# You can also toggle the mouse usage at runtime (control key + middle
-#=======================================================================
+# mouse button on X11, SDL, wxWidgets and Win32).
-floppy_command_delay: 500
+# With the mouse type option you can select the type of mouse to emulate.
-
+# The default value is 'ps2'. The other choices are 'imps2' (wheel mouse
-#=======================================================================
+# on PS/2), 'serial', 'serial_wheel' (one com port requires setting
-# IPS:
+# 'mode=mouse') and 'usb' (3-button mouse - one of the USB ports must be
-# Emulated Instructions Per Second.  This is the number of IPS that bochs
+# connected with the 'mouse' device - requires PCI and USB support).
-# is capable of running on your machine.  Read the note in config.h
-# on how to find this.  Make sure to recompile after.
-#
-# IPS is used to calibrate many time-dependent events within the bochs 
-# simulation.  For example, changing IPS affects the frequency of VGA
-# updates, the duration of time before a key starts to autorepeat, and 
-# the measurement of BogoMips and other benchmarks.
-#
-# Examples:
-# Machine                                         Mips
-# ________________________________________________________________
-# 650Mhz Athlon K-7 with Linux 2.4.4/egcs-2.91.66 2 to 2.5 Mips
-# 400Mhz Pentium II with Linux 2.0.36/egcs-1.0.3  1 to 1.8 Mips
-# 166Mhz 64bit Sparc with Solaris 2.x             approx 0.75 Mips
-# 200Mhz Pentium with Linux 2.x                   approx 0.5 Mips
-#
-#=======================================================================
-ips: 1000000
-
-#=======================================================================
-# PIT:
-# The PIT is the programmable interval timer.  It has an option that tries to
-# keep the PIT in sync with real time.  This feature is still experimental,
-# but it may be useful if you want to prevent Bochs from running too fast, for
-# example a DOS video game.  Be aware that with the realtime pit option, your
-# simulation will not be repeatable; this can a problem if you are debugging.
-#=======================================================================
-#pit: realtime=1
-
-#=======================================================================
-# mouse: Not used in any of the GUI specific modules, but the option
-#        bx_options.mouse_enabled is set to this value.  The idea,
-#        is that the GUI code should not generate mouse events when
-#        not enabled.  The hardware emualation itself is not disabled
-#        by this.  This is to facilitate deterministic runs of bochs.
 #
 # Examples:
 #   mouse: enabled=1
+#   mouse: enabled=1, type=imps2
+#   mouse: enabled=1, type=serial
 #   mouse: enabled=0
-#
-# I wouldn't recommend enabling the mouse by default, unless you have a
-# really good reason to do so.
 #=======================================================================
 mouse: enabled=0
 
@@ -559,8 +578,8 @@ private_colormap: enabled=0
 #   fullscreen: enabled=0
 #   fullscreen: enabled=1
 #=======================================================================
-fullscreen: enabled=0
+#fullscreen: enabled=0
-screenmode: name="sample"
+#screenmode: name="sample"
 
 #=======================================================================
 # ne2k: NE2000 compatible ethernet adapter
@@ -583,24 +602,35 @@ screenmode: name="sample"
 # Niclist source code is in misc/niclist.c and it is included in Windows 
 # binary releases.
 #
-# script: The script value is optionnal, and is the name of a script that 
+# script: The script value is optional, and is the name of a script that 
 # is executed after bochs initialize the network interface. You can use 
 # this script to configure this network interface, or enable masquerading.
 # This is mainly useful for the tun/tap devices that only exist during
 # Bochs execution. The network interface name is supplied to the script
 # as first parameter
+#
+# If you don't want to make connections to any physical networks,
+# you can use the following 'ethmod's to simulate a virtual network.
+#   null: All packets are discarded, but logged to a few files.
+#   arpback: ARP is simulated. Disabled by default.
+#   vde:  Virtual Distributed Ethernet
+#   vnet: ARP, ICMP-echo(ping), DHCP and read/write TFTP are simulated.
+#         The virtual host uses 192.168.10.1.
+#         DHCP assigns 192.168.10.2 to the guest.
+#         TFTP uses the ethdev value for the root directory and doesn't
+#         overwrite files.
+#
 #=======================================================================
-# ne2k: ioaddr=0x280, irq=9, mac=b0:c4:20:00:00:00, ethmod=fbsd, ethdev=xl0
+# ne2k: ioaddr=0x240, irq=9, mac=fe:fd:00:00:00:01, ethmod=fbsd, ethdev=en0 #macosx
-# ne2k: ioaddr=0x280, irq=9, mac=b0:c4:20:00:00:00, ethmod=linux, ethdev=eth0
+# ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:00, ethmod=fbsd, ethdev=xl0
-# ne2k: ioaddr=0x280, irq=9, mac=b0:c4:20:00:00:01, ethmod=win32, ethdev=MYCARD
+# ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:00, ethmod=linux, ethdev=eth0
-# ne2k: ioaddr=0x280, irq=9, mac=fe:fd:00:00:00:01, ethmod=tap, ethdev=tap0
+# ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:01, ethmod=win32, ethdev=MYCARD
-# ne2k: ioaddr=0x280, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=tun0, script=./ifup.tun
+# ne2k: ioaddr=0x240, irq=9, mac=fe:fd:00:00:00:01, ethmod=tap, ethdev=tap0
-# ne2k: ioaddr=0x280, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=tun0
+# ne2k: ioaddr=0x240, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=/dev/net/tun0, script=./tunconfig
-
+# ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:01, ethmod=null, ethdev=eth0
-# Pseudo NIC adaptor.  The way bochs is structured at the moment means
+# ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:01, ethmod=vde, ethdev="/tmp/vde.ctl"
-# that you need to enable ne2k support in order to compile in any of
+# ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:01, ethmod=vnet, ethdev="c:/temp"
-# the networking code.
+pnic: mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=/dev/net/tun:tap0
-pnic: ioaddr=0xdc00, irq=11, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=tun1, script=./ifup.tun
 
 #=======================================================================
 # KEYBOARD_MAPPING:
@@ -628,31 +658,90 @@ keyboard_mapping: enabled=0, map=
 #=======================================================================
 # USER_SHORTCUT:
 # This defines the keyboard shortcut to be sent when you press the "user"
-# button in the headerbar. The shortcut string can be a combination of
+# button in the headerbar. The shortcut string is a combination of maximum
-# these key names: "alt", "ctrl", "del", "esc", "f1", "f4", "tab", "win".
+# 3 key names (listed below) separated with a '-' character. The old-style
-# Up to 3 keys can be pressed at a time.
+# syntax (without the '-') still works for the key combinations supported
+# in Bochs 2.2.1.
+# Valid key names:
+# "alt", "bksl", "bksp", "ctrl", "del", "down", "end", "enter", "esc",
+# "f1", ... "f12", "home", "ins", "left", "menu", "minus", "pgdwn", "pgup",
+# "plus", "right", "shift", "space", "tab", "up", and "win".
 #
 # Example:
-#   user_shortcut: keys=ctrlaltdel
+#   user_shortcut: keys=ctrl-alt-del
 #=======================================================================
-user_shortcut: keys=ctrlaltdel
+user_shortcut: keys=ctrl-alt-del
+
+#=======================================================================
+# I440FXSUPPORT:
+# This option controls the presence of the i440FX PCI chipset. You can
+# also specify the devices connected to PCI slots. Up to 5 slots are
+# available now. These devices are currently supported: ne2k, pcivga,
+# pcidev and pcipnic. If Bochs is compiled with Cirrus SVGA support
+# you'll have the additional choice 'cirrus'.
+#
+# Example:
+#   i440fxsupport: enabled=1, slot1=pcivga, slot2=ne2k
+#=======================================================================
+i440fxsupport: enabled=1, slot1=pcipnic
+
+#=======================================================================
+# USB1:
+# This option controls the presence of the USB root hub which is a part
+# of the i440FX PCI chipset. With the portX option you can connect devices
+# to the hub (currently supported: 'mouse' and 'keypad'). If you connect
+# the mouse to one of the ports and use the mouse option 'type=usb' you'll
+# have a 3-button USB mouse.
+#
+# Example:
+#   usb1: enabled=1, port1=mouse, port2=keypad
+#=======================================================================
+#usb1: enabled=1
+
+#=======================================================================
+# CMOSIMAGE:
+# This defines image file that can be loaded into the CMOS RAM at startup.
+# The rtc_init parameter controls whether initialize the RTC with values stored
+# in the image. By default the time0 argument given to the clock option is used.
+# With 'rtc_init=image' the image is the source for the initial time.
+#
+# Example:
+#   cmosimage: file=cmos.img, rtc_init=image
+#=======================================================================
+#cmosimage: file=cmos.img, rtc_init=time0
 
 #=======================================================================
 # other stuff
 #=======================================================================
 magic_break: enabled=1
-
 #load32bitOSImage: os=nullkernel, path=../kernel.img, iolog=../vga_io.log
 #load32bitOSImage: os=linux, path=../linux.img, iolog=../vga_io.log, initrd=../initrd.img
-i440fxsupport: enabled=1
+#text_snapshot_check: enable
-#time0: 938581955
+
+#-------------------------
+# PCI host device mapping
+#-------------------------
+#pcidev: vendor=0x1234, device=0x5678
+
+#=======================================================================
+# GDBSTUB:
+# Enable GDB stub. See user documentation for details.
+# Default value is enabled=0.
+#=======================================================================
+#gdbstub: enabled=0, port=1234, text_base=0, data_base=0, bss_base=0
+
+#=======================================================================
+# IPS:
+# The IPS directive is DEPRECATED. Use the parameter IPS of the CPU
+# directive instead.
+#=======================================================================
+#ips: 10000000
 
 #=======================================================================
 # for Macintosh, use the style of pathnames in the following
 # examples.
 #
-# vgaromimage: :bios:VGABIOS-elpin-2.20
+# vgaromimage: :bios:VGABIOS-elpin-2.40
-# romimage: file=:bios:BIOS-bochs-981222a, address=0xf0000
+# romimage: file=:bios:BIOS-bochs-latest, address=0xf0000
 # floppya: 1_44=[fd:], status=inserted
 #=======================================================================
-