5.6.1 XC32 (Global Options)

Set up global options for all XC32 language tools. See also “5.6.6 Options Page Features.”

Table 5-1. All Options Category
OptionDescriptionCommand Line
Override default device supportSelect “Do not override” to build the project with a default DFP. Select “Compiler location” to use the relevant DFP shipped with the compiler. DFPs provide device-specific information, such as register names and addresses, which can be used by code in the project.-mdfp=path
Define common macrosAdd macros common to compiler, assembler and linker.-Dmacro
Don’t delete intermediate filesSelect the checkbox to not delete intermediate files. Place them in the object directory and name them based on the source file.

Uncheck to remove intermediate files after a build.

-save-temps=obj
Common include dirsDirectory paths entered here will be appended to the already existing include paths of the compiler.

Relative paths are from the MPLAB X IDE project directory.

-Idir
Elf file to use for preserved locationsSpecify the ELF file which will be used to look up previous defined sections and use the locations from that object file for the new compiled project.

Relative paths are from MPLAB X IDE project directory.

Preserve locations on C files onlyThis is used to preserve any locations within a C file. It will NOT preserve locations from precompiled libraries or assembly source files.-mpreserve-all
Preserve all locations within the projectPreserve all locations in the whole project irrespective of the per file setting. It will also include all pre-compiled artifacts and assembly files.--preserve-all1
Combine source files togetherPrior to LTO, GCC-based compilers had the ability to 'combine' source files together, giving the compiler an opportunity to see more of the source code. This could lead to code and data size reductions.
When this feature is enabled, the build will be constrained in the following ways:
  • The per-file build settings will be ignored.
  • The build will no longer be an incremental one (full build only).
  1. For details on linker command-line options, see MPLAB® XC32 Assembler, Linker and Utilities User’s Guide for PIC32A MCU.