2.5.3 Optimizing Linkage Editor (rlink) Options

Classification

Option

Description

Input Options

-Input

Specifies relocatable files.

-library

Specifies library files.

-binary

Specifies binary files.

-define

Specifies symbol definitions.

-entry

Specifies an entry symbol or entry address.

-noprelink

Selects non-initiation of the prelinker.

Output Options

-form

Selects the output file format.

-debug

Debugging information is output to load module files.

-sdebug

Debugging information is output to the .dbg file.

-nodebug

Debugging information is not output.

-record

Selects the record size.

-end_record [V2.07.00 or later]

This option specifies the end record.

-rom

Specifies the section mapping from ROM to RAM.

-output

Specifies the names of files to be output.

-map

Outputs an external symbol-allocation information file.

-space

Data are output to fill unused ranges of memory.

-message

Information-level messages are output.

-nomessage

The output of messages is disabled.

-msg_unused

Messages are output to indicate the presence of externally defined symbols to which there is no reference.

-byte_count

Specifies the number of bytes in a data record.

-fix_record_length_and_alignment [V2.08.00 or later]

Fixes the format of data records to be output.

-crc

Specifies the format for output of the CRC code.

-padding

Padding data are included at the end of each section.

-vectn

Assigns an address to the specified vector number in the variable vector table (for the RX Family and M16C Family).

-vect

Assigns an address to an unused area in the variable vector table (for the RX Family and M16C Family).

-split_vect [V3.00.00 or later]

Generates split vector table sections.

-jump_entries_for_pic

Outputs a jump table file (for the PIC function of the RX Family).

-cfi [Professional Edition only] [V2.08.00 or later]

Generates the function list for use in detecting illegal indirect function calls.

-cfi_add_func [V2.08.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 [V2.08.00 or later]

Specifies modules which are to be exempted from checking against the function list for use in detecting illegal indirect function calls.

-create_unfilled_area

[To be supported by V2.03 and later versions]

Makes spaces created by .OFFSET unfilled.

List Options

-list

A linkage list file is output.

-show

Selects the contents to be output in the linkage list file.

Optimize Options

-optimize

Selects the items to be optimized at linkage.

-nooptimize

Selects no optimization at linkage.

-samesize

Specifies the minimum size for unification of the same codes.

-symbol_forbid

Specifies symbols for which unreferenced symbol deletion is disabled.

-samecode_forbid

Specifies symbols for which same code unification is disabled.

-section_forbid

Specifies a section where optimization is disabled.

-absolute_forbid

Specifies an address range where optimization is disabled.

Section Options

-start

Specifies a section start address.

-fsymbol

Specifies the section where an external defined symbol will be placed in the output file.

-aligned_section

Specifies the section alignment value as 16 bytes.

Verify Options

-cpu

Checks addresses for consistency.

-contiguous_section

Specifies sections that will not be divided.

Other Options

-s9

Selects the output of an s9 record at the end of the file.

-stack

Selects the output of a stack-usage information file.

-compress

Debugging information are compressed.

-nocompress

Debugging information are not compressed.

-memory

Selects the amount of memory to be used in linkage.

-rename

Specifies symbol names and section names to be modified.

-delete

Specifies symbol names and module names to be deleted.

-replace

Specifies library modules to be replaced.

-extract

Specifies modules to be extracted from library files.

-strip

Debugging information is deleted from absolute files and library files.

-change_message

Specifies changes to the levels of messages (information, warning, and error).

-hide

Name information on local symbols is deleted.

-total_size

The total sizes of sections after linkage are sent to standard output.

Subcommand File Option

-subcommand

Specifies a file from which to include command options.

Options Other Than Above

-logo

Selects the output of copyright information.

-nologo

Selects the non-output of copyright information.

-end

Selects the execution of option strings specified before END.

-exit

Specifies the end of option specification.