Development Tools

-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).
RELOCATION_ATTRIBUTE [V1.06.00 or later]	Not specifiable	Outputs the relocation attribute.
CFI [V1.07.00 or later]	Not specifiable	When the -form=absolute option is specified Outputs the function list for use in detecting illegal indirect function calls. When the -form=hex/bin/stype option is specified and input files are other than absolute/hex/stype Outputs the function list for use in detecting illegal indirect function calls.
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	STRUCT	RELOCATION_ATTRIBUTE	CFI
-form=absolute	only -show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=absolute	-show=all	Valid	Valid	Invalid	Valid	Valid	ValidNote 4	Invalid	Invalid
-form=library	only -show	Valid	Invalid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=library	-show=all	Valid	Invalid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=relocate	only -show	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=relocate	-show=all	Valid	Invalid	Invalid	ValidNote 1	Valid	Invalid	Invalid	Invalid
-form=object	only -show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=object	-show=all	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=hexadecimalNote 2/ stypeNote 3/binary	only -show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=hexadecimalNote 2/ stypeNote 3/binary	-show=all	Valid	Valid	Invalid	Valid	ValidNote 1	ValidNote 4	Invalid	Invalid

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.

Note 4.

If the -rename, -lib_rename, -hide, or -compress option or optimization by deleting unreferenced symbols (-optimize=symbol_delete) is specified, this combination will be invalid.

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.