Development Tools

2.5.3 Link options

This section explains options for the link phase.

Caution about options are shown below.

-	Uppercase characters and lowercase characters are not distinguished for options.

-	Uppercase characters in options and parameters indicate that they can be specified as abbreviations for options and parameters. The characters after the uppercase characters can be omitted.

Example

For example, -FOrm=Absolute can be specified as follows.
-fo=a
-fo=abs
-for=absolu

-	When a file name is specified as a parameter, "(" and ")" cannot be used.

-	When link options are specified for the ccrl command, the -lnkopt option must be used.

The types and explanations for options are shown below.

Table 2.8

Link Options

Classification	Option	Description
Input control	-Input	This option specifies the input file.
	-LIBrary	This option specifies the input library file.
	-Binary	This option specifies the input binary file.
	-DEFine	This option defines an undefined symbol forcedly.
	-ENTry	This option specifies the execution start address.
	-ALLOW_DUPLICATE_MODULE_NAME [V1.09 or later]	This option allows multiple same module names to be specified.
Output control	-FOrm	This option specifies the output format.
	-DEBug	This option outputs debug information to the output file.
	-NODEBug	This option does not output the debug information.
	-RECord	This option specifies the size of the data record to be output.
	-END_RECORD [V1.05 or later]	This option specifies the end record.
	-ROm	This option specifies the section that maps symbols from ROM to RAM.
	-OUtput	This option specifies the output file.
	-SPace	This option fills the vacant area of the output range.
	-Message	This option output information messages.
	-NOMessage	This option suppresses the output of information messages.
	-MSg_unused	This option notifies the symbol that is not referenced.
	-BYte_count	This option specifies the maximum byte count for a data record.
	-FIX_RECORD_LENGTH_AND_ALIGN [V1.06 or later]	Fixes the format of data records to be output.
	-PADDING	This option fills in data at the end of a section.
	-CRc	This option specifies whether to perform the CRC operation.
	-VECT	This option stores an address value in the unused areas in the vector table.
	-VECTN	This option stores address values in the specified areas in the vector table.
	-SPLIT_VECT [V1.07 or later]	This option generates split vector table sections.
	-VFINFO	This option outputs the variable/function information file.
	-CFI [Professional Edition only] [V1.06 or later]	Generates the function list for use in detecting illegal indirect function calls.
	-CFI_ADD_Func [Professional Edition only] [V1.06 or later]	Specifies the symbol or address of a function to be added to the function list for use in detecting illegal indirect function calls.
	-CFI_IGNORE_Module [Professional Edition only] [V1.06 or later]	Specifies modules which are to be exempted from the function list for use in detecting illegal indirect function calls.
	-RAM_INIT_TABLE_SECTION [V1.12 or later]	This option generates an information table for RAM initialization.
List output	-LISt	This option outputs the list file.
List output	-SHow	This option specifies information that is output to the list file.
Optimization	-Optimize	This option specifies whether to execute inter-module optimization.
	-NOOptimize	This option disables inter-module optimization.
	-SEction_forbid	This option disables optimization for the specified section.
	-Absolute_forbid	This option disables optimization regarding address + size specification.
	-SYmbol_forbid [V1.02 or later]	This option specifies unreferenced symbols that are not to be deleted.
	-ALLOW_OPTIMIZE_ENTRY_BLOCK [V1.13 or later]	This option performs optimization on the areas that are allocated before the execution start symbol.
Section specification	-STARt	This option specifies the start address of the section.
	-FSymbol	This option outputs external defined symbols to the symbol address file.
	-USER_OPT_BYTE	This option specifies the value set for the user option bytes.
	-OCDBG	This option specifies the control value for the on-chip debug.
	-SECURITY_OPT_BYTE [V1.12 or later]	This option specifies the control value for the security option byte.
	-SECURITY_ID	This option specifies a security ID value.
	-FLASH_SECURITY_ID [V1.12 or later]	This option specifies the value to be set for the flash programmer security ID.
	-AUTO_SECTION_LAYOUT	This option automatically allocates sections.
	-SPLIT_SECTION [V1.12 or later]	This option enables automatic allocation of sections for each module.
	-STRIDE_DSP_MEMORY_AREA [V1.12 or later]	This option enables automatic allocation of sections to areas split by the memory area shared with the FLEXIBLE APPLICATION ACCELERATOR (FAA).
	-DEBUG_MONITOR	This option specifies the OCD monitor area.
	-RRM	This option specifies the work area for the RRM/DMM function.
	-SELF	This option disables allocation of a section to the self RAM area.
	-SELFW	This option outputs a warning message when a section is allocated to the self RAM area.
	-OCDTR	This option disables allocation of a section to the trace RAM and self RAM areas.
	-OCDTRW	This option outputs a warning message when a section is allocated to the trace RAM and self RAM areas.
Section specification	-OCDHPI	This option disables allocation of a section to the hot plug-in RAM, trace RAM, and self RAM areas.
	-OCDHPIW	This option outputs a warning message when a section is allocated to the hot plug-in RAM, trace RAM, and self RAM areas.
	-DSP_MEMORY_AREA [V1.12 or later]	This option disables allocation of a section to the memory area shared with the FLEXIBLE APPLICATION ACCELERATOR (FAA).
Verify specification	-CPu	This option checks the consistency of the address to which the section is allocated.
	-CHECK_DEVICE	This option checks the device file specified when creating an object file.
	-CHECK_64K_ONLY	This option disables checking whether an allocated section exceeds the (64K-1)-byte boundary.
	-NO_CHECK_SECTION_LAYOUT	This option disables checking of the consistency between the address to which the section is allocated and the address information in a device file.
	-CHECK_OUTPUT_ROM_AREA [V1.07 or later]	This option checks whether the output address of a HEX file ranges in internal ROM or the data flash area.
Subcommand file specification	-SUbcommand	This option specifies options with a subcommand file.
Microcontroller specification	-DEVICE	This option specifies the device file name.
Other	-S9	This option outputs the S9 record at the end.
	-STACk	This option outputs the stack information file.
	-COmpress	This option compresses the debug information.
	-NOCOmpress	This option does not compress the debug information.
	-MEMory	This option specifies the memory size occupied during linking.
	-REName	This option changes an external symbol name or a section name.
	-LIB_REName [V1.08 or later]	This option changes the name of a symbol or section that was input from a library.
	-DELete	This option deletes an external symbol name or a library module.
	-REPlace	This option replaces library modules.
	-EXTract	This option extracts library modules.
	-STRip	This option deletes debug information in the load module file or library file.
	-CHange_message	This option changes the type of information, warning, and error messages.
	-Hide	This option deletes local symbol name information from the output file.
	-Total_size	This option displays the total size of sections after the linking to the standard error output.
	-VERBOSE [V1.10 or later]	This option displays detailed information in the standard error output.
	-LOgo	This option outputs the copyright notice.
	-NOLOgo	This option suppresses the output of the copyright notice.
	-END	This option executes option strings specified before this option.
	-EXIt	This option specifies the end of option specifications.