Как прервать программу в досбокс

Как прервать программу в досбокс

DOSBox — эмулятор DOS для Linux. DOSBox позволяет запускать в окне или на полный экран игры и программы написанные для MS DOS.

Установка DOSBox в Linux Ubuntu:

Запуск эмулятора DOS DOSBox

По умолчанию DOSBox запускается в окне с разрешением 640×400 px.

Переключиться на полный экран можно клавишами Alt+Enter

Полный список горячих клавиш:

Полный список встроенных в DOSBox команд:

Команда	Действие
DIR
CHDIR
ATTRIB
CALL
CD
CHOICE
CLS
COPY
DEL
DELETE
ERASE
ECHO
EXIT
GOTO
HELP
IF
LOADHIGH
LH
MKDIR
MD
PATH
PAUSE
RMDIR	Удалить директорию
RD	Удалить директорию
REM
RENAME
REN
SET
SHIFT
SUBST
TYPE
VER

Полное описание и синтаксис каждой команды можно получить если указать в качестве параметра команды /? через пробел. Например:

Конфигурационный файл DOSBox

• Виртуализация

• Назад
• Вперед

• Вы здесь:  
• Главная />
• Desktop />
• DOSBox DOS под Linux

MS-DOS (основы)

Для того, чтобы запустить DOSBox, неоходимо выбрать меню Приложения→Игры→Эмулятор DOSBox. Эта программа достаточно корректно эмулирует операционную систему MS-DOS, однако надо учитывать, что в нём существуют некоторые ограничения. Однако для первых уроков программирования на ассемблере эта программа подходит идеально.

Команды MS-DOS

MS-DOS — дисковая операционная система. Поэтому большая часть команд связана с работой диска (создание каталогов, операции с файлами и т.д.). Диски в MS-DOS нумеруются также, как и в windows (точнее наоборот, в windows также, как в MS-DOS): диск A — дисковод гибких дисков, C, D и т.д. — локальные диски. Для последних версий появилась возможность подключать CD-ROM, но это требовало изрядного энтузиазма, да и не так уж много человек обладало в то время CD-ROM.

Список команд DOS

Материал из Википедии

Список команд DOS — нижеследующий список команд для операционной системы DOS. Начиная с 5-й версии, этот список с кратким описанием каждой команды может быть получен набором команды HELP. Также начиная с 5-й версии справка по конкретной команде может быть получена набором символов /? после имени команды.

Например, набор команды приведёт к получению справки по команде ren:

Переименование одного или нескольких файлов. Для конечного файла нельзя указать другой диск или каталог.

Все команды DOS являются нечувствительными к регистру букв, то есть любая команда может быть набрана как строчными, так и заглавными буквами.

Вывод и изменение атрибутов файлов. + Установка атрибута. — Снятие атрибута. R Атрибут «Только чтение». A Атрибут «Архивный». S Атрибут «Системный». H Атрибут «Скрытый». [диск:] [путь] [имя_файла] Указание файла или набора файлов для обработки. /S Обработка файлов с указанными именами в текущей папке и во всех ее подпапках. /D Обработка и файлов, и папок.

Эквивалентна команде Unix chmod.

Вывод имени либо смена текущего каталога. .. обозначает переход в родительский каталог.

Команда CD диск: отображает имя текущего каталога указанного диска. Команда CD без параметров отображает имена текущих диска и каталога.

Параметр /D используется для одновременной смены текущих диска и каталога.

Изменение команды CHDIR при включении расширенной обработки команд:

Имя текущего каталога в строке вызова преобразуется к тому же регистру символов, что и для существующих имен на диске. Так, команда CD C:\TEMP на самом деле сделает текущим каталог C:\Temp, если он существует на диске.

Команда CHDIR перестает рассматривать пробелы как разделители, что позволяет перейти в подкаталог, имя которого содержит пробелы, не заключая все имя каталога в кавычки. Например: приводит к тому же результату, что и: При отключении расширенной обработки команд используется только второй вариант.

Эквивалентна команде Unix cd (с параметрами), или pwd (без параметров).

