AT&T UNIX™PC Unix System V Users Manual - tenox

LD ( 1 ) LD (1)
NAME
ld - link editor for common object files
SYNOPSIS
ld [-e epsym] [-f fill] [-lx] [-m] [-o outfile] [-r] [-s] [-t]
[-u sysname] [-x] [-Z] [-L dir] [-M] [-N] [-n] [-z] [-F]
[-V] [-VS num] [-G] [-w] file-names
DESCRIPTION
The ld command combines several object files into one, performs
relocation, resolves external symbols, and supports symbol table
information for symbolic debugging. In the simplest case, the
names of several object programs are given, and ld combines them,
producing an object module that can either be executed or used as
input for a subsequent ld run. The output of ld is left in a.out.
This file is executable if no errors occurred during the load. If any
input file, file-name, is not an object file, ld assumes it is either an
ASCII file containing link editor directives or an archive library.
If any argument is a library, it is searched exactly once at the
point it is encountered in the argument list. Only those routines
defining an unresolved external reference are loaded. The library
(archive) symbol table (see ar( 4)) is searched sequentially with as
many passes as are necessary to resolve external references which
can be satisfied by library members. Thus, the ordering of library
members is unimportant.
The following options are recognized by ld.
-e epsym
Set the default entry point address for the output file to
be that of the symbol epsym .
-f fill Set the default fill pattern for "holes" within an output
section as well as initialized bss sections. The argument
fill is a two-byte constant.
-lx Search a library named libx.a where xis up to nine characters.
A library is searched when its name is encountered,
so the placement of a -1 is significant. By default,
libraries are located in /lib and /usr/lib. However, if
the shell variable LIBROOT is set, the value of
LIBROOT is prepended to /lib and /usr/lib before
searching the libraries.
-m Produce a map or listing of the input/output sections on
the standard output.
-o outfile
Produce an output object file by the name outfile . The
name of the default object file is a.out.
-r Retain relocation entries in the output object file. Relocation
entries must be saved if the output file is to become
an input file in a subsequent ld run. The link editor will
not complain about unresolved references, and the output
file will not be executed.
- 1 -