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 and Description
static int	DBG_ADVANCE_LINE Advances the line register without emitting a positions entry.
static int	DBG_ADVANCE_PC Advances the program counter/address register without emitting a positions entry.
static int	DBG_END_LOCAL Marks a currently-live local variable as out of scope at the current address.
static int	DBG_END_SEQUENCE Terminates a debug info sequence for a method.
static int	DBG_FIRST_SPECIAL the smallest value a special opcode can take
static int	DBG_LINE_BASE
static int	DBG_LINE_RANGE
static int	DBG_RESTART_LOCAL Re-introduces a local variable at the current address.
static 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 int	DBG_SET_FILE Sets the current file that that line numbers refer to.
static 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 int	DBG_START_LOCAL Introduces a local variable at the current address.
static int	DBG_START_LOCAL_EXTENDED Introduces a local variable at the current address with a type signature specified.

Field Detail

DBG_END_SEQUENCE

static final int DBG_END_SEQUENCE

Terminates a debug info sequence for a method.

Args: none

See Also:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

DBG_FIRST_SPECIAL

static final int DBG_FIRST_SPECIAL

the smallest value a special opcode can take

See Also:

Constant Field Values

DBG_LINE_BASE

static final int DBG_LINE_BASE

See Also:

Constant Field Values

DBG_LINE_RANGE

static final int DBG_LINE_RANGE

See Also:

Constant Field Values