Intel XENIX 286 Programmers Guide (86) - Tenox.tc

Programming Commands XENIX Programming
ld -
Invokes the link editor {linker).
Syntax
ld [ option ] .. . filename
Description
...
ld is the XENIX link editor. It creates an executable program by combining one or more
object files and copying the executable result into the file a.out. The filename must
name an object or library file. These names must have the .o (for object) or .a (for
archive library) extensions. If more than one name is given, the names must be
separated by one or more spaces. If errors occur while linking, ld displays an error
message. The resulting a.out file is unexecutable.
ld concatenates the contents if the given object files in the order given in the command
line. Library files in the command line are examined only if there are unresolved
external references encountered from previous object files. Library files must be in
ranlib format; that is, the first member must be named _.SYMDEF, which is a
dictionary for the library. ld ignores the modification dates of the library and the
.SYMDEF entry, so if object files have been added to the library since -.SYMDEF
was
created, the link may result in "invalid object module."
The library is searched iteratively to satisfy as many references as possible. Only those
routines that define unresolved external references are concatenated. Object and
library files are processed at the point they are encountered in the argument list, so the
order of files in the command line is important. In general, all object files should be
given before the library files. ld sets the entry point of the resulting program to be the
beginning of the first routine.
ld has these options:
-A num
Creates a standalone program whose expected load address (in hexadecimal) is
num. This option sets the absolute flag in the header of the a.out file. Such
program files can only be executed as standalone programs.
-B num
Sets the text selector bias to the specified hexadecimal number.
-C Causes the editor to ignore the case of symbols.
-D num
Sets the data selector bias to the specified hexadecimal number.
-F num
Sets the size of the program to num bytes. Default stack size, if not given, is
4K bytes.
B-74