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.

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.

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

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

-VFINFO

This option outputs the variable/function information file.

List output

-LISt

This option outputs the list file.

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

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_ID

This option specifies a security ID value.

-AUTO_SECTION_LAYOUT

This option automatically allocates sections.

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

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

Verify specification

-CPu

This option checks the consistency of the address to which the section is allocated.

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

This option checks the device file specified when creating an object file.

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.

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