org.eclipse.ptp.debug.core.pdi
Interface IPDIDebugger

All Superinterfaces:

IPDIBreakpointManagement, IPDIExecuteManagement, IPDIMemoryBlockManagement, IPDISignalManagement, IPDIStackframeManagement, IPDIThreadManagement, IPDIVariableManagement

public interface IPDIDebugger
extends IPDIBreakpointManagement, IPDIExecuteManagement, IPDIVariableManagement, IPDISignalManagement, IPDIStackframeManagement, IPDIThreadManagement, IPDIMemoryBlockManagement

Represents a number of methods to communication to a debugger

Method Summary

void	addEventManager(IPDIEventManager eventManager) Adds event manager to the debugger.
void	commandRequest(TaskSet tasks, String command) Requests a special command for specify process
int	getErrorAction(int errorCode) Returns an action when error occurred
void	initialize(ILaunchConfiguration configuration, List<String> args, IProgressMonitor monitor) Initialize the debugger.
boolean	isConnected(IProgressMonitor monitor) Connects debugger and adds observer to debugger
void	removeEventManager(IPDIEventManager eventManager) Removes event manager from debugger
void	startDebugger(String app, String path, String dir, String[] args) Starts debugger
void	stopDebugger() Stops debugger

Methods inherited from interface org.eclipse.ptp.debug.core.pdi.IPDIBreakpointManagement

deleteBreakpoint, setAddressBreakpoint, setConditionBreakpoint, setEnabledBreakpoint, setExceptionpoint, setFunctionBreakpoint, setLineBreakpoint, setWatchpoint

Methods inherited from interface org.eclipse.ptp.debug.core.pdi.IPDIExecuteManagement

restart, resume, resume, resume, start, stepInto, stepIntoInstruction, stepOver, stepOverInstruction, stepReturn, stepReturn, stepUntil, suspend, terminate

Methods inherited from interface org.eclipse.ptp.debug.core.pdi.IPDIVariableManagement

deletePartialExpression, evaluateExpression, evaluatePartialExpression, listArguments, listGlobalVariables, listLocalVariables, retrieveVariableType

Methods inherited from interface org.eclipse.ptp.debug.core.pdi.IPDISignalManagement

listSignals

Methods inherited from interface org.eclipse.ptp.debug.core.pdi.IPDIStackframeManagement

listStackFrames, setCurrentStackFrame

Methods inherited from interface org.eclipse.ptp.debug.core.pdi.IPDIThreadManagement

listInfoThreads, retrieveStackInfoDepth, selectThread

Methods inherited from interface org.eclipse.ptp.debug.core.pdi.IPDIMemoryBlockManagement

createDataReadMemory, createDataWriteMemory

Method Detail

addEventManager

void addEventManager(IPDIEventManager eventManager)
                     throws PDIException

Adds event manager to the debugger. Debuggers can use the event manager to pass events to upper layers.

Parameters:

eventManager - event manager to add

Throws:

PDIException - on failure

Since:

5.0

commandRequest

void commandRequest(TaskSet tasks,
                    String command)
                    throws PDIException

Requests a special command for specify process

Parameters:

tasks - target process

command - command

Throws:

PDIException - on failure

Since:

4.0

getErrorAction

int getErrorAction(int errorCode)

Returns an action when error occurred

Parameters:

errorCode - error code

Returns:

an action when error occurred

initialize

void initialize(ILaunchConfiguration configuration,
                List<String> args,
                IProgressMonitor monitor)
                throws PDIException

Initialize the debugger. If args is an empty list, attempt to initialize the debugger and add any necessary arguments to the list. If args is not empty, then attempt to initialize the debugger using the supplied arguments.

Parameters:

configuration - debugger launch configuration

args - debugger arguments

monitor - progress monitor

Throws:

PDIException

isConnected

boolean isConnected(IProgressMonitor monitor)
                    throws PDIException

Connects debugger and adds observer to debugger

Parameters:

monitor -

Returns:

true if connection is established

Throws:

PDIException - on failure

removeEventManager

void removeEventManager(IPDIEventManager eventManager)
                        throws PDIException

Removes event manager from debugger

Parameters:

eventManager - event manager to remove

Throws:

PDIException - on failure

Since:

5.0

startDebugger

void startDebugger(String app,
                   String path,
                   String dir,
                   String[] args)
                   throws PDIException

Starts debugger

Throws:

PDIException - on failure

stopDebugger

void stopDebugger()
                  throws PDIException

Stops debugger

Throws:

PDIException - on failure