Development Tools

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

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
Absolute	Other than above	Object file Relocatable file Binary file Library file	-input, -library, -binary, -debug, -nodebug, -cpu, -start, -rom, -entry, -output, -map, -padding, -hide, -optimize/-nooptimize, -absolute_forbid, -symbol_forbid, -section_forbid, -compress, -nocompress, -rename, -lib_rename, -delete, -define, -fsymbol, -stack, -memory, -msg_unused, -show={all\|symbol\|reference\|xreference\|total_size\|struct\|relocation_attribute\|cfi}, -aligned_section, -overrun_fetch, -cfi, -cfi_add_func, -cfi_ignore_module
Relocate	-extract specified	Library file	-library, -output
Relocate	Other than above	Object file Relocatable file Binary file Library file	-input, -library, -binary, -debug, -nodebug, -output, -hide, -rename, -lib_rename, -delete, -show={all\|symbol\|xreference\|total_size}
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, -map, -space, -optimize/-nooptimize, -absolute_forbid, -symbol_forbid, -section_forbid, -rename, -lib_rename, -delete, -define, -fsymbol, -stack, -recordNote 2, -end_recordNote 2, -s9Note 2, -byte_countNote 3, -fix_record_length_and_alignNote7, -padding, -memory, -msg_unused, -show={all\|symbol\|reference\|xreference\|total_size\|struct\|relocation_attribute\|cfi}, -aligned_section, -overrun_fetchNote 4, -crc, -cfi, -cfi_add_func, -cfi_ignore_module
		Load module file	-input, -output, -recordNote 2, -end_recordNote 2, -s9Note 2, -byte_countNote 3, -fix_record_length_and_alignNote 7, -show={all\|symbol\|reference\|xreference}, -crc
		Intel HEX fileNote 5	-input, -output
		Motorola S-record fileNote 5	-input, -output, -s9Note 2
Library	-strip specified	Library file	-library, -output, -memoryNote 6, -show
	-extract specified	Library file	-library, -output
	Other than above	Object file Relocatable file	-input, -library, -output, -hide, -rename, -delete, -replace, -memoryNote 6, -show={all\|symbol\|section}, -allow_duplicate_module_name

Note 1.

The following options can always be specified.

-message, -nomessage, -change_message, -logo, -nologo, -form, -list, -subcommand

Note 2.

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.

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

Note 5.

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

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

Note 7.

The -fix_record_length_and_align 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