PicC 9.50 dsPIC Manual.pdf

ObjtohexLinker and Utilities5.10.5 Listing FormatA request to LIBR to list module names will simply produce a list of names, one per line, on standardoutput. The s keyletter will produce the same, with a list of symbols after each module name. Eachsymbol will be preceded by the letter D or U, representing a definition or reference to the symbolrespectively. The -P option may be used to determine the width of the paper for this operation. Forexample:LIBR -P80 s file.libwill list all modules in file.lib with their global symbols, with the output formatted for an 80column printer or display.5.10.6 Ordering of LibrariesThe librarian creates libraries with the modules in the order in which they were given on the commandline. When updating a library the order of the modules is preserved. Any new modules addedto a library after it has been created will be appended to the end.The ordering of the modules in a library is significant to the linker. If a library contains a modulewhich references a symbol defined in another module in the same library, the module defining thesymbol should come after the module referencing the symbol.5.10.7 Error MessagesLIBR issues various error messages, most of which represent a fatal error, while some represent aharmless occurrence which will nonetheless be reported unless the -W option was used. In this caseall warning messages will be suppressed.5.11 ObjtohexThe HI-TECH linker is capable of producing simple binary files, or object files as output. Any otherformat required must be produced by running the utility program OBJTOHEX. This allows conversionof object files as produced by the linker into a variety of different formats, including various hexformats. The program is invoked thus:OBJTOHEX options inputfile outputfileAll of the arguments are optional. If outputfile is omitted it defaults to l.hex or l.bin dependingon whether the -b option is used. The inputfile defaults to l.obj.The options for OBJTOHEX are listed in Table 5.4. Where an address is required, the format is thesame as for HLINK.106