xv6

port of xv6 to x86-64
git clone http://frotz.net/git/xv6.git
Log | Files | Refs | README | LICENSE

dot-bochsrc (33514B)


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