-form | CS+ V4.01.00

-form

< Optimizing Linkage Editor (rlink) Options / Output Options >

[Format]

-form = {Absolute | Relocate | Object | Library[={S | U}]} | Hexadecimal | Stype | Binary}

[Default]

When this option is omitted, the default is form=absolute.

[Description]

-	Specifies the output format.

-	Table B-14 lists the suboptions.

Table 2.14

Suboptions of form Option

Suboption	Description
absolute	Outputs an absolute file
relocate	Outputs a relocatable file
object	Outputs an object file. This is specified when a module is extracted as an object file from a library with the extract option.
library	Outputs a library file. When library=s is specified, a system library is output. When library=u is specified, a user library is output. Default is library=u.
hexadecimal	Outputs a HEX file. For details of the HEX format, refer to HEX File Format.
stype	Outputs an S-type file. For details of the S-type format, refer to S-Type File Format.
binary	Outputs a binary file.

[Remarks]

Table B-15 shows relations between output formats and input files or other options.

Table 2.15

Relations Between Output Format and Input File or Other Options

Output Format	Specified Option	Enabled File Format	Specifiable OptionNote1
Absolute	strip specified	Absolute file	input, output
Absolute	Other than above	Object file Relocatable file Binary file Library file	input, library, binary, debug/nodebug, sdebug, cpu, start, rom, entry, output, map, hide, optimize/nooptimize, samesize, symbol_forbid, samecode_forbid, section_forbid, absolute_forbid, compress, rename, delete, define, fsymbol, stack, noprelink, memory, msg_unused, show=symbol, reference, xreference, jump_entries_for_pic, aligned_section
Relocate	extract specified	Library file	library, output
Relocate	Other than above	Object file Relocatable file Binary file Library file	input, library, debug/nodebug, output, hide, rename, delete, noprelink, msg_unused, show=symbol, xreference
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, samesize, symbol_forbid, samecode_forbid, section_forbid, absolute_forbid, rename, delete, define, fsymbol, stack, noprelink, record, s9Note 2, byte_countNote3, memory, msg_unused, show=symbol, reference, xreference, jump_entries_for_pic, aligned_section
Hexadecimal Stype Binary		Absolute file	input, output, record, s9Note2, byte_countNote3, show=symbol, reference, xreference
Library	strip specified	Library file	library, output, memoryNote4, show=symbol, section
	extract specified	Library file	library, output
	Other than above	Object file Relocatable file	input, library, output, hide, rename, delete, replace, noprelink, memoryNote4, show=symbol, section

Notes 1.

message/nomessage, change_message, logo/nologo, form, list, and subcommand can always be specified.

Notes 2.

s9 can be used only when form=stype is specified for the output format.

Notes 3.

byte_count can be used only when form=hexadecimal is specified for the output format.

Notes 4.

memory cannot be used when hide is specified.