User manual

MPLAB
®
XC8 C Compiler User’s Guide
DS52053B-page 278  2012 Microchip Technology Inc.
If the standard input is a file then this file is assumed to contain the command-line
argument. Lines may be broken by leaving a backslash \ at the end of the preceding
line. In this fashion, HLINK commands of almost unlimited length may be issued. For
example, a link command file called x.lnk and containing the following text:
-Z -OX.OBJ -MX.MAP \
-Ptext=0,data=0/,bss,nvram=bss/. \
X.OBJ Y.OBJ Z.OBJ
may be passed to the linker by one of the following:
hlink @x.lnk
hlink < x.lnk
Several linker options require memory addresses or sizes to be specified. The syntax
for all these is similar. By default, the number will be interpreted as a decimal value. To
force interpretation as a HEX number, a trailing H, or h, should be added, for example,
765FH will be treated as a HEX number.
-I Ignore undefined symbols
-J num Set maximum number of errors before aborting
-K Prevent overlaying function parameter and auto areas
-L Preserve relocation items in .obj file
-LM Preserve segment relocation items in .obj file
-N Sort symbol table in map file by address order
-Nc Sort symbol table in map file by class address order
-Ns Sort symbol table in map file by space address order
-Mmapfile Generate a link map in the named file
-Ooutfile Specify name of output file
-Pspec Specify psect addresses and ordering
-Qprocessor Specify the device type (for cosmetic reasons only)
-S Inhibit listing of symbols in symbol file
-Sclass=limit[,bound] Specify address limit, and start boundary for a class of
psects
-Usymbol Pre-enter symbol in table as undefined
-Vavmap Use file avmap to generate an Avocet format symbol file
-Wwarnlev Set warning level (-9 to 9)
-Wwidth Set map file width (>=10)
-X Remove any local symbols from the symbol file
-Z Remove trivial local symbols from the symbol file
--DISL=list Specify disabled messages
--EDF=path Specify message file location
--EMAX=number Specify maximum number of errors
--NORLF Do not relocate list file
--VER Print version number and stop
TABLE 7-1: LINKER COMMAND-LINE OPTIONS (CONTINUED)
Option Effect