DBG$HELP.HLB  —  DEBUG  SYMBOLIZE
    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.
Close Help