5.7.5.1 xc-dsc-ld - General Category
| 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 | 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 | Enter a stack guardband size to ensure that enough stack space is available to process a stack overflow exception. | --stackguard=size |
| 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 | Check to create a makefile that uses a
response file for the link step. In Windows® OS,
you have a maximum command line length of 8191 chars. When linking long
programs, the link line might go over this limit. MPLAB XC-DSC provides a response file work-around. See MPLAB X IDE documentation, Troubleshooting
section, for details. Uncheck to not use a response file. | |
| 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 |
| Override PSV address boundary | Check to allow data sections to be allocated above the
32K PSV address boundary. Normally this is permitted only when the
space(eds) attribute has been applied to variables.
This option is not compatible with the compiler constants-in-code memory
model.Uncheck to not allow the override. | --psv-override |