Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoreutarass2008-05-06 22:19:25 -0400
committereutarass2008-05-06 22:19:25 -0400
commit951ab0329d5312806a36ea3af8ec9e9c38bfd31d (patch)
tree02ae7546d9d835202e24130baee27145035cb2c3 /docs/TCF Service - Run Control.html
parente5e16c779f59865ec66ae225d5e54714535c08c3 (diff)
downloadorg.eclipse.tcf-951ab0329d5312806a36ea3af8ec9e9c38bfd31d.tar.gz
org.eclipse.tcf-951ab0329d5312806a36ea3af8ec9e9c38bfd31d.tar.xz
org.eclipse.tcf-951ab0329d5312806a36ea3af8ec9e9c38bfd31d.zip
Bug 230274: [tcf][api] Run Control Service. Reverse resume modes
Diffstat (limited to 'docs/TCF Service - Run Control.html')
-rw-r--r--docs/TCF Service - Run Control.html50
1 files changed, 38 insertions, 12 deletions
diff --git a/docs/TCF Service - Run Control.html b/docs/TCF Service - Run Control.html
index dc17b079b..fd5adccd5 100644
--- a/docs/TCF Service - Run Control.html
+++ b/docs/TCF Service - Run Control.html
@@ -97,11 +97,11 @@ contextChanged event to notify changes in context data.</p>
Only context that has a state can be resumed or suspended.
<li><code><b><font face="Courier New" size=2 color=#333399>"CanSuspend" : <i>&lt;boolean&gt;</i></font></b></code>
- - true if Suspend command is supported for this contex. It does not mean that the command can be executed successfully in
+ - true if Suspend command is supported for this context. It does not mean that the command can be executed successfully in
the current state of the context. For example, the command still can fail if context is already suspended.
<li><code><b><font face="Courier New" size=2 color=#333399>"CanResume" : <i>&lt;int: bitset of resume modes&gt;</i></font></b></code>
- - for each resume mode, corresponding bit is '1' if Resume command mode is supported for this contex, and '0' otherwise.
+ - for each resume mode, corresponding bit is '1' if Resume command mode is supported for this context, and '0' otherwise.
It does not mean that the command can be executed successfully in
the current state of the context. For example, the command still can fail if context is already resumed.
@@ -167,10 +167,10 @@ to context's children. Only contexts with HasState = true can be resumed.</p>
<p>Resume modes:</p>
<ul>
- <li><code>RM_RESUME = 0</code> - rusume normal execution. Execution will
+ <li><code>RM_RESUME = 0</code> - resume normal execution. Execution will
continue until suspended by command or breakpoint.
- <li><code>RM_STEP_OVER = 1</code> - step over single instruction. If instruction
+ <li><code>RM_STEP_OVER = 1</code> - step over a single instruction. If instruction
is function call, execution continues until control returns from the function.
<li><code>RM_STEP_INTO = 2</code> - single instruction in given context.
@@ -186,6 +186,26 @@ to context's children. Only contexts with HasState = true can be resumed.</p>
<li><code>RM_STEP_OUT = 5</code> - resume execution of given context until control returns from current
function.
+
+ <li><code>RM_REVERSE_RESUME = 6</code> - reverse of <code>RM_RESUME</code>; resume backward execution. Execution will
+ continue until suspended by command or breakpoint.
+
+ <li><code>RM_REVERSE_STEP_OVER = 7</code> - reverse of <code>RM_STEP_OVER</code>; reverse step over a single instruction.
+ This effectively "un-executes" the previous instruction.
+
+ <li><code>RM_REVERSE_STEP_INTO = 8</code> - reverse of <code>RM_STEP_INTO</code>; reverse step into a single instruction in the given context.
+
+ <li><code>RM_REVERSE_STEP_OVER_LINE = 9</code> - reverse of <code>RM_STEP_OVER_LINE</code>; resume backward execution
+ of given context until control reaches the beginning of the code block corresponding to a different source line.
+ Error is returned if line number information not available.
+
+ <li><code>RM_REVERSE_STEP_INTO_LINE = 10</code> - reverse of <code>RM_STEP_INTO_LINE</code>; resume backward execution of given context
+ until control reaches an instruction that belongs to a different line of source code.
+ If a function is called, stop at the beginning of the last line of the function code.
+ Error is returned if line number information not available.
+
+ <li><code>RM_REVERSE_STEP_OUT = 11</code> - reverse of <code>RM_STEP_OUT</code>; resume backward execution of
+ the given context until control reaches the point where the function was called.
</ul>
<p>Result message:</p>
@@ -229,7 +249,7 @@ a generic client might be able to handle it better. Predefined reasons are:</p>
</ul>
<p>Context state properties can contain any data relevant to context state.
-Defenition of state properties depends on a target.</p>
+Definition of state properties depends on a target.</p>
<h3><a name='CmdTerminate'>Terminate</a></h3>
@@ -284,7 +304,7 @@ E RunControl containerResumed <i>&lt;array of context IDs&gt;</i>
<dd>is sent when context properties change. The message contains
array of changed (new) context data. Context data is same as returned by Get Context command.
<dt><b>contextRemoved</b>
- <dd>is sent when context is removed - terminated or dettached. The message contains
+ <dd>is sent when context is removed - terminated or detached. The message contains
array of context IDs.
<dt><b>contextSuspended</b>
<dd>is sent when context is suspended. The message context ID contains context state data,
@@ -308,10 +328,10 @@ E RunControl containerResumed <i>&lt;array of context IDs&gt;</i>
</dl>
<h2><a name='API'>API</a></h2>
-
+
<pre>
<font color=#7F0055>public interface</font> IRunControl <font color=#7F0055>extends</font> IService {
-
+
<font color=#3F5FBF>/**
* Context property names.
*/</font>
@@ -324,7 +344,7 @@ E RunControl containerResumed <i>&lt;array of context IDs&gt;</i>
PROP_CAN_COUNT = "CanCount",
PROP_CAN_SUSPEND = "CanSuspend",
PROP_CAN_TERMINATE = "CanTerminate";
-
+
<font color=#3F5FBF>/**
* Context resume modes.
*/</font>
@@ -334,8 +354,14 @@ E RunControl containerResumed <i>&lt;array of context IDs&gt;</i>
RM_STEP_INTO = 2,
RM_STEP_OVER_LINE = 3,
RM_STEP_INTO_LINE = 4,
- RM_STEP_OUT = 5;
-
+ RM_STEP_OUT = 5,
+ RM_REVERSE_RESUME = 6,
+ RM_REVERSE_STEP_OVER = 7,
+ RM_REVERSE_STEP_INTO = 8,
+ RM_REVERSE_STEP_OVER_LINE = 9,
+ RM_REVERSE_STEP_INTO_LINE = 10,
+ RM_REVERSE_STEP_OUT = 11;
+
<font color=#3F5FBF>/**
* State change reason of a context.
* Reason can be any text, but if it is one of predefined strings,
@@ -561,7 +587,7 @@ E RunControl containerResumed <i>&lt;array of context IDs&gt;</i>
<font color=#3F5FBF>/**
* Called when contexts are removed.
- * <font color=#7F9FBF>@param</font> context_ids - aray of removed context IDs.
+ * <font color=#7F9FBF>@param</font> context_ids - array of removed context IDs.
*/</font>
<font color=#7F0055>void</font> contextRemoved(String context_ids[]);

Back to the top