Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 Manual De Usuario
Los códigos de productos
SW006021-1
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.
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.
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
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.
honor any non-standard qualifiers, but silently ignore them if they cannot be met.
See Section 4.9 “MPLAB IDE V8 Universal Toolsuite Equivalents” or
Section 4.10 “MPLAB X Universal Toolsuite Equivalents” for use of this option in
MPLAB IDE.
Section 4.10 “MPLAB X Universal Toolsuite Equivalents” for use of this option in
MPLAB IDE.
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.
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”.
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 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 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.
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.
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.