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 status.
Reference	Not specifiable	Outputs the symbol address, size, type, optimization status, 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.
VECTOR	Not specifiable	Outputs vector information.
STRUCT	Not specifiable	Outputs information on structure or union members (which have been defined in files that have been compiled with the -g option specified) as part of the symbol information in the link map file. This setting will be invalid if the -form=relocate/object, -rename, -lib_rename, -hide, -compress, or -optimize=symbol_delete option is specified.
RELOCATION_ATTRIBUTE	Not specifiable	Outputs the relocation attribute.
CFI	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,vector,struct option is specified. When the -form=hexadecimal/stype/binary option Outputs the same information as when the -show=symbol,reference,xreference,total_size,vector,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	VECTOR	STRUCT	RELOCATION_ATTRIBUTE	CFI
-form=absolute	only -show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=absolute	-show=all	Valid	Valid	Invalid	Valid	Valid	Valid	Valid	Invalid	Invalid
-form=library	only -show	Valid	Invalid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=library	-show=all	Valid	Invalid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=relocate	only -show	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=relocate	-show=all	Valid	Invalid	Invalid	Valid	Invalid	Valid	Invalid	Invalid	Invalid
-form=object	only -show	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form=object	-show=all	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form= hexadecimalNote 2/stypeNote 3/binary	only -show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
-form= hexadecimalNote 2/stypeNote 3/binary	-show=all	Valid	Valid	Invalid	Valid	ValidNote1	ValidNote1	ValidNote1	Invalid	Invalid

Note 1.

If a load module file, Intel Hex file, or Motorola S-record file is input, this combination will be invalid.

Note 2.

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

Note 3.

If a Motorola S-record file is input, 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.