4.4.2 xc32-as (32-bit Assembler)

A subset of command-line options may be specified in MPLAB X IDE. Select a category, and then set up assembler options. For additional options, see MPLAB XC32 Assembler documentation. See also “4.4.8 Options Page Features”.

Table 4-2. xc32-as General Category
Option	Description	Command Line
Have symbols in production build	Generate debugging information for source-level debugging in MPLAB X.	`--gdwarf-2`
Keep local symbols	Check to keep local symbols, i.e., labels beginning with .L (upper case only). Uncheck to discard local symbols.	`--keep-locals` See MPLAB® XC32 Assembler, Linker and Utilities User's Guide.
Preprocessor macro definitions	Project-specific preprocessor macro defines passed via the compiler's `–D` option.	`-Dmacro[=defn]` See MPLAB® XC32 Assembler, Linker and Utilities User's Guide.
Assembler symbols	Define symbol 'sym' to a given 'value'.	`--defsym sym=value` See MPLAB® XC32 Assembler, Linker and Utilities User's Guide.
Preprocessor Include directories	Relative paths are from MPLAB X project directory.	`-I dir` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Assembler Include directories	Relative paths are from MPLAB X project directory. Add a directory to the list of directories the assembler searches for files specified in `.include` directives. You may add as many directories as necessary to include a variety of paths. The current working directory is always searched first and then `-I` directories in the order in which they were specified (left to right) here.	`-I dir` See MPLAB® XC32 Assembler, Linker and Utilities User's Guide.

Table 4-3. xc32-as Other Options Category
Option	Description	Command Line
Diagnostics level	Select warnings to display in the Output window. Select “Generate warnings” to have the usual warnings issued by the compiler; “Suppress warnings”to have only errors displayed, and "Fatal Warnings" to have the assembler treat warnings as if they were errors.	`--[no-]warn` `--fatal-warnings` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Include source code	Check for a high-level language listing. High-level listings require that the assembly source code is generated by a compiler, a debugging option like `-g` is given to the compiler, and assembly listings (`-al`) are requested. Uncheck for a regular listing.	`-ah` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Expand macros	Check to expand macros in a listing. Uncheck to collapse macros.	`-am` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Include false conditionals	Check to include false conditionals (`.if, .ifdef`) in a listing. Uncheck to omit false conditionals.	`-ac` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Omit forms processing	Check to turn off all forms processing that would be performed by the listing directives `.psize, .eject, .title` and `.sbttl`. Uncheck to process by listing directives.	`-an` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Include assembly	Check for an assembly listing. This `-a` suboption may be used with other suboptions. Uncheck to exclude an assembly listing.	`-al` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
List symbols	Check for a symbol table listing. Uncheck to exclude the symbol table from the listing.	`-as` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Omit debugging directives	Check to omit debugging directives from a listing. This can make the listing cleaner. Uncheck to included debugging directives.	`-ad` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide
List to file	Use this option if you want the assembly listing for any assembly source files in the project. They will have the same basename as the source, with a `.lst` extension.	`-a=file.lst` See the MPLAB® XC32 Assembler, Linker and Utilities User's Guide