Everything
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.

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

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