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 ccrh command, the -Xlk_option option must be used.

The types and explanations for options are shown below.

Table 2.4

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 [V2.02.00 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.06.00 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.
	-MAp	This option outputs the external variable allocation information 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 user of the external defined symbol that is not referenced.
	-BYte_count	This option specifies the maximum byte count for a data record.
	-FIX_RECORD_LENGTH_AND_ALIGN [V1.07.00 or later]	Fixes the format of data records to be output.
	-PADDING	This option fills in data at the end of a section.
	-OVERRUN_FETCH	This option prevents reading of vacant areas due to overrun fetch.
	-CRc	This option outputs the CRC code.
	-CFI [Professional Edition only] [V1.07.00 or later]	Generates the function list for use in detecting illegal indirect function calls.
	-CFI_ADD_Func [Professional Edition only] [V1.07.00 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.07.00 or later]	Specifies modules which are to be exempted from the function list for use in detecting illegal indirect function calls.
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 / -NOOPtimize [V2.01.00 or later]	This option specifies whether link-time optimization is to be executed.
	-SEction_forbid [V2.01.00 or later]	This option suppresses link-time optimization of specific sections.
	-Absolute_forbid [V2.01.00 or later]	This option suppresses link-time optimization in a specific address range.
	-SYmbol_forbid [V2.01.00 or later]	This option suppresses link-time optimization of specific symbols.
Section specification	-STARt	This option specifies the start address of the section.
	-FSymbol	This option outputs external defined symbols to the symbol address file.
	-ALIGNED_SECTION	This option changes the number of alignment of the section to 16 bytes.
Verify specification	-CPu	This option checks the consistency of the address to which the section is allocated.
Subcommand file specification	-SUbcommand	This option specifies options with a subcommand file.
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 [V2.01.00 or later]	This option changes a symbol name or section name 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 [V2.03.00 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.