Difference between revisions of "Usage"
From DOSBoxWiki
Jump to navigationJump to searchm |
|||
| Line 3: | Line 3: | ||
===Usage=== | ===Usage=== | ||
| − | ;<code>name</code>: If <code>name</code> is a directory, DOSBox | + | ;<code>name</code>: If <code>name</code> is a directory, DOSBox will mount the specified directory as the C drive.<br /> If <code>name</code> is an executable, DOSBox will mount the directory of <code>name</code> as the C drive, and start executing <code>name</code>. |
| − | ;<code>-exit</code>: DOSBox will | + | ;<code>-exit</code>: DOSBox will close itself when the DOS application "name" ends. |
| − | ;<code>-c command</code>: Runs the specified command before running <code>name</code>. Multiple commands can be specified. Each command should start with <code>-c</code> though. | + | ;<code>-c command</code>: Runs the specified command before running <code>name</code>. Multiple commands can be specified. Each command should start with <code>-c</code> though. A command can be: an Internal Program, a DOS command or an executable on a mounted drive. |
| Line 15: | Line 15: | ||
| − | ;<code>- | + | ;<code>-userconf</code>: Start DOSBox with the options specified in "configfilelocation". Multiple -conf options may be present. |
| − | ;<code>- | + | ;<code>-conf configfilelocation</code>: Start DOSBox with the options specified in <code>configfilelocation</code>. Multiple -conf options may be present. |
| − | ;<code>-machine machinetype</code>: Setup DOSBox to emulate a specific type of machine. Valid choices are: hercules, cga, tandy, | + | ;<code>-lang languagefilelocation</code>: Start DOSBox using the language string specified in <code>languagefilelocation</code>. |
| + | |||
| + | |||
| + | ;<code>-machine machinetype</code>: Setup DOSBox to emulate a specific type of machine. Valid choices are: hercules, cga, ega, pcjr, tandy, svga_s3 (default) as well as the additional svga chipsets listed in the [[dosbox.conf|DOSBox configuration file]]. The machinetype affects the video card and the available sound cards. | ||
;<code>-noconsole</code> (Windows Only): Start DOSBox without showing the console window, output will be redirected to <code>stdout.txt</code> and <code>stderr.txt</code>. This is useful if DOSBox crashes, since the error messages stored in <code>stdout.txt</code> and <code>stderr.txt</code> may help the developers fixing the problem. | ;<code>-noconsole</code> (Windows Only): Start DOSBox without showing the console window, output will be redirected to <code>stdout.txt</code> and <code>stderr.txt</code>. This is useful if DOSBox crashes, since the error messages stored in <code>stdout.txt</code> and <code>stderr.txt</code> may help the developers fixing the problem. | ||
| + | |||
| + | |||
| + | ;<code>-startmapper</code>: Enter the [[Mapper|mapper]] directly on startup. Useful for people with keyboard or joystick problems. | ||
| + | |||
| + | |||
| + | ;<code>-noautoexec</code>: Skips the [autoexec] section of the loaded configuration file. | ||
| + | |||
| + | |||
| + | ;<code>-securemode</code>: Same as -noautoexec, but adds config.com <code>-securemode</code> at the bottom of AUTOEXEC.BAT (which in turn disables any changes to how the drives are mounted inside DOSBox). | ||
===Notes=== | ===Notes=== | ||
| − | *If a <code>name/ command/ | + | *If a <code>name/ command/ configfilelocation/ languagefilelocation</code> contains a space in it, put the whole <code>name/ command/ configfilelocation/ languagefilelocation</code> between quotes ("example"). |
*In Windows you can also drag directories/files onto the DOSBox executable. | *In Windows you can also drag directories/files onto the DOSBox executable. | ||
Revision as of 15:43, 2 November 2010
Command Line Parameters
dosbox [name] [-exit] [-c command] [-fullscreen] [-userconf] [-conf congfigfilelocation] [-lang languagefilelocation] [-machine machine type] [-noconsole] [-startmapper] [-noautoexec] [-securemode] [-scaler scaler | -forcescaler scaler] [-version] [-socket socket] [-editconf program] [-opencaptures program] [-printconf] [-eraseconf] [-erasemapper]
Usage
name- If
nameis a directory, DOSBox will mount the specified directory as the C drive.
Ifnameis an executable, DOSBox will mount the directory ofnameas the C drive, and start executingname.
-exit- DOSBox will close itself when the DOS application "name" ends.
-c command- Runs the specified command before running
name. Multiple commands can be specified. Each command should start with-cthough. A command can be: an Internal Program, a DOS command or an executable on a mounted drive.
-fullscreen- Starts DOSBox in fullscreen mode.
-userconf- Start DOSBox with the options specified in "configfilelocation". Multiple -conf options may be present.
-conf configfilelocation- Start DOSBox with the options specified in
configfilelocation. Multiple -conf options may be present.
-lang languagefilelocation- Start DOSBox using the language string specified in
languagefilelocation.
-machine machinetype- Setup DOSBox to emulate a specific type of machine. Valid choices are: hercules, cga, ega, pcjr, tandy, svga_s3 (default) as well as the additional svga chipsets listed in the DOSBox configuration file. The machinetype affects the video card and the available sound cards.
-noconsole(Windows Only)- Start DOSBox without showing the console window, output will be redirected to
stdout.txtandstderr.txt. This is useful if DOSBox crashes, since the error messages stored instdout.txtandstderr.txtmay help the developers fixing the problem.
-startmapper- Enter the mapper directly on startup. Useful for people with keyboard or joystick problems.
-noautoexec- Skips the [autoexec] section of the loaded configuration file.
-securemode- Same as -noautoexec, but adds config.com
-securemodeat the bottom of AUTOEXEC.BAT (which in turn disables any changes to how the drives are mounted inside DOSBox).
Notes
- If a
name/ command/ configfilelocation/ languagefilelocationcontains a space in it, put the wholename/ command/ configfilelocation/ languagefilelocationbetween quotes ("example"). - In Windows you can also drag directories/files onto the DOSBox executable.
Example
dosbox c:\atlantis\atlantis.exe -c "MOUNT D C:\SAVES"
This would mount c:\atlantis as c:\ and run atlantis.exe. Before it does that, it would first mount C:\SAVES as the D drive.