5.8.5.1 XC-DSC Linker

Table 5-28. General Options
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` `--no-local-stack`
Allow overlapped sections	Check to not check section addresses for overlaps. Uncheck to check for overlaps.	`--check-sections` `--no-check-sections`
Init data sections	Check to support initialized data. Uncheck to not support.	`--data-init` `--no-data-init`
Pack data template	Check to pack initial data values. Uncheck to not pack.	-`-pack-data` `--no-pack-data`
Create handles	Check to support far code pointers. Uncheck to not support.	`--handles` `--no-handles`
Create default ISR	Check to create an interrupt function for unused vectors. Uncheck to not create a default ISR.	`--isr` `--no-isr`
Remove unused sections	Check to enable garbage collection of unused input sections (on some targets). Uncheck to disable garbage collection.	`--gc-sections` `--no-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`

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

--no-local-stack

Allow overlapped sections

Check to not check section addresses for overlaps.

Uncheck to check for overlaps.

--check-sections

--no-check-sections

Init data sections

Check to support initialized data.

Uncheck to not support.

--data-init

--no-data-init

Pack data template

Check to pack initial data values.

Uncheck to not pack.

--pack-data

--no-pack-data

Create handles

Check to support far code pointers.

Uncheck to not support.

--handles

--no-handles

Create default ISR

Check to create an interrupt function for unused vectors.

Uncheck to not create a default ISR.

--isr

--no-isr

Remove unused sections

Check to enable garbage collection of unused input sections (on some targets).

Uncheck to disable garbage collection.

--gc-sections

--no-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

5.8.5.1 XC-DSC Linker - General