From 1825a41799829ec30a75c5f6ab5dc00aee36eb5c Mon Sep 17 00:00:00 2001 From: Jonathan Campbell Date: Fri, 1 Jul 2022 06:24:06 -0700 Subject: [PATCH] Prepare for release --- .../com.dosbox_x.DOSBox-X.metainfo.xml.in | 2 +- .../installer/dosbox-x.reference.setup.conf | 277 +++++++++--------- dosbox-x.reference.conf | 4 +- dosbox-x.reference.full.conf | 273 +++++++++-------- include/build_timestamp.h | 4 +- 5 files changed, 293 insertions(+), 267 deletions(-) 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"