joncampbell123/dosbox-x
1
0
Fork 0
mirror of https://github.com/joncampbell123/dosbox-x.git synced 2025-10-14 02:17:36 +08:00
Code Issues Packages Projects Releases Wiki Activity

conf update

Browse Source
This commit is contained in:
Jonathan Campbell
2025-10-06 00:39:55 -07:00
parent b3dcbef9c3
commit 141fc3f3ec
3 changed files with 153 additions and 133 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
contrib/windows/installer/dosbox-x.reference.setup.conf
View File

@@ -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:# 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:# 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:# 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:# 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:# 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" #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:# enable pci bus: Enable PCI bus emulation
#DOSBOX-X-ADV-SEE:# #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:# 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:# #DOSBOX-X-ADV-SEE:#
language = language =
title = title =
@@ -503,6 +504,7 @@ forceloadstate = false
#DOSBOX-X-ADV:capture chroma format = auto #DOSBOX-X-ADV:capture chroma format = auto
#DOSBOX-X-ADV:capture format = default #DOSBOX-X-ADV:capture format = default
#DOSBOX-X-ADV:shell environment size = 0 #DOSBOX-X-ADV:shell environment size = 0
#DOSBOX-X-ADV:shell permanent = false
#DOSBOX-X-ADV:private area size = 32768 #DOSBOX-X-ADV:private area size = 32768
a20 = mask a20 = mask
#DOSBOX-X-ADV:turn off a20 gate on boot = true #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:# 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:# 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:# 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:#
#DOSBOX-X-ADV-SEE:# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details): #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:# #DOSBOX-X-ADV-SEE:#
pc-98 BIOS copyright string = false pc-98 BIOS copyright string = false
#DOSBOX-X-ADV:pc-98 int 1b fdc timer wait = 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 dbcs =
#DOSBOX-X-ADV:pc-98 fontx internal symbol = false #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 show graphics layer on initialize = true
#DOSBOX-X-ADV:pc-98 chargen vsync-limited access = true
[dosv] [dosv]
# dosv: Enable DOS/V emulation and specify which version to emulate. This option is intended for use with games or software # 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:goldplay stereo = true
#DOSBOX-X-ADV:dsp require interrupt acknowledge = auto #DOSBOX-X-ADV:dsp require interrupt acknowledge = auto
#DOSBOX-X-ADV:dsp write busy delay = -1 #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:sample rate limits = true
#DOSBOX-X-ADV:instant direct dac = false #DOSBOX-X-ADV:instant direct dac = false
#DOSBOX-X-ADV:stereo control with sbpro only = true #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:# 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:# 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:# 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 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:# 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. #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. # 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. # 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. # 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 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:# 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. #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. # 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:#
#DOSBOX-X-ADV-SEE:# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details): #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:# #DOSBOX-X-ADV-SEE:#
xms = true xms = true
#DOSBOX-X-ADV:turn off a20 gate on load if loadfix needed = false #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 memmove causes flat real mode = true
#DOSBOX-X-ADV:xms init causes flat real mode = false #DOSBOX-X-ADV:xms init causes flat real mode = false
#DOSBOX-X-ADV:resized free memory block becomes allocated = true #DOSBOX-X-ADV:resized free memory block becomes allocated = true
@@ -2659,6 +2668,7 @@ log console = false
share = true share = true
file access tries = 0 file access tries = 0
network redirector = true network redirector = true
mcb corruption becomes application free memory = false
#DOSBOX-X-ADV:minimum dos initial private segment = 0 #DOSBOX-X-ADV:minimum dos initial private segment = 0
#DOSBOX-X-ADV:minimum mcb segment = 0 #DOSBOX-X-ADV:minimum mcb segment = 0
minimum mcb free = 0 minimum mcb free = 0

254
dosbox-x.reference.conf
View File

