| blob | 35cab92f5303766d1a30f5e525f4389783d7dd25 |
1 # You may now use double quotes around pathnames, in case
2 # your pathname includes spaces.
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
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 wxWindows 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 #display_library: amigaos
50 #display_library: beos
51 #display_library: carbon
52 #display_library: macintosh
53 #display_library: nogui
54 #display_library: rfb
55 #display_library: sdl
56 #display_library: term
57 #display_library: win32
58 #display_library: wx
59 display_library: x
61 cpu: count=8, ips=10000000
63 #=======================================================================
64 # ROMIMAGE:
65 # You now need to load a ROM BIOS into F0000-FFFFF. Normally, you can
66 # use a precompiled BIOS in the bios/ directory of the source tree,
67 # named BIOS-bochs-latest.
68 # You can also use the environment variable $BXSHARE to specify the
69 # location of the BIOS.
70 #=======================================================================
71 romimage: file=$BXSHARE/BIOS-bochs-latest, address=0xf0000
72 #romimage: file=$BXSHARE/BIOS-bochs-8-processors, address=0xf0000
73 #romimage: file=bios/P4SMT, address=0xf0000
75 #=======================================================================
76 # MEGS
77 # set this to the default number of Megabytes of memory you want
78 # to emulate. You may also pass the '-megs xyz' option to bochs
79 #
80 # The default is 32MB, most OS's won't need more than that.
81 #=======================================================================
82 #megs: 256
83 #megs: 128
84 #megs: 64
85 megs: 32
86 #megs: 16
87 #megs: 8
89 #=======================================================================
90 # OPTROMIMAGE[1-4]:
91 # You may now load up to 4 optional ROM images. Be sure to use a
92 # read-only area, typically between C8000 and EFFFF. These optional
93 # ROM images should not overwrite the rombios (located at
94 # F0000-FFFFF) and the videobios (located at C0000-C7FFF).
95 # Those ROM images will be initialized by the bios if they contain
96 # the right signature (0x55AA).
97 # It can also be a convenient way to upload some arbitary code/data
98 # in the simulation, that can be retrieved by the boot loader
99 #=======================================================================
100 #optromimage1: file=optionalrom.bin, address=0xd0000
101 #optromimage2: file=optionalrom.bin, address=0xd1000
102 #optromimage3: file=optionalrom.bin, address=0xd2000
103 #optromimage4: file=optionalrom.bin, address=0xd3000
105 #=======================================================================
106 # VGAROMIMAGE
107 # You now need to load a VGA ROM BIOS into C0000.
108 #=======================================================================
109 vgaromimage: $BXSHARE/VGABIOS-lgpl-latest
110 #vgaromimage: bios/VGABIOS-elpin-2.40
111 #vgaromimage: $BXSHARE/VGABIOS-elpin-2.40
113 #=======================================================================
114 # FLOPPYA:
115 # Point this to pathname of floppy image file or device
116 # This should be of a bootable floppy(image/device) if you're
117 # booting from 'a'.
118 #
119 # You can set the initial status of the media to 'ejected' or 'inserted'.
120 # floppya: 2_88=path, status=ejected (2.88M 3.5" floppy)
121 # floppya: 1_44=path, status=inserted (1.44M 3.5" floppy)
122 # floppya: 1_2=path, status=ejected (1.2M 5.25" floppy)
123 # floppya: 720k=path, status=inserted (720K 3.5" floppy)
124 # floppya: 360k=path, status=inserted (360K 5.25" floppy)
125 # floppya: 320k=path, status=inserted (320K 5.25" floppy)
126 # floppya: 180k=path, status=inserted (180K 5.25" floppy)
127 # floppya: 160k=path, status=inserted (160K 5.25" floppy)
128 #
129 # The path should be the name of a disk image file. On unix, you can use
130 # a raw device name such as /dev/fd0 on Linux. On WinNT and Win2k, use
131 # drive letters such as a: or b: as the path. Raw floppy access is not
132 # supported on Windows 95 and 98.
133 #=======================================================================
134 #floppya: 1_44=image.boot, status=inserted
135 #floppya: 1_44=/dev/fd0, status=inserted
137 #=======================================================================
138 # FLOPPYB:
139 # See FLOPPYA above for syntax
140 #=======================================================================
141 #floppyb: 1_44=b:, status=inserted
142 #floppyb: 1_44=b.img, status=inserted
144 #=======================================================================
145 # ATA0, ATA1, ATA2, ATA3
146 # ATA controller for hard disks and cdroms
147 #
148 # ata[0-3]: enabled=[0|1], ioaddr1=addr, ioaddr2=addr, irq=number
149 #
150 # These options enables up to 4 ata channels. For each channel
151 # the two base io addresses and the irq must be specified.
152 #
153 # ata0 is enabled by default, with ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
154 #
155 # Examples:
156 # ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
157 # ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
158 # ata2: enabled=1, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
159 # ata3: enabled=1, ioaddr1=0x168, ioaddr2=0x360, irq=9
160 #=======================================================================
161 ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
162 ata1: enabled=0, ioaddr1=0x170, ioaddr2=0x370, irq=15
163 ata2: enabled=0, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
164 ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x360, irq=9
166 #=======================================================================
167 # ATA[0-3]-MASTER, ATA[0-3]-SLAVE
168 #
169 # This defines the type and characteristics of all attached ata devices:
170 # type= type of attached device [disk|cdrom]
171 # mode= only valid for disks [flat|concat|external|dll|sparse|vmware3]
172 # mode= only valid for disks [undoable|growing|volatile]
173 # path= path of the image
174 # cylinders= only valid for disks
175 # heads= only valid for disks
176 # spt= only valid for disks
177 # status= only valid for cdroms [inserted|ejected]
178 # biosdetect= type of biosdetection [none|auto], only for disks on ata0 [cmos]
179 # translation=type of transation of the bios, only for disks [none|lba|large|rechs|auto]
180 # model= string returned by identify device command
181 # journal= optional filename of the redolog for undoable and volatile disks
182 #
183 # Point this at a hard disk image file, cdrom iso file, or physical cdrom
184 # device. To create a hard disk image, try running bximage. It will help you
185 # choose the size and then suggest a line that works with it.
186 #
187 # In UNIX it may be possible to use a raw device as a Bochs hard disk,
188 # but WE DON'T RECOMMEND IT. In Windows there is no easy way.
189 #
190 # In windows, the drive letter + colon notation should be used for cdroms.
191 # Depending on versions of windows and drivers, you may only be able to
192 # access the "first" cdrom in the system. On MacOSX, use path="drive"
193 # to access the physical drive.
194 #
195 # The path, cylinders, heads, and spt are mandatory for type=disk
196 # The path is mandatory for type=cdrom
197 #
198 # Default values are:
199 # mode=flat, biosdetect=auto, translation=auto, model="Generic 1234"
200 #
201 # The biosdetect option has currently no effect on the bios
202 #
203 # Examples:
204 # ata0-master: type=disk, mode=flat, path=10M.sample, cylinders=306, heads=4, spt=17
205 # ata0-slave: type=disk, mode=flat, path=20M.sample, cylinders=615, heads=4, spt=17
206 # ata1-master: type=disk, mode=flat, path=30M.sample, cylinders=615, heads=6, spt=17
207 # ata1-slave: type=disk, mode=flat, path=46M.sample, cylinders=940, heads=6, spt=17
208 # ata2-master: type=disk, mode=flat, path=62M.sample, cylinders=940, heads=8, spt=17
209 # ata2-slave: type=disk, mode=flat, path=112M.sample, cylinders=900, heads=15, spt=17
210 # ata3-master: type=disk, mode=flat, path=483M.sample, cylinders=1024, heads=15, spt=63
211 # ata3-slave: type=cdrom, path=iso.sample, status=inserted
212 #=======================================================================
213 ata0-master: type=cdrom, path="image.iso", status=inserted
214 #ata0-master: type=disk, mode=flat, path="30M.sample", cylinders=615, heads=6, spt=17
215 #ata0-slave: type=cdrom, path=D:, status=inserted
216 #ata0-slave: type=cdrom, path=/dev/cdrom, status=inserted
217 #ata0-slave: type=cdrom, path="drive", status=inserted
218 #ata0-slave: type=cdrom, path=/dev/rcd0d, status=inserted
220 #=======================================================================
221 # BOOT:
222 # This defines your boot drive.
223 # You can either boot from 'floppy', 'disk' or 'cdrom'
224 # legacy 'a' and 'c' are also supported
225 # Examples:
226 # boot: floppy
227 # boot: disk
228 # boot: cdrom
229 # boot: c
230 # boot: a
231 #=======================================================================
232 boot: cdrom
233 #boot: disk
235 #=======================================================================
236 # IPS:
237 # Emulated Instructions Per Second. This is the number of IPS that bochs
238 # is capable of running on your machine. Read the note in config.h
239 # on how to find this. Make sure to recompile after.
240 #
241 # IPS is used to calibrate many time-dependent events within the bochs
242 # simulation. For example, changing IPS affects the frequency of VGA
243 # updates, the duration of time before a key starts to autorepeat, and
244 # the measurement of BogoMips and other benchmarks.
245 #
246 # Examples:
247 # Machine Mips
248 # ________________________________________________________________
249 # 650Mhz Athlon K-7 with Linux 2.4.4/egcs-2.91.66 2 to 2.5 Mips
250 # 400Mhz Pentium II with Linux 2.0.36/egcs-1.0.3 1 to 1.8 Mips
251 # 166Mhz 64bit Sparc with Solaris 2.x approx 0.75 Mips
252 # 200Mhz Pentium with Linux 2.x approx 0.5 Mips
253 #
254 #=======================================================================
255 ips: 2500000
257 #=======================================================================
258 # CLOCK:
259 # This defines the parameters of the clock inside Bochs:
260 #
261 # SYNC:
262 # TO BE COMPLETED (see Greg explaination in bug #536329)
263 #
264 # TIME0:
265 # Specifies the start (boot) time of the virtual machine. Use a time
266 # value as returned by the time(2) system call. If no time0 value is
267 # set or if time0 equal to 1 (special case) or if time0 equal 'local',
268 # the simulation will be started at the current local host time.
269 # If time0 equal to 2 (special case) or if time0 equal 'utc',
270 # the simulation will be started at the current utc time.
271 #
272 # Syntax:
273 # clock: sync=[none|slowdown|realtime], time0=[timeValue|local|utc]
274 #
275 # Example:
276 # clock: sync=none, time0=local # Now (localtime)
277 # clock: sync=slowdown, time0=315529200 # Tue Jan 1 00:00:00 1980
278 # clock: sync=none, time0=631148400 # Mon Jan 1 00:00:00 1990
279 # clock: sync=realtime, time0=938581955 # Wed Sep 29 07:12:35 1999
280 # clock: sync=realtime, time0=946681200 # Sat Jan 1 00:00:00 2000
281 # clock: sync=none, time0=1 # Now (localtime)
282 # clock: sync=none, time0=utc # Now (utc/gmt)
283 #
284 # Default value are sync=none, time0=local
285 #=======================================================================
286 clock: sync=none, time0=local
289 #=======================================================================
290 # FLOPPY_BOOTSIG_CHECK: disabled=[0|1]
291 # Enables or disables the 0xaa55 signature check on boot floppies
292 # Defaults to disabled=0
293 # Examples:
294 # floppy_bootsig_check: disabled=0
295 # floppy_bootsig_check: disabled=1
296 #=======================================================================
297 #floppy_bootsig_check: disabled=1
298 floppy_bootsig_check: disabled=1
300 #=======================================================================
301 # LOG:
302 # Give the path of the log file you'd like Bochs debug and misc. verbage
303 # to be written to. If you really don't want it, make it /dev/null. :^(
304 #
305 # Examples:
306 # log: ./bochs.out
307 # log: /dev/tty
308 #=======================================================================
309 #log: /dev/null
310 log: bochsout.txt
312 #=======================================================================
313 # LOGPREFIX:
314 # This handles the format of the string prepended to each log line.
315 # You may use those special tokens :
316 # %t : 11 decimal digits timer tick
317 # %i : 8 hexadecimal digits of cpu0 current eip
318 # %e : 1 character event type ('i'nfo, 'd'ebug, 'p'anic, 'e'rror)
319 # %d : 5 characters string of the device, between brackets
320 #
321 # Default : %t%e%d
322 # Examples:
323 # logprefix: %t-%e-@%i-%d
324 # logprefix: %i%e%d
325 #=======================================================================
326 #logprefix: %t%e%d
328 #=======================================================================
329 # LOG CONTROLS
330 #
331 # Bochs now has four severity levels for event logging.
332 # panic: cannot proceed. If you choose to continue after a panic,
333 # don't be surprised if you get strange behavior or crashes.
334 # error: something went wrong, but it is probably safe to continue the
335 # simulation.
336 # info: interesting or useful messages.
337 # debug: messages useful only when debugging the code. This may
338 # spit out thousands per second.
339 #
340 # For events of each level, you can choose to crash, report, or ignore.
341 # TODO: allow choice based on the facility: e.g. crash on panics from
342 # everything except the cdrom, and only report those.
343 #
344 # If you are experiencing many panics, it can be helpful to change
345 # the panic action to report instead of fatal. However, be aware
346 # that anything executed after a panic is uncharted territory and can
347 # cause bochs to become unstable. The panic is a "graceful exit," so
348 # if you disable it you may get a spectacular disaster instead.
349 #=======================================================================
350 panic: action=report
351 error: action=report
352 info: action=report
353 debug: action=ignore
354 #pass: action=fatal
356 #=======================================================================
357 # DEBUGGER_LOG:
358 # Give the path of the log file you'd like Bochs to log debugger output.
359 # If you really don't want it, make it /dev/null or '-'. :^(
360 #
361 # Examples:
362 # debugger_log: ./debugger.out
363 #=======================================================================
364 #debugger_log: /dev/null
365 #debugger_log: debugger.out
366 debugger_log: -
368 #=======================================================================
369 # COM1:
370 # This defines a serial port (UART type 16550A). You can specify a device
371 # to use as com1. This can be a real serial line, or a pty. To use a pty
372 # (under X/Unix), create two windows (xterms, usually). One of them will
373 # run bochs, and the other will act as com1. Find out the tty the com1
374 # window using the `tty' command, and use that as the `dev' parameter.
375 # Then do `sleep 1000000' in the com1 window to keep the shell from
376 # messing with things, and run bochs in the other window. Serial I/O to
377 # com1 (port 0x3f8) will all go to the other window.
378 #=======================================================================
379 #com1: enabled=1, dev=/dev/ttyp9
382 #=======================================================================
383 # PARPORT1:
384 # This defines a parallel (printer) port. When turned on and an output file is
385 # defined the emulated printer port sends characters printed by the guest OS
386 # into the output file. On some platforms a device filename can be used to
387 # send the data to the real parallel port (e.g. "/dev/lp0" on Linux, "lpt1" on
388 # win32 platforms).
389 #
390 # Examples:
391 # parport1: enabled=1, file="parport.out"
392 # parport1: enabled=1, file="/dev/lp0"
393 # parport1: enabled=0
394 #=======================================================================
395 parport1: enabled=1, file="parport.out"
397 #=======================================================================
398 # SB16:
399 # This defines the SB16 sound emulation. It can have several of the
400 # following properties.
401 # All properties are in the format sb16: property=value
402 # midi: The filename is where the midi data is sent. This can be a
403 # device or just a file if you want to record the midi data.
404 # midimode:
405 # 0=no data
406 # 1=output to device (system dependent. midi denotes the device driver)
407 # 2=SMF file output, including headers
408 # 3=output the midi data stream to the file (no midi headers and no
409 # delta times, just command and data bytes)
410 # wave: This is the device/file where wave output is stored
411 # wavemode:
412 # 0=no data
413 # 1=output to device (system dependent. wave denotes the device driver)
414 # 2=VOC file output, incl. headers
415 # 3=output the raw wave stream to the file
416 # log: The file to write the sb16 emulator messages to.
417 # loglevel:
418 # 0=no log
419 # 1=only midi program and bank changes
420 # 2=severe errors
421 # 3=all errors
422 # 4=all errors plus all port accesses
423 # 5=all errors and port accesses plus a lot of extra info
424 # dmatimer:
425 # microseconds per second for a DMA cycle. Make it smaller to fix
426 # non-continous sound. 750000 is usually a good value. This needs a
427 # reasonably correct setting for IPS.
428 #
429 # For an example look at the next line:
430 #=======================================================================
432 #sb16: midimode=1, midi=/dev/midi00, wavemode=1, wave=/dev/dsp, loglevel=2, log=sb16.log, dmatimer=600000
434 #=======================================================================
435 # VGA_UPDATE_INTERVAL:
436 # Video memory is scanned for updates and screen updated every so many
437 # virtual seconds. The default is 300000, about 3Hz. This is generally
438 # plenty. Keep in mind that you must tweak the 'ips:' directive
439 # to be as close to the number of emulated instructions-per-second
440 # your workstation can do, for this to be accurate.
441 #
442 # Examples:
443 # vga_update_interval: 250000
444 #=======================================================================
445 vga_update_interval: 300000
447 # using for Winstone '98 tests
448 #vga_update_interval: 100000
450 #=======================================================================
451 # KEYBOARD_SERIAL_DELAY:
452 # Approximate time in microseconds that it takes one character to
453 # be transfered from the keyboard to controller over the serial path.
454 # Examples:
455 # keyboard_serial_delay: 200
456 #=======================================================================
457 keyboard_serial_delay: 250
459 #=======================================================================
460 # KEYBOARD_PASTE_DELAY:
461 # Approximate time in microseconds between attempts to paste
462 # characters to the keyboard controller. This leaves time for the
463 # guest os to deal with the flow of characters. The ideal setting
464 # depends on how your operating system processes characters. The
465 # default of 100000 usec (.1 seconds) was chosen because it works
466 # consistently in Windows.
467 #
468 # If your OS is losing characters during a paste, increase the paste
469 # delay until it stops losing characters.
470 #
471 # Examples:
472 # keyboard_paste_delay: 100000
473 #=======================================================================
474 keyboard_paste_delay: 100000
476 #=======================================================================
477 # FLOPPY_COMMAND_DELAY:
478 # Time in microseconds to wait before completing some floppy commands
479 # such as read/write/seek/etc, which normally have a delay associated.
480 # I had this hardwired to 50,000 before.
481 #
482 # Examples:
483 # floppy_command_delay: 50000
484 #=======================================================================
485 floppy_command_delay: 500
487 #=======================================================================
488 # MOUSE:
489 # This option prevents Bochs from creating mouse "events" unless a mouse
490 # is enabled. The hardware emulation itself is not disabled by this.
491 # You can turn the mouse on by setting enabled to 1, or turn it off by
492 # setting enabled to 0. Unless you have a particular reason for enabling
493 # the mouse by default, it is recommended that you leave it off.
494 # You can also toggle the mouse usage at runtime (middle mouse button on
495 # X11 and SDL, F12 on Win32).
496 #
497 # Examples:
498 # mouse: enabled=1
499 # mouse: enabled=0
500 #=======================================================================
501 mouse: enabled=0
503 #=======================================================================
504 # private_colormap: Request that the GUI create and use it's own
505 # non-shared colormap. This colormap will be used
506 # when in the bochs window. If not enabled, a
507 # shared colormap scheme may be used. Not implemented
508 # on all GUI's.
509 #
510 # Examples:
511 # private_colormap: enabled=1
512 # private_colormap: enabled=0
513 #=======================================================================
514 private_colormap: enabled=0
516 #=======================================================================
517 # fullscreen: ONLY IMPLEMENTED ON AMIGA
518 # Request that Bochs occupy the entire screen instead of a
519 # window.
520 #
521 # Examples:
522 # fullscreen: enabled=0
523 # fullscreen: enabled=1
524 #=======================================================================
525 #fullscreen: enabled=0
526 #screenmode: name="sample"
528 #=======================================================================
529 # ne2k: NE2000 compatible ethernet adapter
530 #
531 # Examples:
532 # ne2k: ioaddr=IOADDR, irq=IRQ, mac=MACADDR, ethmod=MODULE, ethdev=DEVICE, script=SCRIPT
533 #
534 # ioaddr, irq: You probably won't need to change ioaddr and irq, unless there
535 # are IRQ conflicts.
536 #
537 # mac: The MAC address MUST NOT match the address of any machine on the net.
538 # Also, the first byte must be an even number (bit 0 set means a multicast
539 # address), and you cannot use ff:ff:ff:ff:ff:ff because that's the broadcast
540 # address. For the ethertap module, you must use fe:fd:00:00:00:01. There may
541 # be other restrictions too. To be safe, just use the b0:c4... address.
542 #
543 # ethdev: The ethdev value is the name of the network interface on your host
544 # platform. On UNIX machines, you can get the name by running ifconfig. On
545 # Windows machines, you must run niclist to get the name of the ethdev.
546 # Niclist source code is in misc/niclist.c and it is included in Windows
547 # binary releases.
548 #
549 # script: The script value is optionnal, and is the name of a script that
550 # is executed after bochs initialize the network interface. You can use
551 # this script to configure this network interface, or enable masquerading.
552 # This is mainly useful for the tun/tap devices that only exist during
553 # Bochs execution. The network interface name is supplied to the script
554 # as first parameter
555 #=======================================================================
556 # ne2k: ioaddr=0x240, irq=9, mac=fe:fd:00:00:00:01, ethmod=fbsd, ethdev=en0 #macosx
557 # ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:00, ethmod=fbsd, ethdev=xl0
558 # ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:00, ethmod=linux, ethdev=eth0
559 # ne2k: ioaddr=0x240, irq=9, mac=b0:c4:20:00:00:01, ethmod=win32, ethdev=MYCARD
560 # ne2k: ioaddr=0x240, irq=9, mac=fe:fd:00:00:00:01, ethmod=tap, ethdev=tap0
561 # ne2k: ioaddr=0x240, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=tun0, script=./tunconfig
563 #=======================================================================
564 # KEYBOARD_MAPPING:
565 # This enables a remap of a physical localized keyboard to a
566 # virtualized us keyboard, as the PC architecture expects.
567 # If enabled, the keymap file must be specified.
568 #
569 # Examples:
570 # keyboard_mapping: enabled=1, map=gui/keymaps/x11-pc-de.map
571 #=======================================================================
572 keyboard_mapping: enabled=0, map=
574 #=======================================================================
575 # KEYBOARD_TYPE:
576 # Type of keyboard return by a "identify keyboard" command to the
577 # keyboard controler. It must be one of "xt", "at" or "mf".
578 # Defaults to "mf". It should be ok for almost everybody. A known
579 # exception is french macs, that do have a "at"-like keyboard.
580 #
581 # Examples:
582 # keyboard_type: mf
583 #=======================================================================
584 #keyboard_type: mf
586 #=======================================================================
587 # USER_SHORTCUT:
588 # This defines the keyboard shortcut to be sent when you press the "user"
589 # button in the headerbar. The shortcut string can be a combination of
590 # these key names: "alt", "bksp", "ctrl", "del", "esc", "f1", "f4", "tab"
591 # and "win". Up to 3 keys can be pressed at a time.
592 #
593 # Example:
594 # user_shortcut: keys=ctrlaltdel
595 #=======================================================================
596 #user_shortcut: keys=ctrlaltdel
598 #=======================================================================
599 # other stuff
600 #=======================================================================
601 #magic_break: enabled=1
602 #cmosimage: cmos.img
603 #load32bitOSImage: os=nullkernel, path=../kernel.img, iolog=../vga_io.log
604 #load32bitOSImage: os=linux, path=../linux.img, iolog=../vga_io.log, initrd=../initrd.img
605 #i440fxsupport: enabled=1
606 usb1: enabled=1, ioaddr=0xFF80, irq=10
607 #text_snapshot_check: enable
609 #=======================================================================
610 # for Macintosh, use the style of pathnames in the following
611 # examples.
612 #
613 # vgaromimage: :bios:VGABIOS-elpin-2.40
614 # romimage: file=:bios:BIOS-bochs-latest, address=0xf0000
615 # floppya: 1_44=[fd:], status=inserted
616 #=======================================================================
619 #=======================================================================
620 #
621 # The following directives are DEPRECATED
622 # Please convert them to the new syntax or remove them
623 #
624 #=======================================================================
626 #=======================================================================
627 #
628 # The DISKC option is deprecated. Use ATA* options instead.
629 #
630 # DISKC: file=, cyl=, heads=, spt=
631 # Point this at a hard disk image file. To create
632 # a hard disk image, try running bximage. It will help you choose the
633 # size and then suggest a diskc line that works with it.
634 #
635 # In UNIX it may be possible to use a raw device as a Bochs hard disk,
636 # but WE DON'T RECOMMEND IT. In Windows there is no easy way.
637 #
638 # Examples:
639 # diskc: file=10M.sample, cyl=306, heads=4, spt=17
640 # diskc: file=20M.sample, cyl=615, heads=4, spt=17
641 # diskc: file=30M.sample, cyl=615, heads=6, spt=17
642 # diskc: file=46M.sample, cyl=940, heads=6, spt=17
643 # diskc: file=62M.sample, cyl=940, heads=8, spt=17
644 # diskc: file=112M.sample, cyl=900, heads=15, spt=17
645 # diskc: file=483M.sample, cyl=1024, heads=15, spt=63
646 #=======================================================================
647 #diskc: file="30M.sample", cyl=615, heads=6, spt=17
649 #=======================================================================
650 #
651 # The DISKD option is deprecated. Use ATA* options instead.
652 #
653 # DISKD:
654 # See DISKC above for syntax
655 #
656 # NOTE: diskd and cdromd must not be used together!
657 #=======================================================================
658 #diskd: file="diskd.img", cyl=615, heads=6, spt=17
660 #=======================================================================
661 #
662 # The CDROMD option is deprecated. Use ATA* options instead.
663 #
664 # CDROMD:
665 #
666 # cdromd: dev=/dev/cdrom, status=inserted
667 # cdromd: dev=/dev/cdrom, status=ejected
668 # cdromd: dev=e:, status=ejected
669 #
670 # In windows, the drive letter + colon notation should be used for cdroms.
671 # Depending on versions of windows and drivers, you may only be able to
672 # access the "first" cdrom in the system. On MacOSX, use path="drive"
673 # to access the physical drive.
674 #
675 # NOTE: diskd and cdromd must not be used together!
676 #=======================================================================
677 #cdromd: dev=D:, status=inserted
678 #cdromd: dev=/dev/cdrom, status=inserted
679 #cdromd: dev="drive", status=inserted
681 #=======================================================================
682 #
683 # The TIME0 directive is DEPRECATED. Use the CLOCK directive instead
684 #
685 # TIME0:
686 # Specifies the start (boot) time of the virtual machine. Use a time
687 # value as returned by the time(2) system call. If no time0 value is
688 # set or if time0 equal to 1 (special case), the simulation will be
689 # started at the current time of the host.
690 #
691 # Examples:
692 # time0: 1 # Now
693 # time0: 315529200 # Tue Jan 1 00:00:00 1980
694 # time0: 631148400 # Mon Jan 1 00:00:00 1990
695 # time0: 938581955 # Wed Sep 29 07:12:35 1999
696 # time0: 946681200 # Sat Jan 1 00:00:00 2000
697 #=======================================================================
698 #time0: 938581955
700 #=======================================================================
701 #
702 # The PIT directive is DEPRECATED. Use the CLOCK directive instead
703 #
704 # PIT:
705 # The PIT is the programmable interval timer. It has an option that tries to
706 # keep the PIT in sync with real time. This feature is still experimental,
707 # but it may be useful if you want to prevent Bochs from running too fast, for
708 # example a DOS video game. Be aware that with the realtime pit option, your
709 # simulation will not be repeatable; this can a problem if you are debugging.
710 #=======================================================================
711 #pit: realtime=1
713 #=======================================================================
714 # NEWHARDDRIVESUPPORT: enabled=[0|1]
715 # The old harddrive code is not maintened any more.
716 # Default value is enabled=1
717 #=======================================================================
718 #newharddrivesupport: enabled=1