Name
dosld - MS-DOS cross linker
Syntax
dosld [ options ] file ...
Description
dosld links the object files(s) given by file to create a
program for execution under MS-DOS. Although similar to
ld(CP), dosld has many options that differ significantly
from ld. The options are described below:
-D DS Allocate. This instructs dosld to perform DS
allocation. It is generally used in conjunction with
the -H option.
-H Load high. This option instructs dosld to set a field
in the header of the executable file to tell MS-DOS to
load the program at the highest available position in
memory. It is most often used with programs in which
data precedes code in the memory image.
-L Include line numbers. This option instructs dosld to
include line numbers in the listing file (if any).
Note that dosld cannot put line numbers in the listing
file if the source translator hasn't put them in the
object file.
-M Include public symbols. This option instructs dosld to
include public symbols in the list file. The symbols
are sorted twice, lexicographically and by address.
-C Ignore case. This option instructs dosld to treat upper
and lower case characters in symbol names as identical.
-F num
Set stack size. This option should be followed by a
hexadecimal number. dosld will use this number for the
size in bytes of the stack segment in the output file.
-S num
Set segment limit. This option should be followed by a
decimal number between 1 and 1024. The number sets the
limit on the number of different segments that may be
linked together. The default is 128. Note that the
higher the value given, the slower the link will be.
-m filename
Create map file. This option should be followed by a
filename. dosld will create a file with the given name
in which it will put information about the segments and
groups in the executable. Additionally, public symbols
and line numbers will be listed in this file if the -M
and -L options are given.
-nl num
Set name length. This option should be followed by a
decimal number. The option instructs dosld to truncate
all public and external symbols longer than num
characters.
-o filename
Name output file. This option should be followed by a
filename which dosld will use as the name of the
executable file it creates. The default name is a.out.
-u name
Name undefined symbol. This option should be followed
by a symbol name. dosld will enter the given name into
its symbol table as an undefined symbol. The -u option
may appear more than once on the command line.
-G Ignore group associations. This option instructs dosld
to ignore any group definitions it may find in the
input files. This option is provided for compatibility
with old versions of MS-LINK; generally, it should
never be used.
As with ld, the files passes to dosld may be either UNIX-
style libraries (objects collected using ar(CP) and indexed
using ranlib(CP)) or ordinary 8086 object files. Unless the
-u option appears, at least one of the files passed to dosld
must be an ordinary object file. Libraries are searched
only after all the ordinary object files have been
processed.
Files
/usr/bin/dosld
See Also
ar(CP), as(CP), cc(CP), ld(CP), ranlib(CP)
Value Added
dosld is an extension of AT&T System V provided by the Santa
Cruz Operation.
(printed 6/18/89)