@@ -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). # 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): # 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 BIOS copyright string = false
pc-98 fm board = auto pc-98 fm board = auto
@@ -807,7 +807,7 @@ retrowave_bus = serial
retrowave_port = retrowave_port =
hardwarebase = 220 hardwarebase = 220
goldplay = true goldplay = true
blaster environment variable = true blaster environment variable = false
[gus] [gus]
# gus: Enable the Gravis Ultrasound emulation. # gus: Enable the Gravis Ultrasound emulation.
@@ -1138,135 +1138,137 @@ shellhide = false
timeout = 0 timeout = 0
[dos] [dos]
# xms: Enable XMS support. # xms: Enable XMS support.
# xms handles: Number of XMS handles available for the DOS environment, or 0 to use a reasonable default # 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. # 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. # 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. # 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. # Compatibility with DOSBox SVN can be improved by enabling this option.
# hma: Report through XMS that HMA exists (not necessarily available) # 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. # 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. # 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. # 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. # 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. # 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. # 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. # 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. # 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). # 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. # 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. # 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. # 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. # 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. # 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. # 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. # 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 # 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.
# up to this point. This can be used to deal with EXEPACK issues or DOS programs that cannot # minimum mcb free: Minimum free segment value to leave free. At startup, the DOS kernel will allocate memory
# be loaded too low in memory. If you want more free conventional memory to be reported, # up to this point. This can be used to deal with EXEPACK issues or DOS programs that cannot
# you can for example set its value to 1. # be loaded too low in memory. If you want more free conventional memory to be reported,
# ems: Enable EMS support. The default (=true) provides the best # you can for example set its value to 1.
# compatibility but certain applications may run better with # ems: Enable EMS support. The default (=true) provides the best
# other choices, or require EMS support to be disabled (=false) # compatibility but certain applications may run better with
# to work at all. # other choices, or require EMS support to be disabled (=false)
# Possible values: true, emsboard, emm386, false, 1, 0. # to work at all.
# umb: Enable UMB support. # Possible values: true, emsboard, emm386, false, 1, 0.
# quick reboot: If set, the DOS restart call will reboot the emulated DOS (integrated DOS or guest DOS) instead of the virtual machine. # 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: # 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) # auto (or unset) Pick DOS kernel version 5.0 (DOSBox default)
# 3.3 MS-DOS 3.3 emulation (not tested!) # 3.3 MS-DOS 3.3 emulation (not tested!)
# 5.0 MS-DOS 5.0 emulation (recommended for DOS gaming) # 5.0 MS-DOS 5.0 emulation (recommended for DOS gaming)
# 6.22 MS-DOS 6.22 emulation # 6.22 MS-DOS 6.22 emulation
# 7.0 MS-DOS 7.0 (or Windows 95 pure DOS mode) 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 # 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). # 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. # 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. # 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. # 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. # 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. # 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. # 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. # Possible values: ask, auto, manual.
# shellhigh: Load the DOSBox-X command shell into the upper memory when the UMB is available. # 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. # 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. # Possible values: true, false, 1, 0, auto.
# automount: Enable automatic drive mounting in Windows. # automount: Enable automatic drive mounting in Windows.
# automountall: Automatically mount all available Windows drives at start. # automountall: Automatically mount all available Windows drives at start.
# Possible values: true, false, 1, 0, quiet. # 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. # 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. # 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 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. # 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. # 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. # 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. # 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. # 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". # 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. # 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). # 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. # 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. # 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. # 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. # 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). # 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. # 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/ # 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. # 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. # 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. # 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 "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. # 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. # 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. # 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). # 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. # 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. # 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 # 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. # 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): # 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 = true
xms handles = 0 xms handles = 0
shell configuration as commands = false shell configuration as commands = false
hma = true hma = true
hard drive data rate limit = -1 hard drive data rate limit = -1
floppy drive data rate limit = -1 floppy drive data rate limit = -1
ansi.sys = true ansi.sys = true
log console = false log console = false
share = true share = true
file access tries = 0 file access tries = 0
network redirector = true network redirector = true
minimum mcb free = 0 mcb corruption becomes application free memory = false
ems = true minimum mcb free = 0
umb = true ems = true
quick reboot = false umb = true
ver = quick reboot = false
lfn = auto ver =
fat32setversion = ask lfn = auto
shellhigh = auto fat32setversion = ask
automount = true shellhigh = auto
automountall = false automount = true
mountwarning = true automountall = false
autofixwarning = false mountwarning = true
startcmd = false autofixwarning = false
starttranspath = true startcmd = false
startwait = true starttranspath = true
startquiet = false startwait = true
startnopause = false startquiet = false
vmware = true startnopause = false
int33 = true vmware = true
mouse report rate = 0 int33 = true
keyboardlayout = auto mouse report rate = 0
customcodepage = keyboardlayout = auto
dbcs = true customcodepage =
dos clipboard device enable = false dbcs = true
dos clipboard device name = CLIP$ dos clipboard device enable = false
dos clipboard api = false dos clipboard device name = CLIP$
dos idle api = true dos clipboard api = false
dos idle api = true
[ipx] [ipx]
# ipx: Enable ipx over UDP/IP emulation. # ipx: Enable ipx over UDP/IP emulation.

10
dosbox-x.reference.full.conf
View File

@@ -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 # 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 # 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. # 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 BIOS copyright string = false
pc-98 int 1b fdc timer wait = false pc-98 int 1b fdc timer wait = false
pc-98 pic init to read isr = true pc-98 pic init to read isr = true
@@ -732,6 +735,7 @@ pc-98 fontx sbcs =
pc-98 fontx dbcs = pc-98 fontx dbcs =
pc-98 fontx internal symbol = false pc-98 fontx internal symbol = false
pc-98 show graphics layer on initialize = true pc-98 show graphics layer on initialize = true
pc-98 chargen vsync-limited access = true
[dosv] [dosv]
# dosv: Enable DOS/V emulation and specify which version to emulate. This option is intended for use with games or software # 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 goldplay stereo = true
dsp require interrupt acknowledge = auto dsp require interrupt acknowledge = auto
dsp write busy delay = -1 dsp write busy delay = -1
blaster environment variable = true blaster environment variable = false
sample rate limits = true sample rate limits = true
instant direct dac = false instant direct dac = false
stereo control with sbpro only = true 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. # 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. # 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. # 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 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. # 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. # 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. # 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. # 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. # 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 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 # 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. # 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. # dos idle api: If set, DOSBox-X can lower the host system's CPU load when a supported guest program is idle.
xms = true xms = true
turn off a20 gate on load if loadfix needed = false turn off a20 gate on load if loadfix needed = false
xms log memmove = false
xms memmove causes flat real mode = true xms memmove causes flat real mode = true
xms init causes flat real mode = false xms init causes flat real mode = false
resized free memory block becomes allocated = true resized free memory block becomes allocated = true
@@ -2593,6 +2600,7 @@ cpm compatibility mode = auto
share = true share = true
file access tries = 0 file access tries = 0
network redirector = true network redirector = true
mcb corruption becomes application free memory = false
minimum dos initial private segment = 0 minimum dos initial private segment = 0
minimum mcb segment = 0 minimum mcb segment = 0
minimum mcb free = 0 minimum mcb free = 0