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

All Known Subinterfaces:

IPDIDebugger, IPDISession

All Known Implementing Classes:

Session

public interface IPDIExecuteManagement

Provides the ability to resume a thread. Provides the ability to step into, over, and until from the current execution location. Implementations must be non-blocking. Provides the ability to step return from the frame. Implementations must be non-blocking.

Method Summary

void	restart(TaskSet tasks) TODO not implemented yet in 2.0 Requests to restart of debugging
void	resume(TaskSet tasks, boolean passSignal) Causes this target to resume its execution. if passSignal is false and the target was suspended by a signal when resuming the signal will be discarded Has no effect on a target that is not suspended.
void	resume(TaskSet tasks, IPDILocation location) Resume execution at location.
void	resume(TaskSet tasks, IPDISignal signal) Resume execution where the program stopped but immediately give the signal.
void	start(TaskSet tasks) Starts specify process
void	stepInto(TaskSet tasks, int count) Steps into the current source line.
void	stepIntoInstruction(TaskSet tasks, int count) Steps into the current machine instruction.
void	stepOver(TaskSet tasks, int count) Steps over the current source line. if count <= 0 it is a loop.
void	stepOverInstruction(TaskSet tasks, int count) Steps over the current machine instruction.
void	stepReturn(TaskSet tasks, IAIF aif) Cancel execution of the frame and return with value. value can be null, if no return value is needed.
void	stepReturn(TaskSet tasks, int count) Continue execution until the frame return.
void	stepUntil(TaskSet tasks, IPDILocation location) Continues running until location is reached.
void	suspend(TaskSet tasks) Causes this target/thread to suspend its execution.
void	terminate(TaskSet tasks) Requests to terminate of specify process

Method Detail

resume

void resume(TaskSet tasks,
            boolean passSignal)
            throws PDIException

Causes this target to resume its execution. if passSignal is false and the target was suspended by a signal when resuming the signal will be discarded Has no effect on a target that is not suspended.

Parameters:

tasks - target process

passSignal - whether to discard the signal

Throws:

PDIException - on failure

Since:

4.0

resume

void resume(TaskSet tasks,
            IPDILocation location)
            throws PDIException

Resume execution at location. Note the method does not change stackframe. The result is undefined if it jumps outside of the stackframe. Can only be called when the associated target is suspended.

Parameters:

tasks - target process

location -

Throws:

PDIException - on failure

Since:

4.0

resume

void resume(TaskSet tasks,
            IPDISignal signal)
            throws PDIException

Resume execution where the program stopped but immediately give the signal.

Parameters:

tasks - target process

signal -

Throws:

PDIException - on failure

Since:

4.0

stepOver

void stepOver(TaskSet tasks,
              int count)
              throws PDIException

Steps over the current source line. if count <= 0 it is a loop. Can only be called when the associated target/thread is suspended.

Parameters:

tasks - target process

count - as in `step', but do so count times.

Throws:

PDIException - on failure

Since:

4.0

stepOverInstruction

void stepOverInstruction(TaskSet tasks,
                         int count)
                         throws PDIException

Steps over the current machine instruction. Can only be called when the associated target/thread is suspended. if count <= 0 it is a loop.

Parameters:

tasks - target process

count - as in `stepOverInstruction', but do so count times.

Throws:

PDIException - on failure

Since:

4.0

stepInto

void stepInto(TaskSet tasks,
              int count)
              throws PDIException

Steps into the current source line. Can only be called when the associated target/thread is suspended. if count <= 0 it is a loop.

Parameters:

tasks - target process

count - as in `step', but do so count times.

Throws:

PDIException - on failure

Since:

4.0

stepIntoInstruction

void stepIntoInstruction(TaskSet tasks,
                         int count)
                         throws PDIException

Steps into the current machine instruction. Can only be called when the associated target/thread is suspended. if count <= 0 it is a loop.

Parameters:

tasks - target process

Throws:

PDIException - on failure

Since:

4.0

stepUntil

void stepUntil(TaskSet tasks,
               IPDILocation location)
               throws PDIException

Continues running until location is reached. If the program will be suspended if attempt to exit the current frame. Can only be called when the associated target is suspended.

Parameters:

tasks - target process

location - location

Throws:

PDIException - on failure

Since:

4.0

stepReturn

void stepReturn(TaskSet tasks,
                int count)
                throws PDIException

Continue execution until the frame return.

Parameters:

count - as in `step', but do so count times.

tasks - target process

Throws:

PDIException - on failure

Since:

4.0

stepReturn

void stepReturn(TaskSet tasks,
                IAIF aif)
                throws PDIException

Cancel execution of the frame and return with value. value can be null, if no return value is needed. Can only be called when the associated target/thread is suspended.

Parameters:

tasks - target process

aif - value use as the returning value.

Throws:

PDIException - on failure

Since:

4.0

suspend

void suspend(TaskSet tasks)
             throws PDIException

Causes this target/thread to suspend its execution. Has no effect on an already suspended thread.

Parameters:

tasks - target process

Throws:

PDIException - on failure

Since:

4.0

terminate

void terminate(TaskSet tasks)
               throws PDIException

Requests to terminate of specify process

Parameters:

tasks - target process

Throws:

PDIException - on failure

Since:

4.0

restart

void restart(TaskSet tasks)
             throws PDIException

TODO not implemented yet in 2.0 Requests to restart of debugging

Parameters:

tasks -

Throws:

PDIException - on failure

Since:

4.0

start

void start(TaskSet tasks)
           throws PDIException

Starts specify process

Parameters:

tasks - target process

Throws:

PDIException - on failure

Since:

4.0