Skip to main content
aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authoreutarass2009-06-22 14:39:13 -0400
committereutarass2009-06-22 14:39:13 -0400
commit7de25119ffc78001f4d43a95b789a4323e962dab (patch)
tree793fbf88ac43eb9698df7fb3ab54da2b67a3b9c2 /docs
parent2d0a5fe3ef479bcd3e63b25894cabcb6131ad55a (diff)
downloadorg.eclipse.tcf-7de25119ffc78001f4d43a95b789a4323e962dab.tar.gz
org.eclipse.tcf-7de25119ffc78001f4d43a95b789a4323e962dab.tar.xz
org.eclipse.tcf-7de25119ffc78001f4d43a95b789a4323e962dab.zip
Bug 235251: [tcf][api] runcontrol support for complex resume modes
Diffstat (limited to 'docs')
-rw-r--r--docs/TCF Getting Started.html6
-rw-r--r--docs/TCF Service - Run Control.html126
2 files changed, 88 insertions, 44 deletions
diff --git a/docs/TCF Getting Started.html b/docs/TCF Getting Started.html
index 2a7f01865..524540fbf 100644
--- a/docs/TCF Getting Started.html
+++ b/docs/TCF Getting Started.html
@@ -29,15 +29,15 @@ below are steps to create and populate Eclipse workspace with TCF projects:</p>
<ul>
<li>Install JDK 1.5.0 or later, recommended 1.6.0
- <li>Install <b>Eclipse Classic SDK 3.4</b>, last tested with 3.4.0, recommended 3.4.0<br>
+ <li>Install <b>Eclipse Classic SDK 3.4</b>, last tested with 3.4.2, recommended 3.4.2<br>
<a href='http://download.eclipse.org/eclipse/downloads/'>http://download.eclipse.org/eclipse/downloads/</a>
- <li>Install <b>TM RSE SDK 3.0</b> or later, last tested with 3.0.0, recommended 3.0.0<br>
+ <li>Install <b>TM RSE SDK 3.0</b> or later, last tested with 3.0.3, recommended 3.0.3<br>
<a href='http://download.eclipse.org/dsdp/tm/downloads/'>http://download.eclipse.org/dsdp/tm/downloads/</a>
<li><b>Optional</b> dependencies for TCF/DSF/CDT integration: these are not required by
TCF itself, and not needed for RSE integration or for TCF based debugger demo,
use these for future development:
<ul>
- <li>CDT (Eclipse C/C++ Development Tools SDK) 5.0 or later, last tested with 5.0.0, recommended 5.0.0<br>
+ <li>CDT (Eclipse C/C++ Development Tools SDK) 5.0 or later, last tested with 5.0.2, recommended 5.0.2<br>
<a href='http://www.eclipse.org/cdt/downloads.php'>http://www.eclipse.org/cdt/downloads.php</a>
<li>DD (Device Debug) SDK 1.0.0<br>
<a href='http://download.eclipse.org/dsdp/dd/downloads/'>http://download.eclipse.org/dsdp/dd/downloads/</a>
diff --git a/docs/TCF Service - Run Control.html b/docs/TCF Service - Run Control.html
index 55583a8c6..d6dd9b57d 100644
--- a/docs/TCF Service - Run Control.html
+++ b/docs/TCF Service - Run Control.html
@@ -159,54 +159,98 @@ R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
<pre><b><font face="Courier New" size=2 color=#333399>
C &bull; <i>&lt;token&gt;</i> &bull; RunControl &bull; resume &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: mode&gt;</i> &bull; <i>&lt;int: count&gt;</i> &bull;
+C &bull; <i>&lt;token&gt;</i> &bull; RunControl &bull; resume &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: mode&gt;</i> &bull; <i>&lt;int: count&gt;</i> &bull; <i>&lt;object: parameters&gt;</i> &bull;
</font></b></pre>
<p>The command resumes execution of given context. The command should fail if CanResume
property of the context is '0' for given mode. If context's IsContainer = true, the command is propagated
to context's children. Only contexts with HasState = true can be resumed.</p>
+<p>The command can have optional argument that contains set of resume parameters, for example stepping range definition.</p>
<p>Resume modes:</p>
-<ul>
- <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 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.
-
- <li><code>RM_STEP_OVER_LINE = 3</code> - resume execution of given context until control reaches instruction
- that belongs to a different line of source code, but runs any functions called at
- full speed. Error is returned if line number information not available.
-
- <li><code>RM_STEP_INTO_LINE = 4</code> - resumes execution of given context until control reaches instruction
- that belongs to a different line of source code. If a function is called,
- stop at first line of the function code. Error is returned if line number
- information not available.
-
- <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>
+ <ul>
+ <li>
+ <code>RM_RESUME = 0</code> - resume normal execution. Execution will
+ continue until suspended by command or breakpoint.
+ </li>
+
+ <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>
+
+ <li>
+ <code>RM_STEP_INTO = 2</code> - single instruction in given context.
+ </li>
+
+ <li>
+ <code>RM_STEP_OVER_LINE = 3</code> - resume execution of given context until control reaches instruction
+ that belongs to a different line of source code, but runs any functions called at
+ full speed. Error is returned if line number information not available.
+ </li>
+
+ <li>
+ <code>RM_STEP_INTO_LINE = 4</code> - resumes execution of given context until control reaches instruction
+ that belongs to a different line of source code. If a function is called,
+ stop at first line of the function code. Error is returned if line number
+ information not available.
+ </li>
+
+ <li>
+ <code>RM_STEP_OUT = 5</code> - resume execution of given context until control returns from current
+ function.
+ </li>
+
+ <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>
+
+ <li>
+ <code>RM_REVERSE_STEP_OVER = 7</code> - reverse of <code>RM_STEP_OVER</code>; reverse step over a single instruction.
+ </li>
+
+ <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.
+ This effectively "un-executes" the previous instruction.
+ </li>
+
+ <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 an instruction that belongs to a different source line.
+ If the line contains a function call then don't stop until get out of the function.
+ Error is returned if line number information not available.
+ </li>
+
+ <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>
+
+ <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 current function was called.
+ </li>
+
+ <li>
+ <code>RM_STEP_OVER_RANGE = 12</code> - step over instructions until PC is outside the specified range.
+ If any function call within the range is considered to be in range.
+ </li>
+
+ <li>
+ <code>RM_STEP_INTO_RANGE = 13</code> - step instruction until PC is outside the specified range for any reason.
+ </li>
+
+ <li>
+ <code>RM_REVERSE_STEP_OVER_RANGE = 14</code> - reverse of <code>RM_STEP_OVER_RANGE</code>.
+ </li>
+
+ <li>
+ <code>RM_REVERSE_STEP_INTO_RANGE = 15</code> - reverse of <code>RM_STEP_INTO_RANGE</code>.
+ </li>
+ </ul>
<p>Result message:</p>

Back to the top