Microchip Technology SW006023-2 Data Sheet

Page of 238
MPLAB
®
 XC32 C/C++ Compiler User’s Guide
DS51686E-page 82
 2012 Microchip Technology Inc.
3.9.11
Options for Directory Search
The following options specify to the compiler where to find directories and files to 
search.
-s
Remove all symbol table and relocation information from the 
executable.
-u symbol
Pretend symbol is undefined to force linking of library modules to 
define the symbol. It is legitimate to use -u multiple times with 
different symbols to force loading of additional library modules.
-Wl,option
Pass option as an option to the linker. If option contains commas, 
it is split into multiple options at the commas.
-Xlinker option
Pass option as an option to the linker. You can use this to supply 
system-specific linker options that the compiler does not know how to 
recognize.
TABLE 3-17:
DIRECTORY SEARCH OPTIONS
Option
Definition
-Bprefix
This option specifies where to find the executables, libraries, 
include files and data files of the compiler itself. 
The compiler driver program runs one or more of the 
sub-programs xc32-cpp, xc32-as and xc32-ld. It tries 
prefix
 as a prefix for each program it tries to run.
For each sub-program to be run, the compiler driver first tries the 
-B
 prefix, if any. Lastly, the driver searches the current PATH 
environment variable for the subprogram.
-B
 prefixes that effectively specify directory names also apply to 
libraries in the linker, because the compiler translates these 
options into -L options for the linker. They also apply to include 
files in the preprocessor, because the compiler translates these 
options into -isystem options for the preprocessor. In this case, 
the compiler appends include to the prefix. 
-specs=file
Process file after the compiler reads in the standard specs file, in 
order to override the defaults that the xc32-gcc driver program 
uses when determining what switches to pass to xc32-as, 
xc32-ld
, etc. More than one -specs=file can be specified on 
the command line, and they are processed in order, from left to 
right.
TABLE 3-16:
LINKING OPTIONS (CONTINUED)
Option
Definition