CPU Core used in emulation.

If you experience compatibility problems, attempt to use the normal core.

Floating Point Unit (FPU). Also referred to as the x87, or Math Co-Processor.

Enforce checks for segment limits on 80286 and higher CPU types.

Emulate double fault exception

For Pentium III emulation, this sets the 96-bit Processor Serial Number returned by CPUID.

If not set, then emulation will act as if the PSN has been disabled by the BIOS. Enter as 4 sets of 16-bit hexadecimal digits XXXX-XXXX-XXXX-XXXX.

Reset CPU on triple fault condition (failure to handle double fault)

Always report (to the log file) double faults if set. Else, a double fault is reported only once. Set this option for debugging purposes.

Always report (to the log file) triple faults if set. Else, a triple fault is reported only once. Set this option for debugging purposes.

Controls whether the processor will allow the guest to exit protected mode, back to real mode, using the 286 LMSW instruction (clear the PE bit).

If set, the FDIV (Floating point division) bug will be reported when using the cputype=pentium setting.

Allow RDMSR/WRMSR (Read and Write of model-specific register) instructions. This option is only meaningful when cputype=pentium (or later CPU models).

Enable Pentium CMPXCHG8B (compare and exchange 8 bytes) instruction. This option is only meaningful when cputype=auto or cputype=pentium (or later CPU models).

Enable this explicitly if using software that uses this instruction.

Allow SYSENTER/SYSEXIT (Fast call to enter/exit to privilege level 0) instructions. This option is only meaningful when cputype=pentium_ii (or later CPU models).

Ignore RDMSR/WRMSR (Read and Write of model-specific register) on undefined registers. Normally the CPU will fire an Invalid Opcode exception in that case.

This option is off by default, enable if using software or drivers that assumes the presence of certain MSR registers without checking.

If you are using certain versions of the 3dfx Glide drivers for MS-DOS you will need to set this to TRUE as 3dfx appears to have coded GLIDE2X.OVL to assume the presence of Pentium Pro/Pentium II MTRR registers. Of course a better fix is to set cputype=ppro_slow, cputype=pentium_ii or cputype=pentium_iii which will prevent this issue.

If non-zero, REP string instructions (LODS/MOVS/STOS/INS/OUTS) are interruptible (by interrupts or other events).

If zero, REP string instructions are carried out in full before processing events and interrupts. Set to -1 for a reasonable default setting of "4".

A setting of 0 can improve emulation speed at the expense of emulation accuracy.

A non-zero setting (1-8) may be needed for DOS games and demos that use the IRQ 0 interrupt to play digitized samples while doing VGA palette animation at the same time (use case of REP OUTS), where the non-interruptible version would cause an audible drop in audio pitch.

The dynamic core cache block size (the default value is 32). Please change this value carefully.

According to forum discussions, setting this to 1 can aid debugging, however doing so also causes problems with 32-bit protected mode DOS games and reduces the performance of the dynamic core.

CPU Type used in emulation.

Number of instructions DOSBox-X tries to emulate each millisecond.

Examples:

Some rough guidance on how cycles relates to various legacy CPUs. Note that it depends on which emulated CPU instructions the program uses as DOSBox-X is not cycle accurate.

Amount of cycles to increase with the mapped keyboard shortcut. Setting the value lower than 100, and it will be interpreted as a percentage.

The default value of 10 will be interpreted as 10%.

Amount of cycles to decrease with the mapped keyboard shortcut. Setting the value lower than 100, and it will be interpreted as a percentage.

The default value of 20 will be interpreted as 20%.

The percentage adjustment for use with the "Emulate CPU speed" feature.

Default is 0 (no adjustment), but you can adjust it (between -25% and 25%) if necessary.

Enables Turbo (Fast Forward) mode to speed up operations.

By default, any key press will disengage turbo mode. This can be controlled with the turbo stop on key setting.

If a positive integer is specified, the Turbo function will last for the specific amount of seconds.

