LD(1)                    DOMAIN/IX SYS5                     LD(1)



NAME
     ld - link editor

USAGE
     ld [ -r ] [ -d ] [ -o name ] file ... [ -l [x] ]

DESCRIPTION
     Ld combines several object programs into one, resolves
     external references, and searches libraries usually created
     by ar(1).  It can also be used on libraries created by
     /com/lbr (the DOMAIN librarian) and object modules produced
     by /com/bind (the DOMAIN binder).  When you specify several
     object files, ld combines them, producing an object module
     which can either be executed or become the input for a
     further ld run.  If the module is to be used as input, you
     should supply the -r option to preserve the relocation bits.
     The output of ld is left on an a.out file.

     Ld concatenates the argument routines in the order speci-
     fied.  If any argument is a library, ld searches it exactly
     once at the point encountered in the argument list.  Only
     those routines defining an unresolved external reference are
     loaded.  The order of programs within libraries is unimpor-
     tant.

OPTIONS
     Except for -l, each of the options used should appear before
     filenames.

     -l[x]     With an x, as in -lx, search /usr/lib/libx.a, or
               /usr/local/lib/libx.a, where x is a string.
               Searching is done when the library's name is
               encountered, so the placement of a -l is signifi-
               cant.

     -r        Do not complain about undefined symbols.

     -o name   Use name as the name of the ld output file,
               instead of a.out.

     -e epsym  Set the default entry point address for the output
               file to be that of epsym.

     -m        Produce a load mapfile of the linked object on the
               standard output.

     -s        Strip line number entries and symbol table infor-
               mation from the output object file.

     -L dir    Change the algorithm of searching for libx.a to



Printed 12/4/86                                              LD-1

LD(1)                    DOMAIN/IX SYS5                     LD(1)



               look in dir before looking in /usr/lib and
               /usr/local/lib. This option is only effective if
               it preceeds the -l option on the command line.

     -M        Complain if external definitions do not match.

     -VS num   Include a version num in the object.

     -Wl,arg1,[arg2...]
               Pass argi to the binder.

     -T systype
               Override the systype for which the input modules
               were compiled, and stamp the output module with
               the given systype.  Use of this option changes the
               runtime semantics of the system calls and may
               cause the modules not to work.  Its use is
               discouraged.

     -f        Not supported.

     -t        Not supported.

     -u        Not supported.

     -x        Not supported.

     -V        Not supported.

FILES
     /usr/lib/lib?.a
                    libraries

     a.out          output file

RELATED INFORMATION
     ar(1), cc(1), ar(4).
















LD-2                                              Printed 12/4/86