APIdia Launch Partner
Top Description Inners Methods
sun.jvm.hotspot.debugger.cdbg

public Interface DebugEvent

Known Direct Implementers
sun.jvm.hotspot.debugger.cdbg.basic.BasicDebugEvent
Imports
sun.jvm.hotspot.debugger.*

Describes in an abstract sense the kind of debug events which may be received from the target process. On UNIX platforms these are typically signals intercepted via ptrace or some other mechanism, while on Windows they are usually exceptions. Also describes certain types of events like loading and unloading of DSOs/DLLs ("LoadObjects").

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static class

Method Summary

Modifier and TypeMethod and Description
public Address
getAddress()

For ACCESS_VIOLATION events, returns the address at which the fault occurred.

public Address
getPC()

For BREAKPOINT, SINGLE_STEP, and ACCESS_VIOLATION events, returns the program counter at which the event occurred.

public ThreadProxy
getThread()

Retrieves the ThreadProxy for the thread on which the event occurred.

public DebugEvent.Type
getType()

The type of this debug event; BREAKPOINT, SINGLE_STEP, etc.

public String
getUnknownEventDetail()

For UNKNOWN events, may return a detail message or may return null.

public boolean
getWasWrite()

For ACCESS_VIOLATION events, indicates whether the fault occurred on a write (vs. a read).

Method Detail

getAddressback to summary
public Address getAddress()

For ACCESS_VIOLATION events, returns the address at which the fault occurred. For LOADOBJECT_LOAD and LOADOBJECT_UNLOAD events, returns the base address of the loadobject in the target process's address space. For other types of events returns an undefined value.

getPCback to summary
public Address getPC()

For BREAKPOINT, SINGLE_STEP, and ACCESS_VIOLATION events, returns the program counter at which the event occurred. For other types of events returns an undefined value.

getThreadback to summary
public ThreadProxy getThread()

Retrieves the ThreadProxy for the thread on which the event occurred. This is always present.

getTypeback to summary
public DebugEvent.Type getType()

The type of this debug event; BREAKPOINT, SINGLE_STEP, etc.

getUnknownEventDetailback to summary
public String getUnknownEventDetail()

For UNKNOWN events, may return a detail message or may return null. For other types of events returns an undefined value.

getWasWriteback to summary
public boolean getWasWrite()

For ACCESS_VIOLATION events, indicates whether the fault occurred on a write (vs. a read). For other types of events returns an undefined value.

sun.jvm.hotspot.debugger.cdbg back to summary

public Class DebugEvent.Type

extends Object
Class Inheritance

Field Summary

Modifier and TypeField and Description
public static final DebugEvent.Type
ACCESS_VIOLATION

Indicates an unmapped memory address was read from or written to by the target process

public static final DebugEvent.Type
BREAKPOINT

Indicates a breakpoint was hit

public static final DebugEvent.Type
LOADOBJECT_LOAD

Indicates a DSO/DLL was loaded by the target process

public static final DebugEvent.Type
LOADOBJECT_UNLOAD

Indicates a DSO/DLL was unloaded by the target process

public static final DebugEvent.Type
SINGLE_STEP

Indicates a single machine instruction was stepped

public static final DebugEvent.Type
UNKNOWN

Indicates an event of an unknown type occurred in the target process (catch-all for implementations; but add more event types)

Constructor Summary

AccessConstructor and Description
private
Type()

Method Summary

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

ACCESS_VIOLATIONback to summary
public static final DebugEvent.Type ACCESS_VIOLATION

Indicates an unmapped memory address was read from or written to by the target process

BREAKPOINTback to summary
public static final DebugEvent.Type BREAKPOINT

Indicates a breakpoint was hit

LOADOBJECT_LOADback to summary
public static final DebugEvent.Type LOADOBJECT_LOAD

Indicates a DSO/DLL was loaded by the target process

LOADOBJECT_UNLOADback to summary
public static final DebugEvent.Type LOADOBJECT_UNLOAD

Indicates a DSO/DLL was unloaded by the target process

SINGLE_STEPback to summary
public static final DebugEvent.Type SINGLE_STEP

Indicates a single machine instruction was stepped

UNKNOWNback to summary
public static final DebugEvent.Type UNKNOWN

Indicates an event of an unknown type occurred in the target process (catch-all for implementations; but add more event types)

Constructor Detail

Typeback to summary
private Type()