Команды для работы с каталогами Чтобы команда сработала, нужно ее напечатать при помощи клавиатуры и нажать ENTER. В основном регистр не учитывается, то есть команды можно вводить как маленькими так и большими буквами. DOS не понимает длинные имена файлов, только в формате 8.3, то есть 8 символов в названии файла и 3 — в расширении. Обратите внимание на пробелы. Как правило, в DOS`e после пробела должен стоять параметр.

Команда	Формат	Описание	Параметры
dir	dir диск:\путь\имя_файла /параметры	Просмотр каталога	/p — поэкранный вывод, /W — вывод информации только об именах файлов (по пять в каждой строке)
md	md диск:\имя_каталога	Создание каталога
cd	cd диск:\имя_каталога	Смена текущего каталога
rd	rd диск:\имя_каталога	Удаление каталога
deltree	deltree имя_файла_или_имя_каталога	Удаление каталога со всем его содержимым
move	move диск: имя_каталога новое_имя_каталога	Переименование каталога
path	path диск1:\имя_каталога1;диск2:\имя_каталога2	Поиск

Набрав две точки (..) можно вернуться в предыдущий каталог, а при вводе \ — в корневой каталог.

dir — просмотр оглавления текущего каталога;

dir *.exe — выводится информация обо всех файлах с расширением EXE из текущего каталога;

cd c:\catalog — установить текущим каталог с именем catalog на диске C;

cd .. — переход на каталог выше;

cd\ — переход в корневой каталог;

md books — в текущем каталоге создать подкаталог books;

md c:\archives — в корневом каталоге на диске С: создается каталог archives;

rd games — удаление каталога games в текущем каталоге.

Проверка диска и вывод отчета. Том Определяет точку подключения, имя тома или букву проверяемого диска с двоеточием. имя_файла Файлы, проверяемые на наличие фрагментации (только FAT/FAT32). /F Исправление ошибок на диске. /V Для FAT/FAT32: вывод полного пути и имени для каждого файла на этом диске. Для NTFS: также вывод сообщений об очистке. /R Поиск поврежденных секторов и восстановление их содержимого. (подразумевает /F). /L:размер Только для NTFS: изменение размера файла журнала до указанной величины (в КБ). Если размер не указан, выводится текущее значение размера. /X При необходимости предварительное отключение тома. Все открытые дескрипторы для этого тома будут недействительны. (требует /F). /I Только для NTFS: менее строгая проверка индексных элементов. /C Только для NTFS: пропуск проверки циклов внутри структуры папок.

Ключи /I или /C укорачивают время выполнения CHKDSK за счет пропуска некоторых проверок тома.

Эквивалентна команде fsck в Unix.

Эквивалентна команде clear в Unix.

Копирование одного или нескольких файлов в другое место.

источник Имена одного или нескольких копируемых файлов.

/A Файл является текстовым файлом ASCII .

/B Файл является двоичным файлом.

/D Указывает на возможность создания зашифрованного файла результат Каталог и/или имя для конечных файлов.

/V Проверка правильности копирования файлов.

/N Использование, если возможно, коротких имен при копировании файлов, чьи имена не удовлетворяют стандарту 8.3.

/Y Подавление запроса подтверждения на перезапись существующего конечного файла.

/-Y Обязательный запрос подтверждения на перезапись существующего конечного файла.

/Z Копирование сетевых файлов с возобновлением.

Ключ /Y можно установить через переменную среды COPYCMD.

Ключ /-Y командной строки переопределяет такую установку.

По умолчанию требуется подтверждение, если только команда COPY не выполняется в пакетном файле.

Чтобы объединить файлы, укажите один конечный и несколько исходных файлов, используя подстановочные знаки или формат «файл1+файл2+файл3+…».

Эквивалентна команде cp в Unix.

Расширенными возможностями обладают XCOPY и robocopy

Удаление одного или нескольких файлов.

имена Имена одного или нескольких файлов. Для удаления сразу нескольких файлов используются подстановочные знаки. Если указан каталог, из него будут удалены все файлы. /P Запрос на подтверждение перед удалением каждого файла. /F Принудительное удаление файлов, доступных только для чтения. /S Удаление указанных файлов из всех подкаталогов. /Q Отключение запроса на подтверждение при удалении файлов. /A Отбор файлов для удаления по атрибутам. атрибуты

S	Системные файлы
R	Доступные только для чтения
H	Скрытые файлы
A	Файлы для архивирования

Префикс «-» имеет значение НЕ

Изменение команд DEL и ERASE при включении расширенной обработки команд:

Результаты вывода для ключа /S принимают обратный характер, то есть выводятся только имена удаленных файлов, а не файлов, которые не удалось найти.

deltree [/y] директория

В Unix, функциональность deltree предоставляется командой rm с параметром -r. [править] dir

Вывод списка файлов и подкаталогов из указанного каталога.

/A Вывод файлов с указанными атрибутами. атрибуты D Каталоги R Доступные только для чтения

/B Вывод только имен файлов. /C Применение разделителя групп разрядов для вывода размеров файлов

/D Вывод списка в несколько столбцов с сортировкой по столбцам. /L Использование нижнего регистра для имен файлов. /N Отображение имен файлов в крайнем правом столбце. /O Сортировка списка отображаемых файлов. порядок N По имени (алфавитная) S По размеру (сперва меньшие)

/P Пауза после заполнения каждого экрана. /Q Вывод сведений о владельце файла. /S Вывод списка файлов из указанного каталога и его подкаталогов. /T Выбор поля времени для отображения и сортировки время C Создание

/W Вывод списка в несколько столбцов. /X Отображение коротких имен для файлов, чьи имена не соответствуют

/4 Вывод номера года в четырехзначном формате

Стандартный набор ключей можно записать в переменную среды DIRCMD. Для отмены их действия введите в команде те же ключи с префиксом «-», например: /-W.

Изменение MBR [править] format

Форматирование диска. пример:format c:/ -будет отформатирован диск С

FORMAT том: [/FS:система] [/V:метка] [/Q] [/A:размер] [/C] [/X]

FORMAT том: [/V:метка] [/Q] [/F:размер]

FORMAT тома: [/V:метка] [/Q] [/T:дорожки /N:секторы]

FORMAT тома: [/V:метка] [/Q]

том Указывает букву диска (с последующим двоеточием),

/FS:filesystem Указывает тип файловой системы (FAT, FAT32 или NTFS). /V:метка Метка тома. /Q Быстрое форматирование. /C Только для NTFS: Установка режима сжатия по умолчанию для

/X Инициирует отключение тома, в качестве первого действия, если

/A:размер Заменяет размер кластера по умолчанию. В общих случаях

/F:размер Указывает размер форматируемых гибких дисков (1,44) /T:дорожки Число дорожек на каждой стороне диска. /N:секторы Число секторов на каждой дорожке. Для тех, кому интересны более подробные аспекты MS-DOS, могу посоветовать следущую книгу: dosbible.zip Как её прочитать, разбирайтесь самостоятельно:)

Особенности DOSBox

Т.к. мы работаем на виртуальном компьютере, то первый вопрос, который возникает: «Как мне получить доступ к файлам на обычном компьютере, из-под которого я запустил DOSBox?» Нужно воспользоваться следующим алгоритмом: — Открываем домашнюю папку (Переход → Домашняя папка) — Создаём папку asm, или с каким-нибудь подобным названием — Запускаем DOSBox. В командной строке пишем заклинание mount c

/asm — Всё. Теперь в DOSBox появится диск C:\, содержимое которого в точности соответствует содержимому папки asm. Если вы меняете содержимое папки asm и хотите обновить диски виртуальной машины, то нажмите Ctrl-F4. Для справки можете воспользоваться командами HELP и INTRO в командной строке DOSBox.

Отладчик DEBUG

Debug — Программа отладчик, которую используют для проверки и отладки выполняемых файлов.

Данная программа является консольным приложением и предназначена для создания или изменения кода файлов. С помощью неё можно создавать простые приложение под MS-DOS и отслеживать их работу. Данный отладчик находится на самом низком уровне компиляторов assembler. Но обладает неплохими возможностями такими как просмотр, изменение памяти и получение состояния регистров.

Программа вызывается через командную строку:

Работа с файлами

-N -N Путь_Имя_Файла. С помощью этой команды можно загружать и сохранять файлы. Сокращённо от слова Name. -N My.com [Нажать Enter] -L Загрузка файла. Сокращённо от слова Load. -N My.com [Нажать Enter] -L [Нажать Enter] -W -W Путь_Имя_Файла. Сохранить файл. Сокращённо от слова Write. -N My.com [Нажать Enter] -W [Нажать Enter]

Writing Число_Байт bytes

Отображение и изменение значений регистров Команда Описание Пример -R Выдаёт содержание всех регистров. -R [Нажать Enter] -R [регистр] Просмотр регистра и запись нового значения в регистр. -R AX [Нажать Enter]

Дамп памяти -D Выдаёт содержимое памяти. Сокращённо от слова Dump. -D [Нажать Enter] -D [Начало_Сегмента] L [Конец_Сегмента] Выдаёт содержимое памяти от начального сегмента до конечного сегмента. Чтобы вывести всё память нужно ввести -D 0 L 0 [Нажать Enter] -D 0000 L 0005 [Нажать Enter]

1814:0000 CD 20 FF 9F 00 Дизассемблирование

-U Команда преобразования кода в инструкции ассемблера. Сокращённо от слова Unassemble. -U [Нажать Enter]

1814:0100 ADD [BX+SI],AL 1814:0102 XOR AL,00 Ассемблирование

-A Преобразования инструкции ассемблера в машинный кода. Сокращённо от слова Assemble. -A [Нажать Enter] 1814:0100 MOV AX,0009 1814:0103 [Вводим_Дальше] [Нажать Enter]

-G Запуск исполнения программы. Сокращённо от слова Go. -G [Нажать Enter]

Program terminated normally

-G =[Адрес_Начала_Работы] Начиная с этого адреса начинается компиляция. -G =100 -G [Адрес_Брейкпоинта] [Адрес_Брейкпоинта] … Программа запускается и выполняется пока не дойдёт до брейкпоинта после чего она остановится и выведет значения регистров да продолжения работы необходимо нажать -G. Максимальное число брейкпоинтов 10. -G 176 47d 537 647 [Нажать Enter] -T Команда имеет сходство с командой (-G) Go, но отличается тем что выводит значения регистров поле каждой инструкции. Сокращённо от слова Trace. -T [Нажать Enter] -T =[Адрес_Начала_Работы] [Количество_Иструкций] Дополнительно указывает с какого адреса запускаться программе и количество исполняемых инструкций. -T =100 5[Нажать Enter]

Как запустить старые игры под DOS через DosBox. Лучший эмулятор

DosBox — это программный эмулятор IBM-PC совместимого компьютера под управлением операционной системы (ОС) MS-DOS. Программа DosBox является свободным программным обеспечением, которое позволяет запускать старые программы и игры на современных компьютерах и устройствах под управлением операционных систем Windows, Linux, Adndroid и других.

Официальный сайт программы: www.dosbox.com

Краткий перечень возможностей и плюсов DosBox:

• MS-DOS окружение без наличия физического x86 процессора и оригинала ОС;
• Эмуляция прерываний BIOS и аппаратной части IBM-PC совместимого компьютера;
• Подключение любой папки на компьютере как рабочий диск в виртуальной ОС;
• Графика — Text Mode, Hercules, CGA, EGA, VGA, VESA;
• Аудио — AdLib, Sound Blaster, PC-Speaker(пищалка) и другие старые железки;
• Сеть — TCP/IP, IPX, Com-port(Windows);
• Кроссплатформенность;
• Открытое ПО, наличие исходных кодов;
• Маленький размер дистрибутива 1,5-2 Мб;
• Возможность запуска в портабельном режиме.

Под DosBox уверено запустятся и будут работать различные файловые менеджеры времен MS-DOS, бухгалтерские и банковские программы, среды программирования, программы для радиолюбительских измерений и коммуникации…

В эмуляторе отлично будут работать такие игры как: Dune II, Quake, Duke Nukem, Warcraft II, Chasm the rift и многие другие…

Что такое vDos?

Чтобы запустить старые программы DOS на более новых платформах Windows, используется виртуальная машина DOS (NTVDM). 32-разрядная версия Windows 10 включает в себя это, но 64-разрядная – нет. Вместо этого, пользователи Windows увидят всплывающее предупреждение о том, что программы DOS не могут быть запущены.

vDos — это эмулятор DOS от сторонних разработчиков, который заменяет собственную технологию Windows NTVDM. Когда вы запускаете программное обеспечение DOS через vDos, оно загружается в собственное окно с поддержкой сети и принтеров, доступом к буферу обмена и прямым доступом к системным файлам.

Установка программы DosBox в Linux и Windows

В системах GNU/Linux Свежую версию программы всегда можно скачать на официальном сайте, а также установить через систему репозиториев. Для установки DosBox под GNU/Linux Debian или Ubuntu достаточно одной команды:

sudo apt-get install dosbox

Для операционной системы Windows также можно скачать установщик с официального сайта. Тем не менее, очень удобно использовать портабельную версию программы, которая запускается и работает с флешки или сменного жесткого диска.

Можно сделать, например, подарочную флешку с набором стареньких игр и программ для своего друга на день рождения — если он работал раньше в MS-DOS то наверняка будет что вспомнить.

Качаем и устанавливаем портабельную версию программы — DosBox Portable (portableapps) (2Мб).

После запуска DOSBoxPortable.exe откроется два окошка: первое — окно статуса программы. а второе — окно где производится эмуляция.

Для тех кто знает Английский язык проблем с встроенной системой помощи(HELP) не возникнет.

Команда INTRO позволяет максимально быстро пройтись по основным пунктам при работе с программой — монтирование директорий как дисков, работа с образами CD-ROM, список горячих клавиш.

Установка DosBox

Вы можете установить DosBox в Windows, Linux или MacOS, программа поддерживает все эти системы. В Linux она есть в официальных репозиториях большинства дистрибутивов. Например, для установки в Ubuntu достаточно выполнить:

sudo apt install dosbox

sudo yum install dosbox

sudo dnf install dosbox

Что касается Windows и Mac, то вам нужно будет загрузить установщик из официального сайта. Последняя версия — 0.74, она вышла в 2012 году, но сейчас все еще получает мелкие исправления у улучшения.

Основные консольные команды

Команда HELP выводит на экран список доступных в эмуляторе основных команд MS-DOS:

• DIR — отображает содержимое директории;
• CD — смена текущего каталога;
• CLS — очистка экрана;
• COPY — копирование файлов;
• DEL — удаление файлов;
• EXIT — выход;
• MD — создание директории;
• RD — удаление директории;
• REN — переименование одного или нескольких файлов;
• TYPE — отображение содержимого текстового файла;
• VER — отображает текущую версию DosBox, а также версию эмулируемой MS-DOS.

Список горячих клавиш

• ALT-ENTER — включение/выключение полноэкранного режима;
• ALT-PAUSE — приостановка работы эмулятора DosBox;
• CTRL-F1 — запуск редактора горячих клавиш;
• CTRL-F4 — обновление кеша директорий что подмонтированы;
• CTRL-ALT-F5 — запуск и остановка захвата экрана с последующим сохранением в видеофайл;
• CTRL-F5 — захват и сохранение скриншота;
• CTRL-F6 — запуск и остановка записи звука в Wav файл;
• CTRL-ALT-F7 — старт и остановка записи OPL команд;
• CTRL-ALT-F8 — старт и остановка записи разных MIDI команд;
• CTRL-F7 — уменьшить количество пропускаемых фреймов;
• CTRL-F8 — увеличить количество пропускаемых фреймов;
• CTRL-F9 — холодное выключение DosBox (kill);
• CTRL-F10 — включение и отключение захвата мышки;
• CTRL-F11 — замедление эмулятора, уменьшение количества циклов микропроцессора;
• CTRL-F12 — ускорение эмулятора, увеличение количества циклов микропроцессора;
• ALT-F12 — отключение лимита скорости, максимум.

Список системных кнопок DOSBox:

ALT-ENTER — Переход dosbox на весь экран

CTRL-F1 — Переназначение кнопок

CTRL-F5 — Сделать скриншот

CTRL-F6 — Старт/стоп записи звука в wave файл

CTRL-ALT-F5 — Старт/Стоп создания ролика с экрана (захват видео и запись в avi)

CTRL-F9 — Закрыть DosBox

CTRL-F10 — Захватить/Отпустить мышь

CTRL-F11 — Замедлить скорость игры

CTRL-F12 — Увеличить скорость игры

При нажатии ALT-F12 (Убрать ограничение скорости (турбо кнопка)) игра ускоряется до предела. Ускорение идет пока комбинация нажата. Бывает очень полезно для промотки заставок, ускорения ожидания, даже если игрой это не предусмотрено. К сожалению комбинация не очень стабильна. Самый частый симптом при таком ускорении — исчезновение в дальнейшем звука.

DosBox — это один из самых популярных эмуляторов операционной системы DOS, который может запускать множество Dos игр и программ прямо на современном компьютере. Windows имеет ограниченную поддержку DOS программ в режиме совместимости, Linux же в принципе не поддерживает такой исполняемый формат. А DosBox создает полноценную среду DOS.

В этой небольшой статье мы рассмотрим как пользоваться Dosbox для запуска старых программ и игр, как монтировать разделы там и как настроить саму программу. Но сначала нам нужно разобрать как ее установить.

Монтирование директорий как дисков в DosBox

Теперь приступим к созданию и подключению директории на компьютере в качестве виртуального диска внутри DosBox. Хотелось бы заметить что это может быть любая директория и на любом из подключенных дисков/томов.

Пример команды, которую нужно выполнить в консоли уже запущенной программы DosBox:

mount C D:/DOSGames

• mount — название команды, которую нужно выполнять
• C — название (буква), которое будет присвоено доступному в DosBox виртуальному диску
• D:/DOSGames — путь к папке «DOSGames», которая размещается на диске D (пример для MS Windows).

После запуска будет выведено оповещение что диск с буквой «C» подмонтирован и для него используется директория «D:/DOS_Games». Таким образом можно подмонтировать несколько виртуальных дисков с директориями — на одном хранить программы, на другом документы и т.п.

Подключаемая директория должна существовать, также хочу заметить что в путях можно использовать разделитель слеш (unix) «/» вместо обратного (win) «\» не зависимо от того под какой ОС вы запускаете DosBox.

Еще пример, команда для монтирования в качестве диска X (внутри DosBox) директории /tmp/DOSTEST (из Linux системы):

mount X /tmp/DOSTEST

Конфигурационные файлы

Для каждой программы можно создать свой конфигурационный файл с уникальными для нее параметрами эмуляции.

После первого запуска DosBox будет автоматически создан конфигурационный файл по умолчанию — dosbox.conf. Вот его местонахождение в разных операционных системах:

/.config/dosbox/» (для версии 0.75 и выше) или «

Вместо «<системный_диск>», «<имя_пользователя>» и «<версия>» нужно подставить актуальные для вашего случая и системы данные.

Для редактирования файлов конфигурации можно использовать любой текстовый редактор — notepad (Windows), gedit, kate, nano (Linux) и другие.

Чтобы запустить эмулятор с определенным конфигурационным файлом нужно выполнить команду:

DOSBox.exe -conf «ConfigName.conf»

Где «ConfigName.conf» — имя конфигурационного файла. Если конфигурационный файл размещается не в директории с программой, то вместо имени нужно указывать полный путь к файлу (с названиями директорий), примеры для Windows и Linux:

DOSBox.exe -conf «C:\Test\games-config.conf» dosbox -conf /tmp/games-config.conf

Как пользоваться DosBox

В большинстве случаев DosBox запускается из терминала, а для настройки параметров выполнения команде передаются определенные опции. Сначала рассмотрим синтаксис команды и ее основные опции.

Синтаксис и опции Dosbox

Синтаксис команды очень прост:

$ dosbox опции

Все же остальные параметры задаются с помощью опций и конфигурационного файла. Вот основные опции, которые нам предстоит использовать:

• -fullscreen — включить полноэкранный режим dosbox;
• -noautoexec — не выполнять секцию autoexec конфигурационного файла;
• -c выполнить произвольную команду после запуска;
• -conf — загрузить конфигурационный файл;
• -printconf — вывести адрес конфигурационного файла;
• -eraseconf — удалить конфигурационный файл по умолчанию;

Команды DosBox. Когда вы запустили оболочку DosBox, вы можете в ней работать, для этого можно использовать встроенные команды. Вот некоторые из них:

• MOUNT — монтировать системную папку в окружение DOS;
• MEM — доступное количество памяти;
• CONFIG — записать текущую конфигурацию в файл;
• RESCAN — пересканировать информацию о директориях;
• IMGMOUNT — примонтировать образ iso в оболочку;
• BOOT — запустить другую операционную систему в DosBox;
• LEUB — поменять раскладку клавиатуры.

Настройка автозапуска команд после старта

Воспользуемся поддержкой принципа так называемого файла autoexec.bat из мира MS-DOS в эмуляторе, это очень удобно когда после запуска программы-эмулятора DosBox нужно автоматически выполнить некоторые команды, запустить предустановленные программы.

В качестве примеров того что можно автоматизировать:

• почистить мусор в какой-либо директории (использовать команду DEL)
• подмонтировать новый диск (использовать команду mount)
• запустить Norton/Volkov Commander
• автоматически запустить игру или другую программу
• и т.д.

Чтобы задать команды для автостарта в DosBox нужно добавить список этих команд в специальную секцию под названием «[autoexec]» в конфигурационный файл dosbox.conf.

К примеру, после старта нужно выполнить следующие действия:

1. подмонтировать папку «Data/Disk_C» для портабельной версии программы (Windows — portableapps) как диск «С» в эмуляторе;
2. перейти на диск С;
3. вывести список содержимого диска С.

Открываем в текстовом редакторе конфигурационный файл dosbox.conf и ищем в самом низу секцию «[autoexec]» — все заданные там команды будут автоматически выполнены по порядку после запуска эмулятора .

Вот скриншот реализации приведенных выше 3х команд для авто-запуска по очереди:

Хотелось бы обратить внимание на путь к директории «../../Data/Disk_C» — в данном случае мы указываем относительный путь для портабельной версии программы, а не абсолютный (к примеру «c:/Programs/Dosbox/Data/»).

Программа DosBox будет искать папку относительно файла DOSBox.exe, что находится в директории «App/DOSBox», поэтому мы поднимаемся на два уровня выше «../../» и уже после указываем расположение директории от текущего уровня.

Данный метод монтирования директорий с относительными путями 100% рабочий и отлично подходит для монтирования директорий что расположены рядом на одном диске с программой.

Эта возможность очень удобна, поскольку позволяет переносить портабельную версию программы и содержимое к ней (программы для ДОС) на сменных носителях и дисках, например на флешке или внешнем жестком диске.

Запускаем DosBox и вот что мы должны увидеть:

Директория подмонтировалась как диск С, выполнен переход на диск С и отображены папки и файлы на диске.

Если вы предпочитаете работу в оболочках типа Norton Commander или Volkov Commander то в автозапуск можно также добавить полный путь для запуска оболочки.

Например вы распаковали Volkov Commander в директорию «vc», что расположена в каталоге который будет подмонтирован как диск С. Добавляем в конфигурационный файл примера, что приведен выше, строчку: «c:\vc\vc.com».

Хочу заметить что для всех команд, которые выполняться внутри эмулятора, в путях нужно использовать слеши:

• для Linux — слеш «/»;
• для Windows — обратный слеш «\».

В показанном выше прмиере, при запуске DosBox (портабельная версия программы) под Windows автоматически подмонтируется диск С и запустится Volkov Commander:

Исправляем «кракозябры» (кодировку)

При запуске некоторых русскоязычных программ можем увидеть нечто подобное:

Для исправления неверного отображения кириллических символов в MS-DOS служат утилиты — руссификаторы клавиатуры. В нашем же случае не нужно искать никаких утилит и все решается намного проще.

Добавляем в конфигурационный файл DosBox (dosbox.conf), в секцию «[autoexec]» строчку:

Все, теперь после перезапуска программы символы кириллицы станут отображаться как следует!

Русские символы отображаются корректно!

Пошаговый пример настройки DosBox под Windows

У пользователей операционной системы GNU/Linux скорее всего не возникнет проблем с установкой и настройкой программы. А для некоторых пользователей MS Windows возможно что пригодится следующая подробная пошаговая инструкция.

Но прежде чем приступим, приведу одну очень важную рекомендацию: после скачивания на компьютер файлов каких-либо программ, предназначенных для работы под MS-DOS или MS Windows, их желательно проверить антивирусной программой.

Для пакетной проверки какого-то файла множеством разных антивирусов существует проект VirusTotal.com. На сайте проекта есть кнопка для загрузки файла на проверку.

Загружаем туда скачанные файлы по одному и смотрим результаты проверки множеством разных антивирусов. Файлы размером больше 100МБ загружать туда не рекомендую, как правило большинство небольших программ весят от нескольких единиц до десятков МегаБайт.

В примере будет использоваться портативная версия программы DosBox.

Скачивание программы

Переходим на сайт PortableApps.com со страницей загрузки DosBox — DOSBox Portable (emulator for classic DOS games).

Ищем кнопку «Download» и нажав на нее качаем запакованный пакет с программой.

Как правило, если браузер не спрашивал куда сохранить файл, программа будет сохранена в папке «Загрузки».

Заходим в браузере на сайт VirusTotal, жмем кнопочку «Choose file» (выбрать файл), выбираем скачанный файл «DOSBoxPortable_0.74.3.paf.exe».

Ожидаем когда завершится процесс проверки и смотрим на результаты:

В данном случае видим «0/71» — это значит что проверка выполнялась разными антивирусами в количестве 71 штук и никаких признаков вирусов в загруженном файле не обнаружено.

Установка

Начинаем установку программы — кликаем мышью на скачанном установочном файле. Программа-установщик предложит выбрать язык, например выбираем Русский.

Внимательно читаем все что пишет и запрашивает программа, нажимаем Далее. Потом программа запросит куда распаковать программу — нажав на кнопочку «Обзор» можно указать какой-то отдельный диск или папку, например можно распаковать на подключенную к компьютеру флешку.

Допустим что распаковывать программу мы будем на диск С, путь установки получится «C:\DOSBoxPortable».

Нажимаем кнопку «Установить» и потом по завершению процесса установки «Готово».

Все, программа установлена!

В этом примере она находится на диске С — переходим в «Мой компьютер» на диск С и видим там папку «DOSBoxPortable».

Первый запуск, тест

Прежде всего проясню один очень важный момент. После любого клика курсором мышки в окне DOSBox она автоматически будет захвачена и начнет работать только в пределах этого окна. Чтобы вернуть операционной системе Windows контроль над мышкой нужно нажать сочетание клавиш CTRL-F10 (включение и отключение захвата мышки)!

Рекомендую изучить и где-то записать себе сочетания клавиш, которые приведены в статье выше — они пригодятся потом при работе с программой.

Переходим в папку «DOSBoxPortable» и запускаем там на выполнение одноименный файл «DOSBoxPortable» — окроется два окна программы:

1. Первое окно — это журнал хода выполнения программы
2. Второе окно — рабочее окно программы DOSBox, в нем будем вводить команды, запускать программы.

Для завершения работы программы достаточно закрыть любое из этих двух окон.

Папка с программами для MS-DOS

В этой же папке «DOSBoxPortable» создадим новую папку для наших программ под MS-DOS. Жмем правую клавишу мыши (ПКМ) на свободном пространстве окна — Создать — Папку — вводим ее название «Program» и жмем ЕНТЕР. Папка для программ готова!

Теперь в эту папку можно сохранить разных программ и игр, которые предназначены для работы под MS-DOS.

Важно заметить что все папки и файлы здесь лучше именовать так, чтобы их имя не содержало больше чем 8 символов, например:

• Для программы «Norton Commander» папку можно назвать кратко — «NC»;
• Для программы Банковский Учет 2.0 — «BANK_20»;
• и так далее…

Например, скопируем туда свободный файловый менеджер «DOS Navigator», скачанный архив я распаковал в папку «DN». Также создадим какой-то текстовый файл-документ. После этого эти папки внутри будут выглядеть вот так:

Здесь:

• DN — папка с программой «DOS Navigator»;
• README — текстовый файл README.txt (в проводнике Windows расширение txt не отображено).

Работа в консоли

Теперь запускаем программу, как мы делали это раньше. В рабочем окне (там где сообщение «Welcome to DOSBox») вводим попорядку слудующие команды:

mount C Program C: dir cd DN dn.com

• «mount C Program» — Подключаем созданную нами папку «Program» как диск C;
• «C:» — перемещаемся в командной строке на диск C;
• «dir» — выводим содержимое текущего каталога (в данном случае это корень диска С);
• «cd DN» — переходим в папку «DN», которая находится в текущем каталоге;
• «dn.com» — запускаем на выполнение исполняемый файл «dn.com».

После ввода последней команды должна запуститься программа «dn.com», в данном случае это файловый менеджер «DOS Navigator»:

Теперь, перемастившись с помощью клавиш-стрелок на ‘..’ и нажав ENTER мы поднимемся в файловом менеджере на один каталог вверх (на один уровень вверх). Там мы увидим каталог «DN» и файл «readme.txt».

Став курсором на файл «readme.txt» и нажав клавишу F3 (View, Просмотр) мы увидим содержимое этого файла, для выхода дотаточно нажать Esc.

Автоматизация

Теперь сделаем так, чтобы при запуске программы DosBox подготовка диска и запуск программ выполнялся автоматически.

Открываем проводником папку «DOSBoxPortable» с программой на диске С, переходим в подпапку с названием «Data», потом в папку «settings» — тут хранятся файлыв настройки программы DOSBox (в портативной версии).

Здесь нас интересует файл «dosbox.cof», нам нужно его открыть для редактирования и тут на помощь придет простой стандартный редактор MS Windows — Блокнот.

Запускаем программу «Блокнот» (Notepad): нажимаем ПУСК, в поиске набираем «notepad» или «блокнот», нажимаем на значек с найденной программой — она должна открыться.

Теперь переходим в окно проводника, где у нас отображено содержимое папки «settings», и перетаскиваем мышькой файл «dosbox.cof» в окно программы «Блокнот». В программе должно отобразиться содержимое этого файла.

В блокноте листаем содержимое файла в самый конец, пока не увидим обозначенную скобками секцию «[autoexec]». В самом низу, под ней, добавляем следующие строчки:

keyb ru 866 mount C Program c: cd DN dn.com

Сохраняем файл (в меню «Файл» выбираем «Сохранить») и закрываем программу Блокнот.

Все эти строчки фактически повторяют команды, которые мы вводили вручную в консоли чтобы подключить как диск «С» каталог «Program» и запустить программу «Dos navigator», за исключением строчки «keyb ru 866», которая пригодится в будущем для корректного отображения программ с символами кириллици (русская и украинская раскладки клавиатуры).

Теперь если запустить программу то «Dos Navigator» запустится автоматически.

Печеньки

Несколько полезных замечаний и идей от меня.

В папку «Program» вы теперь можете покопировать нужные вам файлы и программы, которые планируете запускать в режиме эмуляции MS-DOS. После копирования новых файлов в эту папку программу DOSBox желательно перезапустить (закрыть, если открыта, и снова запустить).

Чтобы заменить «Dos Navigator» на Нортотн Коммандер придется в папке «Program» создать папку для программы «NC» и скопировать в нее содержимое программы файлового менеджера.

Потом останется лишь отредактировать файл «dosbox.cof» (как это было показано выше), заменить в нем строчки:

1. «cd DN» на «cd NC»;
2. «dn.com» на «nc.exe».

Теперь после запуска DOSBoxPortable автоматически запустится Norton Commander, а в нем уже можно перемещаться по дереву каталогов и запускать другие программы, работать с файлами и т.п.

Ко всем наработанным внутри MS-DOS программ файлам и документам вы потом сможете получить доступ просто перейдя проводником в папку по пути: Диск С — DOSBoxPortable — Program.

Всю папку «DOSBoxPortable» на диске С теперь можно скопировать на флешку, перенести на другой компьютер с MS Windows XP, 7, 10 и там запустить уже настроенную программу DOSBox со всем содержимым папки Program внутри без каких либо дополнительных изменений. Просто и удобно!

Также, папку «DOSBoxPortable» можно заархивировать и сохранить резервный вариант с промежуточными результатами работы и нараобтками в программах. которые размещены внутри в подпапке «Program».

Архив с уже настроенным DOSBoxPortable и менеджером Dos Navigator внутри для всего проделанного выше — (3.3 МБ).

Может быть, вас посещают приступы ностальгии, когда вы вспоминаете сражения в Doom, где вы боролись с силами ада только лишь с пилой и дробовиком, или же скучаете по такому простому и удобному в использовании текстовому процессору, как Microsoft Word 5.0, в котором ещё не было этой назойливой проверки орфографии.

В таком случае вы, наверное, огорчитесь, узнав, что Windows 10 не поддерживает многие классические DOS-программы. В большинстве случаев, если вы попытаетесь запустить старую версию программы, то вам, скорее всего, будет выведено сообщение об ошибке.

К счастью, бесплатная программа-эмулятор DOSBox с открытым исходным кодом создает DOS-окружение, в котором можно запустить старые игры и программы, чтобы вспомнить свои лучшие деньки!

Данное руководство поможет вам в поиске старых игр и позволит узнать, как можно загрузить и установить DOSBox в вашей системе.

Поиск старого программного обеспечения

Если вы открыли данное руководство, то вы, скорее всего, хотите найти какую-то определенную игру или программу, диск с которой у вас не сохранился.

Как правило, крупные веб-сайты наподобие Amazon и eBay предоставляют широкий выбор ретро-игр на дискетах и компакт-дисках.

Также некоторые вебсайты предлагают так называемое «Abandonware» – программное обеспечение, которое больше не поддерживается производителем, либо компания-производитель которого больше не существует. Как правило, большая часть таких программ распространяется нелегально, так как по закону они не могут быть распространены без разрешения правообладателя.

Однако в интернет-архивах хранится огромное количество DOS-игр. Вебсайты также предлагают целую коллекцию старых MS-DOS приложений, многие из которых могут быть запущены даже в современных браузерах.

Копирование программных файлов

Откройте окно Проводника Windows и перейдите в папку, куда был установлен DOSBox. Например, C:\Program Files (x86)\DOSBox-0.74.

Правым щелчком мыши вызовите контекстное меню и создайте новую папку. Она будет использоваться для хранения ваших программ, поэтому дайте ей какое-нибудь узнаваемое и говорящее имя, например, «GAMES».

После этого скопируйте папку, в которой находится ваша игра или приложение, и перенесите её в только что созданную папку. Если нужная вам игра является файловым образом CD- или DVD-диска, вы также можете скопировать его в созданную в прошлом шаге папку.

Начало работы с DOSBox

Кликните по иконке DOSBox на рабочем столе вашего Windows 10.

Первым делом вам надо указать в программе местоположение вашей игры. Это можно сделать, к примеру, при помощи команды «mount»:

где «GAMES» – это название созданной ранее папки.

Чтобы запустить команду, кликните «Enter», после чего перейдите к виртуальному диску C, просто набрав:

Установка самой программы

Используйте команду DIR, чтобы увидеть список всех файлов, которые находятся в вашей папке. Процесс установки и запуска приложения или игры на разных девайсах может проходить по-разному, поэтому ищите пакетные файлы (BAT) или исполнимые программы (EXE).

Скорее всего, вы увидите файл с названием SETUP.EXE. Чтобы его запустить, просто кликните на опцию «Начать установку».

Если же в папке есть только файловый образ системы, то вам нужно самостоятельно провести установку, используя команду «imgmount»:

imgmount D REDALERT.ISO

После этого вы можете перейти к виртуальному диску «D:\» при помощи:

Не забудьте про команду «DIR», которая может помочь вам найти список файлов и тем самым облегчить поиск установочного файла.

Создание образа файла дискеты

Быть может, ваша программа настолько «ретро», что хранится на дискете. В таком случае создание загрузочного модуля с её содержимым, скорее всего, станет наиболее простым способом загрузить вашу дискету. После этого необходимо будет выполнить установку по той же схеме, как и в случае с файловым образом системы.

Существуют специальные программы, которые позволяют перенести дисковый образ файла в систему Windows. К ним относятся WinImage и MagicISO Maker.

Как только вы перенесли дисковый образ вашей дискеты в папку «GAMES», выполните установку при помощи команды «imgmount»:

imgmount A image_1 -t floppy

Запуск программы

Когда будет закончена установка, вы, скорее всего, будете автоматически перенаправлены к только что установленному файлу. Если этого не произойдет, то используйте команду «cd», чтобы перейти в папку, которую вы указали при подтверждении установки.

Запуск приложения или игры выполняется таким же образом, как и сама установка. Просто используйте «DIR» для того, чтобы вывести на экран список файлов, после чего выберите файл с расширением .exe.

Если во время запуска игры вы увидите, что со скоростью что-то не так, используйте Ctrl + F11 и Ctrl + F12 для снижения скорости и ее повышения соответственно.

Вы можете также сделать скриншот ваших достижений. Он будет сохранен в C:\Users\yourusername\AppData\Local\DOSBox\capture.

Включите протокол IPX

Для работы режима мультиплеера в некоторых старых играх необходимо включение протокола IPX (протокол обмена межсетевыми пакетами). В DOSBox есть специальная программа-эмулятор, которая позволяет нескольким людям в той же сети играть в многопользовательском режиме, используя датаграммный транспортный протокол (UDP).

Для использования данного режима необходимо включить протокол IPX в конфигурационном файле DOSBox с расширением .conf.

Если программа запущена – закройте её и при помощи файлового проводника перейдите к:

Щелкнув правой кнопкой мыши по файлу, кликните на опцию «Открыть при помощи», после чего нажмите «Другие приложения» и выберите «Блокнот».

Удерживая Ctrl + F, введите «ipx», чтобы найти опцию, которая отвечает за многопользовательский режим. Измените «ipx=false» на «ipx=true».

Start IPX Server

После того, как вы включили протокол IPX в конфигурационном файле программы, откройте DOSBox, кликнув два раза по ярлыку на рабочем столе.

Теперь вы можете подключиться к IPX-серверу, что позволит вам установить связь с другими пользователями локальной сети. Для этого введите команду:

ipxnet start server e.g. ipxnet start server 19955

На этом шаге Брандмауэр Windows может вывести сообщение с предупреждением об угрозе. В таком случае нажмите «Разрешить доступ», чтобы переключиться в многопользовательский режим.

Предложите другим пользователям вашей сети открыть DOSBox и ввести следующую команду, чтобы подключиться к вам:

ipxnet connect e.g. ipxnet connect 192.168.1.87 19955

А теперь можно и поиграть!

Установка удобного внешнего интерфейса для DOSBox

Хоть программа DOSBox может быть крайне удобной и полезной, но когда вам приходится вводить определенные команды каждый раз, когда хочется поиграть, это становится несколько утомительным и может убить всякое желание окунуться в прошлое. Чтобы этого не произошло, существует несколько графических интерфейсов для DOSBox, которые несколько облегчают данный процесс. DGBL (DOSBox Game Launcher) – один из таких интерфейсов. Он позволяет создать и сохранить настройки профиля для тех игр, которые вы уже установили, так что вы можете просто запустить игру, не мучаясь с переходами и введением утомляющих команд.

Многие из подобных программ до сих пор находятся в процессе разработки, поэтому перед установкой обязательно создайте резервные копии файлов. Если вы решите установить DGBL, то после загрузки вам нужно будет извлечь ZIP-файлы и запустить файл «launch.exe».

Скриншоты некоторых популярных программ и игр

На завершение решил сделать десяток скриншотов игр и программ, которые удалось запустить под эмулятором, возможно кто-то вспомнит былые времена:

Операционная система Microsoft Windows 3.1 (образ с моего 80286 компьютера).

Файловый менеджер Norton Commander, хранитель экрана — Аквариум.

Игра от Westwood Studios — Dune 2. Легендарная игра с которой началась серия игр в жанре RTS.

Игра Lotus The Ultimate Challange — гонки на машинах.

Игра Prehistorik 2.

Легендарный WarCraft II от Blizzard отлично работает под DosBox.

Игра от Id Software — Wolfenstein 3D. Родоначальник 3D игр. При сжатии RARом умещалась на дискету 1,44. )))

Игра от Disney Software — DuckTales.

Среда программирования MS-DOS Quick Basic.

Оболочка для программирования под Turbo Pascal 7 отлично работает под DosBox.

Среда разработки Borland Turbo C++ 3.0, тоже все работает на отлично!

Как прервать программу в досбокс

Program terminated normally

While we are hoping that one day DOSBox will run all programs ever made for the PC, we are not there yet.

At present, DOSBox running on a high-end machine will roughly be the equivalent of a Pentium I PC. DOSBox can be configured to run a wide range of DOS games, from CGA/Tandy/PCjr classics up to games from the Quake era.

=======
INDEX:
=======

==============
1. Quickstart:
==============

Type INTRO in DOSBox for a quick tour.
It is essential that you get familiar with the idea of mounting, DOSBox does not automatically make any drive (or a part of it) accessible to the emulation. See the FAQ entry «How to start?» as well as the description of the MOUNT command (section 4: «Internal Programs»). If you have your game on a cdrom you may try this guide: https://www.vogons.org/viewtopic.php?t=8933

===============
2. Start (FAQ):
===============

Great Manual, but I still don’t get it.

START: How to start?

At the beginning you’ve got a Z:\> instead of a C:\> at the prompt. You have to make your directories available as drives in DOSBox by using the «mount» command. For example, in Windows «mount C D:\GAMES» will give you a C drive in DOSBox which points to your Windows D:\GAMES directory (that was created before). In Linux, «mount c /home/username» will give you a C drive in DOSBox which points to /home/username in Linux. To change to the drive mounted like above, type «C:». If everything went fine, DOSBox will display the prompt «C:\>».

AUTOMATION: Do I always have to type these commands?

In the DOSBox configuration file is an [autoexec] section. The commands present there are run when DOSBox starts, so you can use this section for the mounting. Look at Section 13: The configuration (options) file

FULLSCREEN: How do I change to fullscreen?

Press alt-enter. Alternatively: Edit the configuration file of DOSBox and change the option fullscreen=false to fullscreen=true. If fullscreen looks wrong in your opinion: Play with the options: fullresolution, output and aspect in the configuration file of DOSBox. To get back from fullscreen mode: Press alt-enter again.

FULLSCREEN: My fullscreen is too large.

This is can be a problem on Windows 10, if you have display scaling set to a value above 100%. Windows in that case will resize the screen on top of dosbox resizing the screen, which can happen for the output: ddraw, opengl, openglnb, overlay. You can disable this Windows behaviour by enabling a specific compatibility setting:

— Right-click the DOSBox icon and select «Properties».
— Go to the «Compatibility» tab.
— Click on «Change high DPI settings».
— Tick «Override high DPI scaling behaviour» and set it to «Application».
— Apply the changes by clicking on «OK».

Unfortunately, this compatibility option causes some side effects in windowed mode, and in this case you will need to change the resolution in the config/Options file for windowresolution (e.g. 1024×768).

Alternatively, you can disable the display scaling and or use a lower fullresolution value.

CD-ROM: My CD-ROM doesn’t work.

To mount your CD-ROM in DOSBox you have to specify some additional options when mounting the CD-ROM.
To enable CD-ROM support (includes MSCDEX) in Windows:

— mount d f:\ -t cdrom

In some cases you might want to use a different CD-ROM interface, for example if CD audio does not work:

To enable SDL-support (does not include low-level CD access!):

— mount d f:\ -t cdrom -usecd 0 -noioctl

To enable ioctl access using digital audio extraction for CD audio (windows-only, useful for Vista):

To enable ioctl access using MCI for CD audio (windows-only):

To force ioctl-only access (windows-only):

To enable low-level aspi-support (win98 with aspi-layer installed):

— d driveletter you will get in DOSBox (d is the best, don’t change it!)

— f:\ location of CD-ROM on your PC. In most cases it will be d:\ or e:\
— 0 The number of the CD-ROM drive, reported by «mount -cd»

(note that this value is only needed when using SDL for CD audio,

otherwise it is ignored)

See also the next question: The game/application can’t find its CD-ROM.

CD-ROM: The game/application can’t find its CD-ROM

Be sure to mount the CD-ROM with -t cdrom switch, this will enable the MSCDEX interface required by DOS games to interface with CD-ROMs. Also try adding the correct label (-label LABEL) to the mount command, where LABEL is the CD-label (volume ID) of the CD-ROM. Under Windows you can specify -ioctl, -aspi or -noioctl. Look at the description of the mount command in Section 4: «Internal programs» for their meaning and the additional audio-CD related options -ioctl_dx, -ioctl_mci, -ioctl_dio. Try creating a CD-ROM image (preferably CUE/BIN pair) and use the DOSBox’s internal IMGMOUNT tool to mount the image (the CUE sheet). This enables very good low-level CD-ROM support on any operating system.

MOUSE: The mouse doesn’t work.

Usually, DOSBox detects when a game uses mouse control. When you click on the screen it should get locked (confined to the DOSBox window) and work. With certain games, the DOSBox mouse detection doesn’t work. In that case you will have to lock the mouse manually by pressing CTRL-F10.

SOUND: There is no sound

Be sure that the sound is correctly configured in the game. This might be done during the installation or with a setup/setsound utility that accompanies the game. First see if an autodetection option is provided. If there is none try selecting Soundblaster or Soundblaster 16 with the default settings being «address=220 irq=7 dma=1» (sometimes highdma=5). You might also want to select Sound Canvas/SCC/MPU-401/General MIDI/Wave Blaster at «address=330 IRQ=2» as music device. The parameters of the emulated sound cards can be changed in the DOSBox configuration file.

If you still don’t get any sound set the core to normal in DOSBox configuration and use some lower fixed cycles value (like cycles=2000). Also
assure that your host operating sound does provide sound. In certain cases it might be useful to use a different emulated sound device
like a soundblaster pro (sbtype=sbpro1 in the DOSBox configuration file) or the gravis ultrasound (gus=true).

SOUND: What sound hardware does DOSBox presently emulate?

DOSBox emulates several legacy sound devices:

• Internal PC speaker/Buzzer
  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 address 220. It is disabled as default.
• Tandy 3 voice
  The emulation of this sound hardware is complete with the exception of the noise channel. The noise channel is not very well documented and as such is only a best guess as to the sound’s accuracy. It is disabled as default.
• Tandy DAC
  Some games may require turning off sound blaster emulation (sbtype=none) for better tandy DAC sound support. Don’t forget to set the sbtype back to sb16 if you don’t use tandy sound.
• Adlib
  This emulation is almost perfect and includes the Adlib’s ability to almost play digitized sound. Placed at address 220 (also on 388).
• SoundBlaster 16 / SoundBlaster Pro I & II / SoundBlaster I & II
  By default DOSBox provides Soundblaster 16 level 16-bit stereo sound. You can select a different SoundBlaster version in the configuration of DOSBox. AWE32 music is not emulated as you can use MPU-401 instead (see below).
• Disney Sound Source and Covox Speech Thing
  Using the printer port, this sound device outputs digital sound only. Placed at LPT1
• 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. For Gravis music you also have to install Gravis drivers inside DOSBox. It is disabled as default.
• MPU-401
  A MIDI passthrough interface is also emulated. This method of sound output will only work when used with external device/emulator. Every Windows XP/Vista/7 and MAC OS has got a default emulator compatible with: Sound Canvas/SCC/General Standard/General MIDI/Wave Blaster. A different device/emulator is needed for Roland LAPC/CM-32L/MT-32 compatibility.

SOUND: The sound stutters or sounds stretched/weird.

You may be using too much CPU power to keep DOSBox running at the current speed. You can lower the cycles, skip frames, reduce the sampling rate of the respective sound device, increase the prebuffer. See section 13: «The configuration (options) file»
If you are using cycles=max or =auto, then make sure that there is no background processes interfering! (especially if they access the harddisk) Also look at Section 10. «How to speed up/slow down DOSBox»

KEYBOARD: I can’t type \ or : in DOSBox.

1. Use / instead, or ALT-58 for : and ALT-92 for \.
2. Change the DOS keyboard layout (see Section 8: Keyboard Layout).
3. Add the commands you want to execute to the [autoexec] section of the DOSBox configuration file.
4. Open the DOSBox configuration file and change the usescancodes entry.
5. Switch the keyboard layout of your operating system.

KEYBOARD: Right Shift and «\» doesn’t work in DOSBox. (Windows only)

This may happen if Windows thinks that you have more than one keyboard connected to your PC when you use some remote control devices. To verity this problem run cmd.exe, navigate to DOSBox program folder and type:

set sdl_videodriver=windib
dosbox.exe

check whether keyboard started to work properly. As windib is slower it is best to use one of the two solutions provided here: https://www.vogons.org/viewtopic.php?t=24072

KEYBOARD: The keyboard lags

Lower the priority setting in the DOSBox configuration file, for example set «priority=normal,normal». You might also want to try lowering the cycles (use a fixed cycle amount to start with, like cycles=10000).

CONTROL: The character/cursor/mouse pointer always moves into one direction!

See if it still happens if you disable the joystick emulation, set joysticktype=none in the [joystick] section of your DOSBox configuration file. Maybe also try unplugging any joystick/gamepad. If you want to use the joystick in the game, try setting timed=false and be sure to calibrate the joystick (both in your OS as well as in the game or the game’s setup program).

SPEED: The game/application runs much too slow/too fast!

CRASH: The game/application does not run at all/crashes!

CRASH: DOSBox crashes on startup!

GAME: My Build game(Duke3D/Blood/Shadow Warrior) has problems

First of all, try to find a port of the game. Those will offer a better experience. To fix the graphics problem that occurs in DOSBox on higher resolutions: Open the configuration file of DOSBox and search for:

machine=svga_s3. Change svga_s3 to vesa_nolfb
Change memsize=16 to memsize=63

SAFETY: Can DOSBox harm my computer?

DOSBox can not harm your computer more than any other resource demanding program. Increasing the cycles does not overclock your real CPU. Setting the cycles too high has a negative performance effect on the software running inside DOSBox.

OPTIONS: I would like to change DOSBox’s options.

HELP: Great Manual, but I still don’t get it

For more questions read the rest of this Manual. You may also look at:

• The DOSBox Guides: https://www.vogons.org/viewforum.php?f=39
• The DOSBox Wiki: https://www.dosbox.com/wiki/
• The DOSBox Site: https://www.dosbox.com
• The DOSBox Forum: https://www.vogons.org/viewforum.php?f=53

===========================
3. Command Line Parameters:
===========================

An overview of the command line options you can give to DOSBox. Although in most cases it is easier to use DOSBox’s configuration file instead. See: Section 13. «The configuration (options) file»

To be able to use Command Line Parameters:
(Windows) open cmd.exe or command.com or edit the shortcut to dosbox.exe
(Linux) use console
(MAC OS X) start terminal.app and navigate to:

The options are valid for all operating systems unless noted in the option description:

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]

dosbox -version
dosbox -editconf program
dosbox -opencaptures program
dosbox -printconf
dosbox -eraseconf
dosbox -erasemapper

name

If «name» is a directory it will mount that as the C: drive.
If «name» is an executable it will mount the directory of «name»
as the C: drive and execute «name».

-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 «-c» though. 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 users specific configuration file. Can be used together with multiple -conf parameters, but -userconf will always be loaded before them.

-conf configfilelocation

Start DOSBox with the options specified in «configfilelocation». Multiple -conf options may be present. See Section 13 for more details.

-lang languagefilelocation

Start DOSBox using the language specified in «languagefilelocation». See Section 14 for more details.

-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.
svga_s3 enables vesa emulation as well.
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 precision.
The machinetype affects the video card and the available sound cards.

-noconsole (Windows Only)

Start DOSBox without showing DOSBox Status Window (console). Output will be redirected to stdout.txt and stderr.txt

-startmapper

Enter the keymapper directly on startup. Useful for people with keyboard problems.

-noautoexec

Skips the [autoexec] section of the loaded configuration file.

-securemode

Same as -noautoexec, but adds config.com -securemode at the bottom of AUTOEXEC.BAT (which in turn disables any changes to how the drives are mounted inside DOSBox).

-scaler scaler

Uses the scaler specified by «scaler». See the DOSBox configuration file for the available scalers.

-forcescaler scaler

Similar to the -scaler parameter, but tries to force usage of the specified scaler even if it might not fit.

-version

output version information and exit. Useful for frontends.

-editconf program

calls program with as first parameter the configuration file. You can specify this command more than once. In this case it will move to second program if the first one fails to start.

-opencaptures program

calls program with as first parameter the location of the captures folder.

-printconf

prints the location of the default configuration file.

-resetconf

removes the default configuration file.

-resetmapper

removes the mapperfile used by the default clean configuration file.

-socket

If a name/command/configfilelocation/languagefilelocation contains a space, put the whole name/command/configfilelocation/languagefilelocation between quotes («command or file name»). If you need to use quotes within quotes (most likely with -c and mount):
Windows and OS/2 users can use single quotes inside the double quotes.
Other people should be able to use escaped double quotes inside the double quotes.
Windows: -c «mount c ‘c:\My folder with DOS games\’»
Linux: -c «mount c \»/tmp/name with space\»»

A rather unusual example, just to demonstrate what you can do (Windows): dosbox D:\folder\file.exe -c «MOUNT Y H:\MyFolder» This mounts D:\folder as C:\ and runs file.exe. Before it does that, it will first mount H:\MyFolder as the Y drive. In Windows, you can also drag directories/files onto the DOSBox executable.

=====================
4. Internal Programs:
=====================

DOSBox supports most of the DOS commands found in command.com. To get a list of the internal commands type «HELP» at the prompt.

In addition, the following commands are available:

MOUNT «Emulated Drive letter» «Real Drive or Directory»

[-t type] [-aspi] [-ioctl] [-noioctl] [-usecd number] [-size drivesize]
[-label drivelabel] [-freesize size_in_mb]
[-freesize size_in_kb (floppies)]

MOUNT -cd
MOUNT -u «Emulated Drive letter»

Program to mount local directories as drives inside DOSBox.

«Emulated Drive letter»

The driveletter inside DOSBox (for example C).

«Real Drive letter (usually for CD-ROMs in Windows) or Directory»
The local directory you want accessible inside DOSBox.

-t type

Type of the mounted directory. Supported are: dir (default), floppy, cdrom.

-size drivesize

(experts only)
Sets the size of the drive, where drivesize is of the form «bps,spc,tcl,fcl»:

bps: bytes per sector, by default 512 for regular drives and 2048 for CD-ROM drives
spc: sectors per cluster, usually between 1 and 127
tcl: total clusters, between 1 and 65534
fcl: total free clusters, between 1 and tcl

-freesize size_in_mb | size_in_kb

Sets the amount of free space available on a drive in megabytes (regular drives) or kilobytes (floppy drives). This is a simpler version of -size.

-label drivelabel

Sets the name of the drive to «drivelabel». Needed on some systems if the CD-ROM label isn’t read correctly (useful when a program can’t find its CD-ROM). If you don’t specify a label and no lowlevel support is selected (that is omitting the -usecd # and/or -aspi parameters, or specifying -noioctl):

For Windows: 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 !!

-aspi

Forces use of the aspi layer. Only valid if mounting a CD-ROM under Windows systems with an ASPI-Layer.

-ioctl (automatic selection of the CD audio interface)
-ioctl_dx (digital audio extraction used for CD audio)
-ioctl_dio (ioctl calls used for CD audio)
-ioctl_mci (MCI used for CD audio)

Forces use of ioctl commands. Only valid if mounting a CD-ROM under a Windows OS which support them (Win2000/XP/NT). The various choices only differ in the way CD audio is handled, preferably -ioctl_dio is used (lowest workload), but this might not work on all systems, so -ioctl_dx (or -ioctl_mci) can be used.

-noioctl

Forces use of the SDL CD-ROM layer. Valid on all systems.

-usecd number

Valid on all systems, under windows the -noioctl switch has to be present to make use of the -usecd switch. Enables to select the drive that should be used by SDL. Use this if the wrong or no CD-ROM drive is mounted while using the SDL CD-ROM interface. «number» can be found by «MOUNT -cd».

-cd

Displays all CD-ROM drives detected by SDL, and their numbers.
See the information at the -usecd entry above.

-u

Note: It’s possible to mount a local directory as CD-ROM drive, but hardware support is then missing.

Basically MOUNT allows you to connect real hardware to DOSBox’s emulated PC. So MOUNT C C:\GAMES tells DOSBox to use your C:\GAMES directory as drive C: in DOSBox. MOUNT C E:\SomeFolder tells DOSBox to use your E:\SomeFolder directory as drive C: in DOSBox.

Mounting your entire C drive with MOUNT C C:\ is NOT recommended! The same is true for mounting the root of any other drive, except for CD-ROMs (due to their read-only nature). Otherwise if you or DOSBox make a mistake you may lose all your files. Also never mount a «Windows» or «Program Files» folders or their subfolders in Windows Vista/7 as DOSBox may not work correctly, or will stop working correctly later. It is recommended to keep all your dos applications/games in a simple folder (for example c:\dosgames) and mount that.

You should always install your game inside DOSBox. So if you have the game on CD you always (even after installation!) have to mount both: folder as a harddisk drive and a CD-ROM.
HardDisk should always be mounted as c
CD-ROM should always be mounted as d
Floppy should always be mounted as a (or b)

Basic MOUNT Examples for normal usage (Windows):

To mount a folder as a harddisk drive:
mount c d:\dosgames

Advanced MOUNT examples (Windows):

To mount a hard disk drive with

870 mb free diskspace (simple version):
mount c d:\dosgames -freesize 870

870 mb free diskspace (experts only, full control):
mount c d:\dosgames -size 512,127,16513,13500

Other MOUNT examples:

To mount system CD-ROM drive at mountpoint /media/cdrom as CD-ROM drive D in DOSBox:
mount d /media/cdrom -t cdrom -usecd 0

If you want to mount a CD image or floppy image, check IMGMOUNT.
MOUNT also works with images but only if you use external program, for example (both are free):

(for CD images) (for floppy images)

Although IMGMOUNT can give better compatibility.

MEM

Program to display the amount and type of free memory.

VER
VER set major_version [minor_version]

Display the current DOSBox version and reported DOS version (parameterless usage). Change the reported DOS version with the «set» parameter, for example: «VER set 6 22» to have DOSBox report DOS 6.22 as version number.

CONFIG -writeconf filelocation
CONFIG -writelang filelocation
CONFIG -securemode
CONFIG -set «section property=value»
CONFIG -get «section property»

CONFIG can be used to change or query various settings of DOSBox during runtime. It can save the current settings and language strings to disk. Information about all possible sections and properties can be found in Section 13: «The configuration (options) file».

-writeconf filelocation

Write the current configuration settings to a file in a specified location. «filelocation» 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 sound cards and many more things. It allows access to AUTOEXEC.BAT as well. See Section 13: «The configuration (options) file» for more information.

-writelang filelocation

Write the current language settings to a file in a specified location. «filelocation» is located on the local drive, not a mounted drive in DOSBox. The language file controls all visible output of the internal commands and the internal DOS. See Section 14: «The Language File» for more information.

-securemode

Switches DOSBox to a more secure mode. In this mode the internal commands MOUNT, IMGMOUNT and BOOT won’t work. It’s not possible either to create a new configfile or languagefile in this mode. (Warning: you can only undo this mode by restarting DOSBox.)

-set «section property=value»

CONFIG will attempt to set the property to new value. Currently CONFIG can not report whether the command succeeded or not.

-get «section property»

The current value of the property is reported and stored in the environment variable %CONFIG%. This can be used to store the value when using batch files.

Both «-set» and «-get» work from batch files and can be used to set up your own preferences for each game. Although it may be easier to use separate DOSBox’s configuration files for each game instead.

Examples:

1. To create a configuration file in your c:\dosgames directory:
   config -writeconf c:\dosgames\dosbox.conf
2. To set the cpu cycles to 10000:
   config -set «cpu cycles=10000»
3. To turn ems memory emulation off:
   config -set «dos ems=off»
4. To check which cpu core is being used.
   config -get «cpu core»

LOADFIX [-size] [program] [program-parameters]
LOADFIX -f

Program to reduce the amount of available conventional memory. Useful for old programs which don’t expect much memory to be free.

-size

number of kilobytes to «eat up», default = 64kb

-f

frees all previously allocated memory

Examples:

1. To start mm2.exe and allocate 64kb memory
   (mm2 will have 64 kb less available):
   loadfix mm2
2. To start mm2.exe and allocate 32kb memory:
   loadfix -32 mm2
3. To free previous allocated memory:
   loadfix -f

RESCAN

Make DOSBox reread the directory structure. Useful if you changed something on a mounted drive outside of DOSBox. (CTRL — F4 does this as well!)

MIXER

Makes DOSBox display its current volume settings. Here’s how you can change them:

mixer channel left:right [/NOSHOW] [/LISTMIDI]

channel

Can be one of the following: MASTER, DISNEY, SPKR, GUS, SB, FM [, CDAUDIO].
CDAUDIO is only available if a CD-ROM interface with volume control is enabled (CD image, ioctl_dx).

left:right

The volume levels in percentages. If you put a D in front it will be in decibel (Example: mixer gus d-10).

/NOSHOW

Prevents DOSBox from showing the result if you set one of the volume levels.

/LISTMIDI

In Windows lists the available midi devices on your PC. To select a device other than the Windows default midi-mapper, change the line ‘midiconfig=’ in the [midi] section of the configuration file to ‘midiconfig=id’, where ‘id’ is the number for the device as listed by LISTMIDI. eg. midiconfig=2

In Linux this option doesn’t work, but you get similar results by using ‘pmidi -l’ in console. Then change the line ‘midiconfig=’ to ‘midiconfig=port’, where ‘port’ is the port for the device as listed by ‘pmidi -l’. eg. midiconfig=128:0

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]

IMGMOUNT DRIVE [imagefile1 imagefile2 .. imagefileN] -t cdrom -fs iso

imagefile

Location of the image file to mount in DOSBox. The location can be on a mounted drive inside DOSBox, or on your real disk. It is possible to mount CD-ROM images (ISOs or CUE/BIN or CUE/IMG) too. If you need CD swapping capabilities, specify all images in succession (see the next entry).
CUE/BIN pairs and cue/img are the preferred CD-ROM image types as they can store audio tracks compared to ISOs (which are data-only). For the CUE/BIN mounting always specify the CUE sheet.

imagefile1 imagefile2 .. imagefileN

Location of the image files to mount in DOSBox. Specifying a number
of image files is only allowed for CD-ROM images.
The CD’s can be swapped with CTRL-F4 at any time.
This is required for games which use multiple CD-ROMs and require the CD
to be switched during the gameplay at some point.

-t

The following are valid image types:

floppy:

Specifies a floppy image. DOSBox will automatically identify the disk geometry (360K, 1.2MB, 720K, 1.44MB, etc).

cdrom:

Specifies a CD-ROM image. The geometry is automatic and set for this size. This can be an iso or a cue/bin pair or a cue/img pair.

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 that 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 you need to format it or if you want to boot the disk using the BOOT command. When using the «none» filesystem, you 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, you would type (without the quotes):

«imgmount 3 d:\test.img -size 512,63,16,142 -fs none»
Compare this with a mount to be able to access the drive
within DOSBox, which would read as:
«imgmount e: d:\test.img -size 512,63,16,142»

-size
The Cylinders, Heads and Sectors of the drive. Required to mount hard drive images.

An example how to mount CD-ROM images (in Linux):

1. imgmount d /tmp/cdimage1.cue /tmp/cdimage2.cue -t cdrom

or (which also works):

1. mount c /tmp
2. imgmount d c:\cdimage1.cue c:\cdimage2.cue -t cdrom

imgmount d f:\img\CD1.cue f:\img\CD2.cue f:\img\CD3.cue -t cdrom
imgmount d «g:\img\7th Guest CD1.cue» «g:\img\7th Guest CD2.cue» -t cdrom

Don’t forget that you can also use MOUNT with images, but only if you use external program, for example (both are free):

(for CD images) (for floppy images)

Although IMGMOUNT can give better compatibility.

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 other operating systems inside DOSBox. If the target emulated system is PCjr (machine=pcjr) the boot command can be used to load PCjr cartridges (.jrc).

BOOT [diskimg1.img diskimg2.img .. diskimgN.img] [-l driveletter]
BOOT [cart.jrc] (PCjr only)

diskimg1.img diskimg2.img .. 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, hit CTRL-F4 to change from the current disk
to the next disk in the list. The list will loop back from the last
disk image to the beginning.

[-l driveletter]

This parameter allows you to specify the drive to boot from. The default is the A drive, the floppy drive. You can also boot a hard drive image mounted as master by specifying «-l C» without the quotes, or the drive as slave by specifying «-l D»

cart.jrc (PCjr only)

When emulation of a PCjr is enabled, cartridges can be loaded with the BOOT command. Support is still limited.

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 the commands and relevant documentation.

With regard to actually setting up a network, one system needs to be the server. To set this up, type «IPXNET STARTSERVER» (without the quotes) in a DOSBox session. The server DOSBox session will automatically add itself to the virtual IPX network. For every additional 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.

To play games that need Netbios a file named NETBIOS.EXE from Novell is needed. Establish the IPX connection as explained above, then run «netbios.exe».

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. You 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 an 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>

If the server is behind a router, UDP port <port> needs to be forwarded to that computer.On Linux/Unix-based systems port numbers smaller than 1023 can only be used with root privileges. Use ports greater than 1023 on those systems.

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 that are 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 session’s IPX tunneling network. For a list of all computers connected to the network use the IPXNET PING command.

The syntax for IPXNET STATUS is:
IPXNET STATUS

KEYB [keyboardlayoutcode [codepage [codepagefile]]]

1. To load the polish typist keys layout (automatically uses codepage 852):
   keyb pl214
2. To load one of russian keyboard layouts with codepage 866:
   keyb ru441 866
   In order to type russian characters press ALT+RIGHT-SHIFT.
3. To load one of french keyboard layouts with codepage 850 (where the
   codepage is defined in EGACPI.DAT):
   keyb fr189 850 EGACPI.DAT
4. To load codepage 858 (without a keyboard layout):
   keyb none 858
   This can be used to change the codepage for the FreeDOS keyb2 utility.
5. To display the current codepage and, if loaded, the keyboard layout:
   keyb

For more information use the /? command line switch with the programs.

================
5. Special Keys:
================

ALT-ENTER	Switch to full screen and back.
ALT-PAUSE	Pause emulation (hit ALT-PAUSE again to continue).
CTRL-F1	Start the keymapper.
CTRL-F4	Change between mounted floppy/CD images. Update directory cache for all drives.
CTRL-ALT-F5	Start/Stop creating a movie of the screen. (avi video capturing)
CTRL-F5	Save a screenshot. (PNG format)
CTRL-F6	Start/Stop recording sound output to a wave file.
CTRL-ALT-F7	Start/Stop recording of OPL commands. (DRO format)
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)*.
ALT-F12	Unlock speed (turbo button/fast forward)**.
F11, ALT-F11	(machine=cga) change tint in NTSC output modes***
F11	(machine=hercules) cycle through amber, green, white colouring***

*NOTE: Once you increase your DOSBox cycles beyond your computer CPU resources, it will produce the same effect as slowing down the emulation. This maximum will vary from computer to computer.

**NOTE: You need free CPU resources for this (the more you have, the faster it goes), so it won’t work at all with cycles=max or a too high amount of fixed cycles. You have to keep the keys pressed for it to work!

***NOTE: These keys won’t work if you saved a mapper file earlier with a different machine type. So either reassign them or reset the mapper.

These are the default keybindings. They can be changed in the keymapper (see Section 7: KeyMapper).

In MAC OS you can try using cmd(applekey) together with Ctrl if the key doesn’t work eg. cmd-ctrl-F1, but some keys may still need remapping (in Linux too).

Saved/recorded files can be found in:

/.dosbox/capture
(MAC OS X) «

This can be changed in the DOSBox configuration file.

====================
6. Joystick/Gamepad:
====================

The standard joystick port in DOS supports a maximum of 4 axes and 4 buttons. For more, different modifications of that configuration were used.

To force DOSBox to use a different type of emulated joystick/gamepad, the entry «joysticktype» in the [joystick] section of the DOSBox configuration file can be used.

(default) autodetects whether you have one or two controllers connected:

if you have one — ‘4axis’ setting is used,
if you have two — ‘2axis’ setting is used.

You also have to configure controller properly inside the game.

It is important to remember that if you saved the mapperfile without joystick connected, or with a different joystick setting, your new setting will not work properly, or not work at all, until you reset DOSBox’s mapperfile.

If controller is working properly outside DOSBox, but doesn’t calibrate properly inside DOSBox, try different ‘timed’ setting in DOSBox’s configuration file.

=============
7. KeyMapper:
=============

You start the DOSBox mapper either with CTRL-F1 (see section 5. Special Keys) or -startmapper (see Section 3. Command Line Parameters). You are presented with a virtual keyboard and a virtual joystick.

These virtual devices correspond to the keys and events DOSBox will report to the DOS applications. If you click on a button with your mouse, you can see in the lower left corner with which event it is associated (EVENT) and to what events it is currently bound.

EVENT

The key or joystick axis/button/hat DOSBox will report to DOS applications. (the event that will happen during the game, (eg. shooting/jumping/walking)

BIND

The key on your real keyboard or the axis/button/hat on your real joystick(s) (as reported by SDL), which is connected to the EVENT.

mod1,2,3

Modifiers. These are keys you need to have to be pressed 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. Basically add a key from your keyboard or an event from the joystick (button press, axis/hat movement) which will produce the EVENT in DOSBox.

Del

Delete the BIND to this EVENT. If an EVENT has no BINDS, then it is not possible to trigger this event in DOSBox (that is there’s no way to type the key or use the respective action of the joystick).

Next

Go through the list of bindings which map to this EVENT.

Example:

Q1. You want to have the X on your keyboard to type a Z in DOSBox.

A. Click on the Z on the keyboard mapper. Click «Add». Now press the X key on your keyboard.

Q2. If you click «Next» a couple of 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» until 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» until you find the mapped key X. Click «Del».

Examples about remapping the joystick:

You have a joystick attached, it is working fine under DOSBox and you want to play some keyboard-only game with the joystick (it is assumed that the game is controlled by the arrows on the keyboard):

1. Start the mapper, then click on one of the left keyboard arrow. EVENT should be key_left. Now click on Add and move your joystick in the respective direction, this should add an event to the BIND.
2. Repeat the above for the missing three directions, additionally the buttons of the joystick can be remapped as well (fire/jump).
3. Click on Save, then on Exit and test it with some game.

You want to swap the y-axis of the joystick because some flightsim uses the up/down joystick movement in a way you don’t like, and it is not configurable in the game itself:

1. Start the mapper and click on Y- in the first joystick field. EVENT should be jaxis_0_1-.
2. Click on Del to remove the current binding, then click Add and move your joystick downwards. A new bind should be created.
3. Repeat this for Y+, save the layout and finally test it with some game.

If you want to remap anything to your d-pad/hat you will have to change ‘joysticktype=auto’ to ‘joysticktype=fcs’ in configuration file. Maybe this will be improved in the next dosbox version.

If you change the default mapping, you can save your changes by clicking on «Save». DOSBox will save the mapping to a location specified in the configuration file (the mapperfile= entry). At startup, DOSBox will load your mapperfile, if it is present in the DOSBox configuration file.

===================
8. Keyboard Layout:
===================

To switch to a different keyboard layout, either the entry «keyboardlayout» in the [dos] section of the DOSBox configuration file can be used, or the internal DOSBox program keyb.com (Section 4: Internal Programs) Both accept DOS conforming language codes (see below), but only by using keyb.com a custom codepage can be specified.

The default keyboardlayout=auto currently works under windows only. The language is chosen according to the OS language, but the keyboard layout is not detected.

Layout switching

DOSBox supports a number of keyboard layouts and codepages by default, in this case just the layout identifier needs to be specified (like keyboardlayout=PL214 in the DOSBox configuration file, or using «keyb PL214» at the DOSBox command prompt). The list of all layouts built into DOSBox is here: https://www.vogons.org/viewtopic.php?t=21824

Some keyboard layouts (for example layout GK319 codepage 869 and layout RU441 codepage 808) have support for dual layouts that can be accessed by pressing LeftALT+RrightSHIFT for one layout and LeftALT+LeftSHIFT for the other. Some keyboard layouts (for example layout LT456 codepage 771) have support for three layouts, third can be accessed by pressing LeftALT+LeftCTRL

Supported external files

The FreeDOS .kl files are supported (FreeDOS keyb2 keyboard layoutfiles) as well as the FreeDOS keyboard.sys/keybrd2.sys/keybrd3.sys libraries which consist of all available .kl files. See http://www.freedos.org/ for precompiled keyboard layouts if the DOSBox-integrated layouts don’t work for some reason, or if updated or new layouts become available.

Both .CPI (MS-DOS and compatible codepage files) and .CPX (FreeDOS UPX-compressed codepage files) can be used. Some codepages are compiled into DOSBox, so it is mostly not needed to care about external codepage files. If you need a different (or custom) codepage file, copy it into the directory of the DOSBox so it is accessible for DOSBox. If you place all ten ega.cpx files (from FreeDOS) in DOSBox folder, an appropriate codepagefile for the requested layout/codepage is chosen automatically.

Additional layouts can be added by copying the corresponding .kl file into the directory of the DOSBox configuration file and using the first part of the filename as language code.

Example: For the file UZ.KL (keyboard layout for Uzbekistan) specify «keyboardlayout=uz» in the DOSBox configuration file.
The integration of keyboard layout packages (like keybrd2.sys) works similar.

Note that the keyboard layout allows foreign characters to be entered, but there is NO support for them in filenames. Try to avoid them both inside DOSBox as well as in files on your host operating system that are accessible by DOSBox.

==============================
9. Serial Multiplayer feature:
==============================

DOSBox can emulate a serial nullmodem cable over network and internet. It can be configured through the [serialports] section in the DOSBox configuration file.

To create a nullmodem connection, one side needs to act as the server and one as the client.

The server needs to be set up in the DOSBox configuration file like this:

serial1=nullmodem server:<IP or name of the server>

Now start your game and choose nullmodem / serial cable / already connected as multiplayer method on COM1. Set the same baudrate on both computers.

Furthermore, additional parameters can be specified to control the behavior of the nullmodem connection. These are all parameters:

* port:	—	TCP port number. Default: 23
* rxdelay:	—	how long (milliseconds) to delay received data if the interface is not ready. Increase this value if you encounter overrun errors in the DOSBox Status Window. Default: 100
* txdelay:	—	how long to gather data before sending a packet. Default: 12 (reduces Network overhead)
* server:	—	This nullmodem will be a client connecting to the specified server. (No server argument: be a server.)
* transparent:1	—	Only send the serial data, no RTS/DTR handshake. Use this when connecting to anything other than a nullmodem.
* telnet:1	—	Interpret Telnet data from the remote site. Automatically sets transparent.
* usedtr:1	—	The connection will not be established until DTR is switched on by the DOS program. Useful for modem terminals. Automatically sets transparent.
* inhsocket:1	—	Use a socket passed to DOSBox by command line. Automatically sets transparent. (Socket Inheritance: It is used for playing old DOS door games on new BBS software.)

Example: Be a server listening on TCP port 5000.
serial1=nullmodem server:<IP or name of the server> port:5000 rxdelay:1000

=====================================
10. How to speed up/slow down DOSBox:
=====================================

DOSBox emulates the CPU, the sound and graphic cards, and other peripherals of a PC, all at the same time. The speed of an emulated DOS application depends on how many instructions can be emulated, which is adjustable (number of cycles).

CPU Cycles (speed up/slow down)

By default (cycles=auto) DOSBox tries to detect whether a game needs to be run with as many instructions emulated per time interval as possible (cycles=max, sometimes this results in game working too fast or unstable), or whether to use fixed amount of cycles (cycles=3000, sometimes this results in game working too slow or too fast). But you can always manually force a different setting in the DOSBox’s configuration file.

You can force the slow or fast behavior by setting a fixed amount of cycles in the DOSBox’s configuration file. If you for example set cycles=10000, then DOSBox window will display a line «Cpu Speed: fixed 10000 cycles» at the top. In this mode you can reduce the amount of cycles even more by hitting CTRL-F11 (you can go as low as you want) or raise it by hitting CTRL-F12 as much as you want, but you will be limited by the power of one core of your computer’s CPU. You can see how much free time your real CPU’s cores have by looking at the Task Manager in Windows 2000/XP/Vista/7 and the System Monitor in Windows 95/98/ME. Once 100% of the power of your computer’s real CPU’s one core is used, there is no further way to speed up DOSBox (it will actually start to slow down), unless you reduce the load generated by the non-CPU parts of DOSBox. DOSBox can use only one core of your CPU, so If you have for example a CPU with 4 cores, DOSBox will not be able to use the power of three other cores.

You can also force the fast behavior by setting cycles=max in the DOSBox configuration file. The DOSBox window will display a line «Cpu Speed: max 100% cycles» at the top then. This time you won’t have to care how much free time your real CPU’s cores have, because DOSBox will always use 100% of your real CPU’s one core. In this mode you can reduce the amount of your real CPU’s core usage by CTRL-F11 or raise it with CTRL-F12.

CPU Core (speed up)

On x86 architectures you can try to force the usage of a dynamically recompiling core (set core=dynamic in the DOSBox configuration file). This usually gives better results if the auto detection (core=auto) fails. It is best accompanied by cycles=max. But you may also try using it with high amounts of cycles (for example 20000 or more). Note that there might be games that work worse/crash with the dynamic core (so save your game often), or do not work at all!

Graphics emulation (speed up)

VGA emulation is a demanding part of DOSBox in terms of actual CPU usage. Increase the number of frames skipped (in increments of one) by pressing CTRL-F8. Your CPU usage should decrease when using a fixed cycle setting, and you will be able to increase cycles with CTRL-F12. You can 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.

Sound emulation (speed up)

You can also try to disable the sound through the setup utility of the game to reduce load on your CPU further. Setting nosound=true in DOSBox’s configuration does NOT disable the emulation of sound devices, just the output of sound will be disabled.

Also try to close every program but DOSBox to reserve as much resources as possible for DOSBox.

Advanced cycles configuration:

The cycles=auto and cycles=max settings can be parameterized to have different startup defaults. The syntax is

cycles=auto [«realmode default»] [«protected mode default»%] [limit «cycle limit»]
cycles=max [«protected mode default»%] [limit «cycle limit»]

cycles=auto 5000 80% limit 20000
will use cycles=5000 for real mode games, 80% CPU throttling for protected mode games along with a hard cycle limit of 20000

====================
11. Troubleshooting:
====================

DOSBox crashes right after starting it:

• use different values for the output= entry in your DOSBox configuration file
• try to update your graphics card driver and DirectX
• (Linux) set the environment variable SDL_AUDIODRIVER to alsa or oss.

Running a certain game closes DOSBox, crashes with some message or hangs:

• see if it works with a default DOSBox installation (unmodified configuration file) try it with sound disabled (use the sound configuration program that comes with the game, additionally you can set sbtype=none and gus=false in the DOSBox configuration file)
• change some entries of the DOSBox configuration file, especially try:
  core=normal
  fixed cycles (for example cycles=10000)
  ems=false
  xms=false
  or combinations of the above settings, similar the machine settings that control the emulated chipset and functionality:
  machine=vesa_nolfb
  or
  machine=vgaonly
• use loadfix before starting the game

The game exits to the DOSBox prompt with some error message:

• read the error message closely and try to locate the error
• try the hints at the above sections
• mount differently as some games are picky about the locations, for example if you used «mount d d:\oldgames\game» try «mount c d:\oldgames\game» and «mount c d:\oldgames»
• if the game requires a CD-ROM be sure you used «-t cdrom» when mounting and try different additional parameters (the ioctl, usecd and label switches, see the appropriate section)
• check the file permissions of the game files (remove read-only attributes, add write permissions etc.)
• try reinstalling the game within DOSBox

=========================
12. DOSBox Status Window:
=========================

DOSBox’s Staus window contains many useful information about your currant configuration, your actions in DOSBox, errors that happened and more. Whenever you have any problem with DOSBox check these messages.

To start DOSBox Status Window:

(Windows) Status Window is being started together with main DOSBox window.
(Linux) You may have to start DOSBox from a console to see Status Window.
(MAC OS X) Right click on DOSBox.app, choose «Show Package Contents»->enter «Contents»->enter «MacOS»->run «DOSBox»

=====================================
13. The configuration (options) file:
=====================================

The configuration file is automatically created the first time you run DOSBox. The file can be found in:

/Library/Preferences/DOSBox 0.74-3 Preferences»

The file is divided into several sections. Each section starts with a [section name] line. The settings are the property=value lines where value can be altered to customize DOSBox.
# and % indicate comment-lines.

An extra configuration 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 Section 4: «Internal programs» for usage of CONFIG.COM. You can start DOSBox with the -conf switch to load the generated file and use its settings.

DOSBox will load configuration files that are specified with -conf. If none were specified, it will try to load «dosbox.conf» from the local directory. If there is none, DOSBox will load the user configuration file. This file will be created if it doesn’t exist.

Important!: In Windows Vista/7 the configuration file won’t work correctly if it is located in «Windows» or «Program Files» folder or their subfolders, or directly on c:\, so the best place for storing extra configuration files is for example: C:\oldgames