os2ld(CP)                      6 January 1993                      os2ld(CP)


 Name

    os2ld - OS/2 cross linker

 Syntax

    os2ld [ options ] file ...

 Description

    os2ld links the object file(s) to create a program for execution under
    OS/2.  Although similar to ld(CP), some os2ld options differ signifi-
    cantly from ld.  The options are described below:

    -B Produce an executable .COM file.

    -C Treat upper and lower case characters in symbol names as identical.

    -D Perform DS allocation, which is generally used in conjunction with the
       -H option.

    -F num
       Set stack size to the hexadecimal number num.  os2ld will set the
       stack segment to num bytes in the output file.

    -H Load high.  This option sets a field in the header of the executable
       file to tell OS/2 to load the program at the highest available posi-
       tion in memory.  It is most often used with programs in which data
       precedes code in the memory image.

    -L Include line numbers in the listing file (if any).  os2ld cannot put
       line numbers in the listing file if the source translator hasn't put
       them in the object file.

    -M Include public symbols in the list file.  The symbols are sorted
       twice, lexicographically and by address.

    -m filename
       Create a map file filename with information about the segments and
       groups in the executable.  Public symbols and line numbers will be
       listed in this file if the -M and -L options are given.

    -n num
       Set name length to the decimal number num.  os2ld truncates all public
       and external symbols longer than num characters.

    -o filename
       Name output file to filename (the default name is a.out).

    -P Pack code segments.

    -Pc[<dec#>]
       Pack code segments; the default limit for a segment is 64k minus 36.

    -Pd[<dec#>]
       Pack data segments; default limit is 64k.

    -Q Don't pack code segments; this option is the default for
       segmented-executable pack code.

    -S num
       Set segment limit to num, a decimal number between 1 and 1024 (the
       default is 128).  num limits the number of different segments that may
       be linked together.  The higher the value given, the slower the link
       will be.

    -u name
       Name undefined symbol name.  os2ld 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.

    As with ld, the files passed to os2ld may be either UNIX-style libraries
    (objects collected using ar(CP) or ordinary 8086 object files.  Unless
    the -u option appears, at least one of the files passed to os2ld must be
    an ordinary object file.  Libraries are searched only after all the ordi-
    nary object files have been processed.

 Files

    /usr/bin/os2ld

 See also

    ar(CP), as(CP), cc(CP), dosld(CP), ld(CP)

 Standards conformance

    os2ld is a value-added extension of AT&T System V provided by the Santa
    Cruz Operation.