PicC 9.50 dsPIC Manual.pdf

Linker and UtilitiesInvoking the Linker5.7.24 -UsymbolThis option will enter the specified symbol into the linker’s symbol table as an undefined symbol.This is useful for linking entirely from libraries, or for linking a module from a library where theordering has been arranged so that by default a later module will be linked.5.7.25 -VavmapTo produce an Avocet format symbol file, the linker needs to be given a map file to allow it tomap psect names to Avocet memory identifiers. The avmap file will normally be supplied with thecompiler, or created automatically by the compiler driver as required.5.7.26 -WnumThe -W option can be used to set the warning level, in the range -9 to 9, or the width of the map file,for values of num >= 10.-W9 will suppress all warning messages. -W0 is the default. Setting the warning level to -9 (-W-9)will give the most comprehensive warning messages.5.7.27 -XLocal symbols can be suppressed from a symbol file with this option. Global symbols will alwaysappear in the symbol file.5.7.28 -ZSome local symbols are compiler generated and not of interest in debugging. This option willsuppress from the symbol file all local symbols that have the form of a single alphabetic character,followed by a digit string. The set of letters that can start a trivial symbol is currently "klfLSu".The -Z option will strip any local symbols starting with one of these letters, and followed by a digitstring.5.8 Invoking the LinkerThe linker is called HLINK, and normally resides in the BIN subdirectory of the compiler installationdirectory. It may be invoked with no arguments, in which case it will prompt for input from standardinput. If the standard input is a file, no prompts will be printed. This manner of invocation isgenerally useful if the number of arguments to HLINK is large. Even if the list of files is too longto fit on one line, continuation lines may be included by leaving a backslash \ at the end of the99