dosld(CP)                      6 January 1993                      dosld(CP)


 Name

    dosld - MS-DOS cross linker

 Syntax

    dosld [ options ] file ...

 Description

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

    -C  Case sensitivity on.  This option instructs dosld to treat upper and
        lower case characters in symbol names as distinct (so that the char-
        acter ``A'' is different from the character ``a'').

    -D  DS Allocate.  This instructs dosld to perform DS allocation.  It is
        generally used in conjunction with the -H option.

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

    -G  Ignore group associations.  This option instructs dosld to ignore any
        group definitions it may find in the input files.  This option is
        provided for compatibility with old versions of MS-LINK; generally,
        it should not be used.

    -H  Load high.  This option instructs dosld to set a field in the header
        of the executable file to tell MS-DOS to load the program at the
        highest available position in memory.  It is most often used with
        programs in which data precedes code in the memory image.

    -L  Include line numbers.  This option instructs dosld to include line
        numbers in the listing file (if any).  dosld cannot put line numbers
        in the listing file if the source translator hasn't put them in the
        object file.

    -M  Include public symbols.  This option instructs dosld to include pub-
        lic symbols in the list file.  The symbols are sorted twice: lexico-
        graphically and by address.

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

    -nl num
        Set name length to a decimal number, num.  dosld will truncate all
        public and external symbols longer than num characters.

    -o filename
        Create output file filename, instead of the default name, a.out.

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

    -u name
        Name undefined symbol, name.  dosld will add name to its symbol table
        as an undefined symbol.  The -u option may appear several times on
        the command line.

    As with ld, the files passed to dosld 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 dosld must be
    an ordinary object file.  Libraries are searched only after all the ordi-
    nary object files have been processed.

 Files

    /usr/bin/dosld

 See also

    ar(CP), as(CP), cc(CP), ld(CP), ranlib(XNX)

 Standards conformance

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