diff --git a/contrib/linux/com.dosbox_x.DOSBox-X.metainfo.xml.in b/contrib/linux/com.dosbox_x.DOSBox-X.metainfo.xml.in
index 54dd13fb123..c04360b10fd 100644
--- a/contrib/linux/com.dosbox_x.DOSBox-X.metainfo.xml.in
+++ b/contrib/linux/com.dosbox_x.DOSBox-X.metainfo.xml.in
@@ -10,7 +10,7 @@
Emulation
-
+
diff --git a/contrib/windows/installer/dosbox-x.reference.setup.conf b/contrib/windows/installer/dosbox-x.reference.setup.conf
index e024a8cc4e6..d872ea7ead4 100644
--- a/contrib/windows/installer/dosbox-x.reference.setup.conf
+++ b/contrib/windows/installer/dosbox-x.reference.setup.conf
@@ -941,9 +941,11 @@ j3100colorscroll = false
#DOSBOX-X-ADV:# ignore odd-even mode in non-cga modes: Some demoscene productions use VGA Mode X but accidentally enable odd/even mode.
#DOSBOX-X-ADV:# Setting this option can correct for that and render the demo properly.
#DOSBOX-X-ADV:# This option forces VGA emulation to ignore odd/even mode except in text and CGA modes.
+#DOSBOX-X-ADV:# ignore sequencer blanking: If set, ignore attempts to blank the display using the EGA/VGA sequencer registers.
+#DOSBOX-X-ADV:# This should not be set except for DOS games with bugs in their display handling code.
#DOSBOX-X-ADV-SEE:#
#DOSBOX-X-ADV-SEE:# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
-#DOSBOX-X-ADV-SEE:# -> vmemdelay; vbe window granularity; vbe window size; enable 8-bit dac; svga lfb base; pci vga; vga attribute controller mapping; vga bios use rom image; vga bios rom image; vga bios size override; video bios dont duplicate cga first half rom font; video bios always offer 14-pixel high rom font; video bios always offer 16-pixel high rom font; video bios enable cga second half rom font; forcerate; sierra ramdac; sierra ramdac lock 565; vga fill active memory; page flip debug line; vertical retrace poll debug line; cgasnow; vga 3da undefined bits; rom bios 8x8 CGA font; rom bios video parameter table; int 10h points at vga bios; unmask timer on int 10 setmode; vesa bank switching window mirroring; vesa bank switching window range check; vesa zero buffer on get information; vesa set display vsync; vesa lfb base scanline adjust; vesa map non-lfb modes to 128kb region; ega per scanline hpel; allow hpel effects; allow hretrace effects; hretrace effect weight; vesa modelist cap; vesa modelist width limit; vesa modelist height limit; vesa vbe put modelist in vesa information; vesa vbe 1.2 modes are 32bpp; allow low resolution vesa modes; allow explicit 24bpp vesa modes; allow high definition vesa modes; allow unusual vesa modes; allow 32bpp vesa modes; allow 24bpp vesa modes; allow 16bpp vesa modes; allow 15bpp vesa modes; allow 8bpp vesa modes; allow 4bpp vesa modes; allow 4bpp packed vesa modes; allow tty vesa modes; double-buffered line compare; ignore vblank wraparound; ignore extended memory bit; enable vga resize delay; resize only on vga active display width increase; vga palette update on full load; ignore odd-even mode in non-cga modes
+#DOSBOX-X-ADV-SEE:# -> vmemdelay; vbe window granularity; vbe window size; enable 8-bit dac; svga lfb base; pci vga; vga attribute controller mapping; vga bios use rom image; vga bios rom image; vga bios size override; video bios dont duplicate cga first half rom font; video bios always offer 14-pixel high rom font; video bios always offer 16-pixel high rom font; video bios enable cga second half rom font; forcerate; sierra ramdac; sierra ramdac lock 565; vga fill active memory; page flip debug line; vertical retrace poll debug line; cgasnow; vga 3da undefined bits; rom bios 8x8 CGA font; rom bios video parameter table; int 10h points at vga bios; unmask timer on int 10 setmode; vesa bank switching window mirroring; vesa bank switching window range check; vesa zero buffer on get information; vesa set display vsync; vesa lfb base scanline adjust; vesa map non-lfb modes to 128kb region; ega per scanline hpel; allow hpel effects; allow hretrace effects; hretrace effect weight; vesa modelist cap; vesa modelist width limit; vesa modelist height limit; vesa vbe put modelist in vesa information; vesa vbe 1.2 modes are 32bpp; allow low resolution vesa modes; allow explicit 24bpp vesa modes; allow high definition vesa modes; allow unusual vesa modes; allow 32bpp vesa modes; allow 24bpp vesa modes; allow 16bpp vesa modes; allow 15bpp vesa modes; allow 8bpp vesa modes; allow 4bpp vesa modes; allow 4bpp packed vesa modes; allow tty vesa modes; double-buffered line compare; ignore vblank wraparound; ignore extended memory bit; enable vga resize delay; resize only on vga active display width increase; vga palette update on full load; ignore odd-even mode in non-cga modes; ignore sequencer blanking
#DOSBOX-X-ADV-SEE:#
#DOSBOX-X-ADV:vmemdelay = 0
vmemsize = -1
@@ -1008,6 +1010,7 @@ high intensity blinking = true
#DOSBOX-X-ADV:resize only on vga active display width increase = false
#DOSBOX-X-ADV:vga palette update on full load = true
#DOSBOX-X-ADV:ignore odd-even mode in non-cga modes = false
+#DOSBOX-X-ADV:ignore sequencer blanking = false
[vsync]
# vsyncmode: Synchronize vsync timing to the host display. Requires calibration within DOSBox-X.
@@ -1018,140 +1021,150 @@ vsyncmode = off
vsyncrate = 75
[cpu]
-# core: CPU Core used in emulation. auto will switch to dynamic if available and appropriate.
-# For the dynamic core, both dynamic_x86 and dynamic_rec are supported (dynamic_x86 is preferred).
-# Windows 95 or other preemptive multitasking OSes will not work with the dynamic_rec core.
-# Possible values: auto, dynamic, dynamic_x86, dynamic_nodhfpu, dynamic, dynamic_rec, normal, full, simple.
-# fpu: Enable FPU emulation
-# Possible values: true, false, 1, 0, auto, 8087, 287, 387.
-#DOSBOX-X-ADV:# processor serial number: For Pentium III emulation, this sets the 96-bit Processor Serial Number returned by CPUID.
-#DOSBOX-X-ADV:# If not set, then emulation will act as if the PSN has been disabled by the BIOS.
-#DOSBOX-X-ADV:# Enter as 4 sets of 16-bit hexadecimal digits XXXX-XXXX-XXXX-XXXX.
-#DOSBOX-X-ADV:# Note that the processor info and feature bits form the topmost 32 bits of the PSN and cannot be changed.
-# segment limits: Enforce checks for segment limits on 80286 and higher CPU types.
-#DOSBOX-X-ADV:# double fault: Emulate double fault exception
-#DOSBOX-X-ADV:# reset on triple fault: Reset CPU on triple fault condition (failure to handle double fault)
-#DOSBOX-X-ADV:# always report double fault: Always report (to log file) double faults if set. Else, a double fault is reported only once. Set this option for debugging purposes.
-#DOSBOX-X-ADV:# always report triple fault: Always report (to log file) triple faults if set. Else, a triple fault is reported only once. Set this option for debugging purposes.
-#DOSBOX-X-ADV:# allow lmsw to exit protected mode: Controls whether the processor will allow the guest to exit protected mode using the 286 LMSW instruction (clear the PE bit)
-#DOSBOX-X-ADV:# Possible values: true, false, 1, 0, auto.
-#DOSBOX-X-ADV:# report fdiv bug: If set, the FDIV bug will be reported with the cputype=pentium setting.
-#DOSBOX-X-ADV:# enable msr: Allow RDMSR/WRMSR instructions. This option is only meaningful when cputype=pentium.
-#DOSBOX-X-ADV:# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
-#DOSBOX-X-ADV:# enable cmpxchg8b: Enable Pentium CMPXCHG8B instruction. Enable this explicitly if using software that uses this instruction.
-#DOSBOX-X-ADV:# You must enable this option to run Windows ME because portions of the kernel rely on this instruction.
-#DOSBOX-X-ADV:# enable syscall: Allow SYSENTER/SYSEXIT instructions. This option is only meaningful when cputype=pentium_ii.
-#DOSBOX-X-ADV:#
-#DOSBOX-X-ADV:# ignore undefined msr: Ignore RDMSR/WRMSR on undefined registers. Normally the CPU will fire an Invalid Opcode exception in that case.
-#DOSBOX-X-ADV:# This option is off by default, enable if using software or drivers that assumes the presence of
-#DOSBOX-X-ADV:# certain MSR registers without checking. If you are using certain versions of the 3dfx Glide drivers for MS-DOS
-#DOSBOX-X-ADV:# you will need to set this to TRUE as 3dfx appears to have coded GLIDE2X.OVL to assume the presence
-#DOSBOX-X-ADV:# of Pentium Pro/Pentium II MTRR registers.
-#DOSBOX-X-ADV:# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
-#DOSBOX-X-ADV:# interruptible rep string op: If nonzero, REP string instructions (LODS/MOVS/STOS/INS/OUTS) are interruptible (by interrupts or other events).
-#DOSBOX-X-ADV:# If zero, REP string instructions are carried out in full before processing events and interrupts.
-#DOSBOX-X-ADV:# Set to -1 for a reasonable default setting based on cpu type and other configuration.
-#DOSBOX-X-ADV:# A setting of 0 can improve emulation speed at the expense of emulation accuracy.
-#DOSBOX-X-ADV:# A nonzero setting (1-8) may be needed for DOS games and demos that use the IRQ 0 interrupt to play digitized samples
-#DOSBOX-X-ADV:# while doing VGA palette animation at the same time (use case of REP OUTS), where the non-interruptible version
-#DOSBOX-X-ADV:# would cause an audible drop in audio pitch.
-#DOSBOX-X-ADV:# dynamic core cache block size: The dynamic core cache block size (the default value is 32). Please change this value carefully.
-#DOSBOX-X-ADV:# According to forum discussions, setting this to 1 can aid debugging, however doing so also causes
-#DOSBOX-X-ADV:# problems with 32-bit protected mode DOS games and reduces the performance of the dynamic core.
-#DOSBOX-X-ADV:#
-# cputype: CPU Type used in emulation. "auto" emulates a 486 which tolerates Pentium instructions.
-# "experimental" enables newer instructions not normally found in the CPU types emulated by DOSBox-X, such as FISTTP.
-# Possible values: auto, 8086, 8086_prefetch, 80186, 80186_prefetch, 286, 286_prefetch, 386, 386_prefetch, 486old, 486old_prefetch, 486, 486_prefetch, pentium, pentium_mmx, ppro_slow, pentium_ii, pentium_iii, experimental.
-# cycles: Number of instructions DOSBox-X tries to emulate each millisecond.
-# Setting this value too high results in sound dropouts and lags.
-# Cycles can be set in 3 ways:
-# 'auto' tries to guess what a game needs.
-# It usually works, but can fail for certain games.
-# 'fixed #number' will set a fixed number of cycles. This is what you usually
-# need if 'auto' fails (Example: fixed 4000).
-# 'max' will allocate as much cycles as your computer is able to
-# handle. Recommended if better performance is desired.
-# Possible values: auto, fixed, max.
-# cycleup: Amount of cycles to decrease/increase with the mapped keyboard shortcut.
-# cycledown: Setting it lower than 100 will be a percentage.
-#DOSBOX-X-ADV:# cycle emulation percentage adjust: 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.
-# turbo: Enables Turbo (Fast Forward) mode to speed up operations.
-#DOSBOX-X-ADV:# stop turbo on key: If set, the Turbo mode will be automatically stopped if a keyboard input is detected.
-#DOSBOX-X-ADV:# stop turbo after second: If a positive integer is specified, the Turbo function will last for specific seconds.
-#DOSBOX-X-ADV:# use dynamic core with paging on: Allow dynamic cores (dynamic_x86 and dynamic_rec) to be used with 386 paging enabled.
-#DOSBOX-X-ADV:# If the dynamic_x86 core is set, this allows Windows 9x/ME to run properly, but may somewhat decrease the performance.
-#DOSBOX-X-ADV:# If the dynamic_rec core is set, this disables the dynamic core if the 386 paging functions are currently enabled.
-#DOSBOX-X-ADV:# If set to auto, this option will be enabled depending on if the 386 paging and a guest system are currently active.
-#DOSBOX-X-ADV:# Possible values: true, false, 1, 0, auto.
-#DOSBOX-X-ADV:# ignore opcode 63: When debugging, do not report illegal opcode 0x63.
-#DOSBOX-X-ADV:# Enable this option to ignore spurious errors while debugging from within Windows 3.1/9x/ME.
-# apmbios: Emulate Advanced Power Management (APM) BIOS calls.
-#DOSBOX-X-ADV:# apmbios pnp: If emulating ISA PnP BIOS, announce APM BIOS in PnP enumeration.
-#DOSBOX-X-ADV:# Warning: this can cause Windows 95 OSR2 and later to enumerate the APM BIOS twice and cause problems.
-#DOSBOX-X-ADV:# apm power button event: When the power button event is triggered from the mapper or the menu, and the guest is using the APM BIOS, which APM BIOS event to send
-#DOSBOX-X-ADV:# Possible values: suspend, standby.
-#DOSBOX-X-ADV:# apmbios version: What version of the APM BIOS specification to emulate.
-#DOSBOX-X-ADV:# You will need at least APM BIOS v1.1 for emulation to work with Windows 95/98/ME.
-#DOSBOX-X-ADV:# Possible values: auto, 1.0, 1.1, 1.2.
-#DOSBOX-X-ADV:# apmbios allow realmode: Allow guest OS to connect from real mode.
-#DOSBOX-X-ADV:# apmbios allow 16-bit protected mode: Allow guest OS to connect from 16-bit protected mode.
-#DOSBOX-X-ADV:# apmbios allow 32-bit protected mode: Allow guest OS to connect from 32-bit protected mode.
-#DOSBOX-X-ADV:# If you want power management in Windows 95/98/ME (beyond using the APM to shutdown the computer) you MUST enable this option.
-#DOSBOX-X-ADV:# Windows 95/98/ME does not support the 16-bit real and protected mode APM BIOS entry points.
-#DOSBOX-X-ADV:# Please note at this time that 32-bit APM is unstable under Windows ME.
-# integration device: Enable DOSBox-X's integration I/O device, a way for additional software to talk to DOSBox-X. It is currently experimental.
-# This can for example be used to return DOSBox-X's current status and by the guest OS to match the mouse pointer position.
-#DOSBOX-X-ADV:# integration device pnp: List DOSBox-X integration I/O device as part of ISA PnP enumeration. This has no purpose yet.
-# isapnpbios: 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.
-#DOSBOX-X-ADV:# isapnpport: Emulate ISA Plug & Play I/O ports, which are separate from the PnP BIOS.
-#DOSBOX-X-ADV:# ISA Plug & Play devices provide these I/O ports as the means to determine hardware and configure resources.
-#DOSBOX-X-ADV:# By default, this setting is 'auto' which enables the PnP I/O ports only if you enable the PnP BIOS.
-#DOSBOX-X-ADV:# Possible values: true, false, 1, 0, auto.
-#DOSBOX-X-ADV:# realbig16: Allow the B (big) bit in real mode. If set, allow the DOS program to set the B bit,
-#DOSBOX-X-ADV:# then jump to realmode with B still set (aka Huge Unreal mode). Needed for Project Angel.
+# core: CPU Core used in emulation. auto will switch to dynamic if available and appropriate.
+# For the dynamic core, both dynamic_x86 and dynamic_rec are supported (dynamic_x86 is preferred).
+# Windows 95 or other preemptive multitasking OSes will not work with the dynamic_rec core.
+# Possible values: auto, dynamic, dynamic_x86, dynamic_nodhfpu, dynamic, dynamic_rec, normal, full, simple.
+# fpu: Enable FPU emulation
+# Possible values: true, false, 1, 0, auto, 8087, 287, 387.
+#DOSBOX-X-ADV:# processor serial number: For Pentium III emulation, this sets the 96-bit Processor Serial Number returned by CPUID.
+#DOSBOX-X-ADV:# If not set, then emulation will act as if the PSN has been disabled by the BIOS.
+#DOSBOX-X-ADV:# Enter as 4 sets of 16-bit hexadecimal digits XXXX-XXXX-XXXX-XXXX.
+#DOSBOX-X-ADV:# Note that the processor info and feature bits form the topmost 32 bits of the PSN and cannot be changed.
+# segment limits: Enforce checks for segment limits on 80286 and higher CPU types.
+#DOSBOX-X-ADV:# double fault: Emulate double fault exception
+#DOSBOX-X-ADV:# clear trap flag on unhandled int 1: If set, the DOS kernel INT 01h handler will clear the trap flag when called.
+#DOSBOX-X-ADV:# Normally a DOS program using INT 01h and the trap flag (usually for debugging)
+#DOSBOX-X-ADV:# will provide it's own INT 01h handler. Some programs need this option set in
+#DOSBOX-X-ADV:# order to not crash during startup due to possible bugs or anti debugger tricks
+#DOSBOX-X-ADV:# that went terribly wrong.
+#DOSBOX-X-ADV:# reset on triple fault: Reset CPU on triple fault condition (failure to handle double fault)
+#DOSBOX-X-ADV:# always report double fault: Always report (to log file) double faults if set. Else, a double fault is reported only once. Set this option for debugging purposes.
+#DOSBOX-X-ADV:# always report triple fault: Always report (to log file) triple faults if set. Else, a triple fault is reported only once. Set this option for debugging purposes.
+#DOSBOX-X-ADV:# mask stack pointer for enter leave instructions: If set, ENTER will mask the stack pointer by 64KB if the stack segment is 16-bit, even if used in a 32-bit form.
+#DOSBOX-X-ADV:# This is not how real Intel processors work, and is intended as a bug fix for certain games
+#DOSBOX-X-ADV:# Possible values: true, false, 1, 0, auto.
+#DOSBOX-X-ADV:# allow lmsw to exit protected mode: Controls whether the processor will allow the guest to exit protected mode using the 286 LMSW instruction (clear the PE bit)
+#DOSBOX-X-ADV:# Possible values: true, false, 1, 0, auto.
+#DOSBOX-X-ADV:# report fdiv bug: If set, the FDIV bug will be reported with the cputype=pentium setting.
+#DOSBOX-X-ADV:# enable msr: Allow RDMSR/WRMSR instructions. This option is only meaningful when cputype=pentium.
+#DOSBOX-X-ADV:# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
+#DOSBOX-X-ADV:# enable cmpxchg8b: Enable Pentium CMPXCHG8B instruction. Enable this explicitly if using software that uses this instruction.
+#DOSBOX-X-ADV:# You must enable this option to run Windows ME because portions of the kernel rely on this instruction.
+#DOSBOX-X-ADV:# enable syscall: Allow SYSENTER/SYSEXIT instructions. This option is only meaningful when cputype=pentium_ii.
+#DOSBOX-X-ADV:#
+#DOSBOX-X-ADV:# ignore undefined msr: Ignore RDMSR/WRMSR on undefined registers. Normally the CPU will fire an Invalid Opcode exception in that case.
+#DOSBOX-X-ADV:# This option is off by default, enable if using software or drivers that assumes the presence of
+#DOSBOX-X-ADV:# certain MSR registers without checking. If you are using certain versions of the 3dfx Glide drivers for MS-DOS
+#DOSBOX-X-ADV:# you will need to set this to TRUE as 3dfx appears to have coded GLIDE2X.OVL to assume the presence
+#DOSBOX-X-ADV:# of Pentium Pro/Pentium II MTRR registers.
+#DOSBOX-X-ADV:# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
+#DOSBOX-X-ADV:# interruptible rep string op: If nonzero, REP string instructions (LODS/MOVS/STOS/INS/OUTS) are interruptible (by interrupts or other events).
+#DOSBOX-X-ADV:# If zero, REP string instructions are carried out in full before processing events and interrupts.
+#DOSBOX-X-ADV:# Set to -1 for a reasonable default setting based on cpu type and other configuration.
+#DOSBOX-X-ADV:# A setting of 0 can improve emulation speed at the expense of emulation accuracy.
+#DOSBOX-X-ADV:# A nonzero setting (1-8) may be needed for DOS games and demos that use the IRQ 0 interrupt to play digitized samples
+#DOSBOX-X-ADV:# while doing VGA palette animation at the same time (use case of REP OUTS), where the non-interruptible version
+#DOSBOX-X-ADV:# would cause an audible drop in audio pitch.
+#DOSBOX-X-ADV:# dynamic core cache block size: The dynamic core cache block size (the default value is 32). Please change this value carefully.
+#DOSBOX-X-ADV:# According to forum discussions, setting this to 1 can aid debugging, however doing so also causes
+#DOSBOX-X-ADV:# problems with 32-bit protected mode DOS games and reduces the performance of the dynamic core.
+#DOSBOX-X-ADV:#
+# cputype: CPU Type used in emulation. "auto" emulates a 486 which tolerates Pentium instructions.
+# "experimental" enables newer instructions not normally found in the CPU types emulated by DOSBox-X, such as FISTTP.
+# Possible values: auto, 8086, 8086_prefetch, 80186, 80186_prefetch, 286, 286_prefetch, 386, 386_prefetch, 486old, 486old_prefetch, 486, 486_prefetch, pentium, pentium_mmx, ppro_slow, pentium_ii, pentium_iii, experimental.
+# cycles: Number of instructions DOSBox-X tries to emulate each millisecond.
+# Setting this value too high results in sound dropouts and lags.
+# Cycles can be set in 3 ways:
+# 'auto' tries to guess what a game needs.
+# It usually works, but can fail for certain games.
+# 'fixed #number' will set a fixed number of cycles. This is what you usually
+# need if 'auto' fails (Example: fixed 4000).
+# 'max' will allocate as much cycles as your computer is able to
+# handle. Recommended if better performance is desired.
+# Possible values: auto, fixed, max.
+# cycleup: Amount of cycles to decrease/increase with the mapped keyboard shortcut.
+# cycledown: Setting it lower than 100 will be a percentage.
+#DOSBOX-X-ADV:# cycle emulation percentage adjust: 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.
+# turbo: Enables Turbo (Fast Forward) mode to speed up operations.
+#DOSBOX-X-ADV:# stop turbo on key: If set, the Turbo mode will be automatically stopped if a keyboard input is detected.
+#DOSBOX-X-ADV:# stop turbo after second: If a positive integer is specified, the Turbo function will last for specific seconds.
+#DOSBOX-X-ADV:# use dynamic core with paging on: Allow dynamic cores (dynamic_x86 and dynamic_rec) to be used with 386 paging enabled.
+#DOSBOX-X-ADV:# If the dynamic_x86 core is set, this allows Windows 9x/ME to run properly, but may somewhat decrease the performance.
+#DOSBOX-X-ADV:# If the dynamic_rec core is set, this disables the dynamic core if the 386 paging functions are currently enabled.
+#DOSBOX-X-ADV:# If set to auto, this option will be enabled depending on if the 386 paging and a guest system are currently active.
+#DOSBOX-X-ADV:# Possible values: true, false, 1, 0, auto.
+#DOSBOX-X-ADV:# ignore opcode 63: When debugging, do not report illegal opcode 0x63.
+#DOSBOX-X-ADV:# Enable this option to ignore spurious errors while debugging from within Windows 3.1/9x/ME.
+# apmbios: Emulate Advanced Power Management (APM) BIOS calls.
+#DOSBOX-X-ADV:# apmbios pnp: If emulating ISA PnP BIOS, announce APM BIOS in PnP enumeration.
+#DOSBOX-X-ADV:# Warning: this can cause Windows 95 OSR2 and later to enumerate the APM BIOS twice and cause problems.
+#DOSBOX-X-ADV:# apm power button event: When the power button event is triggered from the mapper or the menu, and the guest is using the APM BIOS, which APM BIOS event to send
+#DOSBOX-X-ADV:# Possible values: suspend, standby.
+#DOSBOX-X-ADV:# apmbios version: What version of the APM BIOS specification to emulate.
+#DOSBOX-X-ADV:# You will need at least APM BIOS v1.1 for emulation to work with Windows 95/98/ME.
+#DOSBOX-X-ADV:# Possible values: auto, 1.0, 1.1, 1.2.
+#DOSBOX-X-ADV:# apmbios allow realmode: Allow guest OS to connect from real mode.
+#DOSBOX-X-ADV:# apmbios allow 16-bit protected mode: Allow guest OS to connect from 16-bit protected mode.
+#DOSBOX-X-ADV:# apmbios allow 32-bit protected mode: Allow guest OS to connect from 32-bit protected mode.
+#DOSBOX-X-ADV:# If you want power management in Windows 95/98/ME (beyond using the APM to shutdown the computer) you MUST enable this option.
+#DOSBOX-X-ADV:# Windows 95/98/ME does not support the 16-bit real and protected mode APM BIOS entry points.
+#DOSBOX-X-ADV:# Please note at this time that 32-bit APM is unstable under Windows ME.
+# integration device: Enable DOSBox-X's integration I/O device, a way for additional software to talk to DOSBox-X. It is currently experimental.
+# This can for example be used to return DOSBox-X's current status and by the guest OS to match the mouse pointer position.
+#DOSBOX-X-ADV:# integration device pnp: List DOSBox-X integration I/O device as part of ISA PnP enumeration. This has no purpose yet.
+# isapnpbios: 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.
+#DOSBOX-X-ADV:# isapnpport: Emulate ISA Plug & Play I/O ports, which are separate from the PnP BIOS.
+#DOSBOX-X-ADV:# ISA Plug & Play devices provide these I/O ports as the means to determine hardware and configure resources.
+#DOSBOX-X-ADV:# By default, this setting is 'auto' which enables the PnP I/O ports only if you enable the PnP BIOS.
+#DOSBOX-X-ADV:# Possible values: true, false, 1, 0, auto.
+#DOSBOX-X-ADV:# realbig16: Allow the B (big) bit in real mode. If set, allow the DOS program to set the B bit,
+#DOSBOX-X-ADV:# then jump to realmode with B still set (aka Huge Unreal mode). Needed for Project Angel.
#DOSBOX-X-ADV-SEE:#
#DOSBOX-X-ADV-SEE:# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
-#DOSBOX-X-ADV-SEE:# -> processor serial number; double fault; reset on triple fault; always report double fault; always report triple fault; allow lmsw to exit protected mode; report fdiv bug; enable msr; enable cmpxchg8b; enable syscall; ignore undefined msr; interruptible rep string op; dynamic core cache block size; cycle emulation percentage adjust; stop turbo on key; stop turbo after second; use dynamic core with paging on; ignore opcode 63; apmbios pnp; apm power button event; apmbios version; apmbios allow realmode; apmbios allow 16-bit protected mode; apmbios allow 32-bit protected mode; integration device pnp; isapnpport; realbig16
+#DOSBOX-X-ADV-SEE:# -> processor serial number; double fault; clear trap flag on unhandled int 1; reset on triple fault; always report double fault; always report triple fault; mask stack pointer for enter leave instructions; allow lmsw to exit protected mode; report fdiv bug; enable msr; enable cmpxchg8b; enable syscall; ignore undefined msr; interruptible rep string op; dynamic core cache block size; cycle emulation percentage adjust; stop turbo on key; stop turbo after second; use dynamic core with paging on; ignore opcode 63; apmbios pnp; apm power button event; apmbios version; apmbios allow realmode; apmbios allow 16-bit protected mode; apmbios allow 32-bit protected mode; integration device pnp; isapnpport; realbig16
#DOSBOX-X-ADV-SEE:#
-core = auto
-fpu = true
-#DOSBOX-X-ADV:processor serial number =
-segment limits = true
-#DOSBOX-X-ADV:double fault = true
-#DOSBOX-X-ADV:reset on triple fault = true
-#DOSBOX-X-ADV:always report double fault = false
-#DOSBOX-X-ADV:always report triple fault = false
-#DOSBOX-X-ADV:allow lmsw to exit protected mode = auto
-#DOSBOX-X-ADV:report fdiv bug = false
-#DOSBOX-X-ADV:enable msr = true
-#DOSBOX-X-ADV:enable cmpxchg8b = true
-#DOSBOX-X-ADV:enable syscall = true
-#DOSBOX-X-ADV:ignore undefined msr = false
-#DOSBOX-X-ADV:interruptible rep string op = -1
-#DOSBOX-X-ADV:dynamic core cache block size = 32
-cputype = auto
-cycles = auto
-cycleup = 10
-cycledown = 20
-#DOSBOX-X-ADV:cycle emulation percentage adjust = 0
-turbo = false
-#DOSBOX-X-ADV:stop turbo on key = true
-#DOSBOX-X-ADV:stop turbo after second = 0
-#DOSBOX-X-ADV:use dynamic core with paging on = auto
-#DOSBOX-X-ADV:ignore opcode 63 = true
-apmbios = true
-#DOSBOX-X-ADV:apmbios pnp = false
-#DOSBOX-X-ADV:apm power button event = suspend
-#DOSBOX-X-ADV:apmbios version = auto
-#DOSBOX-X-ADV:apmbios allow realmode = true
-#DOSBOX-X-ADV:apmbios allow 16-bit protected mode = true
-#DOSBOX-X-ADV:apmbios allow 32-bit protected mode = true
-integration device = false
-#DOSBOX-X-ADV:integration device pnp = false
-isapnpbios = true
-#DOSBOX-X-ADV:isapnpport = auto
-#DOSBOX-X-ADV:realbig16 = false
+core = auto
+fpu = true
+#DOSBOX-X-ADV:processor serial number =
+segment limits = true
+#DOSBOX-X-ADV:double fault = true
+#DOSBOX-X-ADV:clear trap flag on unhandled int 1 = false
+#DOSBOX-X-ADV:reset on triple fault = true
+#DOSBOX-X-ADV:always report double fault = false
+#DOSBOX-X-ADV:always report triple fault = false
+#DOSBOX-X-ADV:mask stack pointer for enter leave instructions = auto
+#DOSBOX-X-ADV:allow lmsw to exit protected mode = auto
+#DOSBOX-X-ADV:report fdiv bug = false
+#DOSBOX-X-ADV:enable msr = true
+#DOSBOX-X-ADV:enable cmpxchg8b = true
+#DOSBOX-X-ADV:enable syscall = true
+#DOSBOX-X-ADV:ignore undefined msr = false
+#DOSBOX-X-ADV:interruptible rep string op = -1
+#DOSBOX-X-ADV:dynamic core cache block size = 32
+cputype = auto
+cycles = auto
+cycleup = 10
+cycledown = 20
+#DOSBOX-X-ADV:cycle emulation percentage adjust = 0
+turbo = false
+#DOSBOX-X-ADV:stop turbo on key = true
+#DOSBOX-X-ADV:stop turbo after second = 0
+#DOSBOX-X-ADV:use dynamic core with paging on = auto
+#DOSBOX-X-ADV:ignore opcode 63 = true
+apmbios = true
+#DOSBOX-X-ADV:apmbios pnp = false
+#DOSBOX-X-ADV:apm power button event = suspend
+#DOSBOX-X-ADV:apmbios version = auto
+#DOSBOX-X-ADV:apmbios allow realmode = true
+#DOSBOX-X-ADV:apmbios allow 16-bit protected mode = true
+#DOSBOX-X-ADV:apmbios allow 32-bit protected mode = true
+integration device = false
+#DOSBOX-X-ADV:integration device pnp = false
+isapnpbios = true
+#DOSBOX-X-ADV:isapnpport = auto
+#DOSBOX-X-ADV:realbig16 = false
[keyboard]
# aux: Enable emulation of the 8042 auxiliary port. PS/2 mouse emulation requires this to be enabled.
diff --git a/dosbox-x.reference.conf b/dosbox-x.reference.conf
index 5e1e1f4542a..38395868e3e 100644
--- a/dosbox-x.reference.conf
+++ b/dosbox-x.reference.conf
@@ -400,7 +400,7 @@ j3100colorscroll = false
# This option has no effect in PC-98 and some other video modes.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
-# -> vmemdelay; vbe window granularity; vbe window size; enable 8-bit dac; svga lfb base; pci vga; vga attribute controller mapping; vga bios use rom image; vga bios rom image; vga bios size override; video bios dont duplicate cga first half rom font; video bios always offer 14-pixel high rom font; video bios always offer 16-pixel high rom font; video bios enable cga second half rom font; forcerate; sierra ramdac; sierra ramdac lock 565; vga fill active memory; page flip debug line; vertical retrace poll debug line; cgasnow; vga 3da undefined bits; rom bios 8x8 CGA font; rom bios video parameter table; int 10h points at vga bios; unmask timer on int 10 setmode; vesa bank switching window mirroring; vesa bank switching window range check; vesa zero buffer on get information; vesa set display vsync; vesa lfb base scanline adjust; vesa map non-lfb modes to 128kb region; ega per scanline hpel; allow hpel effects; allow hretrace effects; hretrace effect weight; vesa modelist cap; vesa modelist width limit; vesa modelist height limit; vesa vbe put modelist in vesa information; vesa vbe 1.2 modes are 32bpp; allow low resolution vesa modes; allow explicit 24bpp vesa modes; allow high definition vesa modes; allow unusual vesa modes; allow 32bpp vesa modes; allow 24bpp vesa modes; allow 16bpp vesa modes; allow 15bpp vesa modes; allow 8bpp vesa modes; allow 4bpp vesa modes; allow 4bpp packed vesa modes; allow tty vesa modes; double-buffered line compare; ignore vblank wraparound; ignore extended memory bit; enable vga resize delay; resize only on vga active display width increase; vga palette update on full load; ignore odd-even mode in non-cga modes
+# -> vmemdelay; vbe window granularity; vbe window size; enable 8-bit dac; svga lfb base; pci vga; vga attribute controller mapping; vga bios use rom image; vga bios rom image; vga bios size override; video bios dont duplicate cga first half rom font; video bios always offer 14-pixel high rom font; video bios always offer 16-pixel high rom font; video bios enable cga second half rom font; forcerate; sierra ramdac; sierra ramdac lock 565; vga fill active memory; page flip debug line; vertical retrace poll debug line; cgasnow; vga 3da undefined bits; rom bios 8x8 CGA font; rom bios video parameter table; int 10h points at vga bios; unmask timer on int 10 setmode; vesa bank switching window mirroring; vesa bank switching window range check; vesa zero buffer on get information; vesa set display vsync; vesa lfb base scanline adjust; vesa map non-lfb modes to 128kb region; ega per scanline hpel; allow hpel effects; allow hretrace effects; hretrace effect weight; vesa modelist cap; vesa modelist width limit; vesa modelist height limit; vesa vbe put modelist in vesa information; vesa vbe 1.2 modes are 32bpp; allow low resolution vesa modes; allow explicit 24bpp vesa modes; allow high definition vesa modes; allow unusual vesa modes; allow 32bpp vesa modes; allow 24bpp vesa modes; allow 16bpp vesa modes; allow 15bpp vesa modes; allow 8bpp vesa modes; allow 4bpp vesa modes; allow 4bpp packed vesa modes; allow tty vesa modes; double-buffered line compare; ignore vblank wraparound; ignore extended memory bit; enable vga resize delay; resize only on vga active display width increase; vga palette update on full load; ignore odd-even mode in non-cga modes; ignore sequencer blanking
#
vmemsize = -1
vmemsizekb = 0
@@ -445,7 +445,7 @@ vsyncrate = 75
# Do not disable if Windows 9x is configured around PnP devices, you will likely confuse it.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
-# -> processor serial number; double fault; reset on triple fault; always report double fault; always report triple fault; allow lmsw to exit protected mode; report fdiv bug; enable msr; enable cmpxchg8b; enable syscall; ignore undefined msr; interruptible rep string op; dynamic core cache block size; cycle emulation percentage adjust; stop turbo on key; stop turbo after second; use dynamic core with paging on; ignore opcode 63; apmbios pnp; apm power button event; apmbios version; apmbios allow realmode; apmbios allow 16-bit protected mode; apmbios allow 32-bit protected mode; integration device pnp; isapnpport; realbig16
+# -> processor serial number; double fault; clear trap flag on unhandled int 1; reset on triple fault; always report double fault; always report triple fault; mask stack pointer for enter leave instructions; allow lmsw to exit protected mode; report fdiv bug; enable msr; enable cmpxchg8b; enable syscall; ignore undefined msr; interruptible rep string op; dynamic core cache block size; cycle emulation percentage adjust; stop turbo on key; stop turbo after second; use dynamic core with paging on; ignore opcode 63; apmbios pnp; apm power button event; apmbios version; apmbios allow realmode; apmbios allow 16-bit protected mode; apmbios allow 32-bit protected mode; integration device pnp; isapnpport; realbig16
#
core = auto
fpu = true
diff --git a/dosbox-x.reference.full.conf b/dosbox-x.reference.full.conf
index ba9ba640196..4ebda517376 100644
--- a/dosbox-x.reference.full.conf
+++ b/dosbox-x.reference.full.conf
@@ -917,6 +917,8 @@ j3100textcolor =
# ignore odd-even mode in non-cga modes: Some demoscene productions use VGA Mode X but accidentally enable odd/even mode.
# Setting this option can correct for that and render the demo properly.
# This option forces VGA emulation to ignore odd/even mode except in text and CGA modes.
+# ignore sequencer blanking: If set, ignore attempts to blank the display using the EGA/VGA sequencer registers.
+# This should not be set except for DOS games with bugs in their display handling code.
vmemdelay = 0
vmemsize = -1
vmemsizekb = 0
@@ -980,6 +982,7 @@ enable vga resize delay = false
resize only on vga active display width increase = false
vga palette update on full load = true
ignore odd-even mode in non-cga modes = false
+ignore sequencer blanking = false
[vsync]
# vsyncmode: Synchronize vsync timing to the host display. Requires calibration within DOSBox-X.
@@ -990,136 +993,146 @@ vsyncmode = off
vsyncrate = 75
[cpu]
-# core: CPU Core used in emulation. auto will switch to dynamic if available and appropriate.
-# For the dynamic core, both dynamic_x86 and dynamic_rec are supported (dynamic_x86 is preferred).
-# Windows 95 or other preemptive multitasking OSes will not work with the dynamic_rec core.
-# Possible values: auto, dynamic, dynamic_x86, dynamic_nodhfpu, dynamic, dynamic_rec, normal, full, simple.
-# fpu: Enable FPU emulation
-# Possible values: true, false, 1, 0, auto, 8087, 287, 387.
-# processor serial number: 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.
-# Note that the processor info and feature bits form the topmost 32 bits of the PSN and cannot be changed.
-# segment limits: Enforce checks for segment limits on 80286 and higher CPU types.
-# double fault: Emulate double fault exception
-# reset on triple fault: Reset CPU on triple fault condition (failure to handle double fault)
-# always report double fault: Always report (to log file) double faults if set. Else, a double fault is reported only once. Set this option for debugging purposes.
-# always report triple fault: Always report (to log file) triple faults if set. Else, a triple fault is reported only once. Set this option for debugging purposes.
-# allow lmsw to exit protected mode: Controls whether the processor will allow the guest to exit protected mode using the 286 LMSW instruction (clear the PE bit)
-# Possible values: true, false, 1, 0, auto.
-# report fdiv bug: If set, the FDIV bug will be reported with the cputype=pentium setting.
-# enable msr: Allow RDMSR/WRMSR instructions. This option is only meaningful when cputype=pentium.
-# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
-# enable cmpxchg8b: Enable Pentium CMPXCHG8B instruction. Enable this explicitly if using software that uses this instruction.
-# You must enable this option to run Windows ME because portions of the kernel rely on this instruction.
-# enable syscall: Allow SYSENTER/SYSEXIT instructions. This option is only meaningful when cputype=pentium_ii.
-#
-# ignore undefined msr: Ignore RDMSR/WRMSR 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.
-# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
-# interruptible rep string op: If nonzero, 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 based on cpu type and other configuration.
-# A setting of 0 can improve emulation speed at the expense of emulation accuracy.
-# A nonzero 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.
-# dynamic core cache block size: 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.
-#
-# cputype: CPU Type used in emulation. "auto" emulates a 486 which tolerates Pentium instructions.
-# "experimental" enables newer instructions not normally found in the CPU types emulated by DOSBox-X, such as FISTTP.
-# Possible values: auto, 8086, 8086_prefetch, 80186, 80186_prefetch, 286, 286_prefetch, 386, 386_prefetch, 486old, 486old_prefetch, 486, 486_prefetch, pentium, pentium_mmx, ppro_slow, pentium_ii, pentium_iii, experimental.
-# cycles: Number of instructions DOSBox-X tries to emulate each millisecond.
-# Setting this value too high results in sound dropouts and lags.
-# Cycles can be set in 3 ways:
-# 'auto' tries to guess what a game needs.
-# It usually works, but can fail for certain games.
-# 'fixed #number' will set a fixed number of cycles. This is what you usually
-# need if 'auto' fails (Example: fixed 4000).
-# 'max' will allocate as much cycles as your computer is able to
-# handle. Recommended if better performance is desired.
-# Possible values: auto, fixed, max.
-# cycleup: Amount of cycles to decrease/increase with the mapped keyboard shortcut.
-# cycledown: Setting it lower than 100 will be a percentage.
-# cycle emulation percentage adjust: 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.
-# turbo: Enables Turbo (Fast Forward) mode to speed up operations.
-# stop turbo on key: If set, the Turbo mode will be automatically stopped if a keyboard input is detected.
-# stop turbo after second: If a positive integer is specified, the Turbo function will last for specific seconds.
-# use dynamic core with paging on: Allow dynamic cores (dynamic_x86 and dynamic_rec) to be used with 386 paging enabled.
-# If the dynamic_x86 core is set, this allows Windows 9x/ME to run properly, but may somewhat decrease the performance.
-# If the dynamic_rec core is set, this disables the dynamic core if the 386 paging functions are currently enabled.
-# If set to auto, this option will be enabled depending on if the 386 paging and a guest system are currently active.
-# Possible values: true, false, 1, 0, auto.
-# ignore opcode 63: When debugging, do not report illegal opcode 0x63.
-# Enable this option to ignore spurious errors while debugging from within Windows 3.1/9x/ME.
-# apmbios: Emulate Advanced Power Management (APM) BIOS calls.
-# apmbios pnp: If emulating ISA PnP BIOS, announce APM BIOS in PnP enumeration.
-# Warning: this can cause Windows 95 OSR2 and later to enumerate the APM BIOS twice and cause problems.
-# apm power button event: When the power button event is triggered from the mapper or the menu, and the guest is using the APM BIOS, which APM BIOS event to send
-# Possible values: suspend, standby.
-# apmbios version: 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.
-# Possible values: auto, 1.0, 1.1, 1.2.
-# apmbios allow realmode: Allow guest OS to connect from real mode.
-# apmbios allow 16-bit protected mode: Allow guest OS to connect from 16-bit protected mode.
-# apmbios allow 32-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 shutdown 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.
-# integration device: Enable DOSBox-X's integration I/O device, a way for additional software to talk to DOSBox-X. It is currently experimental.
-# This can for example be used to return DOSBox-X's current status and by the guest OS to match the mouse pointer position.
-# integration device pnp: List DOSBox-X integration I/O device as part of ISA PnP enumeration. This has no purpose yet.
-# isapnpbios: 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.
-# isapnpport: Emulate ISA Plug & Play I/O ports, which are separate from the PnP BIOS.
-# ISA Plug & Play devices provide these I/O ports as the means to determine hardware and configure resources.
-# By default, this setting is 'auto' which enables the PnP I/O ports only if you enable the PnP BIOS.
-# Possible values: true, false, 1, 0, auto.
-# realbig16: Allow the B (big) bit in real mode. If set, allow the DOS program to set the B bit,
-# then jump to realmode with B still set (aka Huge Unreal mode). Needed for Project Angel.
-core = auto
-fpu = true
-processor serial number =
-segment limits = true
-double fault = true
-reset on triple fault = true
-always report double fault = false
-always report triple fault = false
-allow lmsw to exit protected mode = auto
-report fdiv bug = false
-enable msr = true
-enable cmpxchg8b = true
-enable syscall = true
-ignore undefined msr = false
-interruptible rep string op = -1
-dynamic core cache block size = 32
-cputype = auto
-cycles = auto
-cycleup = 10
-cycledown = 20
-cycle emulation percentage adjust = 0
-turbo = false
-stop turbo on key = true
-stop turbo after second = 0
-use dynamic core with paging on = auto
-ignore opcode 63 = true
-apmbios = true
-apmbios pnp = false
-apm power button event = suspend
-apmbios version = auto
-apmbios allow realmode = true
-apmbios allow 16-bit protected mode = true
-apmbios allow 32-bit protected mode = true
-integration device = false
-integration device pnp = false
-isapnpbios = true
-isapnpport = auto
-realbig16 = false
+# core: CPU Core used in emulation. auto will switch to dynamic if available and appropriate.
+# For the dynamic core, both dynamic_x86 and dynamic_rec are supported (dynamic_x86 is preferred).
+# Windows 95 or other preemptive multitasking OSes will not work with the dynamic_rec core.
+# Possible values: auto, dynamic, dynamic_x86, dynamic_nodhfpu, dynamic, dynamic_rec, normal, full, simple.
+# fpu: Enable FPU emulation
+# Possible values: true, false, 1, 0, auto, 8087, 287, 387.
+# processor serial number: 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.
+# Note that the processor info and feature bits form the topmost 32 bits of the PSN and cannot be changed.
+# segment limits: Enforce checks for segment limits on 80286 and higher CPU types.
+# double fault: Emulate double fault exception
+# clear trap flag on unhandled int 1: If set, the DOS kernel INT 01h handler will clear the trap flag when called.
+# Normally a DOS program using INT 01h and the trap flag (usually for debugging)
+# will provide it's own INT 01h handler. Some programs need this option set in
+# order to not crash during startup due to possible bugs or anti debugger tricks
+# that went terribly wrong.
+# reset on triple fault: Reset CPU on triple fault condition (failure to handle double fault)
+# always report double fault: Always report (to log file) double faults if set. Else, a double fault is reported only once. Set this option for debugging purposes.
+# always report triple fault: Always report (to log file) triple faults if set. Else, a triple fault is reported only once. Set this option for debugging purposes.
+# mask stack pointer for enter leave instructions: If set, ENTER will mask the stack pointer by 64KB if the stack segment is 16-bit, even if used in a 32-bit form.
+# This is not how real Intel processors work, and is intended as a bug fix for certain games
+# Possible values: true, false, 1, 0, auto.
+# allow lmsw to exit protected mode: Controls whether the processor will allow the guest to exit protected mode using the 286 LMSW instruction (clear the PE bit)
+# Possible values: true, false, 1, 0, auto.
+# report fdiv bug: If set, the FDIV bug will be reported with the cputype=pentium setting.
+# enable msr: Allow RDMSR/WRMSR instructions. This option is only meaningful when cputype=pentium.
+# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
+# enable cmpxchg8b: Enable Pentium CMPXCHG8B instruction. Enable this explicitly if using software that uses this instruction.
+# You must enable this option to run Windows ME because portions of the kernel rely on this instruction.
+# enable syscall: Allow SYSENTER/SYSEXIT instructions. This option is only meaningful when cputype=pentium_ii.
+#
+# ignore undefined msr: Ignore RDMSR/WRMSR 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.
+# WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
+# interruptible rep string op: If nonzero, 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 based on cpu type and other configuration.
+# A setting of 0 can improve emulation speed at the expense of emulation accuracy.
+# A nonzero 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.
+# dynamic core cache block size: 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.
+#
+# cputype: CPU Type used in emulation. "auto" emulates a 486 which tolerates Pentium instructions.
+# "experimental" enables newer instructions not normally found in the CPU types emulated by DOSBox-X, such as FISTTP.
+# Possible values: auto, 8086, 8086_prefetch, 80186, 80186_prefetch, 286, 286_prefetch, 386, 386_prefetch, 486old, 486old_prefetch, 486, 486_prefetch, pentium, pentium_mmx, ppro_slow, pentium_ii, pentium_iii, experimental.
+# cycles: Number of instructions DOSBox-X tries to emulate each millisecond.
+# Setting this value too high results in sound dropouts and lags.
+# Cycles can be set in 3 ways:
+# 'auto' tries to guess what a game needs.
+# It usually works, but can fail for certain games.
+# 'fixed #number' will set a fixed number of cycles. This is what you usually
+# need if 'auto' fails (Example: fixed 4000).
+# 'max' will allocate as much cycles as your computer is able to
+# handle. Recommended if better performance is desired.
+# Possible values: auto, fixed, max.
+# cycleup: Amount of cycles to decrease/increase with the mapped keyboard shortcut.
+# cycledown: Setting it lower than 100 will be a percentage.
+# cycle emulation percentage adjust: 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.
+# turbo: Enables Turbo (Fast Forward) mode to speed up operations.
+# stop turbo on key: If set, the Turbo mode will be automatically stopped if a keyboard input is detected.
+# stop turbo after second: If a positive integer is specified, the Turbo function will last for specific seconds.
+# use dynamic core with paging on: Allow dynamic cores (dynamic_x86 and dynamic_rec) to be used with 386 paging enabled.
+# If the dynamic_x86 core is set, this allows Windows 9x/ME to run properly, but may somewhat decrease the performance.
+# If the dynamic_rec core is set, this disables the dynamic core if the 386 paging functions are currently enabled.
+# If set to auto, this option will be enabled depending on if the 386 paging and a guest system are currently active.
+# Possible values: true, false, 1, 0, auto.
+# ignore opcode 63: When debugging, do not report illegal opcode 0x63.
+# Enable this option to ignore spurious errors while debugging from within Windows 3.1/9x/ME.
+# apmbios: Emulate Advanced Power Management (APM) BIOS calls.
+# apmbios pnp: If emulating ISA PnP BIOS, announce APM BIOS in PnP enumeration.
+# Warning: this can cause Windows 95 OSR2 and later to enumerate the APM BIOS twice and cause problems.
+# apm power button event: When the power button event is triggered from the mapper or the menu, and the guest is using the APM BIOS, which APM BIOS event to send
+# Possible values: suspend, standby.
+# apmbios version: 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.
+# Possible values: auto, 1.0, 1.1, 1.2.
+# apmbios allow realmode: Allow guest OS to connect from real mode.
+# apmbios allow 16-bit protected mode: Allow guest OS to connect from 16-bit protected mode.
+# apmbios allow 32-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 shutdown 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.
+# integration device: Enable DOSBox-X's integration I/O device, a way for additional software to talk to DOSBox-X. It is currently experimental.
+# This can for example be used to return DOSBox-X's current status and by the guest OS to match the mouse pointer position.
+# integration device pnp: List DOSBox-X integration I/O device as part of ISA PnP enumeration. This has no purpose yet.
+# isapnpbios: 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.
+# isapnpport: Emulate ISA Plug & Play I/O ports, which are separate from the PnP BIOS.
+# ISA Plug & Play devices provide these I/O ports as the means to determine hardware and configure resources.
+# By default, this setting is 'auto' which enables the PnP I/O ports only if you enable the PnP BIOS.
+# Possible values: true, false, 1, 0, auto.
+# realbig16: Allow the B (big) bit in real mode. If set, allow the DOS program to set the B bit,
+# then jump to realmode with B still set (aka Huge Unreal mode). Needed for Project Angel.
+core = auto
+fpu = true
+processor serial number =
+segment limits = true
+double fault = true
+clear trap flag on unhandled int 1 = false
+reset on triple fault = true
+always report double fault = false
+always report triple fault = false
+mask stack pointer for enter leave instructions = auto
+allow lmsw to exit protected mode = auto
+report fdiv bug = false
+enable msr = true
+enable cmpxchg8b = true
+enable syscall = true
+ignore undefined msr = false
+interruptible rep string op = -1
+dynamic core cache block size = 32
+cputype = auto
+cycles = auto
+cycleup = 10
+cycledown = 20
+cycle emulation percentage adjust = 0
+turbo = false
+stop turbo on key = true
+stop turbo after second = 0
+use dynamic core with paging on = auto
+ignore opcode 63 = true
+apmbios = true
+apmbios pnp = false
+apm power button event = suspend
+apmbios version = auto
+apmbios allow realmode = true
+apmbios allow 16-bit protected mode = true
+apmbios allow 32-bit protected mode = true
+integration device = false
+integration device pnp = false
+isapnpbios = true
+isapnpport = auto
+realbig16 = false
[keyboard]
# aux: Enable emulation of the 8042 auxiliary port. PS/2 mouse emulation requires this to be enabled.
diff --git a/include/build_timestamp.h b/include/build_timestamp.h
index c7f17dae34d..23c5fc1e7f4 100644
--- a/include/build_timestamp.h
+++ b/include/build_timestamp.h
@@ -1,4 +1,4 @@
/*auto-generated*/
-#define UPDATED_STR "Jun 30, 2022 12:01:46pm"
-#define GIT_COMMIT_HASH "29d83d8"
+#define UPDATED_STR "Jul 1, 2022 6:23:09am"
+#define GIT_COMMIT_HASH "2c17d42"
#define COPYRIGHT_END_YEAR "2022"