2009-05-03 00:08:43 +02:00
|
|
|
|
DOSBox v0.63
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
=====
|
|
|
|
|
NOTE:
|
|
|
|
|
=====
|
|
|
|
|
|
2009-05-02 23:53:27 +02:00
|
|
|
|
While we hope that, one day, DOSBox will run virtually all programs
|
|
|
|
|
ever made for the PC...we are not there yet. At present, DOSBox run on a high-
|
2009-05-03 00:02:15 +02:00
|
|
|
|
end machine will roughly be the equivalent of a 486 PC. The 0.60
|
2009-05-02 23:43:00 +02:00
|
|
|
|
release has added support for "protected mode" allowing for more complex and
|
|
|
|
|
recent programs, but note that this support is early in development and
|
|
|
|
|
nowhere near as complete as the support for 386 real-mode games (or
|
|
|
|
|
earlier). Also note that "protected mode" games need substantially more
|
|
|
|
|
resources and may require a much faster processor for you to run it properly
|
2009-05-02 23:53:27 +02:00
|
|
|
|
in DOSBox.
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
======
|
2009-05-03 00:02:15 +02:00
|
|
|
|
INDEX:
|
2009-05-02 23:03:37 +02:00
|
|
|
|
======
|
2009-05-03 00:02:15 +02:00
|
|
|
|
1. Quickstart
|
|
|
|
|
2. FAQ
|
|
|
|
|
3. Usage
|
|
|
|
|
4. Internal Programs
|
|
|
|
|
5. Special Keys
|
|
|
|
|
6. Keymapper
|
|
|
|
|
7. System Requirements
|
|
|
|
|
8. To run resource-demanding games
|
|
|
|
|
9. The config file
|
|
|
|
|
10. The language file
|
|
|
|
|
11. Building your own version of DOSBox
|
|
|
|
|
12. Special thanks
|
|
|
|
|
13. Contact
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
==============
|
|
|
|
|
1. Quickstart:
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
Type INTRO in DOSBox. That's it.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
=======
|
|
|
|
|
2. FAQ:
|
|
|
|
|
=======
|
|
|
|
|
|
|
|
|
|
Some Frequently Asked Questions:
|
|
|
|
|
|
|
|
|
|
Q: I've got a Z instead of a C at the prompt.
|
|
|
|
|
Q: My CD-ROM doesn't work.
|
|
|
|
|
Q: The mouse doesn't work.
|
|
|
|
|
Q: The sound stutters.
|
|
|
|
|
Q: I can't type \ or : in DOSBox.
|
|
|
|
|
Q: The game/application can't find its CD-ROM.
|
|
|
|
|
Q: The game/application runs much too slow!
|
|
|
|
|
Q: I would like to change the memory size/cpu speed/ems/soundblaster IRQ.
|
|
|
|
|
Q: What sound hardware does DOSBox presently emulate?
|
2009-05-03 00:08:43 +02:00
|
|
|
|
Q: DOSBox crashes on startup and I'm running arts
|
|
|
|
|
Q: Great README, but I still don't get it.
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: I've got a Z instead of a C at the prompt.
|
|
|
|
|
A: You have to make your directories available as drives in DOSBox by using
|
|
|
|
|
the "mount" command. For example, in Windows "mount C D:\" would give
|
|
|
|
|
you a C in DOSBox which points at your Windows D:\ drive.
|
|
|
|
|
In Linux, "mount c /home/username" would give you a C in DOSBox
|
|
|
|
|
which points at /home/username in Linux.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: My CD-ROM doesn't work.
|
|
|
|
|
A: To mount your cdrom in DOSBox you have to specify some additional options
|
|
|
|
|
when mounting the cdrom.
|
|
|
|
|
To enable the most basic cdrom support:
|
|
|
|
|
- mount d f:\ -t cdrom
|
|
|
|
|
To enable low-level SDL-support:
|
|
|
|
|
- mount d f:\ -t cdrom -usecd 0
|
|
|
|
|
To enable low-level ioctl-support(win2k/xp/linux):
|
|
|
|
|
- mount d f:\ -t cdrom -usecd 0 -ioctl
|
|
|
|
|
To enable low-level aspi-support (win98 with aspi-layer installed):
|
|
|
|
|
- mount d f:\ -t cdrom -usecd 0 -apsi
|
|
|
|
|
|
|
|
|
|
In the commands: - d driveletter you in DOSBox
|
|
|
|
|
- f:\ location of cdrom on your PC.
|
|
|
|
|
- 0 The number of the cdrom drive, reported by mount -cd
|
|
|
|
|
See also the question: The game/application can't find its CD-ROM.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: The mouse doesn't work.
|
|
|
|
|
A: Normally DOSBox detects the mouse being used by a game. If you click on
|
2009-05-03 00:08:43 +02:00
|
|
|
|
the screen then it should get locked (confined to the DOSBox window)
|
|
|
|
|
and work. Sometimes the DOSBox mouse detection doesn't work with certain
|
|
|
|
|
games. You might have to force to lock the mouse then with ctrl-F10.
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: The sound stutters.
|
|
|
|
|
A: You're using too much cpu power to keep DOSBox running at the current speed.
|
|
|
|
|
You can either lower the cycles or skip frames or get a faster machine.
|
|
|
|
|
You can also increase the prebuffer in the configfile
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: I can't type \ or : in DOSBox.
|
|
|
|
|
A: This is a known problem. It only occurs if your keyboard layout isn't US.
|
|
|
|
|
Some possible fixes:
|
|
|
|
|
1. Switch your keyboard layout.
|
|
|
|
|
2. Use / instead.
|
2009-05-03 00:08:43 +02:00
|
|
|
|
3. Add the commands you want to execute to the "configfile".
|
2009-05-03 00:02:15 +02:00
|
|
|
|
4. Start the keymapper (CTRL-F1 or add -startmapper switch to dosbox)
|
|
|
|
|
5. for \ try the keys around "enter". For ":" try shift and the keys between
|
|
|
|
|
"enter" and "l" (US keyboard layout).
|
2009-05-03 00:08:43 +02:00
|
|
|
|
6. Use keyb.com from FreeDOS (http://projects.freedos.net/keyb/).
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: The game/application can't find its CD-ROM.
|
|
|
|
|
A: Be sure to mount the CD-ROM with -t cdrom switch. Also try adding the
|
|
|
|
|
correct label (-label LABEL). To enable more low-level CD-ROM support add
|
|
|
|
|
the following switch to mount: -usecd #, where # is the number of your
|
|
|
|
|
CD-ROM drive reported by mount -cd. If you run Win32 you can specify -ioctl
|
|
|
|
|
or -aspi. Look at the description elsewhere in this document for their
|
|
|
|
|
meaning.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: The game/application runs much too slow!
|
|
|
|
|
A: Look at the section "To run resource-demanding games" for more information.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: I would like to change the memory size/cpu speed/ems/soundblaster IRQ.
|
2009-05-03 00:08:43 +02:00
|
|
|
|
A: This is possible! Just create a config file: config -writeconf configfile .
|
2009-05-03 00:02:15 +02:00
|
|
|
|
Start your favourite editor and look at all the settings present. To
|
2009-05-03 00:08:43 +02:00
|
|
|
|
start DOSBox with your new settings: dosbox -conf configfile
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Q: What sound hardware does DOSBox presently emulate?
|
|
|
|
|
A: DOSBox emulates several legacy sound devices:
|
|
|
|
|
- Internal PC speaker
|
|
|
|
|
This emulation includes both the tone generator and several forms of
|
|
|
|
|
digital sound output through the internal speaker.
|
|
|
|
|
- Creative CMS/Gameblaster
|
|
|
|
|
The is the first card released by Creative Labs(R). The default
|
|
|
|
|
configuration places it on port 0x220. It should be noted that enabling
|
|
|
|
|
this with the Adlib emulation may result in conflicts.
|
|
|
|
|
- Tandy 3 voice
|
|
|
|
|
The emulation of this sound hardware is complete with the exception of
|
|
|
|
|
the noise channel, which is not very well documented and as such is only
|
|
|
|
|
a best guess as to the sound's accuracy.
|
|
|
|
|
- Adlib
|
|
|
|
|
Borrowed from MAME, this emulation is almost perfect and includes the
|
|
|
|
|
Adlib's ability to almost play digitized sound.
|
2009-05-03 00:08:43 +02:00
|
|
|
|
- SoundBlaster 16/ SoundBlaster Pro I & II /Sound Blaster I & II
|
|
|
|
|
Coupled with the Adlib, by default DOSBox provides Soundblaster 16
|
|
|
|
|
level 16-bit stereo sound. You can select a different SoundBlaster
|
|
|
|
|
version in the configfile of DOSBox (See Internal Commands: CONFIG).
|
2009-05-03 00:02:15 +02:00
|
|
|
|
- Disney Soundsource
|
|
|
|
|
Using the printer port, this sound device outputs digital sound only.
|
|
|
|
|
- Gravis Ultrasound
|
|
|
|
|
The emulation of this hardware is nearly complete, though the MIDI
|
|
|
|
|
capabilities have been left out since an MPU-401 has been
|
|
|
|
|
emulated in other code.
|
|
|
|
|
- MPU-401
|
|
|
|
|
A MIDI passthrough interface is also emulated. This method of sound
|
|
|
|
|
output will only work when used with a General Midi or MT-32 device.
|
|
|
|
|
|
2009-05-03 00:08:43 +02:00
|
|
|
|
Q: DOSBox crashes on startup and I'm running arts
|
|
|
|
|
A: This isn't really a DOSBox problem, but the solution is to set the
|
|
|
|
|
environment variable SDL_AUDIODRIVER to alsa or oss.
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
Q: Great README, but I still don't get it.
|
|
|
|
|
A: While unlikely, this seems to happen. A look at "The Newbie's
|
|
|
|
|
pictorial guide to DOSBox" located at
|
|
|
|
|
http://vogons.zetafleet.com/viewforum.php?f=39 might help you.
|
2009-05-03 00:08:43 +02:00
|
|
|
|
You could also try the wiki of dosbox:
|
|
|
|
|
http://dosbox.sourceforge.net/wiki/
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For more questions read the remainder of this README and/or check
|
|
|
|
|
the site/forum:
|
|
|
|
|
http://dosbox.sourceforge.net
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
=========
|
|
|
|
|
3. Usage:
|
|
|
|
|
=========
|
|
|
|
|
|
2009-05-03 00:08:43 +02:00
|
|
|
|
An overview of the commandline options you can give to DOSBox.
|
|
|
|
|
Windows Users must open cmd.exe or command.com or edit the shortcut to
|
|
|
|
|
dosbox.exe for this.
|
|
|
|
|
The options are valid for all operating systems unless noted in the option
|
|
|
|
|
description:
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
dosbox [name] [-exit] [-c command] [-fullscreen] [-conf congfigfile]
|
2009-05-02 23:53:27 +02:00
|
|
|
|
[-lang languagefile] [-machine machinetype] [-noconsole]
|
2009-05-03 00:02:15 +02:00
|
|
|
|
[-startmapper]
|
|
|
|
|
|
|
|
|
|
dosbox -version
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
name
|
|
|
|
|
If "name" is a directory it'll mount that as the C: drive.
|
|
|
|
|
If "name" is an executable it'll mount the directory of "name"
|
|
|
|
|
as the C: drive and execute "name".
|
|
|
|
|
|
|
|
|
|
-exit
|
2009-05-03 00:08:43 +02:00
|
|
|
|
dosbox will close itself when the DOS application "name" ends.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
-c command
|
|
|
|
|
Runs the specified command before running "name". Multiple commands
|
|
|
|
|
can be specified. Each command should start with -c though.
|
2009-05-03 00:08:43 +02:00
|
|
|
|
A command can be: an Internal Program, a DOS command or an executable
|
|
|
|
|
on a mounted drive.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
-fullscreen
|
|
|
|
|
Starts dosbox in fullscreen mode.
|
|
|
|
|
|
|
|
|
|
-conf configfile
|
|
|
|
|
Start dosbox with the options specified in "configfile".
|
2009-05-03 00:08:43 +02:00
|
|
|
|
See Chapter 9 for more details.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
-lang languagefile
|
2009-05-03 00:08:43 +02:00
|
|
|
|
Start dosbox using the language specified in "languagefile".
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
-noconsole (Windows Only)
|
2009-05-03 00:02:15 +02:00
|
|
|
|
Start dosbox without showing the console window. Output will
|
2009-05-02 23:43:00 +02:00
|
|
|
|
be redirected to stdout.txt and stderr.txt
|
2009-05-02 23:53:27 +02:00
|
|
|
|
|
|
|
|
|
-machine machinetype
|
|
|
|
|
Setup dosbox to emulate a specific type of machine. Valid choices are:
|
2009-05-03 00:08:43 +02:00
|
|
|
|
hercules, cga, tandy, vga (default). The machinetype has influence on
|
|
|
|
|
both the videocard and the available soundcards.
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
-startmapper
|
|
|
|
|
Enter the keymapper directly on startup. Useful for people with
|
|
|
|
|
keyboard problems.
|
2009-05-02 23:53:27 +02:00
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
-version
|
|
|
|
|
output version information and exit. Useful for frontends.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
Note: If a name/command/configfile/languagefile contains a space in it, put
|
2009-05-03 00:08:43 +02:00
|
|
|
|
the whole name/command/configfile/languagefile between quotes
|
|
|
|
|
("command or file name").
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:35:44 +02:00
|
|
|
|
For example:
|
|
|
|
|
|
|
|
|
|
dosbox c:\atlantis\atlantis.exe -c "MOUNT D C:\SAVES"
|
2009-05-02 23:43:00 +02:00
|
|
|
|
This would mount c:\atlantis as c:\ and run atlantis.exe.
|
2009-05-02 23:35:44 +02:00
|
|
|
|
Before it does that it would first mount C:\SAVES as the D drive.
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
In Windows you can also drag directories/files onto the dosbox executable.
|
|
|
|
|
|
|
|
|
|
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
=====================
|
|
|
|
|
4. Internal Programs:
|
|
|
|
|
=====================
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:53:27 +02:00
|
|
|
|
DOSBox supports most of the DOS commands found in command.com.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
In addition, the following commands are available:
|
|
|
|
|
|
|
|
|
|
MOUNT "Emulated Drive letter" "Real Drive or Directory"
|
|
|
|
|
[-t type] [-aspi] [-ioctl] [-usecd number] [-size drivesize]
|
2009-05-03 00:08:43 +02:00
|
|
|
|
[-label drivelabel] [-freesize size_in_mb]
|
2009-05-02 23:43:00 +02:00
|
|
|
|
MOUNT -cd
|
2009-05-03 00:08:43 +02:00
|
|
|
|
MOUNT -u "Emulated Drive letter"
|
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
Program to mount local directories as drives inside DOSBox.
|
|
|
|
|
|
|
|
|
|
"Emulated Drive letter"
|
|
|
|
|
The driveletter inside dosbox (eg. C).
|
|
|
|
|
|
|
|
|
|
"Real Drive letter or Directory"
|
|
|
|
|
The local directory you want to have inside dosbox.
|
|
|
|
|
(Under Win32 usually the same as "Emulated Drive letter".
|
|
|
|
|
For Example: mount c c:\ )
|
|
|
|
|
|
|
|
|
|
-t type
|
|
|
|
|
Type of the mounted directory. Supported are: dir (standard),
|
|
|
|
|
floppy, cdrom.
|
|
|
|
|
|
|
|
|
|
-size drivesize
|
2009-05-03 00:02:15 +02:00
|
|
|
|
Sets the size of the drive.
|
|
|
|
|
|
2009-05-03 00:08:43 +02:00
|
|
|
|
-freesize size_in_mb
|
2009-05-03 00:02:15 +02:00
|
|
|
|
Sets the amount of free space available on a drive in MB's. This
|
|
|
|
|
is a more simple version of -size.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
-label drivelabel
|
|
|
|
|
Sets the name of the drive to "drivelabel". Needed on some
|
|
|
|
|
systems if the cd label isn't read correctly. Useful when a
|
2009-05-03 00:08:43 +02:00
|
|
|
|
program can't find its cdrom. If you don't specify a label and no
|
|
|
|
|
lowlevel support is selected (-usecd # and/or -ioctl/aspi):
|
|
|
|
|
For win32: label is extracted from "Real Drive".
|
|
|
|
|
For Linux: label is set to NO_LABEL.
|
|
|
|
|
|
|
|
|
|
If you do specify a label this label will be kept as long as the drive
|
|
|
|
|
is mounted. It will not be updated !!
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
-aspi
|
|
|
|
|
Forces to use the aspi layer. Only valid if mounting a cdrom under
|
|
|
|
|
Windows systems with an ASPI-Layer.
|
|
|
|
|
|
|
|
|
|
-ioctl
|
|
|
|
|
Forces to use ioctl commands. Only valid if mounting a cdrom under
|
2009-05-03 00:02:15 +02:00
|
|
|
|
a Windows OS which support them (Win2000/XP/NT).
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
-usecd number
|
|
|
|
|
Forces to use SDL cdrom support for drive number.
|
|
|
|
|
Number can be found by -cd. Valid on all systems.
|
|
|
|
|
|
|
|
|
|
-cd
|
|
|
|
|
Displays all detected cdrom drives and their numbers. Use with -usecd.
|
|
|
|
|
|
2009-05-03 00:08:43 +02:00
|
|
|
|
-u
|
|
|
|
|
Removes the mount. Doesn't work for Z:\.
|
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
Note: It's possible to mount a local directory as cdrom drive.
|
|
|
|
|
Hardware support is then missing.
|
|
|
|
|
|
2009-05-02 23:53:27 +02:00
|
|
|
|
Basically, MOUNT allows you to connect real hardware to DOSBox's "emulated"
|
|
|
|
|
PC. So MOUNT C C:\ tells DOSBox to use your real C: drive as drive C: in
|
2009-05-03 00:02:15 +02:00
|
|
|
|
DOSBox. It also allows you to change the drive's letter identification for
|
2009-05-02 23:43:00 +02:00
|
|
|
|
programs that demand specific drive letters.
|
|
|
|
|
|
|
|
|
|
For example: Touche: Adventures of The Fifth Musketeer must be run on your C:
|
2009-05-03 00:02:15 +02:00
|
|
|
|
drive. Using DOSBox and its mount command, you can trick into thinking it
|
2009-05-02 23:43:00 +02:00
|
|
|
|
is on C drive while placing it where you want it. For example, if the game
|
|
|
|
|
were in D:\TOUCHE, you can use the command MOUNT C D:\ would allow you to
|
|
|
|
|
run Touche from the D drive.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
General MOUNT Examples:
|
2009-05-03 00:08:43 +02:00
|
|
|
|
1. To mount c:\DirX as a floppy :
|
|
|
|
|
mount a c:\DirX -t floppy
|
2009-05-03 00:02:15 +02:00
|
|
|
|
2. To mount system cdrom drive E as cdrom drive D in DOSBox:
|
2009-05-02 23:43:00 +02:00
|
|
|
|
mount d e:\ -t cdrom
|
|
|
|
|
3. To mount system cdrom drive at mountpoint /media/cdrom as cdrom drive D
|
|
|
|
|
in dosbox:
|
|
|
|
|
mount d /media/cdrom -t cdrom -usecd 0
|
2009-05-03 00:02:15 +02:00
|
|
|
|
4. To mount a drive with 870 mb free diskspace (simple version):
|
|
|
|
|
mount c d:\ -freesize 870
|
|
|
|
|
5. To mount a drive with 870 mb free diskspace (experts only, full control):
|
2009-05-02 23:43:00 +02:00
|
|
|
|
mount c d:\ -size 4025,127,16513,1700
|
2009-05-03 00:08:43 +02:00
|
|
|
|
6. To mount /home/user/dirY as drive C in DOSBox:
|
|
|
|
|
mount c /home/user/dirY
|
2009-05-02 23:35:44 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
MEM
|
|
|
|
|
Program to display the amount of free memory.
|
2009-05-02 23:35:44 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
CONFIG [-writeconf] [-writelang] localfile
|
|
|
|
|
Write the current configuration or language settings to file.
|
2009-05-03 00:08:43 +02:00
|
|
|
|
"localfile" is located on the local drive. Not a mounted drive in DOSBox.
|
|
|
|
|
|
|
|
|
|
The configuration file controls various settings of DOSBox: The amount
|
|
|
|
|
of emulated memory, the emulated soundcards and many more things. It
|
|
|
|
|
allows acces to AUTOEXEC.BAT as well.
|
|
|
|
|
See section 9 (The Config File) for more information.
|
|
|
|
|
|
|
|
|
|
The language file controls all visible ouput of the internal commands
|
|
|
|
|
and the internal dos.
|
2009-05-02 23:35:44 +02:00
|
|
|
|
|
2009-05-02 23:53:27 +02:00
|
|
|
|
Example:
|
|
|
|
|
To create a configfile in your current directory:
|
|
|
|
|
config -writeconf dosbox.conf
|
|
|
|
|
|
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
LOADFIX [-size] [program] [program-parameters]
|
|
|
|
|
LOADFIX -f
|
2009-05-03 00:08:43 +02:00
|
|
|
|
Program to reduce the amount of memory available. Useful for old programs
|
|
|
|
|
which don't expect much memory to be free.
|
2009-05-02 23:35:44 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
-size
|
|
|
|
|
number of kb to "eat up", default = 64kb
|
|
|
|
|
|
|
|
|
|
-f
|
|
|
|
|
frees all previously allocated memory
|
|
|
|
|
|
2009-05-02 23:20:05 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
Examples:
|
2009-05-03 00:08:43 +02:00
|
|
|
|
1. To start mm2.exe and allocate 64kb memory
|
|
|
|
|
(mm2 will have 64 kb less available) :
|
2009-05-02 23:43:00 +02:00
|
|
|
|
loadfix mm2
|
|
|
|
|
2. To start mm2.exe and allocate 32kb memory :
|
|
|
|
|
loadfix -32 mm2
|
|
|
|
|
3. To free previous allocated memory :
|
|
|
|
|
loadfix -f
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
RESCAN
|
|
|
|
|
Make DOSBox reread the directory structure. Useful if you changed something
|
2009-05-03 00:08:43 +02:00
|
|
|
|
on a mounted drive outside of DOSBox. (CTRL - F4 does this as well!)
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
MIXER
|
|
|
|
|
Makes DOSBox display its current volume settings.
|
|
|
|
|
You can change this way:
|
|
|
|
|
|
|
|
|
|
mixer channel left:right [/NOSHOW]
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
Can be one of the following: MASTER, DISNEY, SPKR, GUS, SB, FM.
|
|
|
|
|
|
|
|
|
|
left:right
|
|
|
|
|
The volume levels in percentages. If you put a D in front it will be
|
|
|
|
|
in deciBell (example mixer gus d-10).
|
|
|
|
|
|
|
|
|
|
/NOSHOW
|
|
|
|
|
Prevents DOSBox from showing the result if you set one
|
|
|
|
|
of the volume levels.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
IMGMOUNT
|
|
|
|
|
A utility to mount disk images and CD-ROM images in DOSBox.
|
|
|
|
|
|
|
|
|
|
IMGMOUNT DRIVE [imagefile] -t [image_type] -fs [image_format]
|
|
|
|
|
-size [sectorsbytesize, sectorsperhead, heads, cylinders]
|
|
|
|
|
|
|
|
|
|
imagefile
|
2009-05-03 00:08:43 +02:00
|
|
|
|
location of the image files to mount in DOSBox. The location is on a
|
|
|
|
|
mounted drive inside DOSBox. CD-ROM images can be mounted
|
|
|
|
|
directly as well. They don't need to be a mounted drive.
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
-t
|
|
|
|
|
The following are valid image types:
|
|
|
|
|
floppy: Specifies a floppy image or images. DOSBox will automatically
|
|
|
|
|
identify the disk geometry ( 360K, 1.2MB, 720K, 1.44MB, etc).
|
|
|
|
|
iso: Specifies a CD-ROM iso image. The geometry is automatic and
|
|
|
|
|
set for this size. This can be an iso or a cue/bin.
|
|
|
|
|
hdd: Specifies a harddrive image. The proper CHS geometry
|
|
|
|
|
must be set for this to work.
|
|
|
|
|
|
|
|
|
|
-fs
|
|
|
|
|
The following are valid file system formats:
|
|
|
|
|
iso: Specifies the ISO 9660 CD-ROM format.
|
|
|
|
|
fat: Specifies the image uses the FAT file system. DOSBox will attempt
|
|
|
|
|
to mount this image as a drive in DOSBox and make the files
|
|
|
|
|
available from inside DOSBox.
|
|
|
|
|
none: DOSBox will make no attempt to read the file system on the disk.
|
|
|
|
|
This is useful if one needs to format it or one wants to boot
|
|
|
|
|
off of the disk using the BOOT command. When using the "none"
|
|
|
|
|
filesystem, one must specify the drive number (2 or 3,
|
|
|
|
|
where 2 = master, 3 = slave) rather than a drive letter.
|
|
|
|
|
For example, to mount a 70MB image as the slave drive device,
|
|
|
|
|
one would type:
|
|
|
|
|
"imgmount 3 d:\test.img -size 512,63,16,142 -fs none"
|
|
|
|
|
(without the quotes) Compare this with a mount to read the
|
|
|
|
|
drive in DOSBox, which would read as:
|
|
|
|
|
"imgmount e: d:\test.img -size 512,63,16,142"
|
|
|
|
|
|
|
|
|
|
-size
|
|
|
|
|
The Cylinders, Heads and Sectors specification of the drive.
|
|
|
|
|
Required to mount hard drive images.
|
|
|
|
|
|
|
|
|
|
An example of CD-ROM images:
|
|
|
|
|
1a. mount c /tmp
|
|
|
|
|
1b. imgmount d c:\myiso.iso -t iso
|
|
|
|
|
or (which also works):
|
|
|
|
|
2. imgmount d /tmp/myiso.iso -t iso
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
BOOT
|
|
|
|
|
Boot will start floppy images or hard disk images independent of the
|
|
|
|
|
operating system emulation offered by DOSBox. This will allow you to play
|
|
|
|
|
booter floppies or boot to other operating systems inside DOSBox.
|
|
|
|
|
|
|
|
|
|
BOOT [diskimg1.img diskimg2.img .. diskimgN.img] [-l driveletter]
|
|
|
|
|
|
|
|
|
|
diskimgN.img
|
|
|
|
|
This can be any number of floppy disk images one wants mounted after
|
|
|
|
|
DOSBox boots the specified drive letter.
|
|
|
|
|
To swap between images, one hits CTRL+F4 to swap out the current disk
|
|
|
|
|
and swap in the next disk in the list. Once the last disk in the list is
|
|
|
|
|
swapped out, the list loops back to the beginning.
|
|
|
|
|
|
|
|
|
|
[-l driveletter]
|
|
|
|
|
This parameter allows one to specify the drive to boot from.
|
|
|
|
|
The default is the A drive, the floppy drive. One can also boot off of
|
|
|
|
|
a hard drive image mounted as master by specifying "-l C"
|
|
|
|
|
without the quotes, or the drive as slave by specifying "-l D"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
IPX
|
|
|
|
|
|
|
|
|
|
You need to enable IPX networking in the configuration file of DOSBox.
|
|
|
|
|
|
|
|
|
|
All of the IPX networking is managed through the internal DOSBox program
|
|
|
|
|
IPXNET. For help on the IPX networking from inside DOSBox, type
|
|
|
|
|
"IPXNET HELP" (without quotes) and the program will list out the commands
|
|
|
|
|
and relevant documentation.
|
|
|
|
|
|
|
|
|
|
With regard to actually setting up a network, one system needs to be
|
|
|
|
|
the server. To set this up, in a DOSBox session, one should type
|
|
|
|
|
"IPXNET STARTSERVER" (without the quotes). The server DOSBox session will
|
|
|
|
|
automatically add itself to the virtual IPX network. In turn, for every
|
|
|
|
|
other computer that should be part of the virtual IPX network,
|
|
|
|
|
you'll need to type "IPXNET CONNECT <computer host name or IP>".
|
|
|
|
|
For example, if your server is at bob.dosbox.com,
|
|
|
|
|
you would type "IPXNET CONNECT bob.dosbox.com" on every non-server system.
|
|
|
|
|
|
|
|
|
|
The following is an IPXNET command reference:
|
|
|
|
|
|
|
|
|
|
IPXNET CONNECT
|
|
|
|
|
|
|
|
|
|
IPXNET CONNECT opens a connection to an IPX tunneling server
|
|
|
|
|
running on another DOSBox session. The "address" parameter specifies
|
|
|
|
|
the IP address or host name of the server computer. One can also
|
|
|
|
|
specify the UDP port to use. By default IPXNET uses port 213, the
|
|
|
|
|
assigned IANA port for IPX tunneling, for its connection.
|
|
|
|
|
|
|
|
|
|
The syntax for IPXNET CONNECT is:
|
|
|
|
|
IPXNET CONNECT address <port>
|
|
|
|
|
|
|
|
|
|
IPXNET DISCONNECT
|
|
|
|
|
|
|
|
|
|
IPXNET DISCONNECT closes the connection to the IPX tunneling server.
|
|
|
|
|
|
|
|
|
|
The syntax for IPXNET DISCONNECT is:
|
|
|
|
|
IPXNET DISCONNECT
|
|
|
|
|
|
|
|
|
|
IPXNET STARTSERVER
|
|
|
|
|
|
|
|
|
|
IPXNET STARTSERVER starts and IPX tunneling server on this DOSBox
|
|
|
|
|
session. By default, the server will accept connections on UDP port
|
|
|
|
|
213, though this can be changed. Once the server is started, DOSBox
|
|
|
|
|
will automatically start a client connection to the IPX tunneling server.
|
|
|
|
|
|
|
|
|
|
The syntax for IPXNET STARTSERVER is:
|
|
|
|
|
IPXNET STARTSERVER <port>
|
|
|
|
|
|
|
|
|
|
IPXNET STOPSERVER
|
|
|
|
|
|
|
|
|
|
IPXNET STOPSERVER stops the IPX tunneling server running on this DOSBox
|
|
|
|
|
session. Care should be taken to ensure that all other connections have
|
|
|
|
|
terminated as well since stopping the server may cause lockups on other
|
|
|
|
|
machines still using the IPX tunneling server.
|
|
|
|
|
|
|
|
|
|
The syntax for IPXNET STOPSERVER is:
|
|
|
|
|
IPXNET STOPSERVER
|
|
|
|
|
|
|
|
|
|
IPXNET PING
|
|
|
|
|
|
|
|
|
|
IPXNET PING broadcasts a ping request through the IPX tunneled network.
|
|
|
|
|
In response, all other connected computers will respond to the ping
|
|
|
|
|
and report the time it took to receive and send the ping message.
|
|
|
|
|
|
|
|
|
|
The syntax for IPXNET PING is:
|
|
|
|
|
IPXNET PING
|
|
|
|
|
|
|
|
|
|
IPXNET STATUS
|
|
|
|
|
|
|
|
|
|
IPXNET STATUS reports the current state of this DOSBox's sessions
|
|
|
|
|
IPX tunneling network. For a list of the computers connected to the
|
|
|
|
|
network use the IPXNET PING command.
|
|
|
|
|
|
|
|
|
|
The syntax for IPXNET STATUS is:
|
|
|
|
|
IPXNET STATUS
|
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
For more information use the /? command line switch with the programs.
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
================
|
|
|
|
|
5. Special Keys:
|
|
|
|
|
================
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-03 00:08:43 +02:00
|
|
|
|
ALT-ENTER Go full screen and back.
|
|
|
|
|
CTRL-F1 Start the keymapper.
|
|
|
|
|
CTRL-F4 Swap mounted disk-image. Update directory cache for all drives!
|
|
|
|
|
CTRL-F5 Save a screenshot.(png)
|
|
|
|
|
CTRL-F6 Start/Stop recording sound output to a wave file.
|
|
|
|
|
CTRL-ALT-F7 Start/Stop recording of OPL commands.
|
|
|
|
|
CTRL-ALT-F8 Start/Stop the recording of raw MIDI commands.
|
|
|
|
|
CTRL-F7 Decrease frameskip.
|
|
|
|
|
CTRL-F8 Increase frameskip.
|
|
|
|
|
CTRL-F9 Kill dosbox.
|
|
|
|
|
CTRL-F10 Capture/Release the mouse.
|
|
|
|
|
CTRL-F11 Slow down emulation (Decrease DOSBox Cycles).
|
|
|
|
|
CTRL-F12 Speed up emulation (Increase DOSBox Cycles).
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
These are the default keybindings. They can be changed in the keymapper.
|
|
|
|
|
|
2009-05-03 00:08:43 +02:00
|
|
|
|
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 else nothing
|
|
|
|
|
gets saved/recorded !
|
|
|
|
|
|
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
NOTE: Once you increase your DOSBox 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.
|
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
=============
|
|
|
|
|
6. Keymapper:
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
When you start the keymapper (either with CTRL-F1 or -startmapper as a
|
2009-05-03 00:08:43 +02:00
|
|
|
|
commandline argument to the DOSBox executable) you are presented with
|
|
|
|
|
a virtual keyboard.
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
This virtual keyboard corresponds with the keys DOSBox will report to its
|
|
|
|
|
applications. If you click on a key with your mouse, you can see in the
|
|
|
|
|
lowerleft corner which key on your keyboard corresponds with it.
|
|
|
|
|
|
|
|
|
|
Event: EVENT
|
|
|
|
|
BIND: BIND
|
|
|
|
|
Add Del
|
|
|
|
|
mod1 hold Next
|
|
|
|
|
mod2
|
|
|
|
|
mod3
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EVENT
|
|
|
|
|
The key DOSBox will report to the applications being emulated.
|
|
|
|
|
BIND
|
|
|
|
|
The key on your keyboard (as reported by SDL) which is connected to the
|
|
|
|
|
EVENT.
|
|
|
|
|
mod1,2,3
|
|
|
|
|
Modfiers. These are keys you need to have pressed as well, while pressing
|
|
|
|
|
BIND. mod1 = CTRL and mod2 = ALT. These are generally only used when you
|
|
|
|
|
want to change the special keys of DOSBox.
|
|
|
|
|
Add
|
|
|
|
|
Add a new BIND to this EVENT. Basicly add a key from your keyboard which
|
|
|
|
|
will produce the key EVENT in DOSBox.
|
|
|
|
|
Del
|
|
|
|
|
Delete the BIND to this EVENT. If an EVENT has no BINDS than it's not
|
|
|
|
|
possible to type this key in DOSBox.
|
|
|
|
|
Next
|
|
|
|
|
Cycle through the list of keys(BINDS) which map to this EVENT.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
Q1. You want to have the X on your keyboard to type a Z in DOSBox.
|
|
|
|
|
A. With your mouse click on the Z on the keyboard mapper. Click "Add".
|
|
|
|
|
Now press the X key on your keyboard.
|
|
|
|
|
|
|
|
|
|
Q2. If you click "Next" a few times you will notice that the Z on your
|
|
|
|
|
keyboard also produces an Z in DOSBox.
|
|
|
|
|
A. Therefore select the Z again and click "Next" till you have the Z on
|
|
|
|
|
your keyboard. Now click "Del".
|
|
|
|
|
|
|
|
|
|
Q3. If you try it out in DOSBox you will notice that pressing X makes ZX
|
|
|
|
|
appear.
|
|
|
|
|
A. The X on your keyboard is still mapped to the X as well! Click on
|
|
|
|
|
the X in the keyboard mapper and search with "Next" till you find the
|
|
|
|
|
mapped key X. Click "Del".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
If you change the default mapping you can save your changes by pressing
|
|
|
|
|
"Save". DOSBox will save the mapping to location specified in the configfile
|
|
|
|
|
(mapperfile=mapper.txt). At startup DOSBox will load your mapperfile if it's
|
|
|
|
|
present in the configfile.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
=======================
|
|
|
|
|
7. System requirements:
|
|
|
|
|
=======================
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
Fast machine. My guess would be pentium-2 400+ to get decent emulation
|
2009-05-02 23:03:37 +02:00
|
|
|
|
of games written for an 286 machine.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
For protected mode games a 1 Ghz machine is recommended and don't expect
|
2009-05-03 00:08:43 +02:00
|
|
|
|
them to run fast though! Be sure to read the next section on how to speed
|
2009-05-02 23:43:00 +02:00
|
|
|
|
it up somewhat.
|
2009-05-02 23:35:44 +02:00
|
|
|
|
|
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
===================================
|
|
|
|
|
8. To run resource-demanding games:
|
|
|
|
|
===================================
|
2009-05-02 23:35:44 +02:00
|
|
|
|
|
|
|
|
|
DOSBox emulates the CPU, the sound and graphic cards, and some other
|
|
|
|
|
stuff, all at the same time. You can overclock DOSBox by using CTRL+F12, but
|
|
|
|
|
you'll be limited by the power of your actual CPU. You can see how much free
|
|
|
|
|
time your true CPU has by looking at the Task Manager in Windows 2000/XP and
|
|
|
|
|
the System Monitor in Windows 95/98/ME. Once 100% of your real CPU time is
|
|
|
|
|
used there is no further way to speed up DOSBox unless you reduce the load
|
|
|
|
|
generated by the non-CPU parts of DOSBox.
|
|
|
|
|
|
|
|
|
|
So:
|
|
|
|
|
|
|
|
|
|
Close every program but DOSBox
|
|
|
|
|
|
|
|
|
|
Overclock DOSBox until 100% of your CPU is used (use the utilities above to
|
|
|
|
|
check)
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:35:44 +02:00
|
|
|
|
Since VGA emulation is the most demanding part of DOSBox in terms of actual
|
|
|
|
|
CPU usage, we'll start here. Increase the number of frames skipped (in
|
|
|
|
|
increments of one) by pressing CRTL+F8. Your CPU usage should decrease.
|
|
|
|
|
Go back one step and repeat this until the game runs fast enough for you.
|
|
|
|
|
Please note that this is a trade off: you lose in fluidity of video what you
|
|
|
|
|
gain in speed
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:35:44 +02:00
|
|
|
|
You can also try to disable the sound through the setup utility of the game
|
|
|
|
|
to further reduce load on your CPU.
|
2009-05-02 23:20:05 +02:00
|
|
|
|
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
===================
|
|
|
|
|
9. The Config File:
|
|
|
|
|
===================
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
2009-05-02 23:53:27 +02:00
|
|
|
|
A config file can be generated by CONFIG.COM, which can be found on the
|
|
|
|
|
internal dosbox Z: drive when you start up dosbox. Look in the internal
|
|
|
|
|
programs section of the readme for usage of CONFIG.COM.
|
|
|
|
|
You can edit the generated configfile to customize DOSBox.
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
The file is divided into several sections (the names have [] around it).
|
|
|
|
|
Some sections have options which you can set.
|
2009-05-02 23:53:27 +02:00
|
|
|
|
# and % indicate comment-lines.
|
2009-05-02 23:43:00 +02:00
|
|
|
|
The generated configfile contains the current settings. You can alter them and
|
2009-05-02 23:53:27 +02:00
|
|
|
|
start DOSBox with the -conf switch to load the file and use these settings.
|
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
If no configfile is specified with the -conf switch, DOSBox will look in the
|
|
|
|
|
current directory for dosbox.conf. Then it will look for ~/.dosboxrc (Linux),
|
|
|
|
|
~\dosbox.conf (Win32) or "~/Library/Preferences/DOSBox Preferences" (MACOSX).
|
2009-05-02 23:53:27 +02:00
|
|
|
|
|
|
|
|
|
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
======================
|
|
|
|
|
10. The Language File:
|
|
|
|
|
======================
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
A language file can be generated by CONFIG.COM.
|
|
|
|
|
Read it and you will hopefully understand how to change it.
|
2009-05-02 23:53:27 +02:00
|
|
|
|
Start DOSBox with the -lang switch to use your new language file
|
2009-05-02 23:43:00 +02:00
|
|
|
|
or you can setup the filename in the config file in the [dosbox] section.
|
|
|
|
|
There's a language= entry that can be changed with the filename.
|
|
|
|
|
|
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
========================================
|
|
|
|
|
11. Building your own version of DOSBox:
|
|
|
|
|
========================================
|
2009-05-02 23:43:00 +02:00
|
|
|
|
|
|
|
|
|
Download the source.
|
2009-05-02 23:03:37 +02:00
|
|
|
|
Check the INSTALL in the source distribution.
|
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
===================
|
|
|
|
|
12. Special Thanks:
|
|
|
|
|
===================
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
|
|
|
|
Vlad R. of the vdmsound project for excellent sound blaster info.
|
|
|
|
|
Tatsuyuki Satoh of the Mame Team for making an excellent FM emulator.
|
|
|
|
|
The Bochs and DOSemu projects which I used for information.
|
|
|
|
|
Freedos for ideas in making my shell.
|
2009-05-02 23:53:27 +02:00
|
|
|
|
Pierre-Yves G<>rardy for hosting the old Beta Board.
|
|
|
|
|
Colin Snover for hosting our forum.
|
2009-05-02 23:27:47 +02:00
|
|
|
|
The Beta Testers.
|
2009-05-02 23:03:37 +02:00
|
|
|
|
|
|
|
|
|
|
2009-05-03 00:02:15 +02:00
|
|
|
|
|
|
|
|
|
============
|
|
|
|
|
13. Contact:
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
See the site:
|
2009-05-02 23:43:00 +02:00
|
|
|
|
http://dosbox.sourceforge.net
|
2009-05-03 00:02:15 +02:00
|
|
|
|
for an emailaddress (The Crew-page).
|