This is useful when starting a program that takes a long time to load.

If set, the Turbo mode will be automatically stopped if keyboard input is detected.

Allow dynamic cores (dynamic_x86 and dynamic_rec) to be used with 386 paging enabled.

When debugging, do not report illegal opcode 0x63.

Enable this option to ignore spurious errors while debugging from within Windows 3.1/9x/ME.

Emulate Advanced Power Management (APM) BIOS calls.

This for instance allows a guest OS such as Windows 9x to turn off DOSBox-X on shutdown.

If emulating ISA PnP BIOS, announce APM BIOS in PnP enumeration.

What version of the APM BIOS specification to emulate.

You will need at least APM BIOS v1.1 for emulation to work with Windows 95/98/ME.

Allow guest OS to connect from real mode

Allow guest OS to connect from 16-bit protected mode

Allow guest OS to connect from 32-bit protected mode

If you want power management in Windows 95/98/ME (beyond using the APM to shut down the computer) you MUST enable this option.

Windows 95/98/ME does not support the 16-bit real and protected mode APM BIOS entry points. Please note at this time that 32-bit APM is unstable under Windows ME.

Enable DOSBox-X integration I/O device. This could be used in the future by the guest OS to match mouse pointer position, for example.

EXPERIMENTAL! Do not enable unless you’re a developer wanting to work on this functionality.

List DOSBox-X integration I/O device as part of ISA PnP enumeration. This has no purpose yet.

Emulate ISA Plug & Play BIOS.

Enable if using DOSBox-X to run a PnP aware DOS program or if booting Windows 9x. Do not disable if Windows 9x is configured around PnP devices, you will likely confuse it.

Allow the B (big) bit in real mode. If set, allow the DOS program to set the B bit, then jump back to realmode with B still set (aka Huge Unreal mode).

Needed for the Project Angel demo.

Weitek in the 80’s made Math co-processors compatible with the FPU socket found on x86 systemboards. But note that these Weitek FPUs are not software compatible with Intel and AMD FPU units, and can only be used by applications that specifically support it. DOSBox-X supports emulation of Weitek FPUs, but only in combination with 386 and 486 cpu types.

To enable Weitek FPU emulation, set the following options in your config file:

Q: The 8088 is what IBM used in the original IBM PC’s. So why is there no 8088 option?

A: Because there is no difference in terms of emulation between an 8086 and 8088.

Intel released the 8086 first as a 16-bit CPU, and later released the 8088 to reduce cost for manufacturers.

The difference is that the 8086 uses both 16-bit internal and external to the CPU, while the 8088 is 16-bit internal but only 8-bit external to reduce cost. The only practical difference, in regard to emulation, is that a 8088 is a little slower because of this, but that can be compensated for using the cycles= setting.

Q: The 80186 was never used for the IBM PC, so why include it?

A: Indeed, the 80186 was mainly meant for embedded use. The 80186 was never used by IBM, but there were a few rare PC clones that used it. Although they typically had various compatibility problems.

Since various DOS tools support the detection of the 80186, DOSBox-X supports its emulation.

Q: Does DOSBox-X emulate the CPU cycles accurately?

A: No. This would just slow down the emulation, and is practical never needed for running PC programs and games.

On a legacy PC the amount of CPU cycles it takes to complete an instruction can vary depending on the type of instruction and the CPU generation and CPU vendor. DOSBox and by extension DOSBox-X instead completes one instruction per emulated-cycle. As such the cycles= value has no direct relation to the clock frequency or the amount of flops of the emulated system.

For many legacy systems, cycle accurate emulation is desirable. But this does not apply to emulating PCs. Due to the vast amount of clone systems and CPU options produced, software developers could not rely on the amount of time it takes to complete a given instruction. Software developers therefore used other timing methods, and therefore cycle accurate emulation is simply not needed.

If for some reason cycle accurate emulation is required, we suggest you use the PCem or 86Box emulator.