3.2.2 How Do I Compile on the Command-line?

The compiler driver is called xc32-gcc for all 32-bit devices; e.g., in Windows, it is named xc32-gcc.exe. This application should be invoked for all aspects of compilation. It is located in the bin directory of the compiler distribution. Avoid running the individual compiler applications (such as the assembler or linker) explicitly. You can compile and link in the one command, even if your project is spread among multiple source files.

The driver is introduced in 5.1 Invoking the Compiler. See 3.2.4 How Can I Select Which Compiler I Want to Build With? to ensure you are running the correct driver if you have more than one installed. The command-line options to the driver are detailed in 5.7 Driver Option Descriptions. The files that can be passed to the driver are listed and described in 5.1.3 Input File Types.