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

Product codes
SW006021-1
Page of 518
XC8 Command-line Driver
 2012 Microchip Technology Inc.
DS52053B-page 99
4.8.16
--ADDRQUAL: Set Compiler Response to Memory Qualifiers
The --ADDRQUAL option indicates the compiler’s response to non-standard memory 
qualifiers in C source code.
By default these qualifiers are ignored; i.e., they are accepted without error, but have 
no effect. Using this option allows these qualifiers to be interpreted differently by the 
compiler.
The near qualifier is affected by this option. On PIC18 devices, this option also affects 
the far qualifier; and for other 8-bit devices, the bankx qualifiers (bank0, bank1, 
bank2
, etc.) are affected.
The suboptions are detailed in Table 4-7.
For example, when using the option --ADDRQUAL=request the compiler will try to 
honor any non-standard qualifiers, but silently ignore them if they cannot be met.
4.8.17
--ASMLIST: Generate Assembler List Files
The --ASMLIST option tells xc8 to generate assembler listing files for the C and 
assembly source modules being compiled. One assembly list file is produced for the 
entire C program, including code from the C library functions.
Additionally, one assembly list file is produced for each assembly source file in the 
project, including the runtime startup code. For more information, see 
Section 4.4.2 “Startup and Initialization”.
Assembly list files use a .lst extension and, due to the additional information placed 
in these files, cannot be used as assembly source files.
In the case of listings for C source code, the list file shows both the original C code and 
the corresponding assembly code generated by the compiler. See 
Section 6.5 “Assembly-Level Optimizations” for full information regarding the 
content of these files.
The same information is shown in the list files for assembly source code.
This option is on by default when compiling under MPLAB IDE.
4.8.18
--CCI: Enforce and Expect CCI Conformance
Enabling this option will request the compiler to check all source code and compiler 
options for compliance with the Common Compiler Interface (CCI) standard. Code that 
complies with this standard is portable across all MPLAB XC compilers. (The document 
describing the CCI standard is pending at the time of this user’s guide’s writing.) Code 
or options that do not conform to the CCI standard will be flagged by compiler warnings.
TABLE 4-7:
COMPILER RESPONSES TO MEMORY QUALIFIERS
Selection
 Response
require
The qualifiers will be honored. If they cannot be met, an error will be issued.
request
The qualifiers will be honored, if possible. No error will be generated if they 
cannot be followed.
ignore
The qualifiers will be ignored and code compiled as if they were not used.
reject
If the qualifiers are encountered, an error will be immediately generated.