[block] Provide sandev_read() and sandev_write() as global symbols
[ipxe.git] / contrib / vm / bochsrc.txt
1 # You may now use double quotes around pathnames, in case
2 # your pathname includes spaces.
3
4 #=======================================================================
5 # PLUGIN_CTRL:
6 # Controls the presence of optional device plugins. These plugins are loaded
7 # directly with this option and some of them install a config option that is
8 # only available when the plugin device is loaded. The value "1" means to load
9 # the plugin and "0" will unload it (if loaded before).
10 # These plugins are currently supported: 'biosdev', 'e1000', 'es1370',
11 # 'extfpuirq', 'gameport', 'iodebug', 'ne2k', 'parallel', 'pcidev', 'pcipnic',
12 # 'sb16', 'serial', 'speaker', 'unmapped', 'usb_ohci', 'usb_uhci' and 'usb_xhci'.
13 #=======================================================================
14 plugin_ctrl: unmapped=1, biosdev=1, speaker=1, e1000=1, parallel=1, serial=1
15
16 #=======================================================================
17 # CONFIG_INTERFACE
18 #
19 # The configuration interface is a series of menus or dialog boxes that
20 # allows you to change all the settings that control Bochs's behavior.
21 # Depending on the platform there are up to 3 choices of configuration
22 # interface: a text mode version called "textconfig" and two graphical versions
23 # called "win32config" and "wx".  The text mode version uses stdin/stdout and
24 # is always compiled in, unless Bochs is compiled for wx only. The choice
25 # "win32config" is only available on win32 and it is the default there.
26 # The choice "wx" is only available when you use "--with-wx" on the configure
27 # command.  If you do not write a config_interface line, Bochs will
28 # choose a default for you.
29 #
30 # NOTE: if you use the "wx" configuration interface, you must also use
31 # the "wx" display library.
32 #=======================================================================
33 #config_interface: textconfig
34 #config_interface: win32config
35 #config_interface: wx
36
37 #=======================================================================
38 # DISPLAY_LIBRARY
39 #
40 # The display library is the code that displays the Bochs VGA screen.  Bochs
41 # has a selection of about 10 different display library implementations for
42 # different platforms.  If you run configure with multiple --with-* options,
43 # the display_library command lets you choose which one you want to run with.
44 # If you do not write a display_library line, Bochs will choose a default for
45 # you.
46 #
47 # The choices are:
48 #   x              use X windows interface, cross platform
49 #   win32          use native win32 libraries
50 #   carbon         use Carbon library (for MacOS X)
51 #   macintosh      use MacOS pre-10
52 #   amigaos        use native AmigaOS libraries
53 #   sdl            use SDL library, cross platform
54 #   svga           use SVGALIB library for Linux, allows graphics without X11
55 #   term           text only, uses curses/ncurses library, cross platform
56 #   rfb            provides an interface to AT&T's VNC viewer, cross platform
57 #   wx             use wxWidgets library, cross platform
58 #   nogui          no display at all
59 #
60 # NOTE: if you use the "wx" configuration interface, you must also use
61 # the "wx" display library.
62 #
63 # Specific options:
64 # Some display libraries now support specific options to control their
65 # behaviour. These options are supported by more than one display library:
66 #
67 # "gui_debug"   - use GTK debugger gui (sdl, x) / Win32 debugger gui (win32)
68 # "hideIPS"     - disable IPS output in status bar (sdl, wx, x)
69 # "nokeyrepeat" - turn off host keyboard repeat (sdl, win32, x)
70 #
71 # See the examples below for other currently supported options.
72 #=======================================================================
73 #display_library: amigaos
74 #display_library: carbon
75 #display_library: macintosh
76 #display_library: nogui
77 #display_library: rfb, options="timeout=60" # time to wait for client
78 #display_library: sdl, options="fullscreen" # startup in fullscreen mode
79 #display_library: term
80 #display_library: win32
81 #display_library: wx
82 #display_library: x
83
84 #=======================================================================
85 # ROMIMAGE:
86 # The ROM BIOS controls what the PC does when it first powers on.
87 # Normally, you can use a precompiled BIOS in the source or binary
88 # distribution called BIOS-bochs-latest. The ROM BIOS is usually loaded
89 # starting at address 0xf0000, and it is exactly 64k long. Another option
90 # is 128k BIOS which is loaded at address 0xe0000.
91 # You can also use the environment variable $BXSHARE to specify the
92 # location of the BIOS.
93 # The usage of external large BIOS images (up to 512k) at memory top is
94 # now supported, but we still recommend to use the BIOS distributed with
95 # Bochs. The start address optional, since it can be calculated from image size.
96 #=======================================================================
97 #romimage: file=$BXSHARE/BIOS-bochs-latest
98 #romimage: file=bios/seabios-1.6.3.bin
99 #romimage: file=mybios.bin, address=0xfff80000 # 512k at memory top
100 romimage: file=bochs/bios/BIOS-bochs-latest
101
102 #=======================================================================
103 # CPU:
104 # This defines cpu-related parameters inside Bochs:
105 #
106 #  MODEL:
107 #    Selects CPU configuration to emulate from pre-defined list of all
108 #    supported configurations. When this option is used, the CPUID option
109 #    has no effect anymore.
110 #
111 #  CPU configurations that can be selected:
112 # -----------------------------------------------------------------
113 #  pentium_mmx                Intel Pentium MMX
114 #  amd_k6_2_chomper           AMD-K6(tm) 3D processor (Chomper)
115 #  p2_klamath                 Intel Pentium II (Klamath)
116 #  p3_katmai                  Intel Pentium III (Katmai)
117 #  p4_willamette              Intel(R) Pentium(R) 4 (Willamette)
118 #  core_duo_t2400_yonah       Intel(R) Core(TM) Duo CPU T2400 (Yonah)
119 #  atom_n270                  Intel(R) Atom(TM) CPU N270
120 #  athlon64_clawhammer        AMD Athlon(tm) 64 Processor 2800+ (Clawhammer)
121 #  athlon64_venice            AMD Athlon(tm) 64 Processor 3000+ (Venice)
122 #  turion64_tyler             AMD Turion(tm) 64 X2 Mobile TL-60 (Tyler)
123 #  phenom_8650_toliman        AMD Phenom X3 8650 (Toliman)
124 #  p4_prescott_celeron_336    Intel(R) Celeron(R) 336 (Prescott)
125 #  core2_penryn_t9600         Intel Mobile Core 2 Duo T9600 (Penryn)
126 #  corei5_lynnfield_750       Intel(R) Core(TM) i5   750 (Lynnfield)
127 #  corei5_arrandale_m520      Intel(R) Core(TM) i5 M 520 (Arrandale)
128 #  corei7_sandy_bridge_2600k  Intel(R) Core(TM) i7-2600K (Sandy Bridge)
129 #  corei7_ivy_bridge_3770k    Intel(R) Core(TM) i7-3770K CPU (Ivy Bridge)
130 #
131 #  COUNT:
132 #    Set the number of processors:cores per processor:threads per core
133 #    when Bochs is compiled for SMP emulation.
134 #    Bochs currently supports up to 8 threads running simultaniosly.
135 #    If Bochs is compiled without SMP support, it won't accept values
136 #    different from 1.
137 #
138 #  QUANTUM:
139 #    Maximum amount of instructions allowed to execute by processor before
140 #    returning control to another cpu. This option exists only in Bochs
141 #    binary compiled with SMP support.
142 #
143 #  RESET_ON_TRIPLE_FAULT:
144 #    Reset the CPU when triple fault occur (highly recommended) rather than
145 #    PANIC. Remember that if you trying to continue after triple fault the
146 #    simulation will be completely bogus !
147 #
148 #  CPUID_LIMIT_WINNT:
149 #    Determine whether to limit maximum CPUID function to 2. This mode is
150 #    required to workaround WinNT installation and boot issues.
151 #
152 #  MSRS:
153 #    Define path to user CPU Model Specific Registers (MSRs) specification.
154 #    See example in msrs.def.
155 #
156 #  IGNORE_BAD_MSRS:
157 #    Ignore MSR references that Bochs does not understand; print a warning
158 #    message instead of generating #GP exception. This option is enabled
159 #    by default but will not be avaiable if configurable MSRs are enabled.
160 #
161 #  MWAIT_IS_NOP:
162 #    When this option is enabled MWAIT will not put the CPU into a sleep state.
163 #    This option exists only if Bochs compiled with --enable-monitor-mwait.
164 #
165 #  IPS:
166 #    Emulated Instructions Per Second. This is the number of IPS that bochs
167 #    is capable of running on your machine. You can recompile Bochs with
168 #    --enable-show-ips option enabled, to find your host's capability.
169 #    Measured IPS value will then be logged into your log file or shown
170 #    in the status bar (if supported by the gui).
171 #
172 #    IPS is used to calibrate many time-dependent events within the bochs
173 #    simulation.  For example, changing IPS affects the frequency of VGA
174 #    updates, the duration of time before a key starts to autorepeat, and
175 #    the measurement of BogoMips and other benchmarks.
176 #
177 #  Examples:
178 #
179 #  Bochs Machine/Compiler                                 Mips
180 # ______________________________________________________________________
181 #  2.4.6 3.4Ghz Intel Core i7 2600 with Win7x64/g++ 4.5.2 85 to 95 Mips
182 #  2.3.7 3.2Ghz Intel Core 2 Q9770 with WinXP/g++ 3.4     50 to 55 Mips
183 #  2.3.7 2.6Ghz Intel Core 2 Duo with WinXP/g++ 3.4       38 to 43 Mips
184 #  2.2.6 2.6Ghz Intel Core 2 Duo with WinXP/g++ 3.4       21 to 25 Mips
185 #  2.2.6 2.1Ghz Athlon XP with Linux 2.6/g++ 3.4          12 to 15 Mips
186 #=======================================================================
187 cpu: model=core2_penryn_t9600, count=1, ips=50000000, reset_on_triple_fault=1, ignore_bad_msrs=1, msrs="msrs.def"
188 cpu: cpuid_limit_winnt=0
189
190 #=======================================================================
191 # CPUID:
192 #
193 # This defines features and functionality supported by Bochs emulated CPU.
194 # The option has no offect if CPU model was selected in CPU option.
195 #
196 #  MMX:
197 #    Select MMX instruction set support.
198 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 5.
199 #
200 #  APIC:
201 #    Select APIC configuration (LEGACY/XAPIC/XAPIC_EXT/X2APIC).
202 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 5.
203 #
204 #  SEP:
205 #    Select SYSENTER/SYSEXIT instruction set support.
206 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
207 #
208 #  SSE:
209 #    Select SSE instruction set support.
210 #    Any of NONE/SSE/SSE2/SSE3/SSSE3/SSE4_1/SSE4_2 could be selected.
211 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
212 #
213 #  SSE4A:
214 #    Select AMD SSE4A instructions support.
215 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
216 #
217 #  AES:
218 #    Select AES instruction set support.
219 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
220 #
221 #  MOVBE:
222 #    Select MOVBE Intel(R) Atom instruction support.
223 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
224 #
225 #  XSAVE:
226 #    Select XSAVE extensions support.
227 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
228 #
229 #  XSAVEOPT:
230 #    Select XSAVEOPT instruction support.
231 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
232 #
233 #  AVX:
234 #    Select AVX/AVX2 instruction set support.
235 #    This option exists only if Bochs compiled with --enable-avx option.
236 #
237 #  AVX_F16C:
238 #    Select AVX float16 convert instructions support.
239 #    This option exists only if Bochs compiled with --enable-avx option.
240 #
241 #  AVX_FMA:
242 #    Select AVX fused multiply add (FMA) instructions support.
243 #    This option exists only if Bochs compiled with --enable-avx option.
244 #
245 #  BMI:
246 #    Select BMI1/BMI2 instructions support.
247 #    This option exists only if Bochs compiled with --enable-avx option.
248 #
249 #  XOP:
250 #    Select AMD XOP instructions support.
251 #    This option exists only if Bochs compiled with --enable-avx option.
252 #
253 #  FMA4:
254 #    Select AMD four operand FMA instructions support.
255 #    This option exists only if Bochs compiled with --enable-avx option.
256 #
257 #  TBM:
258 #    Select AMD Trailing Bit Manipulation (TBM) instructions support.
259 #    This option exists only if Bochs compiled with --enable-avx option.
260 #
261 #  X86-64:
262 #    Enable x86-64 and long mode support.
263 #    This option exists only if Bochs compiled with x86-64 support.
264 #
265 #  1G_PAGES:
266 #    Enable 1G page size support in long mode.
267 #    This option exists only if Bochs compiled with x86-64 support.
268 #
269 #  PCID:
270 #    Enable Process-Context Identifiers (PCID) support in long mode.
271 #    This option exists only if Bochs compiled with x86-64 support.
272 #
273 #  FSGSBASE:
274 #    Enable GS/GS BASE access instructions support in long mode.
275 #    This option exists only if Bochs compiled with x86-64 support.
276 #
277 #  SMEP:
278 #    Enable Supervisor Mode Execution Protection (SMEP) support.
279 #    This option exists only if Bochs compiled with BX_CPU_LEVEL >= 6.
280 #
281 #  MWAIT:
282 #    Select MONITOR/MWAIT instructions support.
283 #    This option exists only if Bochs compiled with --enable-monitor-mwait.
284 #
285 #  VMX:
286 #    Select VMX extensions emulation support.
287 #    This option exists only if Bochs compiled with --enable-vmx option.
288 #
289 #  VENDOR_STRING:
290 #    Set the CPUID vendor string returned by CPUID(0x0). This should be a
291 #    twelve-character ASCII string.
292 #
293 #  BRAND_STRING:
294 #    Set the CPUID vendor string returned by CPUID(0x80000002 .. 0x80000004).
295 #    This should be at most a forty-eight-character ASCII string.
296 #
297 #  FAMILY:
298 #    Set model information returned by CPUID. Default family value determined
299 #    by configure option --enable-cpu-level.
300 #
301 #  MODEL:
302 #    Set model information returned by CPUID. Default model value is 3.
303 #
304 #  STEPPING:
305 #    Set stepping information returned by CPUID. Default stepping value is 3.
306 #=======================================================================
307 #cpuid: x86_64=1, mmx=1, sep=1, sse=sse4_2, apic=xapic, aes=1, movbe=1, xsave=1
308 #cpuid: family=6, model=0x1a, stepping=5
309
310 #=======================================================================
311 # MEMORY
312 # Set the amount of physical memory you want to emulate.
313 #
314 # GUEST:
315 # Set amount of guest physical memory to emulate. The default is 32MB,
316 # the maximum amount limited only by physical address space limitations.
317 #
318 # HOST:
319 # Set amount of host memory you want to allocate for guest RAM emulation.
320 # It is possible to allocate less memory than you want to emulate in guest
321 # system. This will fake guest to see the non-existing memory. Once guest
322 # system touches new memory block it will be dynamically taken from the
323 # memory pool. You will be warned (by FATAL PANIC) in case guest already
324 # used all allocated host memory and wants more.
325 #
326 #=======================================================================
327 memory: guest=512, host=256
328
329 #=======================================================================
330 # OPTROMIMAGE[1-4]:
331 # You may now load up to 4 optional ROM images. Be sure to use a
332 # read-only area, typically between C8000 and EFFFF. These optional
333 # ROM images should not overwrite the rombios (located at
334 # F0000-FFFFF) and the videobios (located at C0000-C7FFF).
335 # Those ROM images will be initialized by the bios if they contain
336 # the right signature (0x55AA) and a valid checksum.
337 # It can also be a convenient way to upload some arbitrary code/data
338 # in the simulation, that can be retrieved by the boot loader
339 #=======================================================================
340 #optromimage1: file=optionalrom.bin, address=0xd0000
341 #optromimage2: file=optionalrom.bin, address=0xd1000
342 #optromimage3: file=optionalrom.bin, address=0xd2000
343 #optromimage4: file=optionalrom.bin, address=0xd3000
344 optromimage1: file=../../src/bin/intel.rom, address=0xcb000
345
346 #optramimage1: file=/path/file1.img, address=0x0010000
347 #optramimage2: file=/path/file2.img, address=0x0020000
348 #optramimage3: file=/path/file3.img, address=0x0030000
349 #optramimage4: file=/path/file4.img, address=0x0040000
350
351 #=======================================================================
352 # VGAROMIMAGE
353 # You now need to load a VGA ROM BIOS into C0000.
354 #=======================================================================
355 #vgaromimage: file=bios/VGABIOS-elpin-2.40
356 #vgaromimage: file=$BXSHARE/VGABIOS-lgpl-latest
357 #vgaromimage: file=bios/VGABIOS-lgpl-latest-cirrus
358 vgaromimage: file=bochs/bios/VGABIOS-lgpl-latest
359
360 #=======================================================================
361 # VGA:
362 # This defines parameters related to the VGA display
363 #
364 #   EXTENSION
365 #     Here you can specify the display extension to be used. With the value
366 #     'none' you can use standard VGA with no extension. Other supported
367 #     values are 'vbe' for Bochs VBE and 'cirrus' for Cirrus SVGA support.
368 #
369 #   UPDATE_FREQ
370 #     The VGA update frequency is based on the emulated clock and the default
371 #     value is 5. Keep in mind that you must tweak the 'cpu: ips=N' directive
372 #     to be as close to the number of emulated instructions-per-second your
373 #     workstation can do, for this to be accurate. If the realtime sync is
374 #     enabled with the 'clock' option, the value is based on the real time.
375 #     This parameter can be changed at runtime.
376 #
377 # Examples:
378 #   vga: extension=cirrus, update_freq=10
379 #=======================================================================
380 #vga: extension=vbe, update_freq=5
381
382 #=======================================================================
383 # FLOPPYA:
384 # Point this to pathname of floppy image file or device
385 # This should be of a bootable floppy(image/device) if you're
386 # booting from 'a' (or 'floppy').
387 #
388 # You can set the initial status of the media to 'ejected' or 'inserted'.
389 #   floppya: 2_88=path, status=ejected    (2.88M 3.5"  media)
390 #   floppya: 1_44=path, status=inserted   (1.44M 3.5"  media)
391 #   floppya: 1_2=path, status=ejected     (1.2M  5.25" media)
392 #   floppya: 720k=path, status=inserted   (720K  3.5"  media)
393 #   floppya: 360k=path, status=inserted   (360K  5.25" media)
394 #   floppya: 320k=path, status=inserted   (320K  5.25" media)
395 #   floppya: 180k=path, status=inserted   (180K  5.25" media)
396 #   floppya: 160k=path, status=inserted   (160K  5.25" media)
397 #   floppya: image=path, status=inserted  (guess media type from image size)
398 #   floppya: 1_44=vvfat:path, status=inserted  (use directory as VFAT media)
399 #   floppya: type=1_44                    (1.44M 3.5" floppy drive, no media)
400 #
401 # The path should be the name of a disk image file.  On Unix, you can use a raw
402 # device name such as /dev/fd0 on Linux.  On win32 platforms, use drive letters
403 # such as a: or b: as the path.  The parameter 'image' works with image files
404 # only. In that case the size must match one of the supported types.
405 # The parameter 'type' can be used to enable the floppy drive without media
406 # and status specified. Usually the drive type is set up based on the media type.
407 # The optional parameter 'write_protected' can be used to control the media
408 # write protect switch. By default it is turned off.
409 #=======================================================================
410 #floppya: 1_44=/dev/fd0, status=inserted
411 #floppya: image=../1.44, status=inserted
412 #floppya: 1_44=/dev/fd0H1440, status=inserted
413 #floppya: 1_2=../1_2, status=inserted
414 #floppya: 1_44=a:, status=inserted
415 #floppya: 1_44=a.img, status=inserted, write_protected=1
416 #floppya: 1_44=/dev/rfd0a, status=inserted
417 floppya: 1_44=../../src/bin/ipxe.dsk, status=inserted
418
419 #=======================================================================
420 # FLOPPYB:
421 # See FLOPPYA above for syntax
422 #=======================================================================
423 #floppyb: 1_44=b:, status=inserted
424 #floppyb: 1_44=b.img, status=inserted
425
426 #=======================================================================
427 # ATA0, ATA1, ATA2, ATA3
428 # ATA controller for hard disks and cdroms
429 #
430 # ata[0-3]: enabled=[0|1], ioaddr1=addr, ioaddr2=addr, irq=number
431 #
432 # These options enables up to 4 ata channels. For each channel
433 # the two base io addresses and the irq must be specified.
434 #
435 # ata0 and ata1 are enabled by default with the values shown below
436 #
437 # Examples:
438 #   ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
439 #   ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
440 #   ata2: enabled=1, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
441 #   ata3: enabled=1, ioaddr1=0x168, ioaddr2=0x360, irq=9
442 #=======================================================================
443 ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
444 ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
445 ata2: enabled=0, ioaddr1=0x1e8, ioaddr2=0x3e0, irq=11
446 ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x360, irq=9
447
448 #=======================================================================
449 # ATA[0-3]-MASTER, ATA[0-3]-SLAVE
450 #
451 # This defines the type and characteristics of all attached ata devices:
452 #   type=       type of attached device [disk|cdrom]
453 #   mode=       only valid for disks [flat|concat|external|dll|sparse|vmware3]
454 #   mode=       only valid for disks [undoable|growing|volatile|vvfat]
455 #   path=       path of the image / directory
456 #   cylinders=  only valid for disks
457 #   heads=      only valid for disks
458 #   spt=        only valid for disks
459 #   status=     only valid for cdroms [inserted|ejected]
460 #   biosdetect= type of biosdetection [none|auto], only for disks on ata0 [cmos]
461 #   translation=type of translation of the bios, only for disks [none|lba|large|rechs|auto]
462 #   model=      string returned by identify device command
463 #   journal=    optional filename of the redolog for undoable, volatile and vvfat disks
464 #
465 # Point this at a hard disk image file, cdrom iso file, or physical cdrom
466 # device.  To create a hard disk image, try running bximage.  It will help you
467 # choose the size and then suggest a line that works with it.
468 #
469 # In UNIX it may be possible to use a raw device as a Bochs hard disk,
470 # but WE DON'T RECOMMEND IT.  In Windows there is no easy way.
471 #
472 # In windows, the drive letter + colon notation should be used for cdroms.
473 # Depending on versions of windows and drivers, you may only be able to
474 # access the "first" cdrom in the system.  On MacOSX, use path="drive"
475 # to access the physical drive.
476 #
477 # The path is mandatory for hard disks. Disk geometry autodetection works with
478 # images created by bximage if CHS is set to 0/0/0 (cylinders are calculated
479 # using  heads=16 and spt=63). For other hard disk images and modes the
480 # cylinders, heads, and spt are mandatory. In all cases the disk size reported
481 # from the image must be exactly C*H*S*512.
482 #
483 # Default values are:
484 #   mode=flat, biosdetect=auto, translation=auto, model="Generic 1234"
485 #
486 # The biosdetect option has currently no effect on the bios
487 #
488 # Examples:
489 #   ata0-master: type=disk, mode=flat, path=10M.sample, cylinders=306, heads=4, spt=17
490 #   ata0-slave:  type=disk, mode=flat, path=20M.sample, cylinders=615, heads=4, spt=17
491 #   ata1-master: type=disk, mode=flat, path=30M.sample, cylinders=615, heads=6, spt=17
492 #   ata1-slave:  type=disk, mode=flat, path=46M.sample, cylinders=940, heads=6, spt=17
493 #   ata2-master: type=disk, mode=flat, path=62M.sample, cylinders=940, heads=8, spt=17
494 #   ata2-slave:  type=disk, mode=flat, path=112M.sample, cylinders=900, heads=15, spt=17
495 #   ata3-master: type=disk, mode=flat, path=483M.sample, cylinders=1024, heads=15, spt=63
496 #   ata3-slave:  type=cdrom, path=iso.sample, status=inserted
497 #=======================================================================
498 #ata0-master: type=disk, mode=flat, path="30M.sample"
499 #ata0-master: type=disk, mode=flat, path="30M.sample", cylinders=615, heads=6, spt=17
500 #ata0-master: type=disk, mode=flat, path="c.img", cylinders=0 # autodetect
501 #ata0-slave: type=disk, mode=vvfat, path=/bochs/images/vvfat, journal=vvfat.redolog
502 #ata0-slave: type=cdrom, path=D:, status=inserted
503 #ata0-slave: type=cdrom, path=/dev/cdrom, status=inserted
504 #ata0-slave: type=cdrom, path="drive", status=inserted
505 #ata0-slave: type=cdrom, path=/dev/rcd0d, status=inserted
506
507 #=======================================================================
508 # BOOT:
509 # This defines the boot sequence. Now you can specify up to 3 boot drives,
510 # which can be 'floppy', 'disk', 'cdrom' or 'network' (boot ROM).
511 # Legacy 'a' and 'c' are also supported.
512 # Examples:
513 #   boot: floppy
514 #   boot: cdrom, disk
515 #   boot: network, disk
516 #   boot: cdrom, floppy, disk
517 #=======================================================================
518 #boot: floppy
519 #boot: disk
520 boot: network, floppy
521
522 #=======================================================================
523 # CLOCK:
524 # This defines the parameters of the clock inside Bochs:
525 #
526 #  SYNC:
527 #  This defines the method how to synchronize the Bochs internal time
528 #  with realtime. With the value 'none' the Bochs time relies on the IPS
529 #  value and no host time synchronization is used. The 'slowdown' method
530 #  sacrifices performance to preserve reproducibility while allowing host
531 #  time correlation. The 'realtime' method sacrifices reproducibility to
532 #  preserve performance and host-time correlation.
533 #  It is possible to enable both synchronization methods.
534 #
535 #  RTC_SYNC:
536 #  If this option is enabled together with the realtime synchronization,
537 #  the RTC runs at realtime speed. This feature is disabled by default.
538 #
539 #  TIME0:
540 #  Specifies the start (boot) time of the virtual machine. Use a time
541 #  value as returned by the time(2) system call. If no time0 value is
542 #  set or if time0 equal to 1 (special case) or if time0 equal 'local',
543 #  the simulation will be started at the current local host time.
544 #  If time0 equal to 2 (special case) or if time0 equal 'utc',
545 #  the simulation will be started at the current utc time.
546 #
547 # Syntax:
548 #  clock: sync=[none|slowdown|realtime|both], time0=[timeValue|local|utc]
549 #
550 # Example:
551 #   clock: sync=none,     time0=local       # Now (localtime)
552 #   clock: sync=slowdown, time0=315529200   # Tue Jan  1 00:00:00 1980
553 #   clock: sync=none,     time0=631148400   # Mon Jan  1 00:00:00 1990
554 #   clock: sync=realtime, time0=938581955   # Wed Sep 29 07:12:35 1999
555 #   clock: sync=realtime, time0=946681200   # Sat Jan  1 00:00:00 2000
556 #   clock: sync=none,     time0=1           # Now (localtime)
557 #   clock: sync=none,     time0=utc         # Now (utc/gmt)
558 #
559 # Default value are sync=none, time0=local
560 #=======================================================================
561 #clock: sync=none, time0=local
562
563
564 #=======================================================================
565 # FLOPPY_BOOTSIG_CHECK: disabled=[0|1]
566 # Enables or disables the 0xaa55 signature check on boot floppies
567 # Defaults to disabled=0
568 # Examples:
569 #   floppy_bootsig_check: disabled=0
570 #   floppy_bootsig_check: disabled=1
571 #=======================================================================
572 floppy_bootsig_check: disabled=0
573
574 #=======================================================================
575 # LOG:
576 # Give the path of the log file you'd like Bochs debug and misc. verbiage
577 # to be written to. If you don't use this option or set the filename to
578 # '-' the output is written to the console. If you really don't want it,
579 # make it "/dev/null" (Unix) or "nul" (win32). :^(
580 #
581 # Examples:
582 #   log: ./bochs.out
583 #   log: /dev/tty
584 #=======================================================================
585 #log: /dev/null
586 log: bochsout.txt
587
588 #=======================================================================
589 # LOGPREFIX:
590 # This handles the format of the string prepended to each log line.
591 # You may use those special tokens :
592 #   %t : 11 decimal digits timer tick
593 #   %i : 8 hexadecimal digits of cpu current eip (ignored in SMP configuration)
594 #   %e : 1 character event type ('i'nfo, 'd'ebug, 'p'anic, 'e'rror)
595 #   %d : 5 characters string of the device, between brackets
596 #
597 # Default : %t%e%d
598 # Examples:
599 #   logprefix: %t-%e-@%i-%d
600 #   logprefix: %i%e%d
601 #=======================================================================
602 #logprefix: %t%e%d
603
604 #=======================================================================
605 # LOG CONTROLS
606 #
607 # Bochs has four severity levels for event logging.
608 #   panic: cannot proceed.  If you choose to continue after a panic,
609 #          don't be surprised if you get strange behavior or crashes.
610 #   error: something went wrong, but it is probably safe to continue the
611 #          simulation.
612 #   info: interesting or useful messages.
613 #   debug: messages useful only when debugging the code.  This may
614 #          spit out thousands per second.
615 #
616 # For events of each level, you can choose to exit Bochs ('fatal'), 'report'
617 # or 'ignore'. On some guis you have the additional choice 'ask'. A gui dialog
618 # appears asks how to proceed.
619 #
620 # It is also possible to specify the 'action' to do for each Bochs facility
621 # separately (e.g. crash on panics from everything except the cdrom, and only
622 # report those). See the 'log function' module list in the user documentation.
623 #
624 # If you are experiencing many panics, it can be helpful to change
625 # the panic action to report instead of fatal.  However, be aware
626 # that anything executed after a panic is uncharted territory and can
627 # cause bochs to become unstable.  The panic is a "graceful exit," so
628 # if you disable it you may get a spectacular disaster instead.
629 #=======================================================================
630 panic: action=ask
631 error: action=report
632 info: action=report
633 debug: action=ignore, pci=report # report BX_DEBUG from module 'pci'
634
635 #=======================================================================
636 # DEBUGGER_LOG:
637 # Give the path of the log file you'd like Bochs to log debugger output.
638 # If you really don't want it, make it /dev/null or '-'. :^(
639 #
640 # Examples:
641 #   debugger_log: ./debugger.out
642 #=======================================================================
643 #debugger_log: /dev/null
644 #debugger_log: debugger.out
645 debugger_log: -
646
647 #=======================================================================
648 # COM1, COM2, COM3, COM4:
649 # This defines a serial port (UART type 16550A). In the 'term' you can specify
650 # a device to use as com1. This can be a real serial line, or a pty.  To use
651 # a pty (under X/Unix), create two windows (xterms, usually).  One of them will
652 # run bochs, and the other will act as com1. Find out the tty the com1
653 # window using the `tty' command, and use that as the `dev' parameter.
654 # Then do `sleep 1000000' in the com1 window to keep the shell from
655 # messing with things, and run bochs in the other window.  Serial I/O to
656 # com1 (port 0x3f8) will all go to the other window.
657 # In socket* and pipe* (win32 only) modes Bochs becomes either socket/named pipe
658 # client or server. In client mode it connects to an already running server (if
659 # connection fails Bochs treats com port as not connected). In server mode it
660 # opens socket/named pipe and waits until a client application connects to it
661 # before starting simulation. This mode is useful for remote debugging (e.g.
662 # with gdb's "target remote host:port" command or windbg's command line option
663 # -k com:pipe,port=\\.\pipe\pipename). Note: 'socket' is a shorthand for
664 # 'socket-client' and 'pipe' for 'pipe-client'. Socket modes use simple TCP
665 # communication, pipe modes use duplex byte mode pipes.
666 # Other serial modes are 'null' (no input/output), 'file' (output to a file
667 # specified as the 'dev' parameter), 'raw' (use the real serial port - under
668 # construction for win32), 'mouse' (standard serial mouse - requires
669 # mouse option setting 'type=serial', 'type=serial_wheel' or 'type=serial_msys').
670 #
671 # Examples:
672 #   com1: enabled=1, mode=null
673 #   com1: enabled=1, mode=mouse
674 #   com2: enabled=1, mode=file, dev=serial.out
675 #   com3: enabled=1, mode=raw, dev=com1
676 #   com3: enabled=1, mode=socket-client, dev=localhost:8888
677 #   com3: enabled=1, mode=socket-server, dev=localhost:8888
678 #   com4: enabled=1, mode=pipe-client, dev=\\.\pipe\mypipe
679 #   com4: enabled=1, mode=pipe-server, dev=\\.\pipe\mypipe
680 #=======================================================================
681 #com1: enabled=1, mode=term, dev=/dev/ttyp9
682
683
684 #=======================================================================
685 # PARPORT1, PARPORT2:
686 # This defines a parallel (printer) port. When turned on and an output file is
687 # defined the emulated printer port sends characters printed by the guest OS
688 # into the output file. On some platforms a device filename can be used to
689 # send the data to the real parallel port (e.g. "/dev/lp0" on Linux, "lpt1" on
690 # win32 platforms).
691 #
692 # Examples:
693 #   parport1: enabled=1, file="parport.out"
694 #   parport2: enabled=1, file="/dev/lp0"
695 #   parport1: enabled=0
696 #=======================================================================
697 parport1: enabled=1, file="parport.out"
698
699 #=======================================================================
700 # SB16:
701 # This defines the SB16 sound emulation. It can have several of the
702 # following properties.
703 # All properties are in the format sb16: property=value
704 # enabled:
705 #      This optional property controls the presence of the SB16 emulation.
706 #      The emulation is turned on unless this property is used and set to 0.
707 # midi: The filename is where the midi data is sent. This can be a
708 #       device or just a file if you want to record the midi data.
709 # midimode:
710 #      0=no data
711 #      1=output to device (system dependent. midi denotes the device driver)
712 #      2=SMF file output, including headers
713 #      3=output the midi data stream to the file (no midi headers and no
714 #        delta times, just command and data bytes)
715 # wave: This is the device/file where wave output is stored
716 # wavemode:
717 #      0=no data
718 #      1=output to device (system dependent. wave denotes the device driver)
719 #      2=VOC file output, incl. headers
720 #      3=output the raw wave stream to the file
721 # log:  The file to write the sb16 emulator messages to.
722 # loglevel:
723 #      0=no log
724 #      1=resource changes, midi program and bank changes
725 #      2=severe errors
726 #      3=all errors
727 #      4=all errors plus all port accesses
728 #      5=all errors and port accesses plus a lot of extra info
729 # dmatimer:
730 #      microseconds per second for a DMA cycle.  Make it smaller to fix
731 #      non-continuous sound.  750000 is usually a good value.  This needs a
732 #      reasonably correct setting for the IPS parameter of the CPU option.
733 #
734 # Examples for output devices:
735 #   sb16: midimode=1, midi="", wavemode=1, wave=""           # win32
736 #   sb16: midimode=1, midi=alsa:128:0, wavemode=1, wave=alsa # Linux with ALSA
737 #=======================================================================
738 #sb16: midimode=1, midi=/dev/midi00, wavemode=1, wave=/dev/dsp, loglevel=2, log=sb16.log, dmatimer=600000
739
740 #=======================================================================
741 # ES1370:
742 # This defines the ES1370 sound emulation. The parameter 'enabled' controls the
743 # presence of the device. In addition to this, it must be loaded with 'plugin_ctrl'
744 # and assigned to a PCI slot. The 'wavedev' parameter is similar to the 'wave'
745 # parameter of the SB16 soundcard. The emulation supports recording and playback
746 # (except DAC1+DAC2 output at the same time).
747 #
748 # Examples:
749 #   es1370: enabled=1, wavedev=""       # win32
750 #   es1370: enabled=1, wavedev=alsa     # Linux with ALSA
751 #=======================================================================
752 #es1370: enabled=1, wavedev=alsa
753
754 #=======================================================================
755 # KEYBOARD_SERIAL_DELAY:
756 # Approximate time in microseconds that it takes one character to
757 # be transfered from the keyboard to controller over the serial path.
758 # Examples:
759 #   keyboard_serial_delay: 200
760 #=======================================================================
761 keyboard_serial_delay: 250
762
763 #=======================================================================
764 # KEYBOARD_PASTE_DELAY:
765 # Approximate time in microseconds between attempts to paste
766 # characters to the keyboard controller. This leaves time for the
767 # guest os to deal with the flow of characters.  The ideal setting
768 # depends on how your operating system processes characters.  The
769 # default of 100000 usec (.1 seconds) was chosen because it works
770 # consistently in Windows.
771 #
772 # If your OS is losing characters during a paste, increase the paste
773 # delay until it stops losing characters.
774 #
775 # Examples:
776 #   keyboard_paste_delay: 100000
777 #=======================================================================
778 keyboard_paste_delay: 100000
779
780 #=======================================================================
781 # MOUSE:
782 # This defines parameters for the emulated mouse type, the initial status
783 # of the mouse capture and the runtime method to toggle it.
784 #
785 #  TYPE:
786 #  With the mouse type option you can select the type of mouse to emulate.
787 #  The default value is 'ps2'. The other choices are 'imps2' (wheel mouse
788 #  on PS/2), 'serial', 'serial_wheel' and 'serial_msys' (one com port requires
789 #  setting 'mode=mouse'). To connect a mouse to an USB port, see the 'usb_uhci',
790 #  'usb_ohci' or 'usb_xhci' options (requires PCI and USB support).
791 #
792 #  ENABLED:
793 #  The Bochs gui creates mouse "events" unless the 'enabled' option is
794 #  set to 0. The hardware emulation itself is not disabled by this.
795 #  Unless you have a particular reason for enabling the mouse by default,
796 #  it is recommended that you leave it off. You can also toggle the mouse
797 #  usage at runtime (RFB, SDL, Win32, wxWidgets and X11 - see below).
798 #
799 #  TOGGLE:
800 #  The default method to toggle the mouse capture at runtime is to press the
801 #  CTRL key and the middle mouse button ('ctrl+mbutton'). This option allows
802 #  to change the method to 'ctrl+f10' (like DOSBox), 'ctrl+alt' (like QEMU)
803 #  or 'f12' (replaces win32 'legacyF12' option).
804 #
805 # Examples:
806 #   mouse: enabled=1
807 #   mouse: type=imps2, enabled=1
808 #   mouse: type=serial, enabled=1
809 #   mouse: enabled=0, toggle=ctrl+f10
810 #=======================================================================
811 mouse: enabled=0
812
813 #=======================================================================
814 # private_colormap: Request that the GUI create and use it's own
815 #                   non-shared colormap.  This colormap will be used
816 #                   when in the bochs window.  If not enabled, a
817 #                   shared colormap scheme may be used.  Not implemented
818 #                   on all GUI's.
819 #
820 # Examples:
821 #   private_colormap: enabled=1
822 #   private_colormap: enabled=0
823 #=======================================================================
824 private_colormap: enabled=0
825
826 #=======================================================================
827 # fullscreen: ONLY IMPLEMENTED ON AMIGA
828 #             Request that Bochs occupy the entire screen instead of a
829 #             window.
830 #
831 # Examples:
832 #   fullscreen: enabled=0
833 #   fullscreen: enabled=1
834 #=======================================================================
835 #fullscreen: enabled=0
836 #screenmode: name="sample"
837
838 #=======================================================================
839 # ne2k: NE2000 compatible ethernet adapter
840 #
841 # Format:
842 # ne2k: enabled=1, ioaddr=IOADDR, irq=IRQ, mac=MACADDR, ethmod=MODULE,
843 #       ethdev=DEVICE, script=SCRIPT, bootrom=BOOTROM
844 #
845 # IOADDR, IRQ: You probably won't need to change ioaddr and irq, unless there
846 # are IRQ conflicts. These arguments are ignored when assign the ne2k to a
847 # PCI slot.
848 #
849 # MAC: The MAC address MUST NOT match the address of any machine on the net.
850 # Also, the first byte must be an even number (bit 0 set means a multicast
851 # address), and you cannot use ff:ff:ff:ff:ff:ff because that's the broadcast
852 # address.  For the ethertap module, you must use fe:fd:00:00:00:01.  There may
853 # be other restrictions too.  To be safe, just use the b0:c4... address.
854 #
855 # ETHDEV: The ethdev value is the name of the network interface on your host
856 # platform.  On UNIX machines, you can get the name by running ifconfig.  On
857 # Windows machines, you must run niclist to get the name of the ethdev.
858 # Niclist source code is in misc/niclist.c and it is included in Windows
859 # binary releases.
860 #
861 # SCRIPT: The script value is optional, and is the name of a script that
862 # is executed after bochs initialize the network interface. You can use
863 # this script to configure this network interface, or enable masquerading.
864 # This is mainly useful for the tun/tap devices that only exist during
865 # Bochs execution. The network interface name is supplied to the script
866 # as first parameter.
867 #
868 # BOOTROM: The bootrom value is optional, and is the name of the ROM image
869 # to load. Note that this feature is only implemented for the PCI version of
870 # the NE2000.
871 #
872 # If you don't want to make connections to any physical networks,
873 # you can use the following 'ethmod's to simulate a virtual network.
874 #   null: All packets are discarded, but logged to a few files.
875 #   vde:  Virtual Distributed Ethernet
876 #   vnet: ARP, ICMP-echo(ping), DHCP and read/write TFTP are simulated.
877 #         The virtual host uses 192.168.10.1.
878 #         DHCP assigns 192.168.10.2 to the guest.
879 #         TFTP uses the 'ethdev' value for the root directory and doesn't
880 #         overwrite files.
881 #
882 #=======================================================================
883 # ne2k: ioaddr=0x300, irq=9, mac=fe:fd:00:00:00:01, ethmod=fbsd, ethdev=en0 #macosx
884 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:00, ethmod=fbsd, ethdev=xl0
885 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:00, ethmod=linux, ethdev=eth0
886 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=win32, ethdev=MYCARD
887 # ne2k: ioaddr=0x300, irq=9, mac=fe:fd:00:00:00:01, ethmod=tap, ethdev=tap0
888 # ne2k: ioaddr=0x300, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=/dev/net/tun0, script=./tunconfig
889 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=null, ethdev=eth0
890 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=vde, ethdev="/tmp/vde.ctl"
891 # ne2k: ioaddr=0x300, irq=9, mac=b0:c4:20:00:00:01, ethmod=vnet, ethdev="c:/temp"
892 # ne2k: mac=b0:c4:20:00:00:01, ethmod=slirp, script=/usr/local/bin/slirp, bootrom=ne2k_pci.rom
893
894 #=======================================================================
895 # pnic: Bochs/Etherboot pseudo-NIC
896 #
897 # Format:
898 # pnic: enabled=1, mac=MACADDR, ethmod=MODULE, ethdev=DEVICE, script=SCRIPT,
899 #       bootrom=BOOTROM
900 #
901 # The pseudo-NIC accepts the same syntax (for mac, ethmod, ethdev, script,
902 # bootrom) and supports the same networking modules as the NE2000 adapter.
903 # In addition to this, it must be loaded with 'plugin_ctrl' and assigned
904 # to a PCI slot.
905 #=======================================================================
906 #pnic: enabled=1, mac=b0:c4:20:00:00:00, ethmod=vnet
907
908 #=======================================================================
909 # e1000: Intel(R) 82540EM Gigabit Ethernet adapter
910 #
911 # Format:
912 # e1000: enabled=1, mac=MACADDR, ethmod=MODULE, ethdev=DEVICE, script=SCRIPT
913 #        bootrom=BOOTROM
914 #
915 # The E1000 accepts the same syntax (for mac, ethmod, ethdev, script, bootrom)
916 # and supports the same networking modules as the NE2000 adapter. In addition
917 # to this, it must be loaded with 'plugin_ctrl' and assigned to a PCI slot.
918 #=======================================================================
919 #e1000: enabled=1, mac=52:54:00:12:34:56, ethmod=slirp, script=/usr/local/bin/slirp
920 e1000: enabled=1, mac=52:54:00:12:34:56, ethmod=tuntap, ethdev=/dev/net/tun:tap0
921
922 #=======================================================================
923 # KEYBOARD_MAPPING:
924 # This enables a remap of a physical localized keyboard to a
925 # virtualized us keyboard, as the PC architecture expects.
926 # If enabled, the keymap file must be specified.
927 #
928 # Examples:
929 #   keyboard_mapping: enabled=1, map=gui/keymaps/x11-pc-de.map
930 #=======================================================================
931 keyboard_mapping: enabled=0, map=
932
933 #=======================================================================
934 # KEYBOARD_TYPE:
935 # Type of keyboard return by a "identify keyboard" command to the
936 # keyboard controler. It must be one of "xt", "at" or "mf".
937 # Defaults to "mf". It should be ok for almost everybody. A known
938 # exception is french macs, that do have a "at"-like keyboard.
939 #
940 # Examples:
941 #   keyboard_type: mf
942 #=======================================================================
943 #keyboard_type: mf
944
945 #=======================================================================
946 # USER_SHORTCUT:
947 # This defines the keyboard shortcut to be sent when you press the "user"
948 # button in the headerbar. The shortcut string is a combination of maximum
949 # 3 key names (listed below) separated with a '-' character.
950 # Valid key names:
951 # "alt", "bksl", "bksp", "ctrl", "del", "down", "end", "enter", "esc",
952 # "f1", ... "f12", "home", "ins", "left", "menu", "minus", "pgdwn", "pgup",
953 # "plus", "right", "shift", "space", "tab", "up", "win", "print" and "power".
954 #
955 # Example:
956 #   user_shortcut: keys=ctrl-alt-del
957 #=======================================================================
958 #user_shortcut: keys=ctrl-alt-del
959
960 #=======================================================================
961 # PCI:
962 # This option controls the presence of a PCI chipset in Bochs. Currently it only
963 # supports the i440FX chipset. You can also specify the devices connected to
964 # PCI slots. Up to 5 slots are available. These devices are currently supported:
965 # cirrus, e1000, es1370, ne2k, pcivga, pcidev, pcipnic, usb_ohci and usb_xhci.
966 #
967 # Example:
968 #   pci: enabled=1, chipset=i440fx, slot1=pcivga, slot2=ne2k
969 #=======================================================================
970 pci: enabled=1, chipset=i440fx, slot1=e1000
971
972 #=======================================================================
973 # USB_UHCI:
974 # This option controls the presence of the USB root hub which is a part
975 # of the i440FX PCI chipset. With the portX parameter you can connect devices
976 # to the hub (currently supported: 'mouse', 'tablet', 'keypad', 'disk', 'cdrom'
977 # 'hub' and 'printer'). NOTE: UHCI must be loaded with 'plugin_ctrl'.
978 #
979 # The optionsX parameter can be used to assign specific options to the device
980 # connected to the corresponding USB port. Currently this feature is only used
981 # to set the speed reported by device and by the 'disk' device to specify
982 # an alternative redolog file of some image modes.
983 #
984 # If you connect the mouse or tablet to one of the ports, Bochs forwards the
985 # mouse movement data to the USB device instead of the selected mouse type.
986 # When connecting the keypad to one of the ports, Bochs forwards the input of
987 # the numeric keypad to the USB device instead of the PS/2 keyboard.
988 #
989 # To connect a 'flat' mode image as an USB hardisk you can use the 'disk' device
990 # with the path to the image separated with a colon. To use other disk image modes
991 # similar to ATA disks the syntax 'disk:mode:filename' must be used (see below).
992 #
993 # To emulate an USB cdrom you can use the 'cdrom' device name and the path to
994 # an ISO image or raw device name also separated with a colon. An option to
995 # insert/eject media is available in the runtime configuration.
996 #
997 # The device name 'hub' connects an external hub with max. 8 ports (default: 4)
998 # to the root hub. To specify the number of ports you have to add the value
999 # separated with a colon. Connecting devices to the external hub ports is only
1000 # available in the runtime configuration.
1001 #
1002 # The device 'printer' emulates the HP Deskjet 920C printer. The PCL data is
1003 # sent to a file specified in bochsrc.txt. The current code appends the PCL
1004 # code to the file if the file already existed. It would probably be nice to
1005 # overwrite the file instead, asking user first.
1006 #=======================================================================
1007 #usb_uhci: enabled=1
1008 #usb_uhci: enabled=1, port1=mouse, port2=disk:usbstick.img
1009 #usb_uhci: enabled=1, port1=hub:7, port2=disk:growing:usbdisk.img
1010 #usb_uhci: enabled=1, port2=disk:undoable:usbdisk.img, options1=journal:redo.log
1011 #usb_uhci: enabled=1, port1=printer:printdata.bin, port2=cdrom:image.iso
1012
1013 #=======================================================================
1014 # USB_OHCI:
1015 # This option controls the presence of the USB OHCI host controller with a
1016 # 2-port hub. The portX option accepts the same device types with the same
1017 # syntax as the UHCI controller (see above). The OHCI HC must be assigned to
1018 # a PCI slot and loaded with 'plugin_ctrl'.
1019 #=======================================================================
1020 #usb_ohci: enabled=1
1021 #usb_ohci: enabled=1, port1=printer:usbprinter.bin
1022
1023 #=======================================================================
1024 # USB_XHCI:
1025 # This option controls the presence of the experimental USB xHCI host controller
1026 # with a 4-port hub. The portX option accepts the same device types with the
1027 # same syntax as the UHCI controller (see above). The xHCI HC must be assigned
1028 # to a PCI slot and loaded with 'plugin_ctrl'.
1029 #=======================================================================
1030 #usb_xhci: enabled=1
1031
1032 #=======================================================================
1033 # CMOSIMAGE:
1034 # This defines image file that can be loaded into the CMOS RAM at startup.
1035 # The rtc_init parameter controls whether initialize the RTC with values stored
1036 # in the image. By default the time0 argument given to the clock option is used.
1037 # With 'rtc_init=image' the image is the source for the initial time.
1038 #
1039 # Example:
1040 #   cmosimage: file=cmos.img, rtc_init=image
1041 #=======================================================================
1042 #cmosimage: file=cmos.img, rtc_init=time0
1043
1044 #=======================================================================
1045 # MAGIC_BREAK:
1046 # This enables the "magic breakpoint" feature when using the debugger.
1047 # The useless cpu instruction XCHG BX, BX causes Bochs to enter the
1048 # debugger mode. This might be useful for software development.
1049 #
1050 # Example:
1051 #   magic_break: enabled=1
1052 #=======================================================================
1053 #magic_break: enabled=1
1054 magic_break: enabled=1
1055
1056 #=======================================================================
1057 # PORT_E9_HACK:
1058 # The 0xE9 port doesn't exists in normal ISA architecture. However, we
1059 # define a convention here, to display on the console of the system running
1060 # Bochs anything that is written to it. The idea is to provide debug output
1061 # very early when writing BIOS or OS code for example, without having to
1062 # bother with setting up a serial port or etc. Reading from port 0xE9 will
1063 # will return 0xe9 to let you know if the feature is available.
1064 # Leave this 0 unless you have a reason to use it.
1065 #
1066 # Example:
1067 #   port_e9_hack: enabled=1
1068 #=======================================================================
1069 port_e9_hack: enabled=1
1070
1071 #=======================================================================
1072 # DEBUG_SYMBOLS:
1073 # This loads symbols from the specified file for use in Bochs' internal
1074 # debugger. Symbols are loaded into global context. This is equivalent to
1075 # issuing ldsym debugger command at start up.
1076 #
1077 # Example:
1078 #   debug_symbols: file="kernel.sym"
1079 #   debug_symbols: file="kernel.sym", offset=0x80000000
1080 #=======================================================================
1081 #debug_symbols: file="kernel.sym"
1082
1083 #=======================================================================
1084 # other stuff
1085 #=======================================================================
1086 #load32bitOSImage: os=nullkernel, path=../kernel.img, iolog=../vga_io.log
1087 #load32bitOSImage: os=linux, path=../linux.img, iolog=../vga_io.log, initrd=../initrd.img
1088 #print_timestamps: enabled=1
1089
1090 #-------------------------
1091 # PCI host device mapping
1092 #-------------------------
1093 #pcidev: vendor=0x1234, device=0x5678
1094
1095 #=======================================================================
1096 # GDBSTUB:
1097 # Enable GDB stub. See user documentation for details.
1098 # Default value is enabled=0.
1099 #=======================================================================
1100 #gdbstub: enabled=0, port=1234, text_base=0, data_base=0, bss_base=0
1101
1102 #=======================================================================
1103 # USER_PLUGIN:
1104 # Load user-defined plugin. This option is available only if Bochs is
1105 # compiled with plugin support. Maximum 8 different plugins are supported.
1106 # See the example in the Bochs sources how to write a plugin device.
1107 #=======================================================================
1108 #user_plugin: name=testdev
1109
1110 #=======================================================================
1111 # for Macintosh, use the style of pathnames in the following
1112 # examples.
1113 #
1114 # vgaromimage: :bios:VGABIOS-elpin-2.40
1115 # romimage: file=:bios:BIOS-bochs-latest, address=0xf0000
1116 # floppya: 1_44=[fd:], status=inserted
1117 #=======================================================================
1118
1119 #=======================================================================
1120 # MEGS
1121 # Set the number of Megabytes of physical memory you want to emulate.
1122 # The default is 32MB, most OS's won't need more than that.
1123 # The maximum amount of memory supported is 2048Mb.
1124 # The 'MEGS' option is deprecated. Use 'MEMORY' option instead.
1125 #=======================================================================
1126 #megs: 256
1127 #megs: 128
1128 #megs: 64
1129 #megs: 32
1130 #megs: 16
1131 #megs: 8