User manual

MPLAB
®
XC8 C Compiler User’s Guide
DS52053B-page 300  2012 Microchip Technology Inc.
8.5 CROMWELL
The CROMWELL utility converts code and symbol files into different formats. These files
are typically used by debuggers and allow source-level debugging of code. The output
formats available are shown in Table 8-5.
The CROMWELL application is automatically executed by the command-line driver when
required. The following information is required if running the application manually.
The general form of the CROMWELL command is:
CROMWELL [options] inputFiles -okey [outputFile]
where options can be any of the options shown in Table 8-6.
The outputFile (optional) is the name of the output file. The inputFiles are
typically the HEX and SYM file.
CROMWELL automatically searches for the SDB files and reads those if they are found.
The options are further described in the following paragraphs.
TABLE 8-5: CROMWELL FORMAT TYPES
Key Format
cod Bytecraft COD file
coff COFF file format
elf ELF/DWARF file
eomf51 Extended OMF-51 format
hitech HI-TECH Software format
icoff ICOFF file format
ihex Intel HEX file format
mcoff Microchip COFF file format
omf51 OMF-51 file format
pe P&E file format
s19 Motorola HEX file format
TABLE 8-6: CROMWELL COMMAND-LINE OPTIONS
Option Description
-Pname[,architecture] Device name and architecture
-N Identify code classes
-D Dump input file
-C Identify input files only
-F Fake local symbols as global
-Okey Set the output format
-Ikey Set the input format
-L List the available formats
-E Strip file extensions
-B Specify big-endian byte ordering
-M Strip underscore character
-V Verbose mode
--EDF=path Specify message file location
--EMAX=number Specify maximum number of errors
--MSGDISABLE=list Specify disabled messages
--VER Print version number and stop