SYNOPSIS MODULE_ID ld
(
int syms, /* -1, 0, or 1 */
BOOL noAbort, /* TRUE = don’t abort script on error */
char * name /* name of object module, NULL = standard input */
)
This command loads an object module from a file or from standard input. The object
module must be in UNIX a.out format. External references in the module are resolved
during loading. The syms parameter determines how symbols are loaded; possible values:
0 – Add global symbols to the system symbol table.
1 – Add global and local symbols to the system symbol table.
-1 – Add no symbols to the system symbol table.
If there is an error during loading (e.g., externals undefined, too many symbols, etc.), then
shellScriptAbort( ) is called to stop any script that this routine was called from. If noAbort
is TRUE, errors are noted but ignored.
The normal way of using ld( ) is to load all symbols (syms = 1) during debugging and to
load only global symbols later.
EXAMPLE The following example loads the a.out file module from the default file device into
memory, and adds any global symbols to the symbol table:
-> ld
This example loads test.o with all symbols:
-> ld 1,0,"test.o"