5.8.5.1 XC-DSC Linker - General
Notes:
- N/A means MPLAB X IDE option not available in VS Code.
- VSC means VS Code option is not available in MPLAB X IDE.
| Option | Description | Command Line |
|---|---|---|
| Heap size | Specify the size of the heap in bytes. Allocate a run-time heap of size bytes for use by C programs. The heap is allocated from unused data memory. If not enough memory is available, an error is reported. | --heap
size |
| Min stack size | Specify the minimum size of the stack
in bytes. By default, the linker allocates all unused data memory for
the run-time stack. Alternatively, the programmer may allocate the stack
by declaring two global symbols: __SP_init and
__SPLIM_init. Use this option to ensure that at
least a minimum sized stack is available. The actual stack size is
reported in the link map output file. If the minimum size is not
available, an error is reported. | --stack
size |
| Use local stack (dsPIC33C/E/F and dsPIC30F Devices Only) [DD] | Check to prevent allocating the stack in extended data
space memory. The linker will allocate the stack in regular data space
but not extended data space. Uncheck to allow allocating the stack in extended data space memory. The linker will allocate the stack in either regular and/or extended data space. | --local-stack
|
| Allow overlapped sections | Check to not check section addresses
for overlaps. Uncheck to check for overlaps. | --check-sections
|
| Init data sections | Check to support initialized data. Uncheck to not support. | --data-init
|
| Pack data template | Check to pack initial data values. Uncheck to not pack. | --pack-data
|
| Create handles | Check to support far code pointers. Uncheck to not support. | --handles
|
| Create default ISR | Check to create an interrupt function for unused
vectors. Uncheck to not create a default ISR. | --isr
|
| Remove unused sections | Check to enable garbage collection of
unused input sections (on some targets). Uncheck to disable garbage collection. | --gc-sections
|
| Fill value for upper byte of data | Enter a fill value for upper byte of data. Use this
value as the upper byte (bits 16-23) when encoding data into program
memory. This option affects the encoding of sections created with the
psv or eedata attribute, as well
as the data initialization template if the
--no-pack-data option is enabled. | --fillupper=value |
| Stack guardband size | N/A | |
| Additional linker options | VSC: Type any additional linker options that does not exist in this UI. The string will be emitted as is in the -Wl, driver invocation command. | |
| Additional driver options | Type here any additional driver options not existing in this GUI otherwise. The string you introduce here will be emitted as is in the driver invocation command. | |
| Use response file to link | N/A | |
| No Interrupt Vector Table | Check to prevent the linker from generating an IVT/AIVT
vector table. If there is one defined by the user then it will be used;
otherwise the memory will remain unprogrammed. Uncheck to allow the linker to generate a vector table. | --no-ivt |