https://github.com/dosworld/rtools

RDOFF2 16/32 bit object code linker for MS-DOS (Link into COM, MZ, ADAM, LX, PE32 formats).
https://github.com/dosworld/rtools

16-bit com dos exe link linker ms-dos nasm obj object pascal rdf rdl

Last synced: about 2 months ago
JSON representation

RDOFF2 16/32 bit object code linker for MS-DOS (Link into COM, MZ, ADAM, LX, PE32 formats).

• Host: GitHub
• URL: https://github.com/dosworld/rtools
• Owner: DosWorld
• License: mit
• Created: 2022-01-06T01:32:58.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2022-11-11T11:02:58.000Z (about 2 years ago)
• Last Synced: 2023-03-28T20:34:37.601Z (almost 2 years ago)
• Topics: 16-bit, com, dos, exe, link, linker, ms-dos, nasm, obj, object, pascal, rdf, rdl
• Language: Pascal
• Homepage:
• Size: 690 KB
• Stars: 8
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.MD
  • License: LICENSE.TXT

Awesome Lists containing this project

README

        
# RTools

This is MS-DOS tools for linking `RDF`/`RDL` files.

While playing with small compilers, I noticed one problem for all beginners.

It lacks runtime-libraries and linkers support.

I investigate the OBJ/OMF format and found it too complicated.

AOUTB has no segment memory support. COFF and ELF are also complex

and solve problems non-relevant to MS-DOS.

By chance, I meet the RDOFF2 format from NASM - a beautiful and simple

format for object modules.

This repository contains tools for working with RDOFF2 (and source code)

to help you build small compilers.

`RDF` - NASM builtin format `RDOFF2` for object files. Different version of

Nasm works different with this files. So, I strongly advise to use

`NASM version 0.98.39`. See DOC\RDOFF2.TXT and source code.

`RDL` - Again, NASM-format but for libraries.

* nasm - version `0.98.39`, just recompiled for MS-DOS (no DPMI) with RDF support

(by default - is disabled). No other changes.

* rdfdump - dump utility

* rlib - library manager

* rlink - linker itself

# RLINK

RLINK can generate huge files. To speed up RLINK - point your TMP/TEMP directory to ramdrive.

So, don't be confused with dos 16-bit application - RLINK known how to handle more then 64kb and 640kb :).

## Supported output formats

* COM - simple MS-DOS .com file

* MZS - MS-DOS exe, small memory model (CS = code, DS = data,bss,stack)

* MZL - MS-DOS exe, large memory model (each rdf have own CS, DS and BSS segment)

* ADAM - DOS32 Extender.

* LX - OS/2 and DPMI exe file.

* PE - DOS PE32 file (PE32 without imports).

* RDF - Linked rdf into one code-segment (like a .com, but with zero offset and name). Could be used as DLL.

If you load code segment at ????:0000 - you don't need process relocations. And, as bonus, you can use symbol table.

## Builtin stubs and extenders

* Simple stub (will write something like "This is dpmi exe!"). Can be used with HX-DOS Extender or with LX format

 (if you want bind other DOS-Extender).

* Loader DOS32 Extender (for ADAM)

* ZRDX DOS-Extender (for LX)

* Loader HX-DOS Extender (for PE).

If you need viewer for RDF, please visit to https://github.com/DosWorld/objview

"Make" utility available at https://github.com/DosWorld/smallmake

# How to use

See MAKEFILE in TEST directory.

# Dependencies

Requires System2 library:

https://github.com/DosWorld/libsystem2

# Build

You need Turbo Pascal, System2 library and "make" in path.

Just type:

        cd src

        make

# License

NASM version 0.98.39 binaries distributed with own different license

and copyright-holders (see DOC\NASMLIC.TXT, GNU LGPL).

MIT License