Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 User Manual

®

DS52053B-page 92

 2012 Microchip Technology Inc.

Most aspects of the compilation can be controlled using the command-line driver, xc8. 
The driver will configure and execute all required applications, such as the code 
generator, assembler and linker.

xc8

 recognizes the compiler options which are tabled below and are explained in detail 

in the sections following. The case of the options is not important, however command 
shells in most operating systems are case sensitive when it comes to names of files.

-C

Compile to object file and stop

-Dmacro

Define preprocessor macro symbol

-Efilename

Redirect compile errors

-G[filename]

Generate symbolic debug information

-Ipath

Specify include path

-Largument

Set linker option

-M[filename]

Generate map file

-Nnumber

Specify identifier length

-Ofile

Specify output filename and type

-P

Preprocess assembly source

-Q

Quiet mode

-S

Compile to assembly file and stop

-Umacro

Undefine preprocessor macro symbol

-V

Verbose mode

--ADDRQUAL=qualifier

Specify address space qualifier handling

--ASMLIST

Generate assembly list file

--CCI

Enforce and expect CCI rules

--CHAR=type

Default character type (defunct)

--CHECKSUM=specification

Calculate a checksum and store the result in program 
memory

--CHIP=device

Select target device

--CHIPINFO

Print device information

--CODEOFFSET=value

Specify ROM offset address

--DEBUGGER=type

Set debugger environment

--DOUBLE=size

Size of double type

--ECHO

Echo command line

--EMI=mode

Select external memory interface operating mode

--ERRATA=type

Specify errata workarounds

--ERRFORMAT=format

Set error format

--ERRORS=number

Set maximum number of errors

--FILL=specification

Specify a ROM-fill value for unused memory

--FLOAT=size

Size of float type

--GETOPTION=argument

Get advanced options

--HELP=option

Help

--HTML=file

Generate HTML debug files

--LANG=language

Specify language

--MEMMAP=mapfile

Display memory map

--MODE=mode

Choose operating mode