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.

See Also:

• ITerminate
• ISuspendResume
• IBreakpointListener
• IDisconnect
• IMemoryBlockRetrieval
• ILaunch

Method Summary

Modifier and Type	Method	Description
String	getName()	Returns the name of this debug target.
IProcess	getProcess()	Returns the system process associated with this debug target.
IThread[]	getThreads()	Returns the threads contained in this debug target.
boolean	hasThreads()	Returns whether this debug target currently contains any threads.
boolean	supportsBreakpoint(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 Details

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 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

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