ld(1) — sys5



LD(1)           DOMAIN/IX Reference Manual (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 LBR
     (the DOMAIN librarian) and object modules produced by the
     DOMAIN BIND program.  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.

     In the DOMAIN/IX environment, the symbols _etext, _edata,
     and _end (etext, edata, and end in C) are not defined.  If
     the -T option is not given, an attempt to load several dif-
     ferent modules with different systypes produces an error.

OPTIONS
     Except for -l, each of the options used should appear before
     filenames.  Note that the -d, -s, -x, -X, -n, and -i options
     are unsupported; ld ignores them if they are used.  Also
     note that the -u, -m, -t, and -V options are unsupported,
     and their use produces an error.

     -l[x]     Search the /usr/lib/libc.a library, which is the
               standard system library for C programs.  With an
               x, as in -lx, search /usr/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 signi-
               ficant.

     -r        Do not complain about undefined symbols.

     -d        Force definition of common storage even if the -r
               option is present.

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




Printed 6/10/85                                              LD-1



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



     -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.

FILES
     /usr/lib/lib?.a
                    libraries

     a.out          output file

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







































LD-2                                              Printed 6/10/85

Museum