LX51 User's Guide

Directives

LX51 Linker directives are entered on the command line after the output file. Multiple directives must be separated by at least one empty space. Each directive may be entered only once on the command line. If a directive is entered twice, the linker generates an error.

The following table describes all LX51 Linker directives.

DirectiveDescription
ASSIGNDefines a public symbol and its value.
BANKAREASpecifies the address range where code banks are located.
CLASSESSpecifies an address range or order for all sections in a class.
CODEEnables generation of a program-wide source/assembly code listing file.
DISABLEWARNINGDisables generation of specified warning numbers.
IBANKINGUses the on-chip code banking hardware of the Mentor M8051EW core, the Infineon SDA30C16x/26x, and the Micronas SDA555x.
IXREFEnables cross reference details in the listing file.
MERGEPUBLICSIgnore public symbols from PUBLICSONLY object files.
NAMESpecifies the module name of the output file.
NOAJMPAvoids AJMP instructions in bank switch code.
NOAMAKEExcludes AMAKE information from the object file.
NOCOMMENTSExcludes translator comments from the listing file and object file.
NODEFAULTLIBRARYDisables automatic inclusion of C166 run-time library routines.
NOINDIRECTCALLDisables bank switching code for indirectly called functions.
NOJMPTABDisables generation of the code banking jump table.
NOLINESExcludes line number information from the listing file and object file.
NOMAPExcludes the memory map from the listing file.
NOOVERLAYDisables data segment overlaying.
NOPRINTDisables generation of the listing (MAP) file.
NOPUBLICSExcludes public symbols from the listing file and object file.
NOSORTSIZEDisables sorting sections by size prior to locating.
NOSYMBOLSExcludes local symbols from the listing file and object file.
NOTYPEExcludes symbolic type information from the object file.
OBJECTCONTROLSExcludes specified content from the object file.
OVERLAYModifies the call tree for overlaying of local bit and data segments.
PAGELENGTHSpecifies the number of lines on a page in the listing file.
PAGEWIDTHSpecifies the number of characters on a line in the listing file.
PRINTSpecifies the name of the listing file.
PRINTCONTROLSExcludes specified content from the listing file.
PUBLICSONLYIncludes only public symbol information from the specified input file.
PURGEExcludes debug information from the listing file and object file.
RECURSIONSSpecifies the maximum number of recursive calls detected before link failure.
REGFILESpecifies the name of the register definition file for global register coloring.
REMOVEUNUSEDRemove unused program and data segments for the executable program.
RESERVEReserves memory areas and prevents the linker from using them.
RTX51Specifies that the RTX51 Real-Time Kernel is used.
RTX51TINYSpecifies that the RTX51 Tiny Real-Time Kernel is used.
SEGMENTSSpecifies the memory address and order of segments.
SEGSIZESpecifies the memory space for a segment.
SPLIT_XDATAGROUPCreate two separate segments that collect the overlayable xdata segments.
WARNINGLEVELSelects the level of warning detection.