5.8.1 XC-DSC Global (Global Options)

Set up global options for all XC-DSC language tools. See the 5.7.7 Options Page Features section for more information.

Notes:

  • N/A means MPLAB X IDE option not available in VS Code.
  • VSC means VS Code option is not available in MPLAB X IDE.
Table 5-18. All Options Category
OptionDescriptionCommand Line
Override default device supportCheck to automatically handle issuing the DFP (device file pack) location (-mdfp).

Uncheck to allow compiler defaults.

Output file formatN/A
Define common macrosAdd macros common to compiler, assembler and linker.-Dmacro
Generic buildN/A
Don’t delete intermediate filesCheck 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
PartitionVSC: The partition defines which partition this image will be generated for and loaded in.-Idir
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 locationsElf 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 project directory.

--preserved="file.elf"
Preserve locations on C files onlyPreserve any locations within a C file. This will NOT preserve locations from precompiled libraries or assembly source files. -mpreserve-all
Preserve all locations within the project--preserve-all
Combine source files togetherVSC: Prior to LTO, GCC based compilers have the ability to 'combine' source files together, giving the compiler an opportunity to see more of the source code. May 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)