Reference Pages


Содержание

dosbox - Эмулятор x86/DOS с поддержкой звука и графики
dosbox-install - Инсталлятор игр для DOSBox

Название

dosbox — Эмулятор x86/DOS с поддержкой звука и графики

Синтаксис

/usr/bin/dosbox [-version] [-fullscreen] [-conf configfile] [-lang langfile] [-machine machinetype] [-c command] [-exit] [file]

ОПИСАНИЕ

DOSBox является программным эмулятором процессоров Intel x86 и операционной системы DOS.

Необязательный аргумент file должен быть приложением DOS или именем каталога. Если это приложение (.com .exe .bat), указанная программа будет запущена, а её каталог будет подключен в DOS-сессии как диск C:. Если file является именем каталога, откроется DOS-сессия с командной строкой, причём указанный каталог будет виден как диск C:.

ОПЦИИ

Ниже перечислен список поддерживаемых ключей командной строки:

-version

Вывести на консоль версию программы и выйти.

-fullscreen

Запустить DOSBox в полноэкранном режиме.

-c command

Выполнить в DOS-сессии внутреннюю команду command перед запуском пользовательской программы file. Можно указывать больше одной команды, но перед каждой из них должен быть -c.

-conf configfile

Запустить DOSBox с настройками из файла configfile.

-lang langfile

Запустить DOSBox с текстами сообщений из файла langfile.

-machine machinetype

Указать тип оборудования, который DOSBox должен эмулировать. Возможные значения: hercules, cga, tandy, vga (по умолчанию).

-exit

Закрыть DOS-сессию немедленно после завершения пользовательской программы, заданной параметром file.

ВНУТРЕННИЕ КОМАНДЫ

Командная строка DOSBox поддерживает большинство команд, имевшихся в стандартном command.com. В дополнение к ним доступны следующие команды:

MOUNT {буква-диска} {исходный-каталог} [-t тип] [-size размер] [-freesize Nмегабайт] [-usecd номер-устройства] [-label метка-диска]

MOUNT -cd

Программа для назначения внешних каталогов логическими дисками внутри DOS-сессии. Дополнительные параметры содержат информацию, которую DOSBox будет сообщать запускаемым внутри него приложениям.

буква-диска

Буква диска внутри DOS-сессии, например, C.

исходный-каталог

Каталог внешней файловой системы, который требуется "увидеть" внутри DOS-сессии как логический диск.

-t тип-устройства

Тип, который будет иметь логический диск. Возможные значения: dir (по умолчанию), floppy, cdrom.

-size размер-диска

Позволяет явно задать размер логического диска, сообщаемый DOS-приложениям.

-freesize N_мегабайт

Позволяет явно задать количество свободного места на логическом диске, сообщаемое DOS-приложениям.

-label метка-диска

Установить метку диска в указанное значение. Требуется на некоторых системах, если метка CD-ROM'а читается неверно, и запускаемая программа не может распознать свой диск.

-usecd номер-устройства

Принудительная поддержка CD-привода библиотекой SDL для устройства с указанным номером. Номер может быть определён командой mount -cd.

-cd

Показать все обнаруженные CD-приводы и их номера. Служит для использования в -usecd.

MEM

Показать объём свободной памяти

CONFIG [-writeconf file]

CONFIG [-writelang file ]

Записать текущие настройки или тексты сообщений в file. Имя файла принадлежит внешней файловой системе, а не логическому диску, смонтированному внутри DOSBox, например, /usr/local/etc/dosbox/dosbox.conf.

LOADFIX [-size] [имя-программы] [параметры-программы...]

LOADFIX [-f]

Программа для "отъедания" части ОЗУ, используемая для запуска некоторых DOS-приложений, не умевших работать в младших 64k. -size является количеством килобайт оперативной памяти для захвата, например, -32, -64 или -128.

Если в командной строке указано также имя программы, loadfix немедленно запускает её, подставляя в её командную строку необязательные аргументы, указываемые за её именем.

Ключ -f освобождает всю память, захваченную loadfix'ом при предыдущем запуске.

ФАЙЛЫ

Файлы настроек и сообщений используют такой же формат, как и INI-файлы Windows. dosbox.conf ищется сначала либо по заданному ключом -conf пути, либо в текущем каталоге. Затем, если он не найден, проверяется его наличие в домашнем каталоге.

ГОРЯЧИЕ КЛАВИШИ

ALT-ENTER

Переключение между оконным и полноэкранным режимом.

CTRL-F5

Сохранить образ экрана. Имя каталога задаётся в конфигурационном файле, в секции render директивой snapdir. Файлы имеют имена вида snapNNNN.png, где NNNN является порядковым номером.

CTRL-F6

Начать/закончить запись звукового выхода в WAV-файл.

CTRL-F7

Уменьшить количество пропускаемых кадров.

CTRL-F8

Увеличить количество пропускаемых кадров.

CTRL-F9

Закрыть DOS-сессию немедленно.

CTRL-F10

Захватить/освободить мышь.

CTRL-F11

Замедлить эмуляцию (увеличить количество циклов простоя).

CTRL-F12

Ускорить эмуляцию (уменьшить количество циклов простоя).

Примечание

Once you increase your DOSBox cycles beyond your computer's maximum capacity, it will produce the same effect as slowing down the emulation. This maximum will vary from computer to computer, there is no standard.

СИСТЕМНЫЕ ТРЕБОВАНИЯ

Быстрый компьютер. Для выполнения игры, написанной под 286, эмулятору необходим PII-400. Для игр, работающих в защищённом режиме, требуется как минимум гигагерцевый процессор.

Как запускать мммеедленннннные игры

DOSBox программно эмулирует центральный процессор, звуковую карту, видеокарту и кое-что ещё из оборудования IBM PC. Вы можете повысить скорость DOS-сессии, нажимая CTRL-F12, но при этом вы ограничены скоростью вашего настоящего процессора. Количество свободного процессорного времени показывают различные утилиты, например, top. Если занято 100% времени настоящего процессора, не существует другого способа увеличить скорость, кроме уменьшения нагрузки, создаваемой всем, что выполняется, не считая подсистемы эмуляции процессора в dosbox'е.

То есть:

  • закройте все программы, кроме dosbox;
  • разгоняйте dosbox, пока он не захватит все 100% процессорного времени, нажимая CTRL-F12.

Поскольку эмуляция VGA потребляет большую часть процессорного времени, начнём с неё. Увеличивайте количество пропускаемых кадров нажатиями CTRL-F8 до тех пор, пока загрузка процессора не станет меньше 100%. После этого вернитесь на шаг назад нажатием CTRL-F7.

Примечания

Мы свято верим, что в один прекрасный день DOSBox будет запускать в виртуальной среде все программы, когда-либо сделанные для PC... но пока этот великий час ещё не пробил. В настоящий момент DOSBox, запущенный на 1.7-гигагерцевом компьютере, работает со скоростью 386-25MHz.

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

ОШИБКИ

Не все DOS-приложения работают корректно.

Если произошла ошибка, DOSBox завершается без предупреждений.

Если DOSBox запущен не из X Window, может произойти всё, что угодно, вплоть до полного зависания.

СМ. ТАКЖЕ

Файлы конфигурации в /etc/dosbox, README и примеры настроек в /usr/share/doc/dosbox-*.

АВТОРЫ

Авторы исходного английского варианта man-страницы для Debian Linux: Peter Veenstra <H.P.Veenstra@student.rug.nl> и James Oakley <jfunk@funktronics.ca>.

Автор русского перевода для ALTLinux: Илья Евсеев. Из русского варианта удалено описание ключей для DOSBox/Win32.


Название

dosbox-install — Инсталлятор игр для DOSBox

Синтаксис

/usr/bin/dosbox-install [[-h] | [--help]] [[-V] | [--version]] [--verbose] [--executable EXE-filename] [--project Menu-itemname] [--basedir каталог-для-диска-C] [file-or-URL...]

/usr/bin/dosbox-install [[-u] | [--uninstall] | [--remove]] [game-name...]

ОПИСАНИЕ

dosbox-install выполняет четыре функции:

  • скачивает заданный URL с помощью wget или lftpget;

  • если скачанный файл является архивом, распаковывает его в каталог с программами для DOSBox;

  • находит внутри распакованного каталога запускаемый файл (BAT, COM или EXE);

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

Типы аргументов

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

  • если это URL вида протокол://адрес, то выполняются шаги 1-4;

  • если это файл с расширением ZIP, RAR или ARJ, выполняются шаги 2-4;

  • если это каталог, выполняются шаги 3 и 4;

  • если это исполняемый файл EXE/BAT/COM, выполняется шаг 4.

Примеры

  • Скачать, распаковать, найти исполняемый файл, добавить в меню:

    dosbox-install http://ilya-evseev.narod.ru/games/tower.zip

  • Распаковать, найти исполняемый файл, добавить в меню:

    dosbox-install /tmp/ugh.zip

  • Найти исполняемый файл и добавить его запуск в Главное меню:

    dosbox-install /mnt/windows/Games/DefenderOfTheCrown/

  • Добавить исполняемый файл в Главное меню.

    dosbox-install /mnt/windows/Games/LR/LR.COM

Удаление

При запуске с ключом -u происходит удаление уже установленного пакета:

  • удаляется указанный подкаталог из каталога с программами для DOSBox;

  • удаляется одноимённый значок из главного меню графической среды.

ОПЦИИ

-h , --help ,

Вывод краткой подсказки.

-V , --version ,

Информация о версии.

--verbose

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

--executable EXE-filename

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

Примеры:
dosbox-install --executable SIMFILES/SIM.EXE /mnt/windows/Games/SimCity/ dosbox-install --executable gpega.exe /usr/games/dosgames/GrandPrix

--basedir каталог-для-диска-C

Если диском C: должен быть не каталог, в котором непосредственно расположен исполняемый файл, а один из каталогов верхнего уровня, данный ключ позволяет явно указать его.

Пример:
dosbox-install --basedir /mnt/windows/Games/SimCity/ SIMFILES/SIM.EXE

--project Menu-itemname

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

Пример:
dosbox-install --project "Accolade GrandPrix Rally" /usr/games/dosgames/gp/gpega.exe

-u name

Из каталога с DOS-приложениями удаляется указанный подкаталог, из каталога со списком пунктов меню удаляется соответствующий пункт.

Пример:
dosbox-install --remove tower ugh para

ФАЙЛЫ

/usr/games/dosbox является базовым каталогом, в который dosbox-install разворачивает архивы.

/usr/lib/menu содержит файлы-описатели пунктов меню для графической системы.

АВТОРЫ

<evseev@altlinux.ru>, 2003-2004.

СМ. ТАКЖЕ

dosbox(1)
update-menus(1)