-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 2.4 lists the suboptions.

Table 2.14

Suboptions of form Option

No

Suboption

Description

1

absolute

Outputs an absolute file

2

relocate

Outputs a relocatable file

3

object

Outputs an object file. This is specified when a module is extracted as an object file from a library with the extract option.

4

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.

5

hexadecimal

Outputs a HEX file. For details of the HEX format, refer to HEX File Format.

6

stype

Outputs an S-type file. For details of the S-type format, refer to S-Type File Format.

7

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

No

Output Format

Specified Option

Enabled File Format

Specifiable OptionNote1

1

Absolute

strip specified

Absolute file

input, output

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,

lib_rename, delete, define, fsymbol, stack,

noprelink, memory, msg_unused,

show={symbol,reference,xreference,total_size,

vector,relocation_attribute}

jump_entries_for_pic, aligned_section, padding, vectn, vect, split_vect

2

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, lib_rename, delete, noprelink,

msg_unused,

show=symbol,reference,xreference,total_size

3

Object

extract specified

Library file

library, output

4

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,

lib_rename, delete, define, fsymbol, stack,

noprelink, record, end_record, s9Note 2,

byte_countNote3, fix_record_length_and_align,

memory, msg_unused,

show=symbol,reference,xreference,total_size,

vector, jump_entries_for_pic, aligned_section, padding, vectn, vect, split_vect

Absolute file

input, output, record, end_record, s9Note2,

byte_countNote3, fix_record_length_and_align,

show=symbol, reference, xreference

5

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 or form=stype is specified for the output format.

Notes 4.

memory cannot be used when hide is specified.