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