- experimental 2023.05.01+dfsg-1~exp1
DOSBOX-X(1) | dosbox-x | DOSBOX-X(1) |
NAME¶
dosbox-x - a x86/DOS and PC98 emulator
SYNOPSIS¶
dosbox-x [OPTIONS] [FILE]
DESCRIPTION¶
This manual page briefly documents DOSBox-X, an x86/DOS and PC98 emulator.
Options are listed below. Depending on the option, one or more may be specified.
The optional FILE argument should be a DOS executable or a directory. If it is a DOS executable (.com .exe .bat), the program will run automatically. If it is a directory, the directory specified will be mounted as the C:\ drive. If the DOS executable requires parameters, enclose the command and it’s parameters in quotes.
For an introduction type INTRO inside dosbox-x.
OPTIONS¶
A summary of available options.
-?, -h or -help
-v, -ver or -version
-fullscreen, -fs
-machine machinetype
IBM Monochrome Display Adapter (text only)
Hercules Graphics Card (monochrome)
IBM Color Graphics Adapter, with automatic RGB/Composite switching.
IBM CGA attached to a monochrome display
IBM CGA attached to an RGB monitor
IBM CGA (early revision) attached to an NTSC TV
IBM CGA (late revision) attached to an NTSC TV
IBM PCjr
IBM PCjr (late revision) attached to NTSC TV
IBM PCjr (late revision) attached to NTSC TV
Tandy 1000 Graphics Adapter
Amstrad PC1512 graphics mode
IBM Enhanced Graphics Adapter
Japanese Enhanced Graphics Adapter (Microsoft AX)
IBM Multi-Color Graphics Array
IBM Video Graphics Array (see below)
SVGA - Paradise Systems PVGA1A
SVGA - Tseng Labs ET3000
SVGA - Tseng Labs ET4000
VESA SVGA - S3 Trio64 - VBE 2.0
VESA SVGA - S3 86c928 - VBE 2.0 (experimental)
VESA SVGA - S3 Vision 864 - VBE 2.0
VESA SVGA - S3 Vision 868 - VBE 2.0
VESA SVGA - S3 Vision 964 - VBE 2.0
VESA SVGA - S3 Vision 968 - VBE 2.0
VESA SVGA - S3 Trio32 - VBE 2.0
VESA SVGA - S3 Trio64 - VBE 2.0 (same as svga_s3)
VESA SVGA - S3 Trio64V+ - VBE 2.0
VESA SVGA - S3 ViRGE - VBE 2.0 (experimental)
VESA SVGA - S3 ViRGE VX - VBE 2.0 (experimental)
VESA SVGA - S3 Trio64 with VESA BIOS Extensions (VBE) 1.2
VESA SVGA - S3 Trio64 with VESA BIOS Extensions (VBE) 1.0
VESA SVGA - S3 Trio64 with VBE 2.0 with Linear Frame Buffer disabled
Japanese NEC PC-98 emulation
same as pc98
same as pc98
Japanese Fujitsu FM Towns (not implemented)
The default is svga_s3.
For some special VGA effects the machinetype vgaonly can be used, note that this disables SVGA capabilities and might be slower due to the higher emulation accuracy.
Note
The machinetype affects not only the emulated video card, but may also effect the available sound cards.
-conf configfile
-editconf [editor]
-userconf
-printconf
-eraseconf, -resetconf
-erasemapper, -resetmapper
-opencaptures program
-opensaves program
-startui, -startgui or -starttool
-startmapper
-promptfolder
-nopromptfolder
-nogui or -nomenu
-showcycles
-showrt
-socket socketnumber
-savedir path
-defaultdir path
-defaultconf
-defaultmapper
-data-host-forced
-display2 [color]
-lang message_file
-nodpiaware
-securemode
-prerun
-hostrun
-noconfig
-noautoexec
-exit
-silent
-o option(s)
-c command
-set section property=value
-time-limit seconds
-fastlaunch
-helpdebug
INTERNAL INTERPRETER COMMANDS¶
dosbox-x Supports most of the internal DOS commands found in COMMAND.COM. Help text is integrated for these commands in DOSBox-X, and will not be duplicated here. An explanation of these commands can also be found on the DOSBox-X wiki on the Supported Commands page.
ALIAS, ATTRIB, BREAK, CALL, CD/CDDIR, CHCP, CHOICE, CLS, COPY, COUNTRY, CTTY, DATE, DEL/ERASE, DELTREE, ECHO, EXIT, DIR, FOR, GOTO, HELP, IF, LFNFOR, LH/LOADHIGH, MD/MKDIR, MORE, PATH, PAUSE, PROMPT, RD/RMDIR, REM, REN/RENAME, SET, SHIFT, SUBST, TIME, TRUENAME, TYPE, VER, VERIFY, VOL
OTHER PROVIDED COMMANDS¶
In addition, the following extra commands are available on the emulated Z: drive:
Note
Some commands (like NE2000) are only present in case the corresponding feature is enabled.
4DOS, 4HELP, OPTION, BATCOMP
EVAL, SHUTDOWN, DSXMENU, CWSDPMI, EMSMAGIC, UNZIP, ZIP, MPXPLAY, DOSMID, CDPLAY, DOS4GW, DOS32A, DOSIDLE, UTF16, UTF8, AUTOTYPE, ADDKEY, LS, TITLE, COLOR, SETCOLOR
MEM, EDIT, PRINT, DISKCOPY, DEFRAG, FORMAT, FDISK, SYS, FC, COMP, CHKDSK, BUFFERS, DEVICE, APPEND, XCOPY, SORT, REPLACE, LASTDRIV, FILES, FCBS, FIND, MOVE, DEBUG, EDLIN, CHOICE, DELTREE, TREE, LABEL, LOADFIX, MOUSE, MODE, KEYB
HEXMEM32, HEXMEM16, A20GATE, BIOSTEST, INT2FDBG, NMITEST, LOADROM, VESAMOED, VFRCRATE
PARALLEL, SERIAL, MIXER, CAPMOUSE, FLAGSAVE, CFGTOOL, RESCAN, RE-DOS, COUNTRY, CONFIG, BOOT, MOUNT, IMGSWAP, IMGMAKE, IMGMOUNT, INTRO, HELP, NE2000
CGA, CLR, EGA, VGA, DCGA, 132X25, 132X43, 132X50, 132X60, 80X25, 80X50, 80X60
SPECIAL KEYS¶
CTRL-F7
CTRL-F8
CTRL-SHIFT-F7
CTRL-SHIFT-F8
CTRL-F7
CTRL-F8
F12-F
F12-R
F12-B
F12-C
F12-M
F12-Esc
F12-Del
F12-{+}
F12-{-}
F12-]
F12-[
F12-{=}
F12-{-}
F12-Up
F12-Down
F12-Left
F12-Right
F12-D
F12-O
F12-P
F12-I
F12-W
F12-[,]
F12-[.]
F12-S
F12-L
F12-Pause
Ctrl+F5
Ctrl+F6
Ctrl+F9
Ctrl+F10
These are the default keybindings. They can be changed in the keymapper.
Saved/recorded files can be found in current_directory/capture (can be changed in the configfile). The directory has to exist prior to starting dosbox-x else nothing gets saved or recorded!
Note
Once you increase your dosbox-x cycles beyond your
computer’s maximum capacity, it will produce the same effect as
slowing down the emulation.
This maximum will vary from computer to computer, there is no standard.
ENVIRONMENT¶
Any configuration option can be overridden using an environment variable. Environment variables starting with prefix DOSBOX are processed and interpreted as follows: DOSBOX_SECTIONNAME_PROPERTYNAME=value
For example, you can override the render aspect this way:
$ DOSBOX_RENDER_ASPECT=false dosbox-x
BUGS¶
To report a bug, please visit <https://github.com/joncampbell123/dosbox-x/issues>
RESOURCES¶
project web site: <https://dosbox-x.com>
Project Wiki: <https://dosbox-x.com/wiki>
AUTHOR¶
DOSBox-X is maintained by the DOSBox-X Team
2022-04-26 | dosbox-x |