-FOrm


This option specifies the output format.

[Specification format]

-FOrm=format

 

-

Interpretation when omitted

A load module file is output (It is the same result as when the -form=absolute option is specified).

[Detailed description]

-

This option specifies output format format.

-

The items that can be specified as format are shown below.

Absolute

Outputs a load module file.

Relocate

Outputs a relocatable file.

Object

Outputs an object file.

Use this when a module is extracted as an object file from a library by the -extract option.

Library[={S|U}]

Outputs a library file.

When "library=s" is specified, a system library file is output.

When "library=u" is specified, a user library file is output.

If only "library" is specified, it is assumed that "library=u" has been specified.

Hexadecimal

Outputs an Intel HEX file.

See "3.5 Intel HEX File" for details.

Stype

Outputs a Motorola S-record file.

See "3.6 Motorola S-record File" for details.

Binary

Outputs a binary file.

[Remark]

-

The relations between output formats and input files or other options are shown below.

Table 2.9

Relations Between Output Formats And Input Files Or Other Options

Output Format

Specified Option

File Format That Can Be Input

Specifiable Option Note 1

Absolute

-strip specified

Load module file

-input, -output

Other than above

Object file

Relocatable file

Binary file

Library file

-input, -library, -binary, -debug, -nodebug, -cpu, -start, -rom,

-entry, -output, -hide, -optimize, -nooptimize,

-section_forbid, -absolute_forbid, -compress, -nocompress,

-rename, -delete, -define, -fsymbol, -stack, -memory,

-msg_unused,

-show={symbol|reference|xreference|total_size|

vector|struct|relocation_attribute|all}, -user_opt_byte,

-ocdbg, -security_id, -device, -padding, -vect, -vectn,

-split_vect, -vfinfo, -auto_section_layout, -debug_monitor,

-rrm, -self, -selfw, -ocdtr, -ocdtrw, -ocdhpi, -ocdhpiw,

-check_device, -check_64k_only,

-no_check_section_layout, -cfi, -cfi_add_func, -cfi_ignore_module

Relocate

-extract specified

Library file

-library, -output

Other than above

Object file

Relocatable file

Binary file

Library file

-input, -library, -debug, -nodebug, -output, -hide, -rename,

-delete, -show={symbol|xreference|total_size|all},

-check_device

Object

-extract specified

Library file

-library, -output

Hexadecimal

Stype

Binary

Object file

Relocatable file

Binary file

Library file

-input, -library, -binary, -cpu, -start, -rom, -entry, -output,

-space, -optimize, -nooptimize, -section_forbid,

-absolute_forbid, -rename, -delete, -define, -fsymbol, -stack,

-record, -end_recordNote 2, -s9Note 2, -byte_countNote 3, -fix_record_length_and_alignNote 6,

-memory, -msg_unused,

-show={symbol|reference|xreference|total_size|vector|

struct|relocation_attribute|all}, -user_opt_byte, -ocdbg,

-security_id, -crc, -device, -padding, -vect, -vectn,

-split_vect, -vfinfo, -auto_section_layout,

-debug_monitor, -rrm, -self, -selfw, -ocdtr, -ocdtrw, -ocdhpi,

-ocdhpiw, -check_device, -check_64k_only,

-no_check_section_layout,

-check_output_rom_areaNote 7, -cfi, -cfi_add_func,

-cfi_ignore_module

Load module file

-input, -output, -record, -end_recordNote 2, -s9Note 2,

-byte_countNote 3, -fix_record_length_and_alignNote 6,

-show={symbol|reference|xreference|total_size|vector|all}

-device, -check_output_rom_areaNote 7

Intel HEX fileNote 4

-input, -output

-device, -check_output_rom_areaNote 7

Motorola S-record fileNote 4

-input, -output, -s9Note 2

-device, -check_output_rom_areaNote 7

Library

-strip specified

Library file

-library, -output, -memoryNote 5, -show={symbol|section|all}

-extract specified

Library file

-library, -output

Other than above

Object file

Relocatable file

-input, -library, -output, -hide, -rename, -delete, -replace,

-memoryNote 5, -show={symbol|section|all}

Note 1.

The following options can always be specified.
-message, -nomessage, -change_message, -logo, -nologo, -form, -list, -subcommand

Note 2.

The -end_record and -s9 option are valid only when the -form=stype option is specified.

Note 3.

The -byte_count option is valid only when the -form=hexadecimal or -form=stype option is specified.

Note 4.

If an Intel HEX file is specified as an input file, only the -form=hexadecimal option can be specified. If a Motorola S-record file is specified, only the -form=stype option can be specified.

Note 5.

The -memory option cannot be specified when the -hide option is specified.

Note 6.

The -fix_record_length_and_align option is valid only when the -form=hexadecimal or -form=stype option is specified.

Note 7.

The -check_output_rom_area option is valid only when the -form=hexadecimal or -form=stype option is specified.

[Example of use]

-

To output relocatable file c.rel from a.obj and b.obj, describe as:

>rlink a.obj b.obj -form=relocate -output=c.rel

 

-

To extract module "a" from lib.lib and output as an object file, describe as:

>rlink -library=lib.lib -extract=a -form=object

 

-

To extract module "a" from lib.lib and output library file exta.lib, describe as:

>rlink -library=lib.lib -extract=a -form=library -output=exta

 

-

To extract module "a" from lib.lib and output relocatable file a.rel, describe as:

>rlink -library=lib.lib -extract=a -form=relocate