-show


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

[Format]

-show [=<sub>[,...]]
        <sub>:{ symbol | reference | section | xreference | total_size | vector | struct | all}

[Description]

-

Specifies output contents of a list.

-

Table B-16 lists the suboptions.

-

For details of list examples, refer to Linkage List, and Library List in the user's manual.

Table 2.17

Suboptions of show Option

Output Format

Suboption Name

Description

form=library or extract is specified.

symbol

Outputs a symbol name list in a module (when extract is specified).

reference

Not specifiable.

section

Outputs a section list in a module.

xreference

Not specifiable.

total_size

Not specifiable.

vector

Not specifiable.

all

Not specifiable (when extract is specified).

Outputs a symbol name list and a section list in a module (when form=library).

Other than form=library and extract is not specified.

symbol

Outputs symbol address, size, type, and optimization contents.

reference

Outputs the number of symbol references.

section

Not specifiable.

xreference

Outputs the cross-reference information.

total_size

Shows the total sizes of sections allocated to the ROM and RAM areas.

vector

Outputs vector information.

struct

Outputs structure/union member information.

all

If form=rel the linkage editor outputs the same information as when show=symbol,xreference,total_size is specified.

If form=rel,data_stuff have been specified, the linkage editor outputs the same information as when show=symbol,total_size is specified.

If form=abs the linkage editor outputs the same information as when show=symbol,reference,xreference,total_size,struct is specified.

If form=hex/stype/bin the linkage editor outputs the same information as when show=symbol,reference,xreference,total_size,struct is specified.

If form=obj, all is not specifiable.

 

 

[Remarks]

-

The following table shows whether suboptions will be valid or invalid by all possible combinations of options form, show, and/or show=all.

 

 

Symbol

Reference

Section

Xreference

Vector

Total_size

form=abs

show

Valid

Valid

Invalid

Invalid

Invalid

Invalid

show=all

Valid

Valid

Invalid

Valid

Valid

Valid

form=lib

show

Valid

Invalid

Valid

Invalid

Invalid

Invalid

show=all

Valid

Invalid

Valid

Invalid

Invalid

Invalid

form=rel

show

Valid

Invalid

Invalid

Invalid

Invalid

Invalid

show=all

Valid

Invalid

Invalid

ValidNote

Invalid

Valid

form=obj

show

Valid

Valid

Invalid

Invalid

Invalid

Invalid

show=all

Valid

Invalid

Invalid

Invalid

Invalid

Invalid

form=hex/bin/sty

show

Valid

Valid

Invalid

Invalid

Invalid

Invalid

show=all

Valid

Valid

Invalid

Valid

ValidNote

ValidNote

Note

The option is invalid if an absolute-format file is input.

 

-

Note the following limitations on output of the cross-reference information.

-

When an absolute-format file is input, the referrer address information is not output.

-

Information about references to constant symbols within the same file is not output.

-

When optimization is specified at compilation, information about branches to immediate subordinate functions is not output.

-

When optimization of access to external variables is specified, information about references to variables other than base symbols is not output.

-

Both show=total_size and total_size output the same information.

-

When show=reference is valid, the number of references of the variable specified by #pragma address is output as 0.