Microchip Technology SW006023-2N Data Sheet

®

DS51686E-page 62

 2012 Microchip Technology Inc.

The following options control the kind of output produced by the compiler.

-mappio-debug

Enable the APPIN/APPOUT debugging library 
functions for the MPLAB

®

 ICD 3 debugger and MPLAB 

REAL ICE™ in-circuit emulator. This feature allows you 
to use the DBPRINTF and related functions and 
macros as described in the “32-bit Language Tool 
Libraries” document (DS51685). Enable this option 
only when using a target PIC32 device that supports 
the APPIN/APPOUT feature.

-mcci

Enables the Microchip Common C Interface 
compilation mode.

-c

Compile or assemble the source files, but do not link. The default file 
extension is .o.

-E

Stop after the preprocessing stage (i.e., before running the compiler 
proper). The default output file is stdout.

-fexceptions

Enable exception handling. You may need to enable this option when 
compiling C code that needs to interoperate properly with exception 
handlers written in C++.

-o file

Place the output in file.

-S

Stop after compilation proper (i.e., before invoking the assembler). The 
default output file extension is .s.

-v

Print the commands executed during each stage of compilation.

-x

You can specify the input language explicitly with the -x option:
-x language
Specify explicitly the language for the following input files (rather than letting 
the compiler choose a default based on the file name suffix). This option 
applies to all following input files until the next -x option. The following 
values are supported by the compiler:
c

c++

c-header

cpp-output

assembler

assembler-with-cpp

-x none
Turn off any specification of a language, so that subsequent files are 
handled according to their file name suffixes. This is the default behavior 
but is needed if another -x option has been used. For example:
xc32-gcc -x assembler foo.asm bar.asm -x none main.c 

mabonga.s

Without the -x 

none

, the compiler assumes all the input files are for the 

assembler.

--help

Print a description of the command line options.