DOS Compilation / Development Guide¶
This guide will use cross-compilation from Linux to build a DOS executable with the DJGPP toolchain.
DJGPP builds 32-bit programs, which means an 80386 or higher processor is required. 80286 is not supported.
RetroArch on DOS is statically linked. With statically linked RetroArch, each executable is a separate libretro core instead of the core being separately loaded from a single executable. A pre-existing libretro library needs to be present in the root of the source directory in order to link RetroArch DOS. This file needs to be called 'libretro.a'.
Clone RetroArch's repository from GitHub
git clone https://github.com/libretro/RetroArch.git retroarch cd retroarch
For subsequent builds you only need to pull the changes from the repo
cd retroarch git pull
To compile RetroArch run the following commands inside RetroArch's source tree:
1 2 3
CROSS_COMPILE=i686-pc-msdosdjgpp- ./configure --with-libretro="-L. -lretro" make clean make -j4
Replace the value of
CROSS_COMPILE with the prefix of your specific toolchain if necessary.
Once finished, you should find
retroarch.exe in the current directory, this is the final binary you can run inside DOS. Since older DOS versions do not support long filenames, you may want to rename this file to something shorter.
RetroArch for DOS also requires the CWSDPMI server application from the DJGPP distribution, which can be downloaded separately here. On the target system, CWSDPMI.EXE will need to be placed in the same directory as your RetroArch executable for it to run properly.
Once you have the DPMI program in place, simply run your RetroArch executable and the DPMI server will be loaded automatically at startup.
It is also possible to include the DPMI server inside the main RetroArch executable so that only a single file is needed, but that is outside the scope of this document. See here for more information.