-SHow


This option specifies information that is output to the list file.

[Specification format]

-SHow[=info[,info]...]

 

-

Interpretation when omitted

None

[Detailed description]

-

This option specifies information info that is output to the list file.

-

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

Output Information (info)

When -form=library Option Is Specified

When Other Than -form=library Option Is Specified

SYmbol

Outputs symbol names within a module.

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

Reference

Not specifiable

Outputs the symbol address, size, type, optimization contents, and number of symbol references.

SEction

Outputs section names in a module.

Not specifiable

Xreference

Not specifiable

Outputs cross reference information.

Total_size

Not specifiable

Outputs the total sizes of sections separately for ROM-allocated sections and RAM-allocated sections.

struct

Not specifiable

Outputs in the symbol information the structure and union member information defined in files that have been compiled with -g specified (this setting will be invalid if -form=rel or obj is specified).

ALL

Outputs symbol names and section names in a module.

When the -form=relocate option is specified

Outputs the same information as when the -show=symbol,xreference,total_size option is specified.

When the -form=absolute option is specified

Outputs the same information as when the -show=symbol,reference,xreference,total_size,struct option is specified.

When the -form=hexadecimal/stype/binary option

Outputs the same information as when the -show=symbol,reference,xreference,total_size,struct option is specified.

When the -form=object option is specified

Not specifiable

Remark

See "3.2 Link Map File" and "3.4 Library List File" for details about output information.

 

-

See [Remark] for details about when the specification of output information is omitted.

[Example of use]

-

To output the symbol address, size, type, optimization contents, and number of symbol references, describe as:

>rlink a.obj b.obj -list -show=symbol,reference

[Remark]

-

The following table shows whether output information info will be valid or invalid by the combinations of the -form option and the -show or -show=all option.

 

 

Symbol

Reference

Section

Xreference

Total_size

Strust

-form=absolute

only -show

Valid

Valid

Invalid

Invalid

Invalid

Invalid

-show=all

Valid

Valid

Invalid

Valid

Valid

Valid

-form=library

only -show

Valid

Invalid

Valid

Invalid

Invalid

Invalid

-show=all

Valid

Invalid

Valid

Invalid

Invalid

Invalid

-form=relocate

only -show

Valid

Invalid

Invalid

Invalid

Invalid

Invalid

-show=all

Valid

Invalid

Invalid

ValidNote 1

Valid

Invalid

-form=object

only -show

Valid

Valid

Invalid

Invalid

Invalid

Invalid

-show=all

Invalid

Invalid

Invalid

Invalid

Invalid

Invalid

-form=hexadecimalNote 2/
stypeNote 3/binary

only -show

Valid

Valid

Invalid

Invalid

Invalid

Invalid

-show=all

Valid

Valid

Invalid

Valid

ValidNote 1

Valid

Note 1.

If a load module file is input, this combination will be invalid.

Note 2.

If a input file is an Intel Hex file, the -show option cannot be specified.

Note 3.

If a input file is a Motorola S-record file, the -show option cannot be specified.

 

The limitations on the output of the cross reference information are shown below.

-

When a load module file is input, the referrer address information is not output.

-

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

-

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

-

Both -show=total_size option and -total_size option output the same information.