You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

bochsrc 58KB

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