-show | CS+ V8.02.00

-show

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

[Format]

-show [=<sub>[,...]]

        <sub>:{ symbol | reference | section | xreference | total_size | vector |

                struct | relocation_attribute | all}

[Description]

-	Specifies output contents of a list.

-	Table 2.17 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

No	Output Format	Suboption Name	Description
1	form=library 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.
		relocation_attribute	Not specifiable.
		cfi	Not specifiable.
		all	Not specifiable (when extract is specified). Outputs a symbol name list and a section list in a module (when form=library).
2	Other than form=library is 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.
		relocation_attribute	When -form=abs is specified and -strip is not specified, the relocation attribute corresponding to the section is output. When -form=hex/bin/stype is specified and the input file format is not absolute/hex/stype, the relocation attribute corresponding to the section is output. Otherwise, relocation_attribute is not specified.
		cfi	Outputs the function list for use in detecting illegal indirect function calls. cfi must be specified with -cfi option (Otherwise an error will occur). cfi is specifiable when * -form=abs option is specified and -strip option is not specified, or * -form=hex/bin/stype option is specified and input files are absolute/hex/stype. Otherwise, cfi is not specifiable.
		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	relocation_attribute	cfi
form=abs	show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
form=abs	show=all	Valid	Valid	Invalid	Valid	Valid	Valid	Invalid	Invalid
form=lib	show	Valid	Invalid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid
form=lib	show=all	Valid	Invalid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid
form=rel	show	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
form=rel	show=all	Valid	Invalid	Invalid	ValidNote	Invalid	Valid	Invalid	Invalid
form=obj	show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
form=obj	show=all	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
form=hex/bin/sty	show	Valid	Valid	Invalid	Invalid	Invalid	Invalid	Invalid	Invalid
form=hex/bin/sty	show=all	Valid	Valid	Invalid	Valid	ValidNote	ValidNote	Invalid	Invalid

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.