Package com.android.dx.dex.file

Interface DebugInfoConstants

public interface DebugInfoConstants
Constants for the dex debug info state machine format.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    DBG_ADVANCE_LINE
    Advances the line register without emitting a positions entry.
    static final int
    DBG_ADVANCE_PC
    Advances the program counter/address register without emitting a positions entry.
    static final int
    DBG_END_LOCAL
    Marks a currently-live local variable as out of scope at the current address.
    static final int
    DBG_END_SEQUENCE
    Terminates a debug info sequence for a method.
    static final int
    DBG_FIRST_SPECIAL
    the smallest value a special opcode can take
    static final int
    DBG_LINE_BASE
     
    static final int
    DBG_LINE_RANGE
     
    static final int
    DBG_RESTART_LOCAL
    Re-introduces a local variable at the current address.
    static final int
    DBG_SET_EPILOGUE_BEGIN
    Sets the "epilogue_begin" state machine register, indicating that the next position entry that is added should be considered the beginning of a method epilogue (an appropriate place to suspend execution before method exit).
    static final int
    DBG_SET_FILE
    Sets the current file that that line numbers refer to.
    static final int
    DBG_SET_PROLOGUE_END
    Sets the "prologue_end" state machine register, indicating that the next position entry that is added should be considered the end of a method prologue (an appropriate place for a method breakpoint).
    static final int
    DBG_START_LOCAL
    Introduces a local variable at the current address.
    static final int
    DBG_START_LOCAL_EXTENDED
    Introduces a local variable at the current address with a type signature specified.

  • Field Details

    • DBG_END_SEQUENCE

      static final int DBG_END_SEQUENCE
      Terminates a debug info sequence for a method.

      Args: none

      See Also:

    • DBG_ADVANCE_PC

      static final int DBG_ADVANCE_PC
      Advances the program counter/address register without emitting a positions entry.

      Args:

      1. Unsigned LEB128 — amount to advance pc by
      See Also:

    • DBG_ADVANCE_LINE

      static final int DBG_ADVANCE_LINE
      Advances the line register without emitting a positions entry.

      Args:

      1. Signed LEB128 — amount to change line register by.
      See Also:

    • DBG_START_LOCAL

      static final int DBG_START_LOCAL
      Introduces a local variable at the current address.

      Args:

      1. Unsigned LEB128 — register that will contain local.
      2. Unsigned LEB128 — string index (shifted by 1) of local name.
      3. Unsigned LEB128 — type index (shifted by 1) of type.
      See Also:

    • DBG_START_LOCAL_EXTENDED

      static final int DBG_START_LOCAL_EXTENDED
      Introduces a local variable at the current address with a type signature specified.

      Args:

      1. Unsigned LEB128 — register that will contain local.
      2. Unsigned LEB128 — string index (shifted by 1) of local name.
      3. Unsigned LEB128 — type index (shifted by 1) of type.
      4. Unsigned LEB128 — string index (shifted by 1) of type signature.
      See Also:

    • DBG_END_LOCAL

      static final int DBG_END_LOCAL
      Marks a currently-live local variable as out of scope at the current address.

      Args:

      1. Unsigned LEB128 — register that contained local
      See Also:

    • DBG_RESTART_LOCAL

      static final int DBG_RESTART_LOCAL
      Re-introduces a local variable at the current address. The name and type are the same as the last local that was live in the specified register.

      Args:

      1. Unsigned LEB128 — register to re-start.
      See Also:

    • DBG_SET_PROLOGUE_END

      static final int DBG_SET_PROLOGUE_END
      Sets the "prologue_end" state machine register, indicating that the next position entry that is added should be considered the end of a method prologue (an appropriate place for a method breakpoint).

      The prologue_end register is cleared by any special (>= OPCODE_BASE) opcode.

      See Also:

    • DBG_SET_EPILOGUE_BEGIN

      static final int DBG_SET_EPILOGUE_BEGIN
      Sets the "epilogue_begin" state machine register, indicating that the next position entry that is added should be considered the beginning of a method epilogue (an appropriate place to suspend execution before method exit).

      The epilogue_begin register is cleared by any special (>= OPCODE_BASE) opcode.

      See Also:

    • DBG_SET_FILE

      static final int DBG_SET_FILE
      Sets the current file that that line numbers refer to. All subsequent line number entries make reference to this source file name, instead of the default name specified in code_item. Args:
      1. Unsigned LEB128 — string index (shifted by 1) of source file name.
      See Also:

    • DBG_FIRST_SPECIAL

      static final int DBG_FIRST_SPECIAL
      the smallest value a special opcode can take
      See Also:

    • DBG_LINE_BASE

      static final int DBG_LINE_BASE
      See Also:

    • DBG_LINE_RANGE

      static final int DBG_LINE_RANGE
      See Also: