diff --git a/contrib/windows/installer/dosbox-x.reference.setup.conf b/contrib/windows/installer/dosbox-x.reference.setup.conf index 3dbcbd321..b79f2d510 100644 --- a/contrib/windows/installer/dosbox-x.reference.setup.conf +++ b/contrib/windows/installer/dosbox-x.reference.setup.conf @@ -287,6 +287,7 @@ debuggerrun = debugger #DOSBOX-X-ADV:# shell environment size: Size of the initial DOSBox-X shell environment block, in bytes. Setting to 0 implies a default size of 720 bytes as in DOSBox. #DOSBOX-X-ADV:# You can increase this size to store more environment variables in DOS, although this does not affect the environment block #DOSBOX-X-ADV:# of sub-processes spawned from the DOS shell. This option has no effect unless the dynamic kernel allocation is enabled. +#DOSBOX-X-ADV:# shell permanent: If enabled, initial DOSBox-X shell will stay permanent (equivalent to /P switch). #DOSBOX-X-ADV:# private area size: Set DOSBox-X private memory area size. This area contains private memory structures used by the DOS kernel. #DOSBOX-X-ADV:# It is discarded when you boot into another OS. Mainline DOSBox uses 32KB. Testing shows that it is possible #DOSBOX-X-ADV:# to run DOSBox with as little as 4KB. If DOSBox-X aborts with error "not enough memory for internal tables" @@ -464,7 +465,7 @@ debuggerrun = debugger #DOSBOX-X-ADV:# enable pci bus: Enable PCI bus emulation #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:# -> disable graphical splash; allow quit after warning; keyboard hook; weitek; bochs debug port e9; video debug at startup; compresssaveparts; show recorded filename; skip encoding unchanged frames; capture chroma format; capture format; shell environment size; private area size; turn off a20 gate on boot; cbus bus clock; isa bus clock; pci bus clock; call binary on reset; unhandled irq handler; call binary on boot; ibm rom basic; rom bios allocation max; rom bios minimum size; irq delay ns; iodelay; iodelay16; iodelay32; acpi; acpi rsd ptr location; acpi sci irq; acpi iobase; acpi reserved size; memsizekb; dos mem limit; isa memory hole at 512kb; isa memory hole at 15mb; reboot delay; memalias; convert fat free space; convert fat timeout; leading colon write protect image; locking disk image mount; unmask keyboard on int 16 read; int16 keyboard polling undocumented cf behavior; allow port 92 reset; enable port 92; enable 1st dma controller; enable 2nd dma controller; allow dma address decrement; enable 128k capable 16-bit dma; enable dma extra page registers; dma page registers write-only; cascade interrupt never in service; cascade interrupt ignore in service; enable slave pic; enable pc nmi mask; allow more than 640kb base memory; enable pci bus +#DOSBOX-X-ADV-SEE:# -> disable graphical splash; allow quit after warning; keyboard hook; weitek; bochs debug port e9; video debug at startup; compresssaveparts; show recorded filename; skip encoding unchanged frames; capture chroma format; capture format; shell environment size; shell permanent; private area size; turn off a20 gate on boot; cbus bus clock; isa bus clock; pci bus clock; call binary on reset; unhandled irq handler; call binary on boot; ibm rom basic; rom bios allocation max; rom bios minimum size; irq delay ns; iodelay; iodelay16; iodelay32; acpi; acpi rsd ptr location; acpi sci irq; acpi iobase; acpi reserved size; memsizekb; dos mem limit; isa memory hole at 512kb; isa memory hole at 15mb; reboot delay; memalias; convert fat free space; convert fat timeout; leading colon write protect image; locking disk image mount; unmask keyboard on int 16 read; int16 keyboard polling undocumented cf behavior; allow port 92 reset; enable port 92; enable 1st dma controller; enable 2nd dma controller; allow dma address decrement; enable 128k capable 16-bit dma; enable dma extra page registers; dma page registers write-only; cascade interrupt never in service; cascade interrupt ignore in service; enable slave pic; enable pc nmi mask; allow more than 640kb base memory; enable pci bus #DOSBOX-X-ADV-SEE:# language = title = @@ -503,6 +504,7 @@ forceloadstate = false #DOSBOX-X-ADV:capture chroma format = auto #DOSBOX-X-ADV:capture format = default #DOSBOX-X-ADV:shell environment size = 0 +#DOSBOX-X-ADV:shell permanent = false #DOSBOX-X-ADV:private area size = 32768 a20 = mask #DOSBOX-X-ADV:turn off a20 gate on boot = true @@ -714,9 +716,12 @@ monochrome_pal = green #DOSBOX-X-ADV:# pc-98 show graphics layer on initialize: If PC-98 mode and INT 33h emulation is enabled, the graphics layer will be automatically enabled #DOSBOX-X-ADV:# at driver startup AND when INT 33h AX=0 is called. This is NEC MOUSE.COM behavior and default #DOSBOX-X-ADV:# enabled. To emulate other drivers like QMOUSE that do not follow this behavior, set to false. +#DOSBOX-X-ADV:# pc-98 chargen vsync-limited access: If set, reading pixels from the character generator while in Code Access mode (or always, for ANK +#DOSBOX-X-ADV:# characters) will be invalid. Some models (i.e. PC-9821As3) dont seem to have this limitation, but +#DOSBOX-X-ADV:# many others do. #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:# -> pc-98 int 1b fdc timer wait; pc-98 pic init to read isr; pc-98 fm board irq; pc-98 fm board io port; pc-98 time stamp; pc-98 sound bios; pc-98 load sound bios rom file; pc-98 buffer page flip; pc-98 enable 256-color planar; pc-98 enable 188 user cg; pc-98 start gdc at 5mhz; pc-98 allow scanline effect; pc-98 nec mouse function; pc-98 video mode; pc-98 timer always cycles; pc-98 timer master frequency; pc-98 allow 4 display partition graphics; pc-98 fontx sbcs; pc-98 fontx dbcs; pc-98 fontx internal symbol; pc-98 show graphics layer on initialize +#DOSBOX-X-ADV-SEE:# -> pc-98 int 1b fdc timer wait; pc-98 pic init to read isr; pc-98 fm board irq; pc-98 fm board io port; pc-98 time stamp; pc-98 sound bios; pc-98 load sound bios rom file; pc-98 buffer page flip; pc-98 enable 256-color planar; pc-98 enable 188 user cg; pc-98 start gdc at 5mhz; pc-98 allow scanline effect; pc-98 nec mouse function; pc-98 video mode; pc-98 timer always cycles; pc-98 timer master frequency; pc-98 allow 4 display partition graphics; pc-98 fontx sbcs; pc-98 fontx dbcs; pc-98 fontx internal symbol; pc-98 show graphics layer on initialize; pc-98 chargen vsync-limited access #DOSBOX-X-ADV-SEE:# pc-98 BIOS copyright string = false #DOSBOX-X-ADV:pc-98 int 1b fdc timer wait = false @@ -750,6 +755,7 @@ pc-98 anex86 font = #DOSBOX-X-ADV:pc-98 fontx dbcs = #DOSBOX-X-ADV:pc-98 fontx internal symbol = false #DOSBOX-X-ADV:pc-98 show graphics layer on initialize = true +#DOSBOX-X-ADV:pc-98 chargen vsync-limited access = true [dosv] # dosv: Enable DOS/V emulation and specify which version to emulate. This option is intended for use with games or software @@ -1937,7 +1943,7 @@ goldplay = true #DOSBOX-X-ADV:goldplay stereo = true #DOSBOX-X-ADV:dsp require interrupt acknowledge = auto #DOSBOX-X-ADV:dsp write busy delay = -1 -blaster environment variable = true +blaster environment variable = false #DOSBOX-X-ADV:sample rate limits = true #DOSBOX-X-ADV:instant direct dac = false #DOSBOX-X-ADV:stereo control with sbpro only = true @@ -2389,6 +2395,7 @@ timeout = 0 #DOSBOX-X-ADV:# turn off a20 gate on load if loadfix needed: If enabled, and loading a program below the 64kb boundary, turn off the A20 gate. #DOSBOX-X-ADV:# This can help with any program with startup code that assumes the segment wraparound of the 8086. #DOSBOX-X-ADV:# Depending on DOS configuration the A20 gate may be re-enabled later such as calling INT 21h. +#DOSBOX-X-ADV:# xms log memmove: If set, XMS move/copy operations are logged for debugging purposes. #DOSBOX-X-ADV:# xms memmove causes flat real mode: If set, any call to XMS to move/copy memory sets up flat real mode for segment registers DS and ES. #DOSBOX-X-ADV:# xms init causes flat real mode: If set, when the DOS kernel initializes XMS it will switch on flat real mode for segment registers DS and ES if appropriate. #DOSBOX-X-ADV:# resized free memory block becomes allocated: If set, and the DOS application resizes a freed memory block, that block will be marked as allocated to that program. @@ -2450,6 +2457,7 @@ timeout = 0 # network redirector: Report DOS network redirector as resident. This will allow the host name to be returned unless the secure mode is enabled. # You can also directly access UNC network paths in the form \\MACHINE\SHARE even if they are not mounted as drives on Windows systems. # Set either "ipx=true" in [ipx] section or "ne2000=true" in [ne2000] section for a full network redirector environment. +# mcb corruption becomes application free memory: If MCB chain corruption occurs following the DOS program PSP segment and the DOS program does anything to cause memory allocation,make a new free memory block in it's place instead of halting emulation with an MCB chain error. Some DOS programs are sloppywith memory to corrupt the MCB chain after itself in memory. This is apparently real MS-DOS behavior, set to true to enable.If set to false, all MCB chain corruption will halt emulation as DOSBox forks typically do already. #DOSBOX-X-ADV:# minimum dos initial private segment: In non-mainline mapping mode, where DOS structures are allocated from base memory, this sets the #DOSBOX-X-ADV:# minimum segment value. Recommended value is 0x70. You may reduce the value down to 0x50 if freeing #DOSBOX-X-ADV:# up more memory is important. Set to 0 for default. @@ -2627,10 +2635,11 @@ timeout = 0 # dos idle api: If set, DOSBox-X can lower the host system's CPU load when a supported guest program is idle. #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:# -> turn off a20 gate on load if loadfix needed; xms memmove causes flat real mode; xms init causes flat real mode; resized free memory block becomes allocated; badcommandhandler; mscdex device name; hma allow reservation; command shell flush keyboard buffer; special operation file prefix; drive z is remote; drive z convert fat; drive z expand path; drive z hide files; automount drive directories; hidenonrepresentable; hma minimum allocation; dos sda size; hma free space; cpm compatibility mode; minimum dos initial private segment; minimum mcb segment; enable dummy device mcb; maximum environment block size on exec; additional environment block size on exec; enable a20 on windows init; zero memory on xms memory allocation; vcpi; unmask timer on disk io; zero int 67h if no ems; zero unused int 68h; emm386 startup active; zero memory on ems memory allocation; ems system handle memory size; ems system handle on even megabyte; ems frame; umb start; umb end; kernel allocation in umb; keep umb on boot; keep private area on boot; private area in umb; private area write protect; autoa20fix; autoloadfix; startincon; int33 max x; int33 max y; int33 xy adjust; int33 mickey threshold; int33 hide host cursor if interrupt subroutine; int33 hide host cursor when polling; int33 disable cell granularity; int 13 disk change detect; int 13 extensions; biosps2; int15 wait force unmask irq; int15 mouse callback does not preserve registers; filenamechar; collating and uppercase; con device use int 16h to detect keyboard input; zero memory on int 21h memory allocation; pipe temporary device +#DOSBOX-X-ADV-SEE:# -> turn off a20 gate on load if loadfix needed; xms log memmove; xms memmove causes flat real mode; xms init causes flat real mode; resized free memory block becomes allocated; badcommandhandler; mscdex device name; hma allow reservation; command shell flush keyboard buffer; special operation file prefix; drive z is remote; drive z convert fat; drive z expand path; drive z hide files; automount drive directories; hidenonrepresentable; hma minimum allocation; dos sda size; hma free space; cpm compatibility mode; minimum dos initial private segment; minimum mcb segment; enable dummy device mcb; maximum environment block size on exec; additional environment block size on exec; enable a20 on windows init; zero memory on xms memory allocation; vcpi; unmask timer on disk io; zero int 67h if no ems; zero unused int 68h; emm386 startup active; zero memory on ems memory allocation; ems system handle memory size; ems system handle on even megabyte; ems frame; umb start; umb end; kernel allocation in umb; keep umb on boot; keep private area on boot; private area in umb; private area write protect; autoa20fix; autoloadfix; startincon; int33 max x; int33 max y; int33 xy adjust; int33 mickey threshold; int33 hide host cursor if interrupt subroutine; int33 hide host cursor when polling; int33 disable cell granularity; int 13 disk change detect; int 13 extensions; biosps2; int15 wait force unmask irq; int15 mouse callback does not preserve registers; filenamechar; collating and uppercase; con device use int 16h to detect keyboard input; zero memory on int 21h memory allocation; pipe temporary device #DOSBOX-X-ADV-SEE:# xms = true #DOSBOX-X-ADV:turn off a20 gate on load if loadfix needed = false +#DOSBOX-X-ADV:xms log memmove = false #DOSBOX-X-ADV:xms memmove causes flat real mode = true #DOSBOX-X-ADV:xms init causes flat real mode = false #DOSBOX-X-ADV:resized free memory block becomes allocated = true @@ -2659,6 +2668,7 @@ log console = false share = true file access tries = 0 network redirector = true +mcb corruption becomes application free memory = false #DOSBOX-X-ADV:minimum dos initial private segment = 0 #DOSBOX-X-ADV:minimum mcb segment = 0 minimum mcb free = 0 diff --git a/dosbox-x.reference.conf b/dosbox-x.reference.conf index eea073860..4f684cab0 100644 --- a/dosbox-x.reference.conf +++ b/dosbox-x.reference.conf @@ -342,7 +342,7 @@ monochrome_pal = green # If you specify a font here then it will be tried first, perhaps before FONT.ROM (see previous option). # # Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details): -# -> pc-98 int 1b fdc timer wait; pc-98 pic init to read isr; pc-98 fm board irq; pc-98 fm board io port; pc-98 time stamp; pc-98 sound bios; pc-98 load sound bios rom file; pc-98 buffer page flip; pc-98 enable 256-color planar; pc-98 enable 188 user cg; pc-98 start gdc at 5mhz; pc-98 allow scanline effect; pc-98 nec mouse function; pc-98 video mode; pc-98 timer always cycles; pc-98 timer master frequency; pc-98 allow 4 display partition graphics; pc-98 fontx sbcs; pc-98 fontx dbcs; pc-98 fontx internal symbol; pc-98 show graphics layer on initialize +# -> pc-98 int 1b fdc timer wait; pc-98 pic init to read isr; pc-98 fm board irq; pc-98 fm board io port; pc-98 time stamp; pc-98 sound bios; pc-98 load sound bios rom file; pc-98 buffer page flip; pc-98 enable 256-color planar; pc-98 enable 188 user cg; pc-98 start gdc at 5mhz; pc-98 allow scanline effect; pc-98 nec mouse function; pc-98 video mode; pc-98 timer always cycles; pc-98 timer master frequency; pc-98 allow 4 display partition graphics; pc-98 fontx sbcs; pc-98 fontx dbcs; pc-98 fontx internal symbol; pc-98 show graphics layer on initialize; pc-98 chargen vsync-limited access # pc-98 BIOS copyright string = false pc-98 fm board = auto @@ -807,7 +807,7 @@ retrowave_bus = serial retrowave_port = hardwarebase = 220 goldplay = true -blaster environment variable = true +blaster environment variable = false [gus] # gus: Enable the Gravis Ultrasound emulation. @@ -1138,135 +1138,137 @@ shellhide = false timeout = 0 [dos] -# xms: Enable XMS support. -# xms handles: Number of XMS handles available for the DOS environment, or 0 to use a reasonable default -# shell configuration as commands: Allow entering dosbox-x.conf configuration parameters as shell commands to get and set settings. -# This is disabled by default to avoid conflicts between commands and executables. -# It is recommended to get and set dosbox-x.conf settings using the CONFIG command instead. -# Compatibility with DOSBox SVN can be improved by enabling this option. -# hma: Report through XMS that HMA exists (not necessarily available) -# hard drive data rate limit: Slow down (limit) hard disk throughput. This setting controls the limit in bytes/second. -# Set to 0 to disable the limit, or -1 (default) to use a reasonable limit. -# The disk I/O performance as in DOSBox SVN can be achieved by setting this to 0. -# floppy drive data rate limit: Slow down (limit) floppy disk throughput. This setting controls the limit in bytes/second. -# Set to 0 to disable the limit, or -1 (default) to use a reasonable limit. -# The disk I/O performance as in DOSBox SVN can be achieved by setting this to 0. -# ansi.sys: If set (by default), ANSI.SYS emulation is on. If clear, ANSI.SYS is not emulated and will not appear to be installed. -# NOTE: This option has no effect in PC-98 mode where MS-DOS systems integrate ANSI.SYS into the DOS kernel. -# log console: If set, log DOS CON output to the log file. Setting to "quiet" will log DOS CON output only (no debugging output). -# Possible values: true, false, 1, 0, quiet. -# share: Reports SHARE.EXE as resident and provides functions such as file-locking and record-locking, although not all SHARE functions are emulated. -# file access tries: If a positive integer is set, DOSBox-X will try to read/write/lock files directly on mounted local drives for the specified number of times without caching before failing on Windows systems. -# For networked database applications (e.g. dBase, FoxPro, etc), it is strongly recommended to set this to e.g. 3 for correct operations. -# network redirector: Report DOS network redirector as resident. This will allow the host name to be returned unless the secure mode is enabled. -# You can also directly access UNC network paths in the form \\MACHINE\SHARE even if they are not mounted as drives on Windows systems. -# Set either "ipx=true" in [ipx] section or "ne2000=true" in [ne2000] section for a full network redirector environment. -# minimum mcb free: Minimum free segment value to leave free. At startup, the DOS kernel will allocate memory -# up to this point. This can be used to deal with EXEPACK issues or DOS programs that cannot -# be loaded too low in memory. If you want more free conventional memory to be reported, -# you can for example set its value to 1. -# ems: Enable EMS support. The default (=true) provides the best -# compatibility but certain applications may run better with -# other choices, or require EMS support to be disabled (=false) -# to work at all. -# Possible values: true, emsboard, emm386, false, 1, 0. -# umb: Enable UMB support. -# quick reboot: If set, the DOS restart call will reboot the emulated DOS (integrated DOS or guest DOS) instead of the virtual machine. -# -# ver: Set DOS version. Specify as major.minor format. A single number is treated as the major version (compatible with LFN support). Common settings are: -# auto (or unset) Pick DOS kernel version 5.0 (DOSBox default) -# 3.3 MS-DOS 3.3 emulation (not tested!) -# 5.0 MS-DOS 5.0 emulation (recommended for DOS gaming) -# 6.22 MS-DOS 6.22 emulation -# 7.0 MS-DOS 7.0 (or Windows 95 pure DOS mode) emulation -# 7.1 MS-DOS 7.1 (or Windows 98 pure DOS mode) emulation -# Long filename (LFN) support will be enabled with a reported DOS version of 7.0 or higher with "lfn=auto" (default). -# Similarly, FAT32 disk images will be supported with a reported DOS version of 7.1 or higher. -# -# lfn: Enable long filename support. If set to auto (default), LFN support is enabled if the reported DOS version is at least 7.0. -# If set to autostart, the built-in VER command won't activate/deactivate LFN support according to the reported DOS version. -# Possible values: true, false, 1, 0, auto, autostart. -# fat32setversion: Whether DOSBox-X should automatically set the reported DOS version to 7.0/7.10 when it is less than 7.0/7.10 and mounting LBA/FAT32 disk images is requested. -# If set to "ask", a popup message will show up to ask whether DOSBox-X should automatically change the reported DOS version in order to mount the disk image. -# Possible values: ask, auto, manual. -# shellhigh: Load the DOSBox-X command shell into the upper memory when the UMB is available. -# If set to auto (default), it is enabled if the reported DOS version is at least 7.0. -# Possible values: true, false, 1, 0, auto. -# automount: Enable automatic drive mounting in Windows. -# automountall: Automatically mount all available Windows drives at start. -# Possible values: true, false, 1, 0, quiet. -# mountwarning: If set, a warning message will be displayed while trying to auto-mount your Windows host drives. -# autofixwarning: If set to true or both, DOSBox-X shows messages while trying to automatically fix the "Packed file is corrupt" error. -# If set to false or none, DOSBox-X will not show such messages on the screen when the error occurred. -# If set to "a20fix" or "loadfix", DOSBox-X will show the message for the a20fix or the loadfix only. -# Possible values: true, false, 1, 0, both, a20fix, loadfix, none. -# startcmd: Enable START command to start programs to run on the host system. On Windows host programs or commands may also be launched directly. -# starttranspath: Specify whether DOSBox-X should automatically translate all paths in the command-line to host system paths when starting programs to run on the host system. -# startwait: Specify whether DOSBox-X should wait for the host system applications after they are started. -# startquiet: If set, before launching host system applications to run on the host DOSBox-X will not show messages like "Now run it as a Windows application". -# startnopause: If set, DOSBox-X will not pause after host command execution is completed. -# vmware: Enable VMware interface emulation including guest mouse integration (when used along with e.g. VMware mouse driver for Windows 3.x). -# int33: Enable INT 33H for mouse support. -# mouse report rate: Mouse reporting rate, or 0 for auto. This affects how often mouse events are reported to the guest through the mouse interrupt. -# Some games including CyClone need a lower reporting rate to function correctly. Auto mode allows the guest to change the report rate through the PS/2 mouse emulation. -# This option does not affect any DOS game that uses polling through INT 33h to detect mouse movement. -# keyboardlayout: Language code of the keyboard layout (or none). -# customcodepage: Set a custom code page for CHCP command and specify a SBCS code page file, following the standard SBCS code page format. -# Examples of SBCS code pages are available from the Unicode Consortium website: https://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/PC/ -# dbcs: Enable DBCS table and Chinese, Japanese, Korean support for the TrueType font (TTF) output. -# CAUTION: Some software will crash without the DBCS table, including the Open Watcom installer. -# dos clipboard device enable: If enabled, a DOS device will be added for bidirectional communications with the shared clipboard. -# Setting to "read" will only allow read access, and setting to "write" will only allow write access. -# Setting to "full" or "true" enables both; setting to "false" or "disabled" disables the access or device. -# The default device name is CLIP$, but can be changed with the "dos clipboard device name" setting below. -# dos clipboard device name: Set DOS device name (up to 8 characters) for bidirectional communications with the shared clipboard. -# If unset or invalid, the default name CLIP$ will be used (e.g. "TYPE CLIP$" shows the clipboard contents). -# It has no effect if "dos clipboard device enable" is disabled, and it is deactivated if the secure mode is enabled. -# dos clipboard api: If set, DOS APIs for communications with the Windows clipboard will be enabled for shared clipboard communications. -# Caution: Enabling this API may cause some programs to think they are running under Windows -# dos idle api: If set, DOSBox-X can lower the host system's CPU load when a supported guest program is idle. +# xms: Enable XMS support. +# xms handles: Number of XMS handles available for the DOS environment, or 0 to use a reasonable default +# shell configuration as commands: Allow entering dosbox-x.conf configuration parameters as shell commands to get and set settings. +# This is disabled by default to avoid conflicts between commands and executables. +# It is recommended to get and set dosbox-x.conf settings using the CONFIG command instead. +# Compatibility with DOSBox SVN can be improved by enabling this option. +# hma: Report through XMS that HMA exists (not necessarily available) +# hard drive data rate limit: Slow down (limit) hard disk throughput. This setting controls the limit in bytes/second. +# Set to 0 to disable the limit, or -1 (default) to use a reasonable limit. +# The disk I/O performance as in DOSBox SVN can be achieved by setting this to 0. +# floppy drive data rate limit: Slow down (limit) floppy disk throughput. This setting controls the limit in bytes/second. +# Set to 0 to disable the limit, or -1 (default) to use a reasonable limit. +# The disk I/O performance as in DOSBox SVN can be achieved by setting this to 0. +# ansi.sys: If set (by default), ANSI.SYS emulation is on. If clear, ANSI.SYS is not emulated and will not appear to be installed. +# NOTE: This option has no effect in PC-98 mode where MS-DOS systems integrate ANSI.SYS into the DOS kernel. +# log console: If set, log DOS CON output to the log file. Setting to "quiet" will log DOS CON output only (no debugging output). +# Possible values: true, false, 1, 0, quiet. +# share: Reports SHARE.EXE as resident and provides functions such as file-locking and record-locking, although not all SHARE functions are emulated. +# file access tries: If a positive integer is set, DOSBox-X will try to read/write/lock files directly on mounted local drives for the specified number of times without caching before failing on Windows systems. +# For networked database applications (e.g. dBase, FoxPro, etc), it is strongly recommended to set this to e.g. 3 for correct operations. +# network redirector: Report DOS network redirector as resident. This will allow the host name to be returned unless the secure mode is enabled. +# You can also directly access UNC network paths in the form \\MACHINE\SHARE even if they are not mounted as drives on Windows systems. +# Set either "ipx=true" in [ipx] section or "ne2000=true" in [ne2000] section for a full network redirector environment. +# mcb corruption becomes application free memory: If MCB chain corruption occurs following the DOS program PSP segment and the DOS program does anything to cause memory allocation,make a new free memory block in it's place instead of halting emulation with an MCB chain error. Some DOS programs are sloppywith memory to corrupt the MCB chain after itself in memory. This is apparently real MS-DOS behavior, set to true to enable.If set to false, all MCB chain corruption will halt emulation as DOSBox forks typically do already. +# minimum mcb free: Minimum free segment value to leave free. At startup, the DOS kernel will allocate memory +# up to this point. This can be used to deal with EXEPACK issues or DOS programs that cannot +# be loaded too low in memory. If you want more free conventional memory to be reported, +# you can for example set its value to 1. +# ems: Enable EMS support. The default (=true) provides the best +# compatibility but certain applications may run better with +# other choices, or require EMS support to be disabled (=false) +# to work at all. +# Possible values: true, emsboard, emm386, false, 1, 0. +# umb: Enable UMB support. +# quick reboot: If set, the DOS restart call will reboot the emulated DOS (integrated DOS or guest DOS) instead of the virtual machine. +# +# ver: Set DOS version. Specify as major.minor format. A single number is treated as the major version (compatible with LFN support). Common settings are: +# auto (or unset) Pick DOS kernel version 5.0 (DOSBox default) +# 3.3 MS-DOS 3.3 emulation (not tested!) +# 5.0 MS-DOS 5.0 emulation (recommended for DOS gaming) +# 6.22 MS-DOS 6.22 emulation +# 7.0 MS-DOS 7.0 (or Windows 95 pure DOS mode) emulation +# 7.1 MS-DOS 7.1 (or Windows 98 pure DOS mode) emulation +# Long filename (LFN) support will be enabled with a reported DOS version of 7.0 or higher with "lfn=auto" (default). +# Similarly, FAT32 disk images will be supported with a reported DOS version of 7.1 or higher. +# +# lfn: Enable long filename support. If set to auto (default), LFN support is enabled if the reported DOS version is at least 7.0. +# If set to autostart, the built-in VER command won't activate/deactivate LFN support according to the reported DOS version. +# Possible values: true, false, 1, 0, auto, autostart. +# fat32setversion: Whether DOSBox-X should automatically set the reported DOS version to 7.0/7.10 when it is less than 7.0/7.10 and mounting LBA/FAT32 disk images is requested. +# If set to "ask", a popup message will show up to ask whether DOSBox-X should automatically change the reported DOS version in order to mount the disk image. +# Possible values: ask, auto, manual. +# shellhigh: Load the DOSBox-X command shell into the upper memory when the UMB is available. +# If set to auto (default), it is enabled if the reported DOS version is at least 7.0. +# Possible values: true, false, 1, 0, auto. +# automount: Enable automatic drive mounting in Windows. +# automountall: Automatically mount all available Windows drives at start. +# Possible values: true, false, 1, 0, quiet. +# mountwarning: If set, a warning message will be displayed while trying to auto-mount your Windows host drives. +# autofixwarning: If set to true or both, DOSBox-X shows messages while trying to automatically fix the "Packed file is corrupt" error. +# If set to false or none, DOSBox-X will not show such messages on the screen when the error occurred. +# If set to "a20fix" or "loadfix", DOSBox-X will show the message for the a20fix or the loadfix only. +# Possible values: true, false, 1, 0, both, a20fix, loadfix, none. +# startcmd: Enable START command to start programs to run on the host system. On Windows host programs or commands may also be launched directly. +# starttranspath: Specify whether DOSBox-X should automatically translate all paths in the command-line to host system paths when starting programs to run on the host system. +# startwait: Specify whether DOSBox-X should wait for the host system applications after they are started. +# startquiet: If set, before launching host system applications to run on the host DOSBox-X will not show messages like "Now run it as a Windows application". +# startnopause: If set, DOSBox-X will not pause after host command execution is completed. +# vmware: Enable VMware interface emulation including guest mouse integration (when used along with e.g. VMware mouse driver for Windows 3.x). +# int33: Enable INT 33H for mouse support. +# mouse report rate: Mouse reporting rate, or 0 for auto. This affects how often mouse events are reported to the guest through the mouse interrupt. +# Some games including CyClone need a lower reporting rate to function correctly. Auto mode allows the guest to change the report rate through the PS/2 mouse emulation. +# This option does not affect any DOS game that uses polling through INT 33h to detect mouse movement. +# keyboardlayout: Language code of the keyboard layout (or none). +# customcodepage: Set a custom code page for CHCP command and specify a SBCS code page file, following the standard SBCS code page format. +# Examples of SBCS code pages are available from the Unicode Consortium website: https://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/PC/ +# dbcs: Enable DBCS table and Chinese, Japanese, Korean support for the TrueType font (TTF) output. +# CAUTION: Some software will crash without the DBCS table, including the Open Watcom installer. +# dos clipboard device enable: If enabled, a DOS device will be added for bidirectional communications with the shared clipboard. +# Setting to "read" will only allow read access, and setting to "write" will only allow write access. +# Setting to "full" or "true" enables both; setting to "false" or "disabled" disables the access or device. +# The default device name is CLIP$, but can be changed with the "dos clipboard device name" setting below. +# dos clipboard device name: Set DOS device name (up to 8 characters) for bidirectional communications with the shared clipboard. +# If unset or invalid, the default name CLIP$ will be used (e.g. "TYPE CLIP$" shows the clipboard contents). +# It has no effect if "dos clipboard device enable" is disabled, and it is deactivated if the secure mode is enabled. +# dos clipboard api: If set, DOS APIs for communications with the Windows clipboard will be enabled for shared clipboard communications. +# Caution: Enabling this API may cause some programs to think they are running under Windows +# dos idle api: If set, DOSBox-X can lower the host system's CPU load when a supported guest program is idle. # # Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details): -# -> turn off a20 gate on load if loadfix needed; xms memmove causes flat real mode; xms init causes flat real mode; resized free memory block becomes allocated; badcommandhandler; mscdex device name; hma allow reservation; command shell flush keyboard buffer; special operation file prefix; drive z is remote; drive z convert fat; drive z expand path; drive z hide files; automount drive directories; hidenonrepresentable; hma minimum allocation; dos sda size; hma free space; cpm compatibility mode; minimum dos initial private segment; minimum mcb segment; enable dummy device mcb; maximum environment block size on exec; additional environment block size on exec; enable a20 on windows init; zero memory on xms memory allocation; vcpi; unmask timer on disk io; zero int 67h if no ems; zero unused int 68h; emm386 startup active; zero memory on ems memory allocation; ems system handle memory size; ems system handle on even megabyte; ems frame; umb start; umb end; kernel allocation in umb; keep umb on boot; keep private area on boot; private area in umb; private area write protect; autoa20fix; autoloadfix; startincon; int33 max x; int33 max y; int33 xy adjust; int33 mickey threshold; int33 hide host cursor if interrupt subroutine; int33 hide host cursor when polling; int33 disable cell granularity; int 13 disk change detect; int 13 extensions; biosps2; int15 wait force unmask irq; int15 mouse callback does not preserve registers; filenamechar; collating and uppercase; con device use int 16h to detect keyboard input; zero memory on int 21h memory allocation; pipe temporary device +# -> turn off a20 gate on load if loadfix needed; xms log memmove; xms memmove causes flat real mode; xms init causes flat real mode; resized free memory block becomes allocated; badcommandhandler; mscdex device name; hma allow reservation; command shell flush keyboard buffer; special operation file prefix; drive z is remote; drive z convert fat; drive z expand path; drive z hide files; automount drive directories; hidenonrepresentable; hma minimum allocation; dos sda size; hma free space; cpm compatibility mode; minimum dos initial private segment; minimum mcb segment; enable dummy device mcb; maximum environment block size on exec; additional environment block size on exec; enable a20 on windows init; zero memory on xms memory allocation; vcpi; unmask timer on disk io; zero int 67h if no ems; zero unused int 68h; emm386 startup active; zero memory on ems memory allocation; ems system handle memory size; ems system handle on even megabyte; ems frame; umb start; umb end; kernel allocation in umb; keep umb on boot; keep private area on boot; private area in umb; private area write protect; autoa20fix; autoloadfix; startincon; int33 max x; int33 max y; int33 xy adjust; int33 mickey threshold; int33 hide host cursor if interrupt subroutine; int33 hide host cursor when polling; int33 disable cell granularity; int 13 disk change detect; int 13 extensions; biosps2; int15 wait force unmask irq; int15 mouse callback does not preserve registers; filenamechar; collating and uppercase; con device use int 16h to detect keyboard input; zero memory on int 21h memory allocation; pipe temporary device # -xms = true -xms handles = 0 -shell configuration as commands = false -hma = true -hard drive data rate limit = -1 -floppy drive data rate limit = -1 -ansi.sys = true -log console = false -share = true -file access tries = 0 -network redirector = true -minimum mcb free = 0 -ems = true -umb = true -quick reboot = false -ver = -lfn = auto -fat32setversion = ask -shellhigh = auto -automount = true -automountall = false -mountwarning = true -autofixwarning = false -startcmd = false -starttranspath = true -startwait = true -startquiet = false -startnopause = false -vmware = true -int33 = true -mouse report rate = 0 -keyboardlayout = auto -customcodepage = -dbcs = true -dos clipboard device enable = false -dos clipboard device name = CLIP$ -dos clipboard api = false -dos idle api = true +xms = true +xms handles = 0 +shell configuration as commands = false +hma = true +hard drive data rate limit = -1 +floppy drive data rate limit = -1 +ansi.sys = true +log console = false +share = true +file access tries = 0 +network redirector = true +mcb corruption becomes application free memory = false +minimum mcb free = 0 +ems = true +umb = true +quick reboot = false +ver = +lfn = auto +fat32setversion = ask +shellhigh = auto +automount = true +automountall = false +mountwarning = true +autofixwarning = false +startcmd = false +starttranspath = true +startwait = true +startquiet = false +startnopause = false +vmware = true +int33 = true +mouse report rate = 0 +keyboardlayout = auto +customcodepage = +dbcs = true +dos clipboard device enable = false +dos clipboard device name = CLIP$ +dos clipboard api = false +dos idle api = true [ipx] # ipx: Enable ipx over UDP/IP emulation. diff --git a/dosbox-x.reference.full.conf b/dosbox-x.reference.full.conf index ec11f9640..a3acc6810 100644 --- a/dosbox-x.reference.full.conf +++ b/dosbox-x.reference.full.conf @@ -700,6 +700,9 @@ monochrome_pal = green # pc-98 show graphics layer on initialize: If PC-98 mode and INT 33h emulation is enabled, the graphics layer will be automatically enabled # at driver startup AND when INT 33h AX=0 is called. This is NEC MOUSE.COM behavior and default # enabled. To emulate other drivers like QMOUSE that do not follow this behavior, set to false. +# pc-98 chargen vsync-limited access: If set, reading pixels from the character generator while in Code Access mode (or always, for ANK +# characters) will be invalid. Some models (i.e. PC-9821As3) dont seem to have this limitation, but +# many others do. pc-98 BIOS copyright string = false pc-98 int 1b fdc timer wait = false pc-98 pic init to read isr = true @@ -732,6 +735,7 @@ pc-98 fontx sbcs = pc-98 fontx dbcs = pc-98 fontx internal symbol = false pc-98 show graphics layer on initialize = true +pc-98 chargen vsync-limited access = true [dosv] # dosv: Enable DOS/V emulation and specify which version to emulate. This option is intended for use with games or software @@ -1891,7 +1895,7 @@ goldplay = true goldplay stereo = true dsp require interrupt acknowledge = auto dsp write busy delay = -1 -blaster environment variable = true +blaster environment variable = false sample rate limits = true instant direct dac = false stereo control with sbpro only = true @@ -2327,6 +2331,7 @@ timeout = 0 # turn off a20 gate on load if loadfix needed: If enabled, and loading a program below the 64kb boundary, turn off the A20 gate. # This can help with any program with startup code that assumes the segment wraparound of the 8086. # Depending on DOS configuration the A20 gate may be re-enabled later such as calling INT 21h. +# xms log memmove: If set, XMS move/copy operations are logged for debugging purposes. # xms memmove causes flat real mode: If set, any call to XMS to move/copy memory sets up flat real mode for segment registers DS and ES. # xms init causes flat real mode: If set, when the DOS kernel initializes XMS it will switch on flat real mode for segment registers DS and ES if appropriate. # resized free memory block becomes allocated: If set, and the DOS application resizes a freed memory block, that block will be marked as allocated to that program. @@ -2388,6 +2393,7 @@ timeout = 0 # network redirector: Report DOS network redirector as resident. This will allow the host name to be returned unless the secure mode is enabled. # You can also directly access UNC network paths in the form \\MACHINE\SHARE even if they are not mounted as drives on Windows systems. # Set either "ipx=true" in [ipx] section or "ne2000=true" in [ne2000] section for a full network redirector environment. +# mcb corruption becomes application free memory: If MCB chain corruption occurs following the DOS program PSP segment and the DOS program does anything to cause memory allocation,make a new free memory block in it's place instead of halting emulation with an MCB chain error. Some DOS programs are sloppywith memory to corrupt the MCB chain after itself in memory. This is apparently real MS-DOS behavior, set to true to enable.If set to false, all MCB chain corruption will halt emulation as DOSBox forks typically do already. # minimum dos initial private segment: In non-mainline mapping mode, where DOS structures are allocated from base memory, this sets the # minimum segment value. Recommended value is 0x70. You may reduce the value down to 0x50 if freeing # up more memory is important. Set to 0 for default. @@ -2565,6 +2571,7 @@ timeout = 0 # dos idle api: If set, DOSBox-X can lower the host system's CPU load when a supported guest program is idle. xms = true turn off a20 gate on load if loadfix needed = false +xms log memmove = false xms memmove causes flat real mode = true xms init causes flat real mode = false resized free memory block becomes allocated = true @@ -2593,6 +2600,7 @@ cpm compatibility mode = auto share = true file access tries = 0 network redirector = true +mcb corruption becomes application free memory = false minimum dos initial private segment = 0 minimum mcb segment = 0 minimum mcb free = 0