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.
- See Also:
ITerminate
,
ISuspendResume
,
IBreakpointListener
,
IDisconnect
,
IMemoryBlockRetrieval
,
ILaunch
getProcess
public IProcess getProcess()
- Returns the system process associated with this debug target.
- Returns:
- the system process associated with this debug target
getThreads
public 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
public boolean hasThreads()
throws DebugException
- Returns 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
public 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
public boolean supportsBreakpoint(IBreakpoint breakpoint)
- Returns whether this target can install the given breakpoint.
- Returns:
- whether this target can install the given breakpoint
Copyright (c) IBM Corp. and others 2000, 2003. All Rights Reserved.