Package org.eclipse.debug.core.model
Interface IDebugTarget
-
- All Superinterfaces:
IAdaptable,IBreakpointListener,IDebugElement,IDisconnect,IMemoryBlockRetrieval,ISuspendResume,ITerminate
public interface IDebugTarget extends IDebugElement, ITerminate, ISuspendResume, IBreakpointListener, IDisconnect, IMemoryBlockRetrieval
A debug target is a debuggable execution context. For example, a debug target may represent a debuggable process or a virtual machine. A debug target is the root of the debug element hierarchy. A debug target contains threads. Minimally, a debug target supports the following:- terminate
- suspend/resume
- breakpoints
- disconnect
Generally, launching a debug session results in the creation of a debug target. Launching is a client responsibility, as is debug target creation.
Clients may implement this interface.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description StringgetName()Returns the name of this debug target.IProcessgetProcess()Returns the system process associated with this debug target.IThread[]getThreads()Returns the threads contained in this debug target.booleanhasThreads()Returns whether this debug target currently contains any threads.booleansupportsBreakpoint(IBreakpoint breakpoint)Returns whether this target can install the given breakpoint.-
Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapter
-
Methods inherited from interface org.eclipse.debug.core.IBreakpointListener
breakpointAdded, breakpointChanged, breakpointRemoved
-
Methods inherited from interface org.eclipse.debug.core.model.IDebugElement
getDebugTarget, getLaunch, getModelIdentifier
-
Methods inherited from interface org.eclipse.debug.core.model.IDisconnect
canDisconnect, disconnect, isDisconnected
-
Methods inherited from interface org.eclipse.debug.core.model.IMemoryBlockRetrieval
getMemoryBlock, supportsStorageRetrieval
-
Methods inherited from interface org.eclipse.debug.core.model.ISuspendResume
canResume, canSuspend, isSuspended, resume, suspend
-
Methods inherited from interface org.eclipse.debug.core.model.ITerminate
canTerminate, isTerminated, terminate
-
-
-
-
Method Detail
-
getProcess
IProcess getProcess()
Returns the system process associated with this debug target.- Returns:
- the system process associated with this debug target
-
getThreads
IThread[] getThreads() throws DebugException
Returns the threads contained in this debug target. An empty collection is returned if this debug target contains no threads.- Returns:
- a collection of threads
- Throws:
DebugException- if this method fails. Reasons include:- Failure communicating with the debug target. The DebugException's status code contains the underlying exception responsible for the failure.
- Since:
- 2.0
-
hasThreads
boolean hasThreads() throws DebugExceptionReturns whether this debug target currently contains any threads.- Returns:
- whether this debug target currently contains any threads
- Throws:
DebugException- if this method fails. Reasons include:- Failure communicating with the debug target. The DebugException's status code contains the underlying exception responsible for the failure.
- Since:
- 2.0
-
getName
String getName() throws DebugException
Returns the name of this debug target. Name format is debug model specific, and should be specified by a debug model.- Returns:
- this target's name
- Throws:
DebugException- if this method fails. Reasons include:- Failure communicating with the debug target. The DebugException's status code contains the underlying exception responsible for the failure.
-
supportsBreakpoint
boolean supportsBreakpoint(IBreakpoint breakpoint)
Returns whether this target can install the given breakpoint.- Parameters:
breakpoint- breakpoint to consider- Returns:
- whether this target can install the given breakpoint
-
-