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