PicC 9.50 dsPIC Manual.pdf

OperationLinker and Utilities5.7.15 -LWhen the linker produces an output file it does not usually preserve any relocation information, sincethe file is now absolute. In some circumstances a further "relocation" of the program will be done atload time, e.g. when running a .exe file under DOS or a .prg file under TOS. This requires that someinformation about what addresses require relocation is preserved in the object (and subsequently theexecutable) file. The -L option will generate in the output file one null relocation record for eachrelocation record in the input.5.7.16 -LMSimilar to the above option, this preserves relocation records in the output file, but only segmentrelocations. This is used particularly for generating .exe files to run under DOS.5.7.17 -MmapfileThis option causes the linker to generate a link map in the named file, or on the standard output ifthe file name is omitted. The format of the map file is illustrated in Section 5.9.5.7.18 -N, -Ns and-NcBy default the symbol table in the link map will be sorted by name. The -N option will cause it tobe sorted numerically, based on the value of the symbol. The -Ns and -Nc options work similarlyexcept that the symbols are grouped by either their space value, or class.5.7.19 -OoutfileThis option allows specification of an output file name for the linker. The default output file name isl.obj. Use of this option will override the default.5.7.20 -PspecPsects are linked together and assigned addresses based on information supplied to the linker via -Poptions. The argument to the -P option consists basically of comma-separated sequences thus:-Ppsect=lnkaddr+min/ldaddr+min,psect=lnkaddr/ldaddr, ...There are several variations, but essentially each psect is listed with its desired link and load addresses,and a minimum value. All values may be omitted, in which case a default will apply,depending on previous values.96