LINK Help (linker.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
Creating a .DEF File for Overlays
◄Up► ◄Contents► ◄Index► ◄Back►
─────LINK───────────────────────────────────────────────────────────────────
To specify the organization of your overlaid program, write a
module-definition (.DEF) file. Valid statements in a .DEF file for
an overlaid program are SEGMENTS, FUNCTIONS, and INCLUDE. LINK
ignores other statements when linking an overlaid DOS program.
See: ◄Module-Definition Files►
◄FUNCTIONS Statement►
◄SEGMENTS Statement►
◄INCLUDE Statement►
The FUNCTIONS and SEGMENTS Statements
The FUNCTIONS and SEGMENTS statements place code in overlays.
Valid overlay numbers are in the range 1-65,535. To place code in
the root, specify 0. Use FUNCTIONS and SEGMENTS as follows:
■ To place an entire segment into an overlay, use a SEGMENTS
statement specified with an overlay number.
■ To place a function into an overlay, use a FUNCTIONS
statement specified with an overlay number. The function must
be compiled as a packaged function. If a function is
explicitly allocated, it cannot be assigned to a different
overlay from the segment that contains the function.
■ To place a function into a segment and then place the segment
into an overlay, use a FUNCTIONS statement specified with a
segment name and a SEGMENTS statement specified with the
segment name and an overlay number. The function must be
compiled as a packaged function. An explicitly allocated
function cannot be assigned to a segment different from the
one to which it was allocated.
■ To assign an explicitly allocated function to an overlay, use
a FUNCTIONS statement specified with an overlay number, and
do not assign its segment or any other functions in that
segment to an overlay. A FUNCTIONS statement that specifies
an explicitly allocated function implicitly assigns that
function's entire segment to the overlay.
The INCLUDE Statement
The INCLUDE statement inserts a specified text file at the place
where it is specified in a .DEF file. The INCLUDE statement
behaves the same way in .DEF files for all program types.
-♦-