User manual

MPLAB
®
XC8 C Compiler User’s Guide
DS52053B-page 92  2012 Microchip Technology Inc.
4.8 OPTION DESCRIPTIONS
Most aspects of the compilation can be controlled using the command-line driver, xc8.
The driver will configure and execute all required applications, such as the code
generator, assembler and linker.
xc8 recognizes the compiler options which are tabled below and are explained in detail
in the sections following. The case of the options is not important, however command
shells in most operating systems are case sensitive when it comes to names of files.
TABLE 4-6: DRIVER OPTIONS
Option Meaning
-C Compile to object file and stop
-Dmacro Define preprocessor macro symbol
-Efilename Redirect compile errors
-G[filename] Generate symbolic debug information
-Ipath Specify include path
-Largument Set linker option
-M[filename] Generate map file
-Nnumber Specify identifier length
-Ofile Specify output filename and type
-P Preprocess assembly source
-Q Quiet mode
-S Compile to assembly file and stop
-Umacro Undefine preprocessor macro symbol
-V Verbose mode
--ADDRQUAL=qualifier Specify address space qualifier handling
--ASMLIST Generate assembly list file
--CCI Enforce and expect CCI rules
--CHAR=type Default character type (defunct)
--CHECKSUM=specification Calculate a checksum and store the result in program
memory
--CHIP=device Select target device
--CHIPINFO Print device information
--CODEOFFSET=value Specify ROM offset address
--DEBUGGER=type Set debugger environment
--DOUBLE=size Size of double type
--ECHO Echo command line
--EMI=mode Select external memory interface operating mode
--ERRATA=type Specify errata workarounds
--ERRFORMAT=format Set error format
--ERRORS=number Set maximum number of errors
--FILL=specification Specify a ROM-fill value for unused memory
--FLOAT=size Size of float type
--GETOPTION=argument Get advanced options
--HELP=option Help
--HTML=file Generate HTML debug files
--LANG=language Specify language
--MEMMAP=mapfile Display memory map
--MODE=mode Choose operating mode