# Symbol References

Displays a table of reference-related information. When a symbol is selected in the Symbol Table, the Symbol References table updates to display the reference information for that symbol. The type of references displayed is controlled by the three toggle buttons in the toolbar: References To,Instructions From, and Data From.

## Displaying the Symbol References component

> - From the menu-bar of a tool, select Window Symbol References…
> - From the tool-bar of a tool, click on the button

## References To

> Displays all references to the selected symbol. If the number of references to the symbol is less than the total number of references to the address, then the "References To" label above the References table would show "<symbol reference count> of <total reference count>". The following data columns are displayed in the Symbol References table:

> > Address- the address which corresponds to the code unit which references the selected symbol. Clicking on this address will generate a location event and cause the tool (e.g., Code Browser) to re-position to this address.

> > Label - displays the name of the primary symbol at the from address of the reference to the selected symbol. Clicking on this name will generate a location event and cause the tool (e.g., Code Browser) to re-position to the corresponding label.

> > Subroutine - displays the name of the subroutine/function containing the from address of the reference to the selected symbol. Clicking on this name will generate a location event and cause the tool (e.g., Code Browser) to re-position to the corresponding subroutine/function.

> > Access - indicates the type of reference. This column will display one of the following:

> > > RW - read/write data access
> > > Read - read-only data access
> > > Write - write-only data access
> > > Data - general data access
> > > Branch - conditional jump
> > > Jump - unconditional jump
> > > Call - subroutine/function call
> > > Unknown - all other reference types

> > Preview - preview of the instruction or data located at Address which is the source of the reference.

## Instructions From

> If the selected symbol corresponds to an entry point of a subroutine or function, all instruction references from the corresponding subroutine/function will be displayed. If the selected symbol is not a subroutine/function entry point, the list will be empty. The following data columns are displayed in the References table:

> > Address - the address which corresponds to the instruction within the subroutine/function which is the source of the reference. Clicking on this address will generate a location event and cause the tool (e.g., Code Browser) to re-position to this address.

> > Label - displays the name of the primary symbol at the from address of the reference to the selected symbol. Clicking on this name will generate a location event and cause the tool (e.g., Code Browser) to re-position to the corresponding label.

> > Subroutine - displays the name of the subroutine/function containing the from address of the reference to the selected symbol. Clicking on this name will generate a location event and cause the tool (e.g., Code Browser) to re-position to the corresponding subroutine/function.

> > Access - indicates the type of code access associated with the reference. Code access will generally be limited to a flow* type reference unless it is the target of self-modifying code. This column will display one of the following:

> > > RW - read/write data access
> > > Read - read-only data access
> > > Write - write-only data access
> > > Data - general data access
> > > Branch - conditional jump*
> > > Jump - unconditional jump*
> > > Call - subroutine/function call*
> > > Unknown - all other reference types

> > Preview - preview of the instruction or data located at Address which is the source of the reference.

## Data From

> If the selected symbol corresponds to an entry point of a subroutine or function, all data references from the corresponding subroutine/function will be displayed. If the selected symbol is not a subroutine/function entry point, the list will be empty. The following data columns are displayed in the References table:

> > Address - the address which corresponds to the instruction within the subroutine/function which is the source of the reference. Clicking on this address will generate a location event and cause the tool (e.g., Code Browser) to re-position to this address.

> > Label - displays the name of the primary symbol at the from address of the reference to the selected symbol. Clicking on this name will generate a location event and cause the tool (e.g., Code Browser) to re-position to the corresponding label.

> > Subroutine - displays the name of the subroutine/function containing the from address of the reference to the selected symbol. Clicking on this name will generate a location event and cause the tool (e.g., Code Browser) to re-position to the corresponding subroutine/function.

> > Access - indicates the data type.

> > Preview - preview of the instruction or data located at Address which is the source of the reference.

#### Provided by: Symbol Table plugin