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.