Converts a memory address to a symbolic representation, if
possible.
Format
SYMBOLIZE address-expression[, . . . ]
1 – Parameters
address-expression
Specifies an address expression to be symbolized. Do not use the
asterisk (*) wildcard character.
2 – Description
If the address is a static address, it is symbolized as the
nearest preceding symbol name, plus an offset. If the address
is also a code address and a line number can be found that covers
the address, the line number is included in the symbolization.
If the address is a register address, the debugger displays all
symbols in all set modules that are bound to that register. The
full path name of each such symbol is displayed. The register
name itself ("%R5", for example) is also displayed.
If the address is a call stack location in the call frame of a
routine in a set module, the debugger searches for all symbols
in that routine whose addresses are relative to the frame pointer
(FP) or the stack pointer (SP). The closest preceding symbol name
plus an offset is displayed as the symbolization of the address.
A symbol whose address specification is too complex is ignored.
On Alpha processors, the commands
SYMBOLIZE procedure-code-address and
SYMBOLIZE procedure-descriptor-address both display the path
name of the routine, entry point, or Ada package specified by
these addresses.
If the debugger cannot symbolize the address, a message is
displayed.
Related commands:
EVALUATE/ADDRESS
SET MODE [NO]LINE
SET MODE [NO]SYMBOLIC
(SET,SHOW) MODULE
SHOW SYMBOL
3 – Examples
1.DBG> SYMBOLIZE %R5
address PROG\%R5:
PROG\X
DBG>
This example shows that the local variable X in routine PROG is
located in register R5.
2.DBG> SYMBOLIZE %HEX 27C9E3
address 0027C9E3:
MOD5\X
DBG>
This command directs the debugger to treat the integer literal
27C9E3 as a hexadecimal value and convert that address to a
symbolic representation, if possible. The address converts to
the symbol X in module MOD5.