Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDarin Wright2008-02-20 14:40:11 +0000
committerDarin Wright2008-02-20 14:40:11 +0000
commit48bf2c9db202d7b73be3f6e593848b2861bd1a7a (patch)
tree84a40b28cdb087a0e7945ea78499b7b881dd5d10 /org.eclipse.debug.examples.core/pdavm
parent07a000314a26ac8a327fcfe07f4ae13d72a13a6b (diff)
downloadeclipse.platform.debug-48bf2c9db202d7b73be3f6e593848b2861bd1a7a.tar.gz
eclipse.platform.debug-48bf2c9db202d7b73be3f6e593848b2861bd1a7a.tar.xz
eclipse.platform.debug-48bf2c9db202d7b73be3f6e593848b2861bd1a7a.zip
Bug 217369 - PDA debugger protocol reference
Diffstat (limited to 'org.eclipse.debug.examples.core/pdavm')
-rw-r--r--org.eclipse.debug.examples.core/pdavm/docs/protocol.html198
1 files changed, 198 insertions, 0 deletions
diff --git a/org.eclipse.debug.examples.core/pdavm/docs/protocol.html b/org.eclipse.debug.examples.core/pdavm/docs/protocol.html
new file mode 100644
index 000000000..8717a8dbf
--- /dev/null
+++ b/org.eclipse.debug.examples.core/pdavm/docs/protocol.html
@@ -0,0 +1,198 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta content="text/html; charset=ISO-8859-1"
+ http-equiv="content-type">
+ <title>PDA Debugger Protocol Reference</title>
+</head>
+<body>
+
+<h2>PDA Debugger Protocol Reference</h2>
+
+<h3>clear</h3>
+Clears any breakpoint set on given line
+<pre>
+ C: clear {line}
+ R: ok
+</pre>
+
+
+<h3>data</h3>
+Retrieves data stack information
+<pre>
+ C: data
+ R: {value 1}|{value 2}|{value 3}|...|
+</pre>
+
+
+<h3>drop</h3>
+Returns from the current frame without executing the rest of instructions.
+
+<pre>
+ C: drop
+ R: ok
+ E: resumed drop
+ E: suspended drop
+</pre>
+
+
+<h3>eval</h3>
+Sets what events cause the execution to stop.
+
+<pre>
+ C: eval {instruction}%20{parameter}|{instruction}%20{parameter}|...
+ R: ok
+ E: resume client
+ E: evalresult result
+ E: suspended eval
+</pre>
+
+
+<h3>eventstop</h3>
+Sets what events cause the execution to stop.
+
+<pre>
+ C: eventstop {event_name} {0|1}
+ R: ok
+ ...
+ E: suspended event {event_name}
+</pre>
+
+
+<h3>exit</h3>
+Instructs the debugger to exit.
+
+<pre>
+ C: exit
+ R: ok
+</pre>
+
+
+<h3>popdata</h3>
+Pops the top value from the data stack
+
+<pre>
+ C: popdata
+ R: ok
+</pre>
+
+
+<h3>pushdata</h3>
+Pushes the given value on top of the data stack.
+
+<pre>
+ C: pushdata {value}
+ R: ok
+</pre>
+
+
+<h3>resume</h3>
+Resumes the execution
+
+<pre>
+ C: resume
+ R: ok
+ E: resumed client
+</pre>
+
+
+<h3>set</h3>
+Sets a breakpoint at given line
+
+<pre>
+ C: set {line_number}
+ R: ok
+ C: resume
+ E: resumed client
+ E: suspended breakpoint line_number
+</pre>
+
+
+<h3>setdata</h3>
+Sets a data value in the data stack at the given location
+
+<pre>
+ C: setdata {index} {value}
+ R: ok
+</pre>
+
+
+<h3>setvar</h3>
+Sets a variable value
+
+<pre>
+ C: setvar {variable} {value}
+ R: ok
+</pre>
+
+
+<h3>stack</h3>
+Retrieves command stack information
+
+<pre>
+ C: stack
+ R: {file}|{line}|{function}|{var_1}|{var_2}|...{file}|{line}|{function}|{var_1}|{var_2}|......
+</pre>
+
+
+<h3>step</h3>
+Executes next instruction
+
+<pre>
+ C: step
+ R: ok
+ E: resumed step
+ E: suspended step
+</pre>
+
+
+<h3>stepreturn</h3>
+Executes instructions until the current subroutine is finished
+
+<pre>
+ C: stepreturn
+ R: ok
+ E: resumed step
+ E: suspended step
+</pre>
+
+
+<h3>suspend</h3>
+Suspends execution
+
+<pre>
+ C: suspend
+ R: ok
+ E: suspended client
+</pre>
+
+
+<h3>var</h3>
+Retrieves variable value
+
+<pre>
+ C: var {frame_number} {variable_name}
+ R: {variable_value}
+</pre>
+
+
+<h3>watch</h3>
+Sets a watchpoint on a given variable
+
+<pre>
+ C: watch {function}::{variable_name} {watch_operation}
+ R: ok
+ C: resume
+ R: resumed client
+ E: suspended watch {watch_operation} {function}::{variable_name}
+</pre>
+
+The <code>watch_operation<code> value can be:
+<ul>
+ <li>0 - no watch</li>
+ <li>1 - read watch</li>
+ <li>2 - write watch</li>
+ <li>3 - both, etc.</li>
+</ul>
+</body>
+</html>

Back to the top