dos_compilers/README.md

48 lines
3.9 KiB
Markdown
Raw Normal View History

2024-06-30 15:33:18 +02:00
# dos_compilers
MS-DOS compilers, assemblers, and interpreters
2024-06-30 15:39:13 +02:00
The license for this repo applies to code I wrote for this repo including versions of the sieve, e, ttt, and tm benchmarks and the build scripts to invoke the tools. The various DOS tools and documentation each have their own respective license terms. In a few cases I used the sieve benchmark that shipped with the tools, so obviously those copies fall under the license of the respective tool.
I do not own licensing for any of these tools. This repo is simply an aggregation of the tools to ease testing of my NTVDM DOS 3.3 emulator.
In some cases where required I've copied an assembler or linker that did not ship with a given compiler into folders so binaries can be produced. These tools belong to their respective owners.
These tools are available for download from many sites on the internet. They are often in forms that make their extraction and/or use difficult. This repo simplifies the process.
If you own the copyright to any of these tools and want me to take them down, please let me know and I'll do so ASAP. It's not my intention to pirate anyone's software.
I cannot vouch that any of these tools matches their official distribution form. Many of these were apparently taken from snapshots on peoples' machines through the years and include changes, files, and/or configuration not found in a pristine distribution.
In some cases I've included user manuals in PDF form that I've found online for the various compilers. They sometimes match the version and sometimes not, but they are always helpful.
I can vouch that the m.bat script in each folder builds working benchmark binaries. In the cases of tools that can't be invoked via the command-line (e.g. Turbo Pascal), those tools also produce working benchmark binaries.
It is my intention to show each tool in its best light with respect to the benchmarks. If you know of better optimization flags or ways to improve the benchmark source code for a given tool, please feel free to submit a pull request or open an issue. That said, I want to avoid cheap hacks like using peek/poke in BASIC instead of local variables.
The benchmarks include:
* sieve: The classic from BYTE Magazine that counts prime numbers.
* e: Computes the irrational number e to 192 digits.
* ttt: proves you can't win at tic-tac-toe if the opponent is competent
* tm: test malloc. This calls malloc/calloc/free in the C runtime to measure performance. It's C only and many compilers can't run it.
2024-07-03 08:43:42 +02:00
To run the compilers on Windows, use the m.bat script in each folder. Sometimes m.bat is in a subfolder named "bin" or "code". For example:
2024-06-30 15:39:13 +02:00
* m sieve
* m e
* m ttt
To run the resulting apps, use NTVDM's -c flag to force console mode and -p flag to show performance information. The interpreters have other modes for running; see their respective m.bat files for details.
* ntvdm -c -p sieve
* ntvdm -c -p e
* ntvdm -c -p ttt
The Borland Pascal (v1 through v3) and BASIC products don't support command-line builds, so you have to run the apps, load the source file, and build manually.
2024-06-30 17:09:14 +02:00
On Linux or MacOS copy m.bat to m.sh, change % to $, use dos2unix to remove CR/LF, change REM comments to #, and chmod to enable execution. (If you do this, feel free to submit a pull request.) Also be sure to put ntvdm in your path.
2024-06-30 15:39:13 +02:00
If you're running Linux or MacOS and see perplexing compilation errors, it could be your source files don't have cr/lf line separators. Use unix2dos to add them; nearly all these compilers require them. Some compilers require a ^Z / 0x1a at the end of files. CB86 is an example. Again, if you see build errors this may be the problem.
2024-06-30 15:40:19 +02:00
Here are runtimes for the benchmarks in milliseconds for a 4.77Mhz 8086 (not 8088) as emulated by [NTVDM](https://github.com/davidly/ntvdm)
2024-07-03 08:43:42 +02:00
![runtimes](https://github.com/davidly/dos_compilers/assets/1497921/0acd359d-b283-4c54-a6d0-a976e3698c10)