Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorfburton2008-05-09 21:35:19 -0400
committerfburton2008-05-09 21:35:19 -0400
commite5d17e159a17f6958055e0481c461fd662a7b71c (patch)
tree13c998255235b5d4348534421912b8b1f5061395
parent3e13131ea2c6e6a4a21ca4cef9e2f1720146c435 (diff)
downloadorg.eclipse.tcf-e5d17e159a17f6958055e0481c461fd662a7b71c.tar.gz
org.eclipse.tcf-e5d17e159a17f6958055e0481c461fd662a7b71c.tar.xz
org.eclipse.tcf-e5d17e159a17f6958055e0481c461fd662a7b71c.zip
Replaced non-ASCII characters with named HTML character entities
-rw-r--r--docs/TCF Service - Breakpoints.html88
-rw-r--r--docs/TCF Service - File System.html106
-rw-r--r--docs/TCF Service - Memory.html370
-rw-r--r--docs/TCF Service - Processes.html74
-rw-r--r--docs/TCF Service - Registers.html70
-rw-r--r--docs/TCF Service - Run Control.html120
-rw-r--r--docs/TCF Service - Stack Trace.html54
-rw-r--r--docs/TCF Service - System Monitor.html90
-rw-r--r--docs/TCF Services.html18
-rw-r--r--docs/TCF Specification.html960
10 files changed, 975 insertions, 975 deletions
diff --git a/docs/TCF Service - Breakpoints.html b/docs/TCF Service - Breakpoints.html
index 14a2656f4..e4c868757 100644
--- a/docs/TCF Service - Breakpoints.html
+++ b/docs/TCF Service - Breakpoints.html
@@ -101,19 +101,19 @@ see <a href='TCF Services.html#ErrorFormat'>Error Report Format</a>.</p>
<h3><a name='CmdSet'>Set</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • set • <i>&lt;array of breakpoints&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; set &bull; <i>&lt;array of breakpoints&gt;</i> &bull;
<i>&lt;array of breakpoints&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;breakpoints list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;breakpoints list&gt;</i> ]
<i>&lt;breakpoints list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;breakpoint data&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;breakpoints list&gt;</i>, <i>&lt;breakpoint data&gt;</i>
+ &rArr; <i>&lt;breakpoint data&gt;</i>
+ &rArr; <i>&lt;breakpoints list&gt;</i>, <i>&lt;breakpoint data&gt;</i>
<i>&lt;breakpoint data&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p> The command downloads breakpoint data to a target agent.
@@ -223,7 +223,7 @@ A breakpoint service implementation may not change the properties set by the cli
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<p><b>Examples:</b></p>
@@ -274,7 +274,7 @@ The following properties set a temporal breakpoint that stops <code>core0</code>
<h3><a name='CmdAdd'>Add</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • add • <i>&lt;breakpoint data&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; add &bull; <i>&lt;breakpoint data&gt;</i> &bull;
</font></b></pre>
<p>The command adds a breakpoint to the target agent breakpoint table. The host should send this command when the user creates a new breakpoint</p>
@@ -282,13 +282,13 @@ C • <i>&lt;token&gt;</i> • Breakpoints • add • <i>&lt;breakpoint data&gt;</i> •
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdChange'>Change</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • change • <i>&lt;breakpoint data&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; change &bull; <i>&lt;breakpoint data&gt;</i> &bull;
</font></b></pre>
<p>The command updates the breakpoint data in the target agent breakpoint table. The host should send this command when the user modifies a breakpoint</p>
@@ -296,25 +296,25 @@ C • <i>&lt;token&gt;</i> • Breakpoints • change • <i>&lt;breakpoint data&gt;</i>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdEnable'>Enable</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • enable • <i>&lt;array of breakpoint IDs&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; enable &bull; <i>&lt;array of breakpoint IDs&gt;</i> &bull;
<i>&lt;array of breakpoint IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;breakpoint IDs list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;breakpoint IDs list&gt;</i> ]
<i>&lt;breakpoint IDs list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;breakpoint ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;breakpoint IDs list&gt;</i>, <i>&lt;breakpoint ID&gt;</i>
+ &rArr; <i>&lt;breakpoint ID&gt;</i>
+ &rArr; <i>&lt;breakpoint IDs list&gt;</i>, <i>&lt;breakpoint ID&gt;</i>
<i>&lt;breakpoint ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string&gt;</i>
+ &rArr; <i>&lt;string&gt;</i>
</font></b></pre>
<p>The command enables a list of breakpoints - sets breakpoint property "Enabled" to true.</p>
@@ -322,13 +322,13 @@ C • <i>&lt;token&gt;</i> • Breakpoints • enable • <i>&lt;array of breakpoint IDs
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdDisable'>Disable</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • disable • <i>&lt;array of breakpoint IDs&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; disable &bull; <i>&lt;array of breakpoint IDs&gt;</i> &bull;
</font></b></pre>
<p>The command disables a list of breakpoints - sets breakpoint property "Enabled" to false.</p>
@@ -336,13 +336,13 @@ C • <i>&lt;token&gt;</i> • Breakpoints • disable • <i>&lt;array of breakpoint ID
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdRemove'>Remove</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • remove • <i>&lt;array of breakpoint IDs&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; remove &bull; <i>&lt;array of breakpoint IDs&gt;</i> &bull;
</font></b></pre>
<p>The command removes a list of breakpoints. Host should send this command when user deletes breakpoints.</p>
@@ -350,13 +350,13 @@ C • <i>&lt;token&gt;</i> • Breakpoints • remove • <i>&lt;array of breakpoint IDs
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdGetIDs'>Get IDs</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • getIDs •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; getIDs &bull;
</font></b></pre>
<p>The command uploads IDs of breakpoints known to target agent,
@@ -368,13 +368,13 @@ channels.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of breakpoint IDs&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of breakpoint IDs&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdGetProperties'>Get Properties</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • getProperties • <i>&lt;string: breakpoint ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; getProperties &bull; <i>&lt;string: breakpoint ID&gt;</i> &bull;
</font></b></pre>
<p>The command uploads the properties of the given breakpoint from the target agent breakpoint table.</p>
@@ -382,13 +382,13 @@ C • <i>&lt;token&gt;</i> • Breakpoints • getProperties • <i>&lt;string: breakpoi
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;breakpoint data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;breakpoint data&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdGetStatus'>Get Status</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • getStatus • <i>&lt;string: breakpoint ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; getStatus &bull; <i>&lt;string: breakpoint ID&gt;</i> &bull;
</font></b></pre>
<p>The command uploads the status of given the breakpoint from the target agent.</p>
@@ -396,10 +396,10 @@ C • <i>&lt;token&gt;</i> • Breakpoints • getStatus • <i>&lt;string: breakpoint I
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;breakpoint status&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;breakpoint status&gt;</i> &bull;
<i>&lt;breakpoint status&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Breakpoint status consists of a list of status properties. All properties are optional.
@@ -424,16 +424,16 @@ in a list of instance status data objects
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;array of instance status data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;Instance status data list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;Instance status data list&gt;</i> ]
<i>&lt;Instance status data list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;Instance status data&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;Instance staus data list&gt;</i>, <i>&lt;Instance status data&gt;</i>
+ &rArr; <i>&lt;Instance status data&gt;</i>
+ &rArr; <i>&lt;Instance staus data list&gt;</i>, <i>&lt;Instance status data&gt;</i>
<i>&lt;Instance status data&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Instance status data consists of a list of properties pertaining to each installed instance of the breakpoint.
@@ -449,7 +449,7 @@ in a list of instance status data objects
<h3><a name='CmdGetCapabilities'>Get Capabilities</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Breakpoints • getCapabilities • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Breakpoints &bull; getCapabilities &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command reports breakpoint service capabilities to clients so they
@@ -462,10 +462,10 @@ capabilities.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;service capabilities&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;service capabilities&gt;</i> &bull;
<i>&lt;service capabilities&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Service capabilities consist of a list of properties. All properties are optional.
@@ -492,10 +492,10 @@ of breakpoint properties that was sent by a client to a target. The purpose of t
let all clients know about breakpoints that were created by other clients.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-E • Breakpoints • status • <i>&lt;string: breakpoint ID&gt;</i> • <i>&lt;breakpoint status&gt;</i> •
-E • Breakpoints • contextAdded • <i>&lt;array of breakpoints&gt;</i> •
-E • Breakpoints • contextChanged • <i>&lt;array of breakpoints&gt;</i> •
-E • Breakpoints • contextRemoved • <i>&lt;array of breakpoint IDs&gt;</i> •
+E &bull; Breakpoints &bull; status &bull; <i>&lt;string: breakpoint ID&gt;</i> &bull; <i>&lt;breakpoint status&gt;</i> &bull;
+E &bull; Breakpoints &bull; contextAdded &bull; <i>&lt;array of breakpoints&gt;</i> &bull;
+E &bull; Breakpoints &bull; contextChanged &bull; <i>&lt;array of breakpoints&gt;</i> &bull;
+E &bull; Breakpoints &bull; contextRemoved &bull; <i>&lt;array of breakpoint IDs&gt;</i> &bull;
</font></b></pre>
<dl>
diff --git a/docs/TCF Service - File System.html b/docs/TCF Service - File System.html
index 711b31fe4..dd10042bb 100644
--- a/docs/TCF Service - File System.html
+++ b/docs/TCF Service - File System.html
@@ -135,7 +135,7 @@ using a slash ('/') as the separator, and that will work as expected.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;file attributes&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>All attributes are optional.
@@ -212,7 +212,7 @@ defined by future versions of this protocol):</p>
<h3><a name='CmdOpen'>open</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • open • <i>&lt;string: file name&gt;</i> • <i>&lt;int: mode&gt;</i> • <i>&lt;file attributes&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; open &bull; <i>&lt;string: file name&gt;</i> &bull; <i>&lt;int: mode&gt;</i> &bull; <i>&lt;file attributes&gt;</i> &bull;
</font></b></pre>
<p>The command opens or creates a file on a remote system. If mode contains O_CREAT then new file is created, otherwise exsting
@@ -222,11 +222,11 @@ the command parameters, a default value is used.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;file handle&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;file handle&gt;</i> &bull;
<i>&lt;file handle&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;string&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;string&gt;</i>
</font></b></pre>
<p>On success, the replay contains open file handle. The handle is encoded as a string of characters. Client should never try
@@ -236,7 +236,7 @@ not needed any more. Server should close all files that were left open after cli
<h3><a name='CmdClose'>close</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • close • <i>&lt;string: file handle&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; close &bull; <i>&lt;string: file handle&gt;</i> &bull;
</font></b></pre>
<p>The command closes a handle, which was open by 'open' or 'opendir' commands.</p>
@@ -244,13 +244,13 @@ C • <i>&lt;token&gt;</i> • FileSystem • close • <i>&lt;string: file handle&gt;</
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdRead'>read</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • read • <i>&lt;string: file handle&gt;</i> • <i>&lt;int: offset&gt;</i> • <i>&lt;int: size&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; read &bull; <i>&lt;string: file handle&gt;</i> &bull; <i>&lt;int: offset&gt;</i> &bull; <i>&lt;int: size&gt;</i> &bull;
</font></b></pre>
<p>The command reads bytes from an open file.
@@ -266,7 +266,7 @@ or error. For e.g. device files this may return fewer bytes than requested.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;string: data&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;boolean: eof&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;string: data&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;boolean: eof&gt;</i> &bull;
</font></b></pre>
<p><i>&lt;string: data&gt;</i> is Base64 encoded byte array of file data. Number of bytes is determined by the string length.
@@ -275,7 +275,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;string: data&gt;</i> • <i>&lt;error report&gt;
<h3><a name='CmdWrite'>write</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • write • <i>&lt;string: file handle&gt;</i> • <i>&lt;int: offset&gt;</i> • <i>&lt;string: data&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; write &bull; <i>&lt;string: file handle&gt;</i> &bull; <i>&lt;int: offset&gt;</i> &bull; <i>&lt;string: data&gt;</i> &bull;
</font></b></pre>
<p>The command writes bytes into an open file.
@@ -287,13 +287,13 @@ and then the data. <i>&lt;string: data&gt;</i> is Base64 encoded array of data b
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdStat'>stat</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • stat • <i>&lt;string: file name&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; stat &bull; <i>&lt;string: file name&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves file attributes.</p>
@@ -301,13 +301,13 @@ C • <i>&lt;token&gt;</i> • FileSystem • stat • <i>&lt;string: file name&gt;</i>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;file attributes&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;file attributes&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdLStat'>lstat</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • lstat • <i>&lt;string: file name&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; lstat &bull; <i>&lt;string: file name&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves file attributes.
@@ -316,13 +316,13 @@ Unlike 'stat', 'lstat' does not follow symbolic links.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;file attributes&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;file attributes&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdFStat'>fstat</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • fstat • <i>&lt;string: file handle&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; fstat &bull; <i>&lt;string: file handle&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves file attributes for an open file (identified by the file handle).</p>
@@ -330,13 +330,13 @@ C • <i>&lt;token&gt;</i> • FileSystem • fstat • <i>&lt;string: file handle&gt;</
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;file attributes&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;file attributes&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdSetStat'>setstat</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • setstat • <i>&lt;string: file name&gt;</i> • <i>&lt;file attributes&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; setstat &bull; <i>&lt;string: file name&gt;</i> &bull; <i>&lt;file attributes&gt;</i> &bull;
</font></b></pre>
<p>The command sets file attributes.
@@ -349,13 +349,13 @@ specified attributes.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdFSetStat'>fsetstat</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • fsetstat • <i>&lt;string: file handle&gt;</i> • <i>&lt;file attributes&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; fsetstat &bull; <i>&lt;string: file handle&gt;</i> &bull; <i>&lt;file attributes&gt;</i> &bull;
</font></b></pre>
<p>The command sets file attributes for an open file (identified by the file handle).
@@ -365,13 +365,13 @@ permissions or access times, as well as for truncating a file.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdOpenDir'>opendir</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • opendir • <i>&lt;string: path&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; opendir &bull; <i>&lt;string: path&gt;</i> &bull;
</font></b></pre>
<p>The command opens a directory for reading.
@@ -384,13 +384,13 @@ should be closed regardless of whether a read errors have occurred or not.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;file handle&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;file handle&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdReadDir'>readdir</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • readdir • <i>&lt;string: file handle&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; readdir &bull; <i>&lt;string: file handle&gt;</i> &bull;
</font></b></pre>
<p>The command returns one
@@ -405,19 +405,19 @@ response.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;array of directory entries&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;boolean: eof&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;array of directory entries&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;boolean: eof&gt;</i> &bull;
<i>&lt;array of directory entries&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;directory entry list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;directory entry list&gt;</i> ]
<i>&lt;directory entry list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;directory entry&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&ltdirectory entry list&gt;</i> , <i>&lt;directory entry&gt;</i>
+ &rArr; <i>&lt;directory entry&gt;</i>
+ &rArr; <i>&ltdirectory entry list&gt;</i> , <i>&lt;directory entry&gt;</i>
<i>&lt;directory entry&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Directory entry attributes are:</p>
@@ -435,7 +435,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;array of directory entries&gt;</i> • <i>&lt;er
<h3><a name='CmdMkDir'>mkdir</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • mkdir • <i>&lt;string: directory path&gt;</i> • <i>&lt;file attributes&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; mkdir &bull; <i>&lt;string: directory path&gt;</i> &bull; <i>&lt;file attributes&gt;</i> &bull;
</font></b></pre>
<p>The command creates a directory on the server.
@@ -445,13 +445,13 @@ C • <i>&lt;token&gt;</i> • FileSystem • mkdir • <i>&lt;string: directory path&gt
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdRmDir'>rmdir</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • rmdir • <i>&lt;string: directory path&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; rmdir &bull; <i>&lt;string: directory path&gt;</i> &bull;
</font></b></pre>
<p>The command removes a directory.
@@ -463,13 +463,13 @@ directory. <i>&lt;string: directory path&gt;</i> - specifies the directory to be
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdRoots'>roots</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • roots •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; roots &bull;
</font></b></pre>
<p>The command retrieves file system roots - top level file system objects.
@@ -483,13 +483,13 @@ protocol file names to OS native names and back.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of directory entries&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of directory entries&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdRemove'>remove</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • remove • <i>&lt;string: path&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; remove &bull; <i>&lt;string: path&gt;</i> &bull;
</font></b></pre>
<p>The command removes a file or symbolic link.
@@ -498,13 +498,13 @@ This request cannot be used to remove directories.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdRealPath'>realpath</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • realpath • <i>&lt;string: path&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; realpath &bull; <i>&lt;string: path&gt;</i> &bull;
</font></b></pre>
<p>The command canonicalizes any given path name to an absolute path.
@@ -514,13 +514,13 @@ relative pathnames without a leading slash into absolute paths.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;string: path&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;string: path&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdRename'>rename</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • rename • <i>&lt;string: old path&gt;</i> • <i>&lt;string: new path&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; rename &bull; <i>&lt;string: old path&gt;</i> &bull; <i>&lt;string: new path&gt;</i> &bull;
</font></b></pre>
<p>The command renames a file.
@@ -532,13 +532,13 @@ point to different file systems on the server.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdReadLink'>readlink</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • readlink • <i>&lt;string: link path&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; readlink &bull; <i>&lt;string: link path&gt;</i> &bull;
</font></b></pre>
<p>The command reads the target of a symbolic link.
@@ -547,13 +547,13 @@ C • <i>&lt;token&gt;</i> • FileSystem • readlink • <i>&lt;string: link path&gt;<
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;string: path&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;string: path&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdSymLink'>symlink</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • symlink • <i>&lt;string: link path&gt;</i> • <i>&lt;string: target path&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; symlink &bull; <i>&lt;string: link path&gt;</i> &bull; <i>&lt;string: target path&gt;</i> &bull;
</font></b></pre>
<p>The command creates a symbolic link on the server.
@@ -563,14 +563,14 @@ C • <i>&lt;token&gt;</i> • FileSystem • symlink • <i>&lt;string: link path&gt;</
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdCopy'>copy</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • copy • <i>&lt;string: source path&gt;</i> • <i>&lt;string: destination path&gt;</i> •
- <i>&lt;boolean: copy permissions&gt;</i> • <i>&lt;boolean: copy ownership&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; copy &bull; <i>&lt;string: source path&gt;</i> &bull; <i>&lt;string: destination path&gt;</i> &bull;
+ <i>&lt;boolean: copy permissions&gt;</i> &bull; <i>&lt;boolean: copy ownership&gt;</i> &bull;
</font></b></pre>
<p>The command copies a file on remote system.
@@ -582,13 +582,13 @@ If <i>&lt;boolean: copy ownership&gt;</i> is true then copy source file UID and
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdUser'>user</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • FileSystem • user •
+C &bull; <i>&lt;token&gt;</i> &bull; FileSystem &bull; user &bull;
</font></b></pre>
<p>The command retrieves information about user account, which is used by server
@@ -597,8 +597,8 @@ to access file system on behalf of the client.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;int: real UID&gt;</i> • <i>&lt;int: effective UID&gt;</i> •
- <i>&lt;int: real GID&gt;</i> • <i>&lt;int: effective GID&gt;</i> • <i>&lt;string: home directory&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;int: real UID&gt;</i> &bull; <i>&lt;int: effective UID&gt;</i> &bull;
+ <i>&lt;int: real GID&gt;</i> &bull; <i>&lt;int: effective GID&gt;</i> &bull; <i>&lt;string: home directory&gt;</i> &bull;
</font></b></pre>
<h2><a name='API'>API</a></h2>
diff --git a/docs/TCF Service - Memory.html b/docs/TCF Service - Memory.html
index afca975ea..199a474eb 100644
--- a/docs/TCF Service - Memory.html
+++ b/docs/TCF Service - Memory.html
@@ -35,15 +35,15 @@ in addition to error report, describes data validity on per byte basis:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;array of error addresses&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ <i>&lt;error address list&gt;</i> ]
+ &rArr; null
+ &rArr; [ <i>&lt;error address list&gt;</i> ]
<i>&lt;error address list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;error address&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;error address list&gt;</i> , <i>&lt;error address&gt;</i>
+ &rArr; <i>&lt;error address&gt;</i>
+ &rArr; <i>&lt;error address list&gt;</i> , <i>&lt;error address&gt;</i>
<i>&lt;error address&gt;</i>
- <font face=Wingdings>Ψ</font> { "addr" : <i>&lt;int: range starting address&gt;</i> , "size" : <i>&lt;int: range length in bytes&gt;</i> , "stat" : <i>&lt;int: status code&gt;</i> , "msg" : <i>&lt;error description&gt;</i> }
+ &rArr; { "addr" : <i>&lt;int: range starting address&gt;</i> , "size" : <i>&lt;int: range length in bytes&gt;</i> , "stat" : <i>&lt;int: status code&gt;</i> , "msg" : <i>&lt;error description&gt;</i> }
</font></b></pre>
<p>If there is no entry in error addresses array for a data byte, then status of such
@@ -51,10 +51,10 @@ byte is defined by main error report.</p>
<p>Status code is bitwise or of status flags:</p>
<dl>
- <dt><code><b>BYTE_VALID        = 0x00</b></code> <dd>no error for this byte
-    <dt><code><b>BYTE_UNKNOWN      = 0x01</b></code> <dd>status is unknown
- <dt><code><b>BYTE_INVALID      = 0x02</b></code> <dd>byte value in invalid, error message describes the problem
- <dt><code><b>BYTE_CANNOT_READ  = 0x04</b></code> <dd>cannot read the byte
+ <dt><code><b>BYTE_VALID = 0x00</b></code> <dd>no error for this byte
+ <dt><code><b>BYTE_UNKNOWN = 0x01</b></code> <dd>status is unknown
+ <dt><code><b>BYTE_INVALID = 0x02</b></code> <dd>byte value in invalid, error message describes the problem
+ <dt><code><b>BYTE_CANNOT_READ = 0x04</b></code> <dd>cannot read the byte
<dt><code><b>BYTE_CANNOT_WRITE = 0x08</b></code> <dd>cannot write the byte
</dl>
@@ -63,7 +63,7 @@ byte is defined by main error report.</p>
<h3><a name='CmdGetContext'>Get Context</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Memory • getContext • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Memory &bull; getContext &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves context info for given context ID. A context corresponds to an
@@ -90,11 +90,11 @@ that is:</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;context data&gt;</i> &bull;
<i>&lt;context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Context data object should, at least, contain member
@@ -120,12 +120,12 @@ Service sends contextChanged event to notify changes in context data.</p>
<h3><a name='CmdGetChildren'>Get Children</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Memory • getChildren • <i>&lt;string: parent context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Memory &bull; getChildren &bull; <i>&lt;string: parent context ID&gt;</i> &bull;
</font></b></pre>
<p>The command requests a list of contexts available for memory access commands.</p>
-<p>Parent context ID can be null – to retrieve top level of the hierarchy, can be one
+<p>Parent context ID can be null &ndash; to retrieve top level of the hierarchy, can be one
of context IDs retrieved by previous getChildren commands, or it can be obtained from another service.
Contexts hierarchy can be simple plain list or it can form a tree. It is up to target agent developers to
choose layout that is most descriptive for a given target.</p>
@@ -133,25 +133,25 @@ choose layout that is most descriptive for a given target.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context IDs&gt;</i> •<i></i>
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of context IDs&gt;</i> &bull;<i></i>
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
</font></b></pre>
<h3><a name='CmdSetMemory'>Set Memory</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • &lt;token&gt; • Memory • set •
- <i>&lt;string: context ID&gt;</i> • <i>&lt;int: address&gt;</i> • <i>&lt;int: word size&gt;</i> •
- <i>&lt;int: byte count&gt;</i> • <i>&lt;int: mode&gt;</i> • <i>&lt;string: BASE64 encoded byte array&gt;</i> •
+C &bull; &lt;token&gt; &bull; Memory &bull; set &bull;
+ <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: address&gt;</i> &bull; <i>&lt;int: word size&gt;</i> &bull;
+ <i>&lt;int: byte count&gt;</i> &bull; <i>&lt;int: mode&gt;</i> &bull; <i>&lt;string: BASE64 encoded byte array&gt;</i> &bull;
</font></b></pre>
<p>Writes data bytes at given address in memory, "word size" bytes at a time. Address
@@ -159,15 +159,15 @@ should be aligned by "word size". Context ID must be one returned by getContexts
Mode is logical OR of any combination of:</p>
<ul type='disc'>
- <li>0x1 – continue on error (like bus error or page fault)
+ <li>0x1 &ndash; continue on error (like bus error or page fault)
- <li>0x2 – verify data after writing by reading back and compare
+ <li>0x2 &ndash; verify data after writing by reading back and compare
</ul>
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of error addresses&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of error addresses&gt;</i> &bull;
</font></b></pre>
<p>Error report provides integer error code and a short, human readable explanation
@@ -177,9 +177,9 @@ to be written into memory.</p>
<h3><a name='CmdGetMemory'>Get Memory</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • &lt;token&gt; • Memory • get •
- <i>&lt;string: context ID&gt;</i> • <i>&lt;int: address&gt;</i> • <i>&lt;int: word size&gt;</i> •
- <i>&lt;int: byte count&gt;</i> • <i>&lt;int: mode&gt;</i> •
+C &bull; &lt;token&gt; &bull; Memory &bull; get &bull;
+ <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: address&gt;</i> &bull; <i>&lt;int: word size&gt;</i> &bull;
+ <i>&lt;int: byte count&gt;</i> &bull; <i>&lt;int: mode&gt;</i> &bull;
</font></b></pre>
<p>Reads data bytes at given address in memory, "word size" bytes at a time. Address
@@ -187,15 +187,15 @@ should be aligned by "word size". Context ID must be one returned by getContexts
Mode is logical OR of any combination of:</p>
<ul type='disc'>
- <li>0x1 – continue on error (like bus error or page fault)
+ <li>0x1 &ndash; continue on error (like bus error or page fault)
- <li>0x2 – verify data after reading by re-reading and compare
+ <li>0x2 &ndash; verify data after reading by re-reading and compare
</ul>
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;string: BASE64 encoded byte array&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of error addresses&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;string: BASE64 encoded byte array&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of error addresses&gt;</i> &bull;
</font></b></pre>
<p>Error report provides integer error code and a short, human readable explanation
@@ -205,9 +205,9 @@ to be retrieved from memory.</p>
<h3><a name='CmdFillMemory'>Fill Memory</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • &lt;token&gt; • Memory • fill •
- <i>&lt;string: context ID&gt;</i> • <i>&lt;int: address&gt;</i> • <i>&lt;int: word size&gt;</i> •
- &lt;int: byte count&gt; • <i>&lt;int: mode&gt;</i> • <i>&lt;array: array of pattern bytes&gt;</i> •
+C &bull; &lt;token&gt; &bull; Memory &bull; fill &bull;
+ <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: address&gt;</i> &bull; <i>&lt;int: word size&gt;</i> &bull;
+ &lt;int: byte count&gt; &bull; <i>&lt;int: mode&gt;</i> &bull; <i>&lt;array: array of pattern bytes&gt;</i> &bull;
</font></b></pre>
<p>Writes pattern bytes at given address in memory, "word size" bytes at a time. Address
@@ -216,15 +216,15 @@ pattern is repeated necessary number of times. Context ID must be one returned b
getContexts. Mode is logical OR of any combination of:</p>
<ul type='disc'>
- <li>0x1 – continue on error (like bus error or page fault)
+ <li>0x1 &ndash; continue on error (like bus error or page fault)
- <li>0x2 – verify data after writing by reading back and compare
+ <li>0x2 &ndash; verify data after writing by reading back and compare
</ul>
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of error addresses&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of error addresses&gt;</i> &bull;
</font></b></pre>
<p>Error report provides integer error code and a short, human readable explanation
@@ -237,30 +237,30 @@ to be written into memory.</p>
or changed, and when memory content is altered by "set" or "fill" commands.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-E • Memory • contextAdded • <i>&lt;array of context data&gt;</i> •
-E • Memory • contextChanged • <i>&lt;array of context data&gt;</i> •
-E • Memory • contextRemoved • <i>&lt;array of context IDs&gt;</i> •
-E • Memory • memoryChanged • <i>&lt;string: context ID&gt;</i> • <i>&lt;array of address ranges&gt;</i> •
+E &bull; Memory &bull; contextAdded &bull; <i>&lt;array of context data&gt;</i> &bull;
+E &bull; Memory &bull; contextChanged &bull; <i>&lt;array of context data&gt;</i> &bull;
+E &bull; Memory &bull; contextRemoved &bull; <i>&lt;array of context IDs&gt;</i> &bull;
+E &bull; Memory &bull; memoryChanged &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;array of address ranges&gt;</i> &bull;
<i>&lt;array of context data&gt;</i> <font face="Times New Roman" size=3>- see Get Contexts command.</font>
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
<i>&lt;array of address ranges&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ <i>&lt;address ranges list&gt;</i> ]
+ &rArr; null
+ &rArr; [ <i>&lt;address ranges list&gt;</i> ]
<i>&lt;address ranges list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;address range&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;address ranges list&gt;</i> , <i>&lt;address range&gt;</i>
+ &rArr; <i>&lt;address range&gt;</i>
+ &rArr; <i>&lt;address ranges list&gt;</i> , <i>&lt;address range&gt;</i>
<i>&lt;address range&gt;</i>
- <font face=Wingdings>Ψ</font> { "addr" : <i>&lt;int: range starting address&gt;</i> , "size" : <i>&lt;int: range length in bytes&gt;</i> }
+ &rArr; { "addr" : <i>&lt;int: range starting address&gt;</i> , "size" : <i>&lt;int: range length in bytes&gt;</i> }
</font></b></pre>
<h2><a name='API'>API</a></h2>
@@ -276,19 +276,19 @@ E • Memory • memoryChanged • <i>&lt;string: context ID&gt;</i> • <i>&lt;array of
<font color=#3F5FBF>/**
* Retrieve context info for given context ID.
*
- * <font color=#7F9FBF>@param</font> id – context ID.
+ * <font color=#7F9FBF>@param</font> id &ndash; context ID.
* <font color=#7F9FBF>@param</font> done - callback interface called when operation is completed.
-     */</font>
+ */</font>
IToken getContext(String id, DoneGetContext done);
<font color=#3F5FBF>/**
* Client callback interface for getContext().
-     */</font>
+ */</font>
<font color=#7F0055>interface</font> DoneGetContext {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context – context data.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context &ndash; context data.
*/</font>
<font color=#7F0055>void</font> doneGetContext(IToken token, Exception error, MemoryContext context);
}
@@ -303,7 +303,7 @@ E • Memory • memoryChanged • <i>&lt;string: context ID&gt;</i> • <i>&lt;array of
* with same IDs, however, each service accesses its own subset of context's
* attributes and functionality, which is relevant to that service.
*
- * <font color=#7F9FBF>@param</font> parent_context_id – parent context ID. Can be null –
+ * <font color=#7F9FBF>@param</font> parent_context_id &ndash; parent context ID. Can be null &ndash;
* to retrieve top level of the hierarchy, or one of context IDs retrieved
* by previous getContexts commands.
* <font color=#7F9FBF>@param</font> done - callback interface called when operation is completed.
@@ -316,139 +316,139 @@ E • Memory • memoryChanged • <i>&lt;string: context ID&gt;</i> • <i>&lt;array of
<font color=#7F0055>interface</font> DoneGetChildren {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
-         * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
-         * <font color=#7F9FBF>@param</font> contexts – array of available context IDs.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> contexts &ndash; array of available context IDs.
*/</font>
<font color=#7F0055>void</font> doneGetChildren(IToken token, Exception error, String[] context_ids);
}
-    <font color=#3F5FBF>/**
-     * Memory access mode:
-     * Carry on when some of the memory cannot be accessed and
-     * return MemoryError at the end if any of the bytes
-     * were not processed correctly.
-     */</font>
-    <font color=#7F0055>final static int</font> MODE_CONTINUEONERROR = 0x1;
-
-    <font color=#3F5FBF>/**
-     * Memory access mode:
-     * Verify result of memory operations (by reading and comparing).
-     */</font>
-    <font color=#7F0055>final static int</font> MODE_VERIFY = 0x2;
-
-    <font color=#7F0055>interface</font> MemoryContext {
-
-        <font color=#3F5FBF>/**
-         * Retrieve context ID.
-         * Same as getProperties().get("id")
-         */</font>
-        String getID();
-
-        <font color=#3F5FBF>/**
-         * Return true if the context has children.
-         * Same as getProperties().get("has_children")
-         * Children can be retrieved by getContexts call.
-         */</font>
-        <font color=#7F0055>boolean</font> hasChildren();
-
-        <font color=#3F5FBF>/**
-         * Retrieve context properties.
-         */</font>
-        Map&lt;String,Object&gt; getProperties();
-
-        <font color=#3F5FBF>/**
-         * Set target memory.
-         * If 'word_size' is 0 it means client does not care about word size.
-         */</font>
-        <font color=#7F0055>void</font> set(long addr, <font color=#7F0055>int</font> word_size, byte[] buf,
-                         <font color=#7F0055>int</font> offs, <font color=#7F0055>int</font> size, <font color=#7F0055>int</font> mode, DoneMemory done);
-
-        <font color=#3F5FBF>/**
-         * Read target memory.
-         */</font>
-        <font color=#7F0055>void</font> get(long addr, <font color=#7F0055>int</font> word_size, byte[] buf,
-                         <font color=#7F0055>int</font> offs, <font color=#7F0055>int</font> size, <font color=#7F0055>int</font> mode, DoneMemory done);
-
-        <font color=#3F5FBF>/**
-         * Fill target memory with given pattern.
-         * 'size' is number of bytes to fill.
-         */</font>
-        <font color=#7F0055>void</font> fill(long addr, <font color=#7F0055>int</font> word_size, byte[] value,
-                          <font color=#7F0055>int</font> size, <font color=#7F0055>int</font> mode, DoneMemory done);
-   
-        <font color=#3F5FBF>/**
-         * Client callback interface for set(), get() and fill().
-         */</font>
-        <font color=#7F0055>interface</font> DoneMemory {
-            <font color=#7F0055>void</font> doneMemory(MemoryError error);
-        }
-    }
-
-    <font color=#7F0055>class</font> MemoryError <font color=#7F0055>extends</font> Exception {
-    }
+ <font color=#3F5FBF>/**
+ * Memory access mode:
+ * Carry on when some of the memory cannot be accessed and
+ * return MemoryError at the end if any of the bytes
+ * were not processed correctly.
+ */</font>
+ <font color=#7F0055>final static int</font> MODE_CONTINUEONERROR = 0x1;
+
+ <font color=#3F5FBF>/**
+ * Memory access mode:
+ * Verify result of memory operations (by reading and comparing).
+ */</font>
+ <font color=#7F0055>final static int</font> MODE_VERIFY = 0x2;
+
+ <font color=#7F0055>interface</font> MemoryContext {
+
+ <font color=#3F5FBF>/**
+ * Retrieve context ID.
+ * Same as getProperties().get("id")
+ */</font>
+ String getID();
+
+ <font color=#3F5FBF>/**
+ * Return true if the context has children.
+ * Same as getProperties().get("has_children")
+ * Children can be retrieved by getContexts call.
+ */</font>
+ <font color=#7F0055>boolean</font> hasChildren();
+
+ <font color=#3F5FBF>/**
+ * Retrieve context properties.
+ */</font>
+ Map&lt;String,Object&gt; getProperties();
+
+ <font color=#3F5FBF>/**
+ * Set target memory.
+ * If 'word_size' is 0 it means client does not care about word size.
+ */</font>
+ <font color=#7F0055>void</font> set(long addr, <font color=#7F0055>int</font> word_size, byte[] buf,
+ <font color=#7F0055>int</font> offs, <font color=#7F0055>int</font> size, <font color=#7F0055>int</font> mode, DoneMemory done);
+
+ <font color=#3F5FBF>/**
+ * Read target memory.
+ */</font>
+ <font color=#7F0055>void</font> get(long addr, <font color=#7F0055>int</font> word_size, byte[] buf,
+ <font color=#7F0055>int</font> offs, <font color=#7F0055>int</font> size, <font color=#7F0055>int</font> mode, DoneMemory done);
+
+ <font color=#3F5FBF>/**
+ * Fill target memory with given pattern.
+ * 'size' is number of bytes to fill.
+ */</font>
+ <font color=#7F0055>void</font> fill(long addr, <font color=#7F0055>int</font> word_size, byte[] value,
+ <font color=#7F0055>int</font> size, <font color=#7F0055>int</font> mode, DoneMemory done);
+
+ <font color=#3F5FBF>/**
+ * Client callback interface for set(), get() and fill().
+ */</font>
+ <font color=#7F0055>interface</font> DoneMemory {
+ <font color=#7F0055>void</font> doneMemory(MemoryError error);
+ }
+ }
+
+ <font color=#7F0055>class</font> MemoryError <font color=#7F0055>extends</font> Exception {
+ }
-    <font color=#3F5FBF>/**
-     * ErrorOffset interface can be implemented by MemoryError object,
-     * which is returned by get, set and fill commands.
-     *
-  * get/set/fill () returns this exception when reading failed
-   * for some but not all bytes, and MODE_CONTINUEONERROR
-     * has been set in mode. (For example, when only part of the request
-     * translates to valid memory addresses.)
-     * Exception.getMessage can be used for generalized message of the
-     * possible reasons of partial memory operation.
-     */</font>
-    <font color=#7F0055>interface</font> ErrorOffset {
-       
-        // Error may have per byte information
-        <font color=#7F0055>final static int</font>
-            BYTE_VALID        = 0x00,
-            BYTE_UNKNOWN      = 0x01, // e.g. out of range
-            BYTE_INVALID      = 0x02,
-            BYTE_CANNOT_READ  = 0x04,
-            BYTE_CANNOT_WRITE = 0x08;
-
-        <font color=#7F0055>int</font> getStatus(<font color=#7F0055>int</font> offset);
-
-        <font color=#3F5FBF>/**
-         * Returns the detail message string about the
-         * byte associated with specified location.
-         * <font color=#7F9FBF>@return</font>  the detail error message string.
-         */</font>
-        String getMessage(<font color=#7F0055>int</font> offset);
-       
-    }
-
-    <font color=#7F0055>void</font> addListener(MemoryListener listener);
-
-    <font color=#7F0055>interface</font> MemoryListener {
-
-        <font color=#3F5FBF>/**
-         * Called when a new memory access context(s) is created.
-         */</font>
-        <font color=#7F0055>void</font> contextAdded(Context[] contexts);
-
-        <font color=#3F5FBF>/**
-         * Called when a new memory access context(s) properties changed.
-         */</font>
-        <font color=#7F0055>void</font> contextChanged(Context[] contexts);
-
-        <font color=#3F5FBF>/**
-         * Called when memory access context(s) is removed.
-         */</font>
-        <font color=#7F0055>void</font> contextRemoved(String[] context_ids);
-
-        <font color=#3F5FBF>/**
-         * Called when target memory content was changed and clients
-         * need to update themselves. Clients, at least, should invalidate
-         * corresponding cached memory data.
-         * Not every change is notified - it is not possible,
-         * only those, which are not caused by normal execution of the debuggee.
-         * ‘addr’ and ‘size’ can be null if unknown.
-         */</font>
-        <font color=#7F0055>void</font> memoryChanged(String context_id,
-               long[] addr, long[] size);
-    }
+ <font color=#3F5FBF>/**
+ * ErrorOffset interface can be implemented by MemoryError object,
+ * which is returned by get, set and fill commands.
+ *
+ * get/set/fill () returns this exception when reading failed
+ * for some but not all bytes, and MODE_CONTINUEONERROR
+ * has been set in mode. (For example, when only part of the request
+ * translates to valid memory addresses.)
+ * Exception.getMessage can be used for generalized message of the
+ * possible reasons of partial memory operation.
+ */</font>
+ <font color=#7F0055>interface</font> ErrorOffset {
+
+ // Error may have per byte information
+ <font color=#7F0055>final static int</font>
+ BYTE_VALID = 0x00,
+ BYTE_UNKNOWN = 0x01, // e.g. out of range
+ BYTE_INVALID = 0x02,
+ BYTE_CANNOT_READ = 0x04,
+ BYTE_CANNOT_WRITE = 0x08;
+
+ <font color=#7F0055>int</font> getStatus(<font color=#7F0055>int</font> offset);
+
+ <font color=#3F5FBF>/**
+ * Returns the detail message string about the
+ * byte associated with specified location.
+ * <font color=#7F9FBF>@return</font> the detail error message string.
+ */</font>
+ String getMessage(<font color=#7F0055>int</font> offset);
+
+ }
+
+ <font color=#7F0055>void</font> addListener(MemoryListener listener);
+
+ <font color=#7F0055>interface</font> MemoryListener {
+
+ <font color=#3F5FBF>/**
+ * Called when a new memory access context(s) is created.
+ */</font>
+ <font color=#7F0055>void</font> contextAdded(Context[] contexts);
+
+ <font color=#3F5FBF>/**
+ * Called when a new memory access context(s) properties changed.
+ */</font>
+ <font color=#7F0055>void</font> contextChanged(Context[] contexts);
+
+ <font color=#3F5FBF>/**
+ * Called when memory access context(s) is removed.
+ */</font>
+ <font color=#7F0055>void</font> contextRemoved(String[] context_ids);
+
+ <font color=#3F5FBF>/**
+ * Called when target memory content was changed and clients
+ * need to update themselves. Clients, at least, should invalidate
+ * corresponding cached memory data.
+ * Not every change is notified - it is not possible,
+ * only those, which are not caused by normal execution of the debuggee.
+ * &lsquo;addr&rsquo; and &lsquo;size&rsquo; can be null if unknown.
+ */</font>
+ <font color=#7F0055>void</font> memoryChanged(String context_id,
+ long[] addr, long[] size);
+ }
}
</pre>
diff --git a/docs/TCF Service - Processes.html b/docs/TCF Service - Processes.html
index dbb3f0309..3b64c2843 100644
--- a/docs/TCF Service - Processes.html
+++ b/docs/TCF Service - Processes.html
@@ -42,7 +42,7 @@ see <a href='TCF Services.html#ErrorFormat'>Error Report Format</a>.</p>
<h3><a name='CmdGetContext'>Get Context</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Processes • getContext • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Processes &bull; getContext &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves context info for given context ID.
@@ -57,11 +57,11 @@ useful information.
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;context data&gt;</i> &bull;
<i>&lt;context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Context data object should, at least, contain member
@@ -89,12 +89,12 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;
<h3><a name='CmdGetChildren'>Get Children</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Processes • getChildren • <i>&lt;string: parent context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Processes &bull; getChildren &bull; <i>&lt;string: parent context ID&gt;</i> &bull;
</font></b></pre>
<p>The command requests a list of contexts available for process control commands.</p>
-<p>Parent context ID can be null – to retrieve top level of the hierarchy, can be one
+<p>Parent context ID can be null &ndash; to retrieve top level of the hierarchy, can be one
of context IDs retrieved by previous getChildren commands, or it can be obtained from another service.
Contexts hierarchy can be simple plain list or it can form a tree. It is up to target agent developers to
choose layout that is most descriptive for a given target.</p>
@@ -102,22 +102,22 @@ choose layout that is most descriptive for a given target.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context IDs&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of context IDs&gt;</i> &bull;
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
</font></b></pre>
<h3><a name='CmdAttach'>Attach</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Processes • attach • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Processes &bull; attach &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command attaches debugger to a process.
@@ -126,13 +126,13 @@ Services like Run Control, Memory, Breakpoints work only with attached processes
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdDetach'>Detach</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Processes • detach • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Processes &bull; detach &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command detaches debugger from a process.</p>
@@ -140,13 +140,13 @@ C • <i>&lt;token&gt;</i> • Processes • detach • <i>&lt;string: context ID&gt;</i
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdTerminate'>Terminate</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Processes • terminate • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Processes &bull; terminate &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command terminates a process.</p>
@@ -154,13 +154,13 @@ C • <i>&lt;token&gt;</i> • Processes • terminate • <i>&lt;string: context ID&gt;
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdSignal'>Signal</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Processes • signal • <i>&lt;string: context ID&gt;</i> • <i>&lt;int: signal&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Processes &bull; signal &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: signal&gt;</i> &bull;
</font></b></pre>
<p>The command sends a signal to a process.</p>
@@ -168,23 +168,23 @@ C • <i>&lt;token&gt;</i> • Processes • signal • <i>&lt;string: context ID&gt;</i
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdStart'>Start</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Processes • start • <i>&lt;string: working directory&gt;</i> • <i>&lt;string: program image file&gt;</i> •
- <i>&lt;string array: command line&gt;</i> • <i>&lt;string array: environment variables&gt;</i> • <i>&lt;boolean: attach&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Processes &bull; start &bull; <i>&lt;string: working directory&gt;</i> &bull; <i>&lt;string: program image file&gt;</i> &bull;
+ <i>&lt;string array: command line&gt;</i> &bull; <i>&lt;string array: environment variables&gt;</i> &bull; <i>&lt;boolean: attach&gt;</i> &bull;
<i>&lt;string array&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;string list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;string list&gt;</i> ]
<i>&lt;string list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string list&gt;</i> , <i>&lt;string&gt;</i>
+ &rArr; <i>&lt;string&gt;</i>
+ &rArr; <i>&lt;string list&gt;</i> , <i>&lt;string&gt;</i>
</font></b></pre>
<p>The command starts a new process on remote machine.
@@ -198,7 +198,7 @@ they will be added to default process environment.
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;context data&gt;</i> &bull;
</font></b></pre>
<p>On success the command returns context data for created process. Context data has same format as Get Context result.</p>
@@ -224,7 +224,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;
* If the ID is not a process ID, 'IProcesses.getContext' may not return any
* useful information
*
- * <font color=#7F9FBF><font color=#7F9FBF>@param</font></font> id – context ID.
+ * <font color=#7F9FBF><font color=#7F9FBF>@param</font></font> id &ndash; context ID.
* <font color=#7F9FBF><font color=#7F9FBF>@param</font></font> done - call back interface called when operation is completed.
*/</font>
IToken getContext(String id, DoneGetContext done);
@@ -235,8 +235,8 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;
<font color=#7F0055>interface</font> DoneGetContext {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context – context data.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context &ndash; context data.
*/</font>
<font color=#7F0055>void</font> doneGetContext(IToken token, Exception error, ProcessContext context);
}
@@ -244,7 +244,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;
<font color=#3F5FBF>/**
* Retrieve children of given context.
*
- * <font color=#7F9FBF>@param</font> parent_context_id – parent context ID. Can be null –
+ * <font color=#7F9FBF>@param</font> parent_context_id &ndash; parent context ID. Can be null &ndash;
* to retrieve top level of the hierarchy, or one of context IDs retrieved
* by previous getContext or getChildren commands.
* <font color=#7F9FBF>@param</font> done - call back interface called when operation is completed.
@@ -257,8 +257,8 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;
<font color=#7F0055>interface</font> DoneGetChildren {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context_ids – array of available context IDs.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context_ids &ndash; array of available context IDs.
*/</font>
<font color=#7F0055>void</font> doneGetChildren(IToken token, Exception error, String[] context_ids);
}
@@ -286,20 +286,20 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;
<font color=#3F5FBF>/**
* Get context ID.
- * Same as getProperties().get(“ID”)
+ * Same as getProperties().get(&ldquo;ID&rdquo;)
*/</font>
String getID();
<font color=#3F5FBF>/**
* Get parent context ID.
- * Same as getProperties().get(“ParentID”)
+ * Same as getProperties().get(&ldquo;ParentID&rdquo;)
*/</font>
String getParentID();
<font color=#3F5FBF>/**
* Get process name.
* Client UI can show this name to a user.
- * Same as getProperties().get(“Name”)
+ * Same as getProperties().get(&ldquo;Name&rdquo;)
*/</font>
String getName();
diff --git a/docs/TCF Service - Registers.html b/docs/TCF Service - Registers.html
index 44b713bdf..b47f490c7 100644
--- a/docs/TCF Service - Registers.html
+++ b/docs/TCF Service - Registers.html
@@ -43,7 +43,7 @@ multiple locations. This allows:
<h3><a name='CmdGetContext'>Get Context</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Registers • getContext • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Registers &bull; getContext &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves context info for given context ID. A context corresponds to an
@@ -59,11 +59,11 @@ Target agent should define contexts hierarchy that is:</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;context data&gt;</i> &bull;
<i>&lt;context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Context data object should, at least, contain member
@@ -135,7 +135,7 @@ Service sends contextChanged event to notify changes in context data.</p>
<h3><a name='CmdGetChildren'>Get Children</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Registers • getChildren • <i>&lt;string: parent context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Registers &bull; getChildren &bull; <i>&lt;string: parent context ID&gt;</i> &bull;
</font></b></pre>
<p>The command requests a list of contexts available for registers access commands.</p>
@@ -148,23 +148,23 @@ It is up to target agent developers to choose layout that is most descriptive fo
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context IDs&gt;</i> •<i></i>
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of context IDs&gt;</i> &bull;<i></i>
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
</font></b></pre>
<h3><a name='CmdSetRegister'>Set Register</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • &lt;token&gt; • Registers • set • <i>&lt;string: context ID&gt;</i> • <i>&lt;string: value&gt;</i> •
+C &bull; &lt;token&gt; &bull; Registers &bull; set &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;string: value&gt;</i> &bull;
</font></b></pre>
<p>Writes value into given register context. Context ID must be one returned by getContexts.
@@ -173,7 +173,7 @@ Value is BASE64 encoded byte array of binary data. Array size should match the s
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<p>Error report provides integer error code and a short, human readable explanation
@@ -182,7 +182,7 @@ of error.</p>
<h3><a name='CmdGetRegister'>Get Register</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • &lt;token&gt; • Registers • get • <i>&lt;string: context ID&gt;</i> •
+C &bull; &lt;token&gt; &bull; Registers &bull; get &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>Reads register value from given register context. Context ID must be one returned by getContexts.
@@ -191,7 +191,7 @@ C • &lt;token&gt; • Registers • get • <i>&lt;string: context ID&gt;</i> •
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;string: value&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;string: value&gt;</i> &bull;
</font></b></pre>
<p>Error report provides integer error code and a short, human readable explanation
@@ -200,17 +200,17 @@ of error. Value is BASE64 encoded byte array of binary data. Array size should m
<h3><a name='CmdSetMultiple'>Set Multiple Registers</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • &lt;token&gt; • Registers • setm • <i>&lt;array of locations&gt;</i> • <i>&lt;string: value&gt;</i> •
+C &bull; &lt;token&gt; &bull; Registers &bull; setm &bull; <i>&lt;array of locations&gt;</i> &bull; <i>&lt;string: value&gt;</i> &bull;
<i>&lt;array of locations&gt;</i>
- <font face=Wingdings>Ψ</font> [ <i>&lt;location list&gt;</i> ]
+ &rArr; [ <i>&lt;location list&gt;</i> ]
<i>&lt;location list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;location&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;location list&gt;</i> , <i>&lt;location&gt;</i>
+ &rArr; <i>&lt;location&gt;</i>
+ &rArr; <i>&lt;location list&gt;</i> , <i>&lt;location&gt;</i>
<i>&lt;location&gt;</i>
- <font face=Wingdings>Ψ</font> [ <i>&lt;string: register context ID&gt;</i> , <i>&lt;int: offset in bytes&gt;</i> , <i>&lt;int: size in bytes&gt;</i> ]
+ &rArr; [ <i>&lt;string: register context ID&gt;</i> , <i>&lt;int: offset in bytes&gt;</i> , <i>&lt;int: size in bytes&gt;</i> ]
</font></b></pre>
<p>Writes value into given list of locations in registers. Each location is represented by 3-element array that consists of
@@ -220,7 +220,7 @@ Value is BASE64 encoded byte array of binary data. Byte array size should match
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<p>Error report provides integer error code and a short, human readable explanation
@@ -229,17 +229,17 @@ of error.</p>
<h3><a name='CmdGetMultiple'>Get Multiple Registers</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • &lt;token&gt; • Registers • getm • <i>&lt;array of locations&gt;</i> •
+C &bull; &lt;token&gt; &bull; Registers &bull; getm &bull; <i>&lt;array of locations&gt;</i> &bull;
<i>&lt;array of locations&gt;</i>
- <font face=Wingdings>Ψ</font> [ <i>&lt;location list&gt;</i> ]
+ &rArr; [ <i>&lt;location list&gt;</i> ]
<i>&lt;location list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;location&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;location list&gt;</i> , <i>&lt;location&gt;</i>
+ &rArr; <i>&lt;location&gt;</i>
+ &rArr; <i>&lt;location list&gt;</i> , <i>&lt;location&gt;</i>
<i>&lt;location&gt;</i>
- <font face=Wingdings>Ψ</font> [ <i>&lt;string: register context ID&gt;</i> , <i>&lt;int: offset in bytes&gt;</i> , <i>&lt;int: size in bytes&gt;</i> ]
+ &rArr; [ <i>&lt;string: register context ID&gt;</i> , <i>&lt;int: offset in bytes&gt;</i> , <i>&lt;int: size in bytes&gt;</i> ]
</font></b></pre>
<p>Reads register values from given list of locations in registers. Each location is represented by 3-element array that consists of
@@ -249,7 +249,7 @@ context ID, offset in the context in bytes and value size in bytes.
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;string: value&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;string: value&gt;</i> &bull;
</font></b></pre>
<p>Error report provides integer error code and a short, human readable explanation
@@ -261,8 +261,8 @@ of error. Value is BASE64 encoded byte array of binary data. Byte array size sho
a register content is altered by "set" commands.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-E • Registers • contextChanged •
-E • Registers • registerChanged • <i>&lt;string: context ID&gt;</i> •
+E &bull; Registers &bull; contextChanged &bull;
+E &bull; Registers &bull; registerChanged &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<h2><a name='API'>API</a></h2>
@@ -301,7 +301,7 @@ E • Registers • registerChanged • <i>&lt;string: context ID&gt;</i> •
<font color=#3F5FBF>/**
* Retrieve context info for given context ID.
*
- * <font color=#7F9FBF>@param</font> id – context ID.
+ * <font color=#7F9FBF>@param</font> id &ndash; context ID.
* <font color=#7F9FBF>@param</font> done - call back interface called when operation is completed.
*/</font>
IToken getContext(String id, DoneGetContext done);
@@ -312,8 +312,8 @@ E • Registers • registerChanged • <i>&lt;string: context ID&gt;</i> •
<font color=#7F0055>interface</font> DoneGetContext {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context – context data.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context &ndash; context data.
*/</font>
<font color=#7F0055>void</font> doneGetContext(IToken token, Exception error, RegistersContext context);
}
@@ -328,7 +328,7 @@ E • Registers • registerChanged • <i>&lt;string: context ID&gt;</i> •
* with same IDs, however, each service accesses its own subset of context's
* attributes and functionality, which is relevant to that service.
*
- * <font color=#7F9FBF>@param</font> parent_context_id – parent context ID. Can be null –
+ * <font color=#7F9FBF>@param</font> parent_context_id &ndash; parent context ID. Can be null &ndash;
* to retrieve top level of the hierarchy, or one of context IDs retrieved
* by previous getChildren commands.
* <font color=#7F9FBF>@param</font> done - call back interface called when operation is completed.
@@ -341,8 +341,8 @@ E • Registers • registerChanged • <i>&lt;string: context ID&gt;</i> •
<font color=#7F0055>interface</font> DoneGetChildren {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context_ids – array of available context IDs.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context_ids &ndash; array of available context IDs.
*/</font>
<font color=#7F0055>void</font> doneGetChildren(IToken token, Exception error, String[] context_ids);
}
diff --git a/docs/TCF Service - Run Control.html b/docs/TCF Service - Run Control.html
index fd5adccd5..55583a8c6 100644
--- a/docs/TCF Service - Run Control.html
+++ b/docs/TCF Service - Run Control.html
@@ -36,7 +36,7 @@ see <a href='TCF Services.html#ErrorFormat'>Error Report Format</a>.</p>
context is in a particular state. For example, if single step command arrives when
context is running, it does not wait until it stops, but returns an error. If a command
successfully resumed a context, it does not wait until instruction pointer reaches
-desired destination – from client point of view the command execution ends right after
+desired destination &ndash; from client point of view the command execution ends right after
context was resumed. Various stepping commands can leave a context running in a special
mode, which is different from normal execution, for example, it can leave temporary
breakpoints to suspend the context when control reaches a particular place. Such execution
@@ -47,7 +47,7 @@ why a context is suspended by listening to events.</p>
<h3><a name='CmdGetContext'>Get Context</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • RunControl • getContext • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; RunControl &bull; getContext &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves context properties for given context ID.
@@ -63,11 +63,11 @@ attributes and functionality, which is relevant to that service.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;context data&gt;</i> &bull;
<i>&lt;context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;object: context properties&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;object: context properties&gt;</i>
</font></b></pre>
<p>Context data object is collection of context properties. It should, at least, contain member
@@ -115,12 +115,12 @@ contextChanged event to notify changes in context data.</p>
<h3><a name='CmdGetChildren'>Get Children</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • RunControl • getChildren • <i>&lt;string: parent context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; RunControl &bull; getChildren &bull; <i>&lt;string: parent context ID&gt;</i> &bull;
</font></b></pre>
<p>The command requests list of execution contexts available for run control commands.</p>
-<p>Parent context ID can be null – to retrieve top level of the hierarchy, can be one
+<p>Parent context ID can be null &ndash; to retrieve top level of the hierarchy, can be one
of context IDs retrieved by previous getChildren commands, or it can be obtained from another service.
Contexts hierarchy can be simple plain list or it can form a tree. It is up to target agent developers to
choose layout that is most descriptive for a given target.</p>
@@ -128,21 +128,21 @@ choose layout that is most descriptive for a given target.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context IDs&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of context IDs&gt;</i> &bull;
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; null
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
</font></b></pre>
<h3><a name='CmdSuspend'>Suspend</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • RunControl • suspend • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; RunControl &bull; suspend &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command suspends execution of given context. The command should fail if CanSuspend property of the context is false.
@@ -152,13 +152,13 @@ can be suspended.</p>
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdResume'>Resume</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • RunControl • resume • <i>&lt;string: context ID&gt;</i> • <i>&lt;int: mode&gt;</i> • <i>&lt;int: count&gt;</i> •
+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;
</font></b></pre>
<p>The command resumes execution of given context. The command should fail if CanResume
@@ -211,13 +211,13 @@ to context's children. Only contexts with HasState = true can be resumed.</p>
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='CmdGetState'>Get State</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • RunControl • getState • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; RunControl &bull; getState &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves current state of the context. The command should fail if HasState property of
@@ -226,12 +226,12 @@ the context is false.</p>
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;boolean: suspended&gt;</i> •
- <i>&lt;int: PC&gt;</i> • <i>&lt;string: last state change reason&gt;</i> • <i>&lt;state data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;boolean: suspended&gt;</i> &bull;
+ <i>&lt;int: PC&gt;</i> &bull; <i>&lt;string: last state change reason&gt;</i> &bull; <i>&lt;state data&gt;</i> &bull;
<i>&lt;state data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;object: context state properties&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;object: context state properties&gt;</i>
</font></b></pre>
<p>State change reason can be any text, but if it is one of predefined strings,
@@ -254,7 +254,7 @@ Definition of state properties depends on a target.</p>
<h3><a name='CmdTerminate'>Terminate</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • RunControl • terminate • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; RunControl &bull; terminate &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command terminates execution of given context. The command should fail if CanTerminate
@@ -263,37 +263,37 @@ property of the context is false.</p>
<p>Result message:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h2><a name='Events'>Events</a></h2>
<pre><b><font face="Courier New" size=2 color=#333399>
-E • RunControl • contextAdded • <i>&lt;array of context data&gt;</i> •
+E &bull; RunControl &bull; contextAdded &bull; <i>&lt;array of context data&gt;</i> &bull;
-E • RunControl • contextChanged • <i>&lt;array of context data&gt;</i> •
+E &bull; RunControl &bull; contextChanged &bull; <i>&lt;array of context data&gt;</i> &bull;
-E • RunControl • contextRemoved • <i>&lt;array of context IDs&gt;</i> •
+E &bull; RunControl &bull; contextRemoved &bull; <i>&lt;array of context IDs&gt;</i> &bull;
-E • RunControl • contextSuspended • <i>&lt;string: context ID&gt;</i> • <i>&lt;int: PC&gt;</i> •
- <i>&lt;string: reason&gt;</i> • <i>&lt;state data&gt;</i> •
+E &bull; RunControl &bull; contextSuspended &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: PC&gt;</i> &bull;
+ <i>&lt;string: reason&gt;</i> &bull; <i>&lt;state data&gt;</i> &bull;
-E • RunControl • contextResumed • <i>&lt;string: context ID&gt;</i> •
+E &bull; RunControl &bull; contextResumed &bull; <i>&lt;string: context ID&gt;</i> &bull;
-E • RunControl • contextException • <i>&lt;string: context ID&gt;</i> • <i>&lt;string: description&gt;</i> •
+E &bull; RunControl &bull; contextException &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;string: description&gt;</i> &bull;
-E • RunControl • containerSuspended • <i>&lt;string: context ID&gt;</i> • <i>&lt;int: PC&gt;</i> •
- <i>&lt;string: reason&gt;</i> • <i>&lt;state data&gt;</i> • <i>&lt;array of context IDs&gt;</i> •
+E &bull; RunControl &bull; containerSuspended &bull; <i>&lt;string: context ID&gt;</i> &bull; <i>&lt;int: PC&gt;</i> &bull;
+ <i>&lt;string: reason&gt;</i> &bull; <i>&lt;state data&gt;</i> &bull; <i>&lt;array of context IDs&gt;</i> &bull;
-E • RunControl • containerResumed • <i>&lt;array of context IDs&gt;</i> •
+E &bull; RunControl &bull; containerResumed &bull; <i>&lt;array of context IDs&gt;</i> &bull;
<i>&lt;array of context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ <i>&lt;context data list&gt;</i> ]
+ &rArr; null
+ &rArr; [ <i>&lt;context data list&gt;</i> ]
<i>&lt;context data list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object: context data&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context data list&gt;</i> , <i>&lt;object: context data&gt;</i>
+ &rArr; <i>&lt;object: context data&gt;</i>
+ &rArr; <i>&lt;context data list&gt;</i> , <i>&lt;object: context data&gt;</i>
</font></b></pre>
<dl>
@@ -381,7 +381,7 @@ E • RunControl • containerResumed • <i>&lt;array of context IDs&gt;</i> •
<font color=#3F5FBF>/**
* Retrieve context info for given context ID.
*
- * <font color=#7F9FBF>@param</font> id – context ID.
+ * <font color=#7F9FBF>@param</font> id &ndash; context ID.
* <font color=#7F9FBF>@param</font> done - callback interface called when operation is completed.
*/</font>
IToken getContext(String id, DoneGetContext done);
@@ -392,33 +392,33 @@ E • RunControl • containerResumed • <i>&lt;array of context IDs&gt;</i> •
<font color=#7F0055>interface</font> DoneGetContext {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context – context data.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context &ndash; context data.
*/</font>
<font color=#7F0055>void</font> doneGetContext(IToken token, Exception error, RunControlContext context);
}
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Retrieve children of given context.
*
- * <font color=#7F9FBF>@param</font> parent_context_id – parent context ID. Can be null –
+ * <font color=#7F9FBF>@param</font> parent_context_id &ndash; parent context ID. Can be null &ndash;
* to retrieve top level of the hierarchy, or one of context IDs retrieved
* by previous getContext or getChildren commands.
* <font color=#7F9FBF>@param</font> done - callback interface called when operation is completed.
-     */</font>
+ */</font>
IToken getChildren(String parent_context_id, DoneGetChildren done);
-    <font color=#3F5FBF>/**
-     * Client callback interface for getContexts().
-     */</font>
-    <font color=#7F0055>interface</font> DoneGetChildren {
-        <font color=#3F5FBF>/**
-         * Called when contexts data retrieval is done.
-         * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
-         * <font color=#7F9FBF>@param</font> contexts – array of available context IDs.
-         */</font>
-        <font color=#7F0055>void</font> doneGetChildren(IToken token, RunControlError error, Context[] contexts);
-    }
+ <font color=#3F5FBF>/**
+ * Client callback interface for getContexts().
+ */</font>
+ <font color=#7F0055>interface</font> DoneGetChildren {
+ <font color=#3F5FBF>/**
+ * Called when contexts data retrieval is done.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> contexts &ndash; array of available context IDs.
+ */</font>
+ <font color=#7F0055>void</font> doneGetChildren(IToken token, RunControlError error, Context[] contexts);
+ }
<font color=#3F5FBF>/**
* A context corresponds to an execution thread, process, address space, etc.
@@ -429,13 +429,13 @@ E • RunControl • containerResumed • <i>&lt;array of context IDs&gt;</i> •
* with same IDs, however, each service accesses its own subset of context's
* attributes and functionality, which is relevant to that service.
*/</font>
-    <font color=#7F0055>interface</font> RunControlContext {
+ <font color=#7F0055>interface</font> RunControlContext {
<font color=#3F5FBF>/**
* Retrieve context ID.
* Same as getProperties().get("ID")
*/</font>
-        String getID();
+ String getID();
<font color=#3F5FBF>/**
* Retrieve parent context ID.
@@ -448,7 +448,7 @@ E • RunControl • containerResumed • <i>&lt;array of context IDs&gt;</i> •
* Context properties are read only, clients should not try to modify them.
* <font color=#7F9FBF>@return</font> Map of context properties.
*/</font>
-        Map&lt;String,Object&gt; getProperties();
+ Map&lt;String,Object&gt; getProperties();
<font color=#3F5FBF>/**
* Utility method to read context property PROP_IS_CONTAINER.
@@ -537,10 +537,10 @@ E • RunControl • containerResumed • <i>&lt;array of context IDs&gt;</i> •
* <font color=#7F9FBF>@return</font> pending command handle, can be used to cancel the command.
*/</font>
IToken terminate(DoneCommand done);
-    }
+ }
-    <font color=#7F0055>class</font> RunControlError <font color=#7F0055>extends</font> Exception {
-    }
+ <font color=#7F0055>class</font> RunControlError <font color=#7F0055>extends</font> Exception {
+ }
<font color=#7F0055>interface</font> DoneGetState {
<font color=#7F0055>void</font> doneGetState(IToken token, Exception error, <font color=#7F0055>boolean</font> suspended, String pc,
diff --git a/docs/TCF Service - Stack Trace.html b/docs/TCF Service - Stack Trace.html
index c1ce675d5..661607bbd 100644
--- a/docs/TCF Service - Stack Trace.html
+++ b/docs/TCF Service - Stack Trace.html
@@ -31,16 +31,16 @@ see <a href='TCF Services.html#ErrorFormat'>Error Report Format</a>.</p>
<h3><a name='CmdGetContext'>Get Context</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • StackTrace • getContext • <i>&lt;array of context IDs&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; StackTrace &bull; getContext &bull; <i>&lt;array of context IDs&gt;</i> &bull;
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
</font></b></pre>
<p>The command retrieves context info for given context IDs.
@@ -52,20 +52,20 @@ each stack is also represented by a separate context.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;array of context data&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;array of context data&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
<i>&lt;array of context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;context data list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;context data list&gt;</i> ]
<i>&lt;context data list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context data&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context data list&gt;</i> , <i>&lt;context data&gt;</i>
+ &rArr; <i>&lt;context data&gt;</i>
+ &rArr; <i>&lt;context data list&gt;</i> , <i>&lt;context data&gt;</i>
<i>&lt;context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Context data object should, at least, contain member
@@ -106,7 +106,7 @@ Cached context data should by flushed when parent thread is resumed.</p>
<h3><a name='CmdGetChildren'>Get Children</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • StackTrace • getChildren • <i>&lt;string: parent context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; StackTrace &bull; getChildren &bull; <i>&lt;string: parent context ID&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves stack trace context list.
@@ -121,16 +121,16 @@ Client can use Run Control service to suspend a thread.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context IDs&gt;</i> •<i></i>
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of context IDs&gt;</i> &bull;<i></i>
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
</font></b></pre>
@@ -166,7 +166,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context
* The command will fail if parent thread is not suspended.
* Client can use Run Control service to suspend a thread.
*
- * <font color=#7F9FBF>@param</font> id – array of context IDs.
+ * <font color=#7F9FBF>@param</font> id &ndash; array of context IDs.
* <font color=#7F9FBF>@param</font> done - call back interface called when operation is completed.
*/</font>
IToken getContext(String[] id, DoneGetContext done);
@@ -177,8 +177,8 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context
<font color=#7F0055>interface</font> DoneGetContext {
<font color=#3F5FBF>/**
* Called when context data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context – array of context data or null if error.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context &ndash; array of context data or null if error.
*/</font>
<font color=#7F0055>void</font> doneGetContext(IToken token, Exception error, StackTraceContext[] context);
}
@@ -193,7 +193,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context
* The command will fail if parent thread is not suspended.
* Client can use Run Control service to suspend a thread.
*
- * <font color=#7F9FBF>@param</font> parent_context_id – parent context ID.
+ * <font color=#7F9FBF>@param</font> parent_context_id &ndash; parent context ID.
* <font color=#7F9FBF>@param</font> done - call back interface called when operation is completed.
*/</font>
IToken getChildren(String parent_context_id, DoneGetChildren done);
@@ -204,8 +204,8 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context
<font color=#7F0055>interface</font> DoneGetChildren {
<font color=#3F5FBF>/**
* Called when context list retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context_ids – array of available context IDs.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context_ids &ndash; array of available context IDs.
* Stack frames are ordered from stack bottom to top.
*/</font>
<font color=#7F0055>void</font> doneGetChildren(IToken token, Exception error, String[] context_ids);
diff --git a/docs/TCF Service - System Monitor.html b/docs/TCF Service - System Monitor.html
index fb9dbd1ed..8ed6c1211 100644
--- a/docs/TCF Service - System Monitor.html
+++ b/docs/TCF Service - System Monitor.html
@@ -38,7 +38,7 @@ see <a href='TCF Services.html#ErrorFormat'>Error Report Format</a>.</p>
<h3><a name='CmdGetContext'>Get Context</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • SysMonitor • getContext • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; SysMonitor &bull; getContext &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command retrieves context info for given context ID.
@@ -49,11 +49,11 @@ command with a context that was obtained from another service.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;context data&gt;</i> &bull;
<i>&lt;context data&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
+ &rArr; null
+ &rArr; <i>&lt;object&gt;</i>
</font></b></pre>
<p>Context data object should, at least, contain member
@@ -225,12 +225,12 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;context data&gt;
<h3><a name='CmdGetChildren'>Get Children</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • SysMonitor • getChildren • <i>&lt;string: parent context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; SysMonitor &bull; getChildren &bull; <i>&lt;string: parent context ID&gt;</i> &bull;
</font></b></pre>
<p>The command requests a list of contexts available for System Monitor commands.</p>
-<p>Parent context ID can be null – to retrieve top level of the hierarchy, can be one
+<p>Parent context ID can be null &ndash; to retrieve top level of the hierarchy, can be one
of context IDs retrieved by previous getChildren commands, or it can be obtained from another service.
Contexts hierarchy can be simple plain list or it can form a tree. It is up to target agent developers to
choose layout that is most descriptive for a given target.</p>
@@ -238,22 +238,22 @@ choose layout that is most descriptive for a given target.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of context IDs&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of context IDs&gt;</i> &bull;
<i>&lt;array of context IDs&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;context ID list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;context ID list&gt;</i> ]
<i>&lt;context ID list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string: context ID&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;string: context ID&gt;</i>
+ &rArr; <i>&lt;context ID list&gt;</i> , <i>&lt;string: context ID&gt;</i>
</font></b></pre>
<h3><a name='CmdGetCommandLine'>Get Command Line</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • SysMonitor • getCommandLine • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; SysMonitor &bull; getCommandLine &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command requests a list of progess command line arguments.</p>
@@ -261,22 +261,22 @@ C • <i>&lt;token&gt;</i> • SysMonitor • getCommandLine • <i>&lt;string: context
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of string&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of string&gt;</i> &bull;
<i>&lt;array of string&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> [ ]
- <font face=Wingdings>Ψ</font> [ <i>&lt;string list&gt;</i> ]
+ &rArr; null
+ &rArr; [ ]
+ &rArr; [ <i>&lt;string list&gt;</i> ]
<i>&lt;string list&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string list&gt;</i> , <i>&lt;string&gt;</i>
+ &rArr; <i>&lt;string&gt;</i>
+ &rArr; <i>&lt;string list&gt;</i> , <i>&lt;string&gt;</i>
</font></b></pre>
<h3><a name='CmdGetEnvironment'>Get Environment</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • SysMonitor • getEnvironment • <i>&lt;string: context ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; SysMonitor &bull; getEnvironment &bull; <i>&lt;string: context ID&gt;</i> &bull;
</font></b></pre>
<p>The command requests a list of progess environment variables.</p>
@@ -284,7 +284,7 @@ C • <i>&lt;token&gt;</i> • SysMonitor • getEnvironment • <i>&lt;string: context
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of string&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull; <i>&lt;array of string&gt;</i> &bull;
</font></b></pre>
<h2><a name='Events'>Events</a></h2>
@@ -301,7 +301,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of string&
<font color=#3F5FBF>/**
* Retrieve context info for given context ID.
*
- * <font color=#7F9FBF>@param</font> id – context ID.
+ * <font color=#7F9FBF>@param</font> id &ndash; context ID.
* <font color=#7F9FBF>@param</font> done - callback interface called when operation is completed.
*/</font>
IToken getContext(String id, DoneGetContext done);
@@ -312,8 +312,8 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of string&
<font color=#7F0055>interface</font> DoneGetContext {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context – context data.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context &ndash; context data.
*/</font>
<font color=#7F0055>void</font> doneGetContext(IToken token, Exception error, SysMonitorContext context);
}
@@ -321,7 +321,7 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of string&
<font color=#3F5FBF>/**
* Retrieve children of given context.
*
- * <font color=#7F9FBF>@param</font> parent_context_id – parent context ID. Can be null –
+ * <font color=#7F9FBF>@param</font> parent_context_id &ndash; parent context ID. Can be null &ndash;
* to retrieve top level of the hierarchy, or one of context IDs retrieved
* by previous getContext or getChildren commands.
* <font color=#7F9FBF>@param</font> done - callback interface called when operation is completed.
@@ -334,8 +334,8 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of string&
<font color=#7F0055>interface</font> DoneGetChildren {
<font color=#3F5FBF>/**
* Called when contexts data retrieval is done.
- * <font color=#7F9FBF>@param</font> error – error description if operation failed, null if succeeded.
- * <font color=#7F9FBF>@param</font> context_ids – array of available context IDs.
+ * <font color=#7F9FBF>@param</font> error &ndash; error description if operation failed, null if succeeded.
+ * <font color=#7F9FBF>@param</font> context_ids &ndash; array of available context IDs.
*/</font>
<font color=#7F0055>void</font> doneGetChildren(IToken token, Exception error, String[] context_ids);
}
@@ -517,109 +517,109 @@ R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> • <i>&lt;array of string&
<font color=#3F5FBF>/**
* Get context ID.
- * Same as getProperties().get(“ID”)
+ * Same as getProperties().get(&ldquo;ID&rdquo;)
*/</font>
String getID();
<font color=#3F5FBF>/**
* Get parent context ID.
- * Same as getProperties().get(“ParentID”)
+ * Same as getProperties().get(&ldquo;ParentID&rdquo;)
*/</font>
String getParentID();
<font color=#3F5FBF>/**
* Get process group ID.
- * Same as getProperties().get(“PGRP”)
+ * Same as getProperties().get(&ldquo;PGRP&rdquo;)
*/</font>
<font color=#7F0055>long</font> getPGRP();
<font color=#3F5FBF>/**
* Get process ID.
- * Same as getProperties().get(“PID”)
+ * Same as getProperties().get(&ldquo;PID&rdquo;)
*/</font>
<font color=#7F0055>long</font> getPID();
<font color=#3F5FBF>/**
* Get process parent ID.
- * Same as getProperties().get(“PPID”)
+ * Same as getProperties().get(&ldquo;PPID&rdquo;)
*/</font>
<font color=#7F0055>long</font> getPPID();
<font color=#3F5FBF>/**
* Get process TTY group ID.
- * Same as getProperties().get(“TGID”)
+ * Same as getProperties().get(&ldquo;TGID&rdquo;)
*/</font>
<font color=#7F0055>long</font> getTGID();
<font color=#3F5FBF>/**
* Get tracer process ID.
- * Same as getProperties().get(“TracerPID”)
+ * Same as getProperties().get(&ldquo;TracerPID&rdquo;)
*/</font>
<font color=#7F0055>long</font> getTracerPID();
<font color=#3F5FBF>/**
* Get process owner user ID.
- * Same as getProperties().get(“UID”)
+ * Same as getProperties().get(&ldquo;UID&rdquo;)
*/</font>
<font color=#7F0055>long</font> getUID();
<font color=#3F5FBF>/**
* Get process owner user name.
- * Same as getProperties().get(“UserName”)
+ * Same as getProperties().get(&ldquo;UserName&rdquo;)
*/</font>
String getUserName();
<font color=#3F5FBF>/**
* Get process owner user group ID.
- * Same as getProperties().get(“UGID”)
+ * Same as getProperties().get(&ldquo;UGID&rdquo;)
*/</font>
<font color=#7F0055>long</font> getUGID();
<font color=#3F5FBF>/**
* Get process owner user group name.
- * Same as getProperties().get(“GroupName”)
+ * Same as getProperties().get(&ldquo;GroupName&rdquo;)
*/</font>
String getGroupName();
<font color=#3F5FBF>/**
* Get process state.
- * Same as getProperties().get(“State”)
+ * Same as getProperties().get(&ldquo;State&rdquo;)
*/</font>
String getState();
<font color=#3F5FBF>/**
* Get process virtual memory size in bytes.
- * Same as getProperties().get(“VSize”)
+ * Same as getProperties().get(&ldquo;VSize&rdquo;)
*/</font>
<font color=#7F0055>long</font> getVSize();
<font color=#3F5FBF>/**
* Get process virtual memory page size in bytes.
- * Same as getProperties().get(“PSize”)
+ * Same as getProperties().get(&ldquo;PSize&rdquo;)
*/</font>
<font color=#7F0055>long</font> getPSize();
<font color=#3F5FBF>/**
* Get number of memory pages in process resident set.
- * Same as getProperties().get(“RSS”)
+ * Same as getProperties().get(&ldquo;RSS&rdquo;)
*/</font>
<font color=#7F0055>long</font> getRSS();
<font color=#3F5FBF>/**
* Get context executable file.
- * Same as getProperties().get(“File”)
+ * Same as getProperties().get(&ldquo;File&rdquo;)
*/</font>
String getFile();
<font color=#3F5FBF>/**
* Get context current file system root.
- * Same as getProperties().get(“Root”)
+ * Same as getProperties().get(&ldquo;Root&rdquo;)
*/</font>
String getRoot();
<font color=#3F5FBF>/**
* Get context current working directory.
- * Same as getProperties().get(“CWD”)
+ * Same as getProperties().get(&ldquo;CWD&rdquo;)
*/</font>
String getCurrentWorkingDirectory();
diff --git a/docs/TCF Services.html b/docs/TCF Services.html
index 38377555c..f0a527563 100644
--- a/docs/TCF Services.html
+++ b/docs/TCF Services.html
@@ -48,8 +48,8 @@ using a simple variant of Backus-Naur Form. In particular:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;chars&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;char&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt; &lt;char&gt;</i>
+ &rArr; <i>&lt;char&gt;</i>
+ &rArr; <i>&lt;chars&gt; &lt;char&gt;</i>
</font></b></pre>
<ul type='disc'>
@@ -58,7 +58,7 @@ using a simple variant of Backus-Naur Form. In particular:</p>
<li>All text in the category definition, other than categories and spaces, is UTF-8
based representation of a message bytes.
- <li>The symbol ‘•’ designates a zero byte.
+ <li>The symbol &lsquo;&bull;&rsquo; designates a zero byte.
</ul>
<h2><a name='ErrorFormat'>Error Report Format</a></h2>
@@ -67,7 +67,7 @@ using a simple variant of Backus-Naur Form. In particular:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;error report&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;int: error code&gt;</i> • <i>&lt;error description&gt;</i>
+ &rArr; <i>&lt;int: error code&gt;</i> &bull; <i>&lt;error description&gt;</i>
</font></b></pre>
<p>Error code zero means success. Error description provides a short, localizable,
@@ -75,13 +75,13 @@ human readable explanation of error.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;error description&gt;</i>
- <font face=Wingdings>Ψ</font> null
- <font face=Wingdings>Ψ</font> <i>&lt;string&gt;</i>
- <font face=Wingdings>Ψ</font> { "format" : <i>&lt;string&gt;</i> , "params" : [ <i>&lt;params&gt;</i> ] }
+ &rArr; null
+ &rArr; <i>&lt;string&gt;</i>
+ &rArr; { "format" : <i>&lt;string&gt;</i> , "params" : [ <i>&lt;params&gt;</i> ] }
<i>&lt;params&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;value&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;params&gt;</i> , <i>&lt;value&gt;</i>
+ &rArr; <i>&lt;value&gt;</i>
+ &rArr; <i>&lt;params&gt;</i> , <i>&lt;value&gt;</i>
</font></b></pre>
<p>For <b><i><font face="Courier New" size=2 color=#333399>&lt;string&gt;</font></i></b>
diff --git a/docs/TCF Specification.html b/docs/TCF Specification.html
index 39becc8d1..6233ba279 100644
--- a/docs/TCF Specification.html
+++ b/docs/TCF Specification.html
@@ -85,8 +85,8 @@ A service can be discovered, added or removed as a group at communication endpoi
<dt><b>Message:</b> <dd>a packet of data, formatted according to framework specification
and transmitted over communication channel.
-<dt><b>Channel:</b> <dd>communication link connecting two endpoints (peers).  A single
-channel may be used to communicate with multiple services.  Multiple channels may
+<dt><b>Channel:</b> <dd>communication link connecting two endpoints (peers). A single
+channel may be used to communicate with multiple services. Multiple channels may
be used to connect the same peers, however no command or event ordering is guaranteed
across channels.
@@ -139,14 +139,14 @@ them about state changes.
<li>Services can be added and removed dynamically.
- <li>Framework should define a set of common high level interfaces (services).  For
+ <li>Framework should define a set of common high level interfaces (services). For
example: flow control, memory access, registers access, up-load mechanism, kernel
awareness, run control, target file system, console, flash programming. Implementation
of these interfaces is optional, but if provided it will support much wider compatibility
with various tools.
<li>Framework should be layered in such a way so it is possible to use different transport
- medias (e.g. TCP/IP, RS232, USB, etc) without any changes to individual services. 
+ medias (e.g. TCP/IP, RS232, USB, etc) without any changes to individual services.
In other words, transport implementation should be services agnostic, and services
implementation should be transport agnostic.
@@ -157,7 +157,7 @@ them about state changes.
use.
<li>The definition of services (groups of related commands and events) is separate
- from the definition of the framework itself.  The framework provides unified communication
+ from the definition of the framework itself. The framework provides unified communication
mechanism, while services use it to communicate with its clients.
<li>Anybody (including 3rd parties) can add services without having to modify communication
@@ -183,7 +183,7 @@ them about state changes.
<li>Supports of concurrent requests. Maximum number of concurrent requests (window
size) can be limited on target side. Simple agents only have to support window size
- of 1. Framework should maintain a queue of additional requests, so tools don’t need
+ of 1. Framework should maintain a queue of additional requests, so tools don't need
to know the window size. This may only be relevant for certain transport protocols
e.g. UDP.
@@ -203,15 +203,15 @@ using a simple variant of Backus-Naur Form. In particular:</p>
</font></i></b>Category name can be followed by colon and a text, which explains semantics
of the category, for example: <b><i><font face="Courier New" size=2 color=#333399>&lt;int:
error code&gt;</font></i></b> has same meaning as <b><i><font face="Courier New" size=2 color=#333399>&lt;int&gt;</font></i></b>,
- but denotes that the integer number used to indicate an “error code”.
+ but denotes that the integer number used to indicate an &ldquo;error code&rdquo;.
<li>A syntax rule consists of a category designation followed by one or more syntax
definitions for the category. The category name and each definition are placed on
separate lines, bullets are used to denote definitions, for example:
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;chars&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;char&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt; &lt;char&gt;</i>
+ &rArr; <i>&lt;char&gt;</i>
+ &rArr; <i>&lt;chars&gt; &lt;char&gt;</i>
</font></b></pre>
<li>Spaces are added for readability only and they are not part of the syntax.
@@ -219,14 +219,14 @@ using a simple variant of Backus-Naur Form. In particular:</p>
<li>All text in the category definition, other then categories and spaces, is UTF-8
based representation of a message bytes.
- <li>The symbol ‘•’ designates a zero byte.
+ <li>The symbol &lsquo;&bull;&rsquo; designates a zero byte.
</ul>
<h1><a name='Design'>Framework Software Design Considerations</a></h1>
<p>The framework will be packaged, distributed and installed on a host as separate
product. It should be installed as system service and require no configuration for
-most common case – target connected over TCP or UDP on a local network. For more complicated
+most common case &ndash; target connected over TCP or UDP on a local network. For more complicated
setup, framework should have easily accessible and user friendly GUI with all relevant
configuration options.</p>
@@ -304,7 +304,7 @@ be asynchronous. Asynchronous functions do not have any return value, and return
immediately, most of the time before the intended job is done. They take additional
arguments to specify a callback function and callback data. In object-oriented languages
such as Java, this is typically done by a single callback object argument containing
-both the data and the function.  The result listener is called asynchronously when
+both the data and the function. The result listener is called asynchronously when
the job is done. This approach is commonly known as asynchronous<b>, </b>event-driven<b>
</b>or<b> </b>callback-based<b> </b>programming<b>.</b></p>
@@ -318,7 +318,7 @@ of Control (also known as the Hollywood Principle - "Don't call us, we'll call y
<p>Communication between development tools and embedded devices must allow a host
to collect target side data and build a reflection of target state. Reflection is
-usually incomplete – a subset of all remote data. Reflection is always delayed – it
+usually incomplete &ndash; a subset of all remote data. Reflection is always delayed &ndash; it
represents a remote peer state in the past. Reflection can be updated by polling for
data changes or by listening to events (event is communication message that is sent
asynchronously by a peer to notify others about state change). Reflection is correct
@@ -388,7 +388,7 @@ value 3.</p>
the client will know that command was executed <i>after</i> X was assigned 3, the
last message contains last known value of X and 2 is the correct value to show. If
the target is allowed to transmit events and results in arbitrary order, the client
-will have no clue what to show – 2 or 3. In fact, the client will have to make a tough
+will have no clue what to show &ndash; 2 or 3. In fact, the client will have to make a tough
decision about each message it receives: either trust message data as correct last
known target state, or assume the message came in out-of-order and ignore it, or re-request
the information from the target.</p>
@@ -411,7 +411,7 @@ coming in frequently, client can end up in infinite loop re-requesting the data
and again, and it will never have trustworthy data about current target state.</p>
<p>Developers should be careful when using multithreading or multiple queues in software
-design – it can easily cause message reordering.</p>
+design &ndash; it can easily cause message reordering.</p>
<p>The framework itself is required to preserve message order. However, if for whatever
reason a target agent cannot preserve message order, the result will be that clients
@@ -455,25 +455,25 @@ example:</p>
<li>Service Location Protocol (SLP), developed by the IETF;
- <li>Jini, which is Sun’s Java-base approach to service discovery, see <a href='http://www.sun.com/jini'>http://www.sun.com/jini</a>;
+ <li>Jini, which is Sun's Java-base approach to service discovery, see <a href='http://www.sun.com/jini'>http://www.sun.com/jini</a>;
<li>Salutation, developed by an open industry consortium, called the Salutation Consortium;
- <li>Microsoft’s Universal Plug and Play (UPnP), see <a href='http://www.upnp.org/'>http://www.upnp.org</a>;
+ <li>Microsoft's Universal Plug and Play (UPnP), see <a href='http://www.upnp.org/'>http://www.upnp.org</a>;
<li>Bluetooth Service Discovery Protocol (SDP).
</ul>
<p>Service discovery protocols, as well as transport protocols will be supported by
framework plug-ins, they are not part of framework code itself, and they can be developed
-by 3rd parties. Note that existing discovery protocols define term “service” differently
+by 3rd parties. Note that existing discovery protocols define term &ldquo;service&rdquo; differently
- as an independent communication endpoint (usually a TCP/IP port). In this document
-it is called “peer” (host, target, communication endpoint), and a peer can provide
+it is called &ldquo;peer&rdquo; (host, target, communication endpoint), and a peer can provide
multiple services over single communication channel.</p>
<p>Using of standard discovery protocols should be optional, because it can potentially
cause conflict or interference between development tools and application being developed
-over a use of same standard protocol – devices software often includes implementation
+over a use of same standard protocol &ndash; devices software often includes implementation
of service discovery protocols as part of application code to support their main functions.
</p>
@@ -487,9 +487,9 @@ packet is treated as array of bytes at this level. The communication protocol im
also provides:</p>
<ul type='disc'>
- <li>Multiplexing – opening multiple channels per peer.
+ <li>Multiplexing &ndash; opening multiple channels per peer.
- <li>Proxy – packet forwarding in behalf of other hosts.
+ <li>Proxy &ndash; packet forwarding in behalf of other hosts.
</ul>
<p>Protocol defines three packet types: commands (requests), results (responses),
@@ -501,24 +501,24 @@ using framework preferred marshaling for data formatting.</p>
<p>Syntax:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;message&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;command&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;result&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;event&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;flow control message&gt;</i>
+ &rArr; <i>&lt;command&gt;</i>
+ &rArr; <i>&lt;result&gt;</i>
+ &rArr; <i>&lt;event&gt;</i>
+ &rArr; <i>&lt;flow control message&gt;</i>
</font></b></pre>
<h2><a name='ProtocolCommands'>Commands</a></h2>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;command&gt;</i>
- <font face=Wingdings>Ψ</font> C • <i>&lt;token&gt; </i>• <i>&lt;service name&gt; </i>• <i>&lt;command name&gt; </i>• <i>&lt;byte array: arguments&gt;</i>
+ &rArr; C &bull; <i>&lt;token&gt; </i>&bull; <i>&lt;service name&gt; </i>&bull; <i>&lt;command name&gt; </i>&bull; <i>&lt;byte array: arguments&gt;</i>
</font></b></pre>
-<p>Command packets start with string “C”.</p>
+<p>Command packets start with string &ldquo;C&rdquo;.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;token&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt;</i>
+ &rArr; <i>&lt;chars&gt;</i>
</font></b></pre>
<p>Token is unique string generated by framework for each command. It is used to match
@@ -526,7 +526,7 @@ results to commands.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;service name&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt;</i>
+ &rArr; <i>&lt;chars&gt;</i>
</font></b></pre>
<p>Service name is used to identify a service that handles the command, it is same
@@ -534,13 +534,13 @@ string as returned by Service.getName().</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;command name&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt;</i>
+ &rArr; <i>&lt;chars&gt;</i>
</font></b></pre>
<p>Command name interpretation depends on a service.</p>
<p>A command should always be answered with result packed. Result does not have to
-be positive – it can include an error code, but there always must be one. Since client
+be positive &ndash; it can include an error code, but there always must be one. Since client
cannot detect that a response is missing, if for some reasons peer is not able to
answer a command, it should consider such situation a fatal communication error and
it must shutdown the communication channel. It is not necessary to wait for result
@@ -554,19 +554,19 @@ store the requests and time to process them.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;result&gt;</i>
- <font face=Wingdings>Ψ</font> R • <i>&lt;token&gt;</i> • <i>&lt;byte array: result data&gt;</i>
- <font face=Wingdings>Ψ</font> P • <i>&lt;token&gt;</i> • <i>&lt;byte array: result data&gt;</i>
+ &rArr; R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;byte array: result data&gt;</i>
+ &rArr; P &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;byte array: result data&gt;</i>
</font></b></pre>
-<p>Result packets start with string “P” for intermediate result and “R” for final
-result. Receiving of “R” result concludes execution of corresponding command.
-There should be exactly one “R” result for each command. In addition, command execution can produce any number of
-intermediate “P” results. “P” results can be sent before “R”, and it can serve, for
+<p>Result packets start with string &ldquo;P&rdquo; for intermediate result and &ldquo;R&rdquo; for final
+result. Receiving of &ldquo;R&rdquo; result concludes execution of corresponding command.
+There should be exactly one &ldquo;R&rdquo; result for each command. In addition, command execution can produce any number of
+intermediate &ldquo;P&rdquo; results. &ldquo;P&rdquo; results can be sent before &ldquo;R&rdquo;, and it can serve, for
example, as command execution progress report when execution takes long time.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;token&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt;</i>
+ &rArr; <i>&lt;chars&gt;</i>
</font></b></pre>
<p>Token should match token field of one of the pending commands that produced the result.</p>
@@ -575,14 +575,14 @@ example, as command execution progress report when execution takes long time.</p
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;event&gt;</i>
- <font face=Wingdings>Ψ</font> E • <i>&lt;service name&gt;</i> • <i>&lt;event name&gt;</i> • <i>&lt;byte array: event data&gt;</i>
+ &rArr; E &bull; <i>&lt;service name&gt;</i> &bull; <i>&lt;event name&gt;</i> &bull; <i>&lt;byte array: event data&gt;</i>
</font></b></pre>
-<p>Event packets start with string “E”.</p>
+<p>Event packets start with string &ldquo;E&rdquo;.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;service name&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt;</i>
+ &rArr; <i>&lt;chars&gt;</i>
</font></b></pre>
<p>Service name identifies a service that fired event, same string as returned by
@@ -590,7 +590,7 @@ Service.getName().</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;event name&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt;</i>
+ &rArr; <i>&lt;chars&gt;</i>
</font></b></pre>
<p>Event name meaning depends on a service.</p>
@@ -598,11 +598,11 @@ Service.getName().</p>
<p>Events are used to notify clients about changes in peer state. Services should
provide sufficient variety of events for clients to track remote peer state without
too much of polling. Clients, interested in a particular aspect of the target state,
-should have a “reflection” (or “model”) of that state and update the reflection by
+should have a &ldquo;reflection&rdquo; (or &ldquo;model&rdquo;) of that state and update the reflection by
listening for relevant events. If a service implements a command that changes a particular
aspect of peers state, then, normally, it should also generate notifications event
when that same part of the state changes and it should provide a command to retrieve
-current value of the state – to be used by clients to initialize the reflection. Service
+current value of the state &ndash; to be used by clients to initialize the reflection. Service
events are defined statically, together with commands. The framework does not do any
event processing besides delivering them to clients, however a service can define
additional event related functionality if necessary, for example, commands for event
@@ -627,10 +627,10 @@ to less detailed messages, etc.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;flow control message&gt;</i>
- <font face=Wingdings>Ψ</font> F • <i>&lt;int: traffic congestion level&gt;</i> •
+ &rArr; F &bull; <i>&lt;int: traffic congestion level&gt;</i> &bull;
</font></b></pre>
-<p>Traffic congestion level value is in range –100..100, where –100 means no pending
+<p>Traffic congestion level value is in range &ndash;100..100, where &ndash;100 means no pending
messages (no traffic), 0 means optimal load, and positive numbers
indicate level of congestion. When a peer receives flow control message with congestion level > 0
it should try to reduce its transmition speed.</p>
@@ -645,29 +645,29 @@ for actual data formats.</p>
<p>&nbsp;</p>
<pre>
-Send   :      C 1 RunControl suspend “Thread1”
-Receive:      E RunControl suspended “Thread1”
-Receive:      R 1 “Success”
+Send : C 1 RunControl suspend &ldquo;Thread1&rdquo;
+Receive: E RunControl suspended &ldquo;Thread1&rdquo;
+Receive: R 1 &ldquo;Success&rdquo;
</pre>
<p>Same command, but target was already suspended:</p>
<pre>
-Receive:      E RunControl suspended “Thread1”
-Send   :      C 2 RunControl suspend “Thread1”
-Receive:      R 2 “Already suspended”
+Receive: E RunControl suspended &ldquo;Thread1&rdquo;
+&hellip;
+Send : C 2 RunControl suspend &ldquo;Thread1&rdquo;
+Receive: R 2 &ldquo;Already suspended&rdquo;
</pre>
<p>Same command, but target was suspended (by another client) after sending the command,
but before command was executed: </p>
<pre>
-Receive:      E RunControl running “Thread1”
-Send   :      C 3 RunControl suspend “Thread1”
-Receive:      E RunControl suspended “Thread1”
-Receive:      R 3 “Already suspended”
+Receive: E RunControl running &ldquo;Thread1&rdquo;
+&hellip;
+Send : C 3 RunControl suspend &ldquo;Thread1&rdquo;
+Receive: E RunControl suspended &ldquo;Thread1&rdquo;
+Receive: R 3 &ldquo;Already suspended&rdquo;
</pre>
<h2><a name='API'>Framework API</a></h2>
@@ -681,10 +681,10 @@ Receive:      R 3 “Already suspended”
* 3. list of open communication channels.
*/</font>
<font color=#7F0055>public class</font> Protocol {
-    
-    <font color=#7F0055>private static</font> IEventQueue <i>event_queue</i>;
-    
-    <font color=#3F5FBF>/**
+
+ <font color=#7F0055>private static</font> IEventQueue <i>event_queue</i>;
+
+ <font color=#3F5FBF>/**
* Before TCF can be used it should be given an object implementing IEventQueue interface.
* The implementation maintains a queue of objects implementing Runnable interface and
* executes <code>run</code> methods of that objects in a sequence by a single thread.
@@ -697,92 +697,92 @@ Receive:      R 3 “Already suspended”
* invoked from the dispatch thread.
*
* <font color=#7F9FBF>@param</font> event_queue - IEventQueue implementation.
-     */</font>
-    <font color=#7F0055>public static void</font> setEventQueue(IEventQueue event_queue);
-   
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> instance of IEventQueue that should be used for TCF events.
-     */</font>
-    <font color=#7F0055>public static</font> IEventQueue getEventQueue();
-   
-    <font color=#3F5FBF>/**
-     * Returns true if the calling thread is TCF dispatch thread.
-     * Use this call to ensure that a given task is being executed (or not being)
-     * on dispatch thread.
-     * This method is thread-safe.
-     *
-     * <font color=#7F9FBF>@return</font> true if running on the dispatch thread.
-     */</font>
-    <font color=#7F0055>public static boolean</font> isDispatchThread();
-   
-    <font color=#3F5FBF>/**
-     * Causes runnable to have its run
-     * method called in the dispatch thread of the framework.
-     * Runnables are dispatched in same order as queued.
+ */</font>
+ <font color=#7F0055>public static void</font> setEventQueue(IEventQueue event_queue);
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> instance of IEventQueue that should be used for TCF events.
+ */</font>
+ <font color=#7F0055>public static</font> IEventQueue getEventQueue();
+
+ <font color=#3F5FBF>/**
+ * Returns true if the calling thread is TCF dispatch thread.
+ * Use this call to ensure that a given task is being executed (or not being)
+ * on dispatch thread.
+ * This method is thread-safe.
+ *
+ * <font color=#7F9FBF>@return</font> true if running on the dispatch thread.
+ */</font>
+ <font color=#7F0055>public static boolean</font> isDispatchThread();
+
+ <font color=#3F5FBF>/**
+ * Causes runnable to have its run
+ * method called in the dispatch thread of the framework.
+ * Runnables are dispatched in same order as queued.
* If invokeLater is called from the dispatching thread
* the <i>runnable.run()</i> will still be deferred until
* all pending events have been processed.
*
* This method can be invoked from any thread.
-     *
-     * <font color=#7F9FBF>@param runnable</font> the Runnable whose run
-     * method should be executed asynchronously.</font>
-     */</font>
-    <font color=#7F0055>public static void</font> invokeLater(Runnable runnable);
-   
-    <font color=#3F5FBF>/**
-     * Causes runnable to have its run
-     * method called in the dispatch thread of the framework.
-     * Calling thread is suspended util the method is executed.
-     * This method is thread-safe.
-     *
-     * <font color=#7F9FBF>@param runnable</font> the Runnable whose run
-     * method should be executed on dispatch thread.
-     */</font>
-    <font color=#7F0055>public static void</font> invokeAndWait(Runnable runnable)
-        <font color=#7F0055>throws</font> InterruptedException;
-   
-    <font color=#3F5FBF>/**
+ *
+ * <font color=#7F9FBF>@param runnable</font> the Runnable whose run
+ * method should be executed asynchronously.</font>
+ */</font>
+ <font color=#7F0055>public static void</font> invokeLater(Runnable runnable);
+
+ <font color=#3F5FBF>/**
+ * Causes runnable to have its run
+ * method called in the dispatch thread of the framework.
+ * Calling thread is suspended util the method is executed.
+ * This method is thread-safe.
+ *
+ * <font color=#7F9FBF>@param runnable</font> the Runnable whose run
+ * method should be executed on dispatch thread.
+ */</font>
+ <font color=#7F0055>public static void</font> invokeAndWait(Runnable runnable)
+ <font color=#7F0055>throws</font> InterruptedException;
+
+ <font color=#3F5FBF>/**
* Get instance of the framework locator service.
* The service can be used to discover available remote peers.
*
* @return instance of ILocator.
-     */</font>
+ */</font>
<font color=#7F0055>public static</font> ILocator getLocator();
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Return an array of all open channels.
* @return an array of IChannel
-     */</font>
+ */</font>
<font color=#7F0055>public static</font> IChannel[] getOpenChannels();
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Interface to be implemented by clients willing to be notified when
* new TCF communication channel is opened.
-     */</font>
+ */</font>
<font color=#7F0055>public interface</font> ChannelOpenListener {
<font color=#7F0055>public void</font> onChannelOpen(IChannel channel);
}
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Add a listener that will be notified when new channel is opened.
* @param listener
-     */</font>
+ */</font>
<font color=#7F0055>public static void</font> addChannelOpenListener(ChannelOpenListener listener);
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Remove channel opening listener.
* @param listener
-     */</font>
+ */</font>
<font color=#7F0055>public static void</font> removeChannelOpenListener(ChannelOpenListener listener);
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Transmit TCF event message.
- * The message is sent to all open communication channels – broadcasted.
-     */</font>
+ * The message is sent to all open communication channels &ndash; broadcasted.
+ */</font>
<font color=#7F0055>public static void</font> sendEvent(String service, String name, byte[] data);
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Call back after TCF messages sent by this host up to this moment are delivered
* to their intended target. This method is intended for synchronization of messages
* across multiple channels.
@@ -792,204 +792,204 @@ Receive:      R 3 “Already suspended”
*
* @param done will be executed by dispatch thread after communication
* messages are delivered to corresponding targets.
-     */</font>
+ */</font>
<font color=#7F0055>public static void</font> sync(Runnable done);
}
<font color=#3F5FBF>/**
- * IChannel represents communication link connecting two endpoints (peers).
- * The channel asynchroniously transmits messages: commands, results and events.
- * A single channel may be used to communicate with multiple services.
- * Multiple channels may be used to connect the same peers, however no command or event
- * ordering is guaranteed across channels.
- */</font>
+ * IChannel represents communication link connecting two endpoints (peers).
+ * The channel asynchroniously transmits messages: commands, results and events.
+ * A single channel may be used to communicate with multiple services.
+ * Multiple channels may be used to connect the same peers, however no command or event
+ * ordering is guaranteed across channels.
+ */</font>
<font color=#7F0055>public interface</font> IChannel {
-   
-    <font color=#3F5FBF>/**
-     * Channel state IDs
-     */</font>
-    <font color=#7F0055>static final</font> int
-        <i><font color=#0000C0>STATE_OPENNING</font></i> = 0,
-        <i><font color=#0000C0>STATE_OPEN</font></i> = 1,
-        <i><font color=#0000C0>STATE_CLOSED</font></i> = 2;
-   
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> channel current state, see STATE_*
-     */</font>
-    int getState();
-
-    <font color=#3F5FBF>/**
-     * Send command message to remote peer for execution. Commands can be queued
-     * locally before transmission. Sending commands too fast can fill up
-     * communication channel buffers. Calling thread will be blocked until
-     * enough buffer space is freed up by transmitting pending messages.
-     */</font>
-    IToken sendCommand(IService service, String name, <font color=#7F0055>byte</font>[] args,
-        ICommandListener done);
-
-    <font color=#3F5FBF>/**
-     * Command listener interface. Clients implement this interface
-     * to receive command results.
-     */</font>
-    <font color=#7F0055>interface</font> ICommandListener {
-       
-        <font color=#3F5FBF>/**
-         * Called when progress message (intermediate result) is received
-         * from remote peer.
-         */</font>
-        <font color=#7F0055>void</font> progress(<font color=#7F0055>byte</font>[] data);
-       
-        <font color=#3F5FBF>/**
-         * Called when command result received from remote peer.
-         */</font>
-        <font color=#7F0055>void</font> result(<font color=#7F0055>byte</font>[] data);
-    }
-
-    <font color=#3F5FBF>/**
-     * Send result message to remote peer. Messages can be queued locally before
-     * transmission. Sending messages too fast can fill up communication channel
-     * buffers. Calling thread will be blocked until enough buffer space is
-     * freed up by transmitting pending messages.
-     */</font>
-    <font color=#7F0055>void</font> sendResult(IToken token, <font color=#7F0055>byte</font>[] results);
-
-    <font color=#3F5FBF>/**
-     * Get current level of outbound traffic congestion.
-     *
-     * <font color=#7F9FBF>@return</font> integer value in range –100..100, where –100 means no pending
-     * messages (no traffic), 0 means optimal load, and positive numbers
-     * indicate level of congestion.
-     *
-     * Note: inbound traffic congestion is detected by framework and reported to
-     * remote peer without client needed to be involved.
-     */</font>
-    int getCongestion();
-
-    <font color=#3F5FBF>/**
-     * Channel listener interface.
-     */</font>
-    <font color=#7F0055>interface</font> IChannelListener {
-
-        <font color=#3F5FBF>/**
-         * Notifies listeners about congestion level changes. When level &gt; 0
-         * client should delay sending more messages.
-         */</font>
-        <font color=#7F0055>void</font> congestionLevel(int level);
-    }
-
-    <font color=#3F5FBF>/**
-     * Subscribe a channel listener. The listener will be notified about changes of
-     * outbound traffic congestion level.
-     */</font>
-    <font color=#7F0055>void</font> addChannelListener(IChannelListener listener);
-
-    <font color=#3F5FBF>/**
-     * Remove a channel listener.
-     */</font>
-    <font color=#7F0055>void</font> removeChannelListener(IChannelListener listener);
-
-    <font color=#3F5FBF>/**
-     * Command server interface.
-     * This interface is to be implemented by service providers.
-     */</font>
-    <font color=#7F0055>interface</font> ICommandServer {
-
-        <font color=#3F5FBF>/**
-         * Called every time a command is received from remote peer.
-         */</font>
-        <font color=#7F0055>void</font> command(IToken token, String name, <font color=#7F0055>byte</font>[] data);
-    }
-   
-    <font color=#3F5FBF>/**
-     * Subscribe a command server. The server will be notified about command
-     * messages received through this channel for given service.
-     */</font>
-    <font color=#7F0055>void</font> addCommandServer(IService service, ICommandServer listener);
-
-    <font color=#3F5FBF>/**
-     * Remove a command server.
-     */</font>
-    <font color=#7F0055>void</font> removeCommandServer(IService service, ICommandServer listener);
+
+ <font color=#3F5FBF>/**
+ * Channel state IDs
+ */</font>
+ <font color=#7F0055>static final</font> int
+ <i><font color=#0000C0>STATE_OPENNING</font></i> = 0,
+ <i><font color=#0000C0>STATE_OPEN</font></i> = 1,
+ <i><font color=#0000C0>STATE_CLOSED</font></i> = 2;
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> channel current state, see STATE_*
+ */</font>
+ int getState();
+
+ <font color=#3F5FBF>/**
+ * Send command message to remote peer for execution. Commands can be queued
+ * locally before transmission. Sending commands too fast can fill up
+ * communication channel buffers. Calling thread will be blocked until
+ * enough buffer space is freed up by transmitting pending messages.
+ */</font>
+ IToken sendCommand(IService service, String name, <font color=#7F0055>byte</font>[] args,
+ ICommandListener done);
+
+ <font color=#3F5FBF>/**
+ * Command listener interface. Clients implement this interface
+ * to receive command results.
+ */</font>
+ <font color=#7F0055>interface</font> ICommandListener {
+
+ <font color=#3F5FBF>/**
+ * Called when progress message (intermediate result) is received
+ * from remote peer.
+ */</font>
+ <font color=#7F0055>void</font> progress(<font color=#7F0055>byte</font>[] data);
+
+ <font color=#3F5FBF>/**
+ * Called when command result received from remote peer.
+ */</font>
+ <font color=#7F0055>void</font> result(<font color=#7F0055>byte</font>[] data);
+ }
+
+ <font color=#3F5FBF>/**
+ * Send result message to remote peer. Messages can be queued locally before
+ * transmission. Sending messages too fast can fill up communication channel
+ * buffers. Calling thread will be blocked until enough buffer space is
+ * freed up by transmitting pending messages.
+ */</font>
+ <font color=#7F0055>void</font> sendResult(IToken token, <font color=#7F0055>byte</font>[] results);
+
+ <font color=#3F5FBF>/**
+ * Get current level of outbound traffic congestion.
+ *
+ * <font color=#7F9FBF>@return</font> integer value in range &ndash;100..100, where &ndash;100 means no pending
+ * messages (no traffic), 0 means optimal load, and positive numbers
+ * indicate level of congestion.
+ *
+ * Note: inbound traffic congestion is detected by framework and reported to
+ * remote peer without client needed to be involved.
+ */</font>
+ int getCongestion();
+
+ <font color=#3F5FBF>/**
+ * Channel listener interface.
+ */</font>
+ <font color=#7F0055>interface</font> IChannelListener {
+
+ <font color=#3F5FBF>/**
+ * Notifies listeners about congestion level changes. When level &gt; 0
+ * client should delay sending more messages.
+ */</font>
+ <font color=#7F0055>void</font> congestionLevel(int level);
+ }
+
+ <font color=#3F5FBF>/**
+ * Subscribe a channel listener. The listener will be notified about changes of
+ * outbound traffic congestion level.
+ */</font>
+ <font color=#7F0055>void</font> addChannelListener(IChannelListener listener);
+
+ <font color=#3F5FBF>/**
+ * Remove a channel listener.
+ */</font>
+ <font color=#7F0055>void</font> removeChannelListener(IChannelListener listener);
+
+ <font color=#3F5FBF>/**
+ * Command server interface.
+ * This interface is to be implemented by service providers.
+ */</font>
+ <font color=#7F0055>interface</font> ICommandServer {
+
+ <font color=#3F5FBF>/**
+ * Called every time a command is received from remote peer.
+ */</font>
+ <font color=#7F0055>void</font> command(IToken token, String name, <font color=#7F0055>byte</font>[] data);
+ }
+
+ <font color=#3F5FBF>/**
+ * Subscribe a command server. The server will be notified about command
+ * messages received through this channel for given service.
+ */</font>
+ <font color=#7F0055>void</font> addCommandServer(IService service, ICommandServer listener);
+
+ <font color=#3F5FBF>/**
+ * Remove a command server.
+ */</font>
+ <font color=#7F0055>void</font> removeCommandServer(IService service, ICommandServer listener);
<font color=#3F5FBF>/**
-     * A generic interface for service event listener.
-     * Services usually define a service specific event listener interface,
-     * which is implemented using this generic listener.
-     * Service clients should use service specific listener interface,
-     * unless no such interface is defined.
-     */</font>
-    <font color=#7F0055>interface</font> IEventListener {
-        <font color=#7F0055>void</font> event(String name, <font color=#7F0055>byte</font>[] data);
-    }
-
-    <font color=#3F5FBF>/**
-     * Subscribe an event message listener for given service.
-     */</font>
-    <font color=#7F0055>void</font> addEventListener(IService service, IEventListener listener);
-
-    <font color=#3F5FBF>/**
-     * Unsubscribe an event message listener for given service.
-     */</font>
-    <font color=#7F0055>void</font> removeEventListener(IService service, IEventListener listener);
+ * A generic interface for service event listener.
+ * Services usually define a service specific event listener interface,
+ * which is implemented using this generic listener.
+ * Service clients should use service specific listener interface,
+ * unless no such interface is defined.
+ */</font>
+ <font color=#7F0055>interface</font> IEventListener {
+ <font color=#7F0055>void</font> event(String name, <font color=#7F0055>byte</font>[] data);
+ }
+
+ <font color=#3F5FBF>/**
+ * Subscribe an event message listener for given service.
+ */</font>
+ <font color=#7F0055>void</font> addEventListener(IService service, IEventListener listener);
+
+ <font color=#3F5FBF>/**
+ * Unsubscribe an event message listener for given service.
+ */</font>
+ <font color=#7F0055>void</font> removeEventListener(IService service, IEventListener listener);
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> IPeer object representing local endpoint of communication channel.
+ */</font>
+ IPeer getLocalPeer();
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> IPeer object representing remote endpoint of communication channel.
+ */</font>
+ IPeer getRemotePeer();
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> map of services available on local peer. It maps service names to
+ * IService implemetations.
+ */</font>
+ Map&lt;String, IService&gt; getLocalServices();
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> map of services available on removte peer. It maps service names to
+ * IService implemetations.
+ */</font>
+ Map&lt;String, IService&gt; getRemoteServices();
<font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> IPeer object representing local endpoint of communication channel.
-     */</font>
-    IPeer getLocalPeer();
-
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> IPeer object representing remote endpoint of communication channel.
-     */</font>
-    IPeer getRemotePeer();
-
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> map of services available on local peer. It maps service names to
-     * IService implemetations.
-     */</font>
-    Map&lt;String, IService&gt; getLocalServices();
-
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> map of services available on removte peer. It maps service names to
-     * IService implemetations.
-     */</font>
-    Map&lt;String, IService&gt; getRemoteServices();
-
-    <font color=#3F5FBF>/**
-     * Close communication channel.
-     */</font>
-    <font color=#7F0055>void</font> close();
-
-    <font color=#3F5FBF>/**
-     * Close channel in case of communication error.
-     * <font color=#7F9FBF>@param error</font>
-     */</font>
-    <font color=#7F0055>void</font> terminate(Throwable error);
-   
-    <font color=#3F5FBF>/**
-     * Redirect this channel to given peer using this channel remote peer
-     * locator service as a proxy.
-     * <font color=#7F9FBF>@param peer_id</font>
-     */</font>
-    <font color=#7F0055>void</font> redirect(String peer_id);
+ * Close communication channel.
+ */</font>
+ <font color=#7F0055>void</font> close();
+
+ <font color=#3F5FBF>/**
+ * Close channel in case of communication error.
+ * <font color=#7F9FBF>@param error</font>
+ */</font>
+ <font color=#7F0055>void</font> terminate(Throwable error);
+
+ <font color=#3F5FBF>/**
+ * Redirect this channel to given peer using this channel remote peer
+ * locator service as a proxy.
+ * <font color=#7F9FBF>@param peer_id</font>
+ */</font>
+ <font color=#7F0055>void</font> redirect(String peer_id);
}
<font color=#3F5FBF>/**
* Object implemeting IToken interface is created by framework for every
- * command sent over communication channel. It is used to match command to its
- * results, and also can be used to cancel commands.
- */</font>
+ * command sent over communication channel. It is used to match command to its
+ * results, and also can be used to cancel commands.
+ */</font>
<font color=#7F0055>public</font> interface IToken {
-   
-    <font color=#3F5FBF>/**
-     * Try to cancel a command associated with given token. A command can be
-     * canceled by this method only if it was not transmitted yet to remote peer
-     * for execution. Successfully canceled command does not produce any result
-     * messages.
-     *
-     * <font color=#7F9FBF>@return</font> true if successful.
-     */</font>
-    <font color=#7F0055>boolean</font> cancel();
+
+ <font color=#3F5FBF>/**
+ * Try to cancel a command associated with given token. A command can be
+ * canceled by this method only if it was not transmitted yet to remote peer
+ * for execution. Successfully canceled command does not produce any result
+ * messages.
+ *
+ * <font color=#7F9FBF>@return</font> true if successful.
+ */</font>
+ <font color=#7F0055>boolean</font> cancel();
}
</pre>
@@ -1034,82 +1034,82 @@ using UTF-8 encoding.</p>
<pre><b><font face="Courier New" size=2 color=#333399>
<i>&lt;object&gt;</i>
- <font face=Wingdings>Ψ</font> {}
- <font face=Wingdings>Ψ</font> { <i>&lt;members&gt;</i> }
+ &rArr; {}
+ &rArr; { <i>&lt;members&gt;</i> }
+
<i>&lt;members&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string&gt;</i> : <i>&lt;value&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;members&gt;</i> , <i>&lt;string&gt;</i> : <i>&lt;value&gt;</i>
+ &rArr; <i>&lt;string&gt;</i> : <i>&lt;value&gt;</i>
+ &rArr; <i>&lt;members&gt;</i> , <i>&lt;string&gt;</i> : <i>&lt;value&gt;</i>
<i>&lt;array&gt;</i>
- <font face=Wingdings>Ψ</font> []
- <font face=Wingdings>Ψ</font> [ <i>&lt;elements&gt;</i> ]
+ &rArr; []
+ &rArr; [ <i>&lt;elements&gt;</i> ]
<i>&lt;elements&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;value&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;elements</i>&gt; , <i>&lt;value&gt;</i>
+ &rArr; <i>&lt;value&gt;</i>
+ &rArr; <i>&lt;elements</i>&gt; , <i>&lt;value&gt;</i>
<i>&lt;value&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;string&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;number&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;object&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;array&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;boolean&gt;</i>
- <font face=Wingdings>Ψ</font> null
+ &rArr; <i>&lt;string&gt;</i>
+ &rArr; <i>&lt;number&gt;</i>
+ &rArr; <i>&lt;object&gt;</i>
+ &rArr; <i>&lt;array&gt;</i>
+ &rArr; <i>&lt;boolean&gt;</i>
+ &rArr; null
<i>&lt;boolean&gt;</i>
- <font face=Wingdings>Ψ</font> true
- <font face=Wingdings>Ψ</font> false
+ &rArr; true
+ &rArr; false
<i>&lt;string&gt;</i>
- <font face=Wingdings>Ψ</font> ""
- <font face=Wingdings>Ψ</font> " <i>&lt;chars&gt;</i> "
+ &rArr; ""
+ &rArr; " <i>&lt;chars&gt;</i> "
<i>&lt;chars&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;char&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;chars&gt; &lt;char&gt;</i>
+ &rArr; <i>&lt;char&gt;</i>
+ &rArr; <i>&lt;chars&gt; &lt;char&gt;</i>
<i>&lt;char</i>&gt;
- <font face=Wingdings>Ψ</font> <i>&lt;any Unicode except " or \ or control&gt;</i>
- <font face=Wingdings>Ψ</font> \"<i></i>
- <font face=Wingdings>Ψ</font> \\<i></i>
- <font face=Wingdings>Ψ</font> \/<i></i>
- <font face=Wingdings>Ψ</font> \b<i></i>
- <font face=Wingdings>Ψ</font> \f<i></i>
- <font face=Wingdings>Ψ</font> \n<i></i>
- <font face=Wingdings>Ψ</font> \r<i></i>
- <font face=Wingdings>Ψ</font> \t<i></i>
- <font face=Wingdings>Ψ</font> \u <i>&lt;four-hex-digits&gt;</i>
+ &rArr; <i>&lt;any Unicode except " or \ or control&gt;</i>
+ &rArr; \"<i></i>
+ &rArr; \\<i></i>
+ &rArr; \/<i></i>
+ &rArr; \b<i></i>
+ &rArr; \f<i></i>
+ &rArr; \n<i></i>
+ &rArr; \r<i></i>
+ &rArr; \t<i></i>
+ &rArr; \u <i>&lt;four-hex-digits&gt;</i>
<i>&lt;number</i>&gt;
- <font face=Wingdings>Ψ</font> <i>&lt;int&gt;</i>
- <font face=Wingdings>Ψ</font> &lt;<i>int&gt; &lt;fraction&gt;</i>
- <font face=Wingdings>Ψ</font> &lt;<i>int&gt; &lt;exponent&gt;</i>
- <font face=Wingdings>Ψ</font> &lt;<i>int&gt; &lt;fraction&gt; &lt;exponent&gt;</i>
+ &rArr; <i>&lt;int&gt;</i>
+ &rArr; &lt;<i>int&gt; &lt;fraction&gt;</i>
+ &rArr; &lt;<i>int&gt; &lt;exponent&gt;</i>
+ &rArr; &lt;<i>int&gt; &lt;fraction&gt; &lt;exponent&gt;</i>
+
<i>&lt;int&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;digit&gt;</i>
- <font face=Wingdings>Ψ</font> &lt;<i>digit 1-9&gt; &lt;digits&gt;</i>
- <font face=Wingdings>Ψ</font> - &lt;<i>digit&gt;</i>
- <font face=Wingdings>Ψ</font> - &lt;<i>digit 1-9&gt; &lt;digits</i>&gt;
+ &rArr; <i>&lt;digit&gt;</i>
+ &rArr; &lt;<i>digit 1-9&gt; &lt;digits&gt;</i>
+ &rArr; - &lt;<i>digit&gt;</i>
+ &rArr; - &lt;<i>digit 1-9&gt; &lt;digits</i>&gt;
<i>&lt;fraction&gt;</i>
- <font face=Wingdings>Ψ</font> . <i>&lt;digits&gt;</i>
+ &rArr; . <i>&lt;digits&gt;</i>
<i>&lt;exponent&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;e&gt;</i> <i>&lt;digits&gt;</i>
+ &rArr; <i>&lt;e&gt;</i> <i>&lt;digits&gt;</i>
<i>&lt;digits&gt;</i>
- <font face=Wingdings>Ψ</font> <i>&lt;digit&gt;</i>
- <font face=Wingdings>Ψ</font> &lt;<i>digits&gt;</i> &lt;<i>digit&gt;</i>
+ &rArr; <i>&lt;digit&gt;</i>
+ &rArr; &lt;<i>digits&gt;</i> &lt;<i>digit&gt;</i>
<i>&lt;e&gt;</i>
- <font face=Wingdings>Ψ</font> e
- <font face=Wingdings>Ψ</font> e+
- <font face=Wingdings>Ψ</font> e-
- <font face=Wingdings>Ψ</font> E
- <font face=Wingdings>Ψ</font> E+
- <font face=Wingdings>Ψ</font> E-
+ &rArr; e
+ &rArr; e+
+ &rArr; e-
+ &rArr; E
+ &rArr; E+
+ &rArr; E-
</font></b></pre>
@@ -1120,32 +1120,32 @@ using UTF-8 encoding.</p>
<p>This is a JSON array containing two objects:</p>
<pre>
-   [
-       {
-          "Precision": "zip",
-          "Latitude":  37.7668,
-          "Longitude": -122.3959,
-          "City":      "SAN FRANCISCO",
-          "State":     "CA",
-          "Zip":       "94107",
-          "Country":   "US"
-       },
-       {
-          "Precision": "zip",
-          "Latitude":  37.371991,
-          "Longitude": -122.026020,
-          "City":      "SUNNYVALE",
-          "State":     "CA",
-          "Zip":       "94085",
-          "Country":   "US"
-       }
-   ]
+ [
+ {
+ "Precision": "zip",
+ "Latitude": 37.7668,
+ "Longitude": -122.3959,
+ "City": "SAN FRANCISCO",
+ "State": "CA",
+ "Zip": "94107",
+ "Country": "US"
+ },
+ {
+ "Precision": "zip",
+ "Latitude": 37.371991,
+ "Longitude": -122.026020,
+ "City": "SUNNYVALE",
+ "State": "CA",
+ "Zip": "94085",
+ "Country": "US"
+ }
+ ]
</pre>
<h1><a name='Locator'>Locator Service</a></h1>
<p>Locator Service uses transport layer to search for peers and to collect data about
-peer’s attributes and capabilities (services).  Discovery mechanism depends on transport
+peer's attributes and capabilities (services). Discovery mechanism depends on transport
protocol and is part of that protocol handler. Targets, known by other hosts, are
added to local list of peers. <font color=red>Security? </font>Automatically discovered
targets require no further configuration. Additional targets can be configured manually.</p>
@@ -1196,7 +1196,7 @@ at services it implements (use IChannel.getRemoteServices() method to get a map
<h3><a name='LocatorCommandRedirect'>redirect</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Locator • redirect • <i>&lt;string: peer ID&gt;</i> •
+C &bull; <i>&lt;token&gt;</i> &bull; Locator &bull; redirect &bull; <i>&lt;string: peer ID&gt;</i> &bull;
</font></b></pre>
<p>The command redirects the channel to become connected to given peer.
@@ -1205,13 +1205,13 @@ Locator service starts acting as a proxy.</p>
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> • <i>&lt;error report&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull; <i>&lt;error report&gt;</i> &bull;
</font></b></pre>
<h3><a name='LocatorCommandSync'>sync</a></h3>
<pre><b><font face="Courier New" size=2 color=#333399>
-C • <i>&lt;token&gt;</i> • Locator • sync •
+C &bull; <i>&lt;token&gt;</i> &bull; Locator &bull; sync &bull;
</font></b></pre>
<p>Sync command does nothing and simply returns back an empty result. The command is used for
@@ -1221,16 +1221,16 @@ for sync result a client makes sure that all commands, that were issued before s
<p>Reply:</p>
<pre><b><font face="Courier New" size=2 color=#333399>
-R • <i>&lt;token&gt;</i> •
+R &bull; <i>&lt;token&gt;</i> &bull;
</font></b></pre>
<h2><a name='LocatorEvents'>Locator Service Events</a></h2>
<pre><b><font face="Courier New" size=2 color=#333399>
-E • Locator • Hello • <i>&lt;array: service names&gt;</i> •
-E • Locator • peerAdded • <i>&lt;object: peer data&gt;</i> •
-E • Locator • peerChanged • <i>&lt;object: peer data&gt;</i> •
-E • Locator • peerRemoved • <i>&lt;string: peer ID&gt;</i> •
+E &bull; Locator &bull; Hello &bull; <i>&lt;array: service names&gt;</i> &bull;
+E &bull; Locator &bull; peerAdded &bull; <i>&lt;object: peer data&gt;</i> &bull;
+E &bull; Locator &bull; peerChanged &bull; <i>&lt;object: peer data&gt;</i> &bull;
+E &bull; Locator &bull; peerRemoved &bull; <i>&lt;string: peer ID&gt;</i> &bull;
</font></b></pre>
<dl>
@@ -1254,86 +1254,86 @@ E • Locator • peerRemoved • <i>&lt;string: peer ID&gt;</i> •
<pre>
<font color=#3F5FBF>/**
- * Base interface for all service interfaces.
- * A client can get list of available services by
- * calling IPeer.getLocalServices or IPeer.getRemoteServives
- */</font>
+ * Base interface for all service interfaces.
+ * A client can get list of available services by
+ * calling IPeer.getLocalServices or IPeer.getRemoteServives
+ */</font>
<font color=#7F0055>public</font> interface IService {
-    <font color=#3F5FBF>/**
-     * Get unique name of this service.
-     */</font>
-    String getName();
+ <font color=#3F5FBF>/**
+ * Get unique name of this service.
+ */</font>
+ String getName();
}
<font color=#3F5FBF>/**
- * Both hosts and targets are represented by objects
- * implementing IPeer interface. A peer can act as host or
- * target depending on services it implements.
- * List of currently known peers can be retrieved by
- * calling ILocator.getPeers
- */</font>
+ * Both hosts and targets are represented by objects
+ * implementing IPeer interface. A peer can act as host or
+ * target depending on services it implements.
+ * List of currently known peers can be retrieved by
+ * calling ILocator.getPeers
+ */</font>
<font color=#7F0055>public interface</font> IPeer {
-   
-    <font color=#7F0055>static final</font> String
-        <i><font color=#0000C0>ATTR_ID</font></i> = <font color=#2A00FF>"ID"</font>,
-        <i><font color=#0000C0>ATTR_NAME</font></i> = <font color=#2A00FF>"Name"</font>,
-        <i><font color=#0000C0>ATTR_OS_NAME</font></i> = <font color=#2A00FF>"OSName"</font>,
-        <i><font color=#0000C0>ATTR_TRANSPORT_NAME</font></i> = <font color=#2A00FF>"TransportName"</font>,
-        <i><font color=#0000C0>ATTR_IP_HOST</font></i> = <font color=#2A00FF>"Host"</font>,
-        <i><font color=#0000C0>ATTR_IP_ALIASES</font></i> = <font color=#2A00FF>"Aliases"</font>,
-        <i><font color=#0000C0>ATTR_IP_ADDRESSES</font></i> = <font color=#2A00FF>"Addresses"</font>,
-        <i><font color=#0000C0>ATTR_IP_PORT</font></i> = <font color=#2A00FF>"Port"</font>;
-           
-   
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> map of peer attributes
-     */</font>
-    Map&lt;String, String&gt; getAttributes();
-
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> peer unique ID, same as getAttributes().get(ATTR_ID)
-     */</font>
-    String getID();
-
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> peer name, same as getAttributes().get(ATTR_NAME)
-     */</font>
-    String getName();
-
-    <font color=#3F5FBF>/**
-     * Same as getAttributes().get(ATTR_OS_NAME)
-     */</font>
-    String getOSName();
-
-    <font color=#3F5FBF>/**
-     * Same as getAttributes().get(ATTR_TRANSPORT_NAME)
-     */</font>
-    String getTransportName();
-
-    <font color=#3F5FBF>/**
-     * Open channel to communicate with this peer.
-     * Note: the channel is not fully open yet when this method returns.
-     * It’s state is IChannel.STATE_OPENNING.
-     * Protocol.Listener will be called when the channel will be opened or closed.
-     */</font>
-    IChannel openChannel() <font color=#7F0055>throws</font> IOException;
+
+ <font color=#7F0055>static final</font> String
+ <i><font color=#0000C0>ATTR_ID</font></i> = <font color=#2A00FF>"ID"</font>,
+ <i><font color=#0000C0>ATTR_NAME</font></i> = <font color=#2A00FF>"Name"</font>,
+ <i><font color=#0000C0>ATTR_OS_NAME</font></i> = <font color=#2A00FF>"OSName"</font>,
+ <i><font color=#0000C0>ATTR_TRANSPORT_NAME</font></i> = <font color=#2A00FF>"TransportName"</font>,
+ <i><font color=#0000C0>ATTR_IP_HOST</font></i> = <font color=#2A00FF>"Host"</font>,
+ <i><font color=#0000C0>ATTR_IP_ALIASES</font></i> = <font color=#2A00FF>"Aliases"</font>,
+ <i><font color=#0000C0>ATTR_IP_ADDRESSES</font></i> = <font color=#2A00FF>"Addresses"</font>,
+ <i><font color=#0000C0>ATTR_IP_PORT</font></i> = <font color=#2A00FF>"Port"</font>;
+
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> map of peer attributes
+ */</font>
+ Map&lt;String, String&gt; getAttributes();
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> peer unique ID, same as getAttributes().get(ATTR_ID)
+ */</font>
+ String getID();
+
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> peer name, same as getAttributes().get(ATTR_NAME)
+ */</font>
+ String getName();
+
+ <font color=#3F5FBF>/**
+ * Same as getAttributes().get(ATTR_OS_NAME)
+ */</font>
+ String getOSName();
+
+ <font color=#3F5FBF>/**
+ * Same as getAttributes().get(ATTR_TRANSPORT_NAME)
+ */</font>
+ String getTransportName();
+
+ <font color=#3F5FBF>/**
+ * Open channel to communicate with this peer.
+ * Note: the channel is not fully open yet when this method returns.
+ * It's state is IChannel.STATE_OPENNING.
+ * Protocol.Listener will be called when the channel will be opened or closed.
+ */</font>
+ IChannel openChannel() <font color=#7F0055>throws</font> IOException;
}
<font color=#3F5FBF>/**
- * ILocator service uses transport layer to search for peers and to collect data about
- * peer’s attributes and capabilities (services). Discovery mechanism depends on
- * transport protocol and is part of that protocol handler. Targets, known by other
- * hosts, are added to local list of peers.
- * Automatically discovered targets require no further configuration. Additional targets
- * can be configured manually.
- *
- * Clients should use Protocol.getLocator() to obtain local instance of ILocator,
- * then ILocator.getPeers() can be used to get of available peers (hosts and targets).
- */</font>
+ * ILocator service uses transport layer to search for peers and to collect data about
+ * peer's attributes and capabilities (services). Discovery mechanism depends on
+ * transport protocol and is part of that protocol handler. Targets, known by other
+ * hosts, are added to local list of peers.
+ * Automatically discovered targets require no further configuration. Additional targets
+ * can be configured manually.
+ *
+ * Clients should use Protocol.getLocator() to obtain local instance of ILocator,
+ * then ILocator.getPeers() can be used to get of available peers (hosts and targets).
+ */</font>
<font color=#7F0055>public interface</font> ILocator <font color=#7F0055>extends</font> IService {
-   
-    <font color=#7F0055>static final</font> String <i><font color=#0000C0>NAME</font></i> = <font color=#2A00FF>"Locator"</font>;
+
+ <font color=#7F0055>static final</font> String <i><font color=#0000C0>NAME</font></i> = <font color=#2A00FF>"Locator"</font>;
<font color=#3F5FBF>/**
* Auto-configuration command and response codes.
@@ -1342,28 +1342,28 @@ E • Locator • peerRemoved • <i>&lt;string: peer ID&gt;</i> •
<i><font color=#0000C0>CONF_REQ_INFO</font></i> = 1,
<i><font color=#0000C0>CONF_PEER_INFO</font></i> = 2;
-    <font color=#3F5FBF>/**
-     * <font color=#7F9FBF>@return</font> Locator service name: "Locator"
-     */</font>
-    String getName();
+ <font color=#3F5FBF>/**
+ * <font color=#7F9FBF>@return</font> Locator service name: "Locator"
+ */</font>
+ String getName();
-    <font color=#3F5FBF>/**
+ <font color=#3F5FBF>/**
* Get map (ID -> IPeer) of available peers (hosts and targets).
* The method return cached (currently known to the framework) list of peers.
* The list is updated according to event received from transport layer
-     */</font>
-    Map&lt;String,IPeer&gt; getPeers();
-
-    <font color=#3F5FBF>/**
-     * Redirect this service channel to given peer using this service as a proxy.
-     */</font>
-    IToken redirect(String peer_id, DoneRedirect done);
-   
-    <font color=#7F0055>interface</font> DoneRedirect {
-        <font color=#7F0055>void</font> doneRedirect(IToken token, Exception error);
-    }
-
-    <font color=#3F5FBF>/**
+ */</font>
+ Map&lt;String,IPeer&gt; getPeers();
+
+ <font color=#3F5FBF>/**
+ * Redirect this service channel to given peer using this service as a proxy.
+ */</font>
+ IToken redirect(String peer_id, DoneRedirect done);
+
+ <font color=#7F0055>interface</font> DoneRedirect {
+ <font color=#7F0055>void</font> doneRedirect(IToken token, Exception error);
+ }
+
+ <font color=#3F5FBF>/**
* Call back after TCF messages sent to this target up to this moment are delivered.
* This method is intended for synchronization of messages
* across multiple channels.
@@ -1382,23 +1382,23 @@ E • Locator • peerRemoved • <i>&lt;string: peer ID&gt;</i> •
<font color=#7F0055>void</font> doneSync(IToken token);
}
-    <font color=#3F5FBF>/**
-     * Add a listener for locator service events.
-     */</font>
-    <font color=#7F0055>void</font> addListener(Listener listener);
+ <font color=#3F5FBF>/**
+ * Add a listener for locator service events.
+ */</font>
+ <font color=#7F0055>void</font> addListener(Listener listener);
-    <font color=#3F5FBF>/**
-     * Remove a listener for locator service events.
-     */</font>
-    <font color=#7F0055>void</font> removeListener(Listener listener);
+ <font color=#3F5FBF>/**
+ * Remove a listener for locator service events.
+ */</font>
+ <font color=#7F0055>void</font> removeListener(Listener listener);
-    <font color=#7F0055>interface</font> Listener {
-        <font color=#7F0055>void</font> peerAdded(IPeer peer);
+ <font color=#7F0055>interface</font> Listener {
+ <font color=#7F0055>void</font> peerAdded(IPeer peer);
-        <font color=#7F0055>void</font> peerRemoved(IPeer peer);
+ <font color=#7F0055>void</font> peerRemoved(IPeer peer);
-        <font color=#7F0055>void</font> peerChanged(IPeer peer);
-    }
+ <font color=#7F0055>void</font> peerChanged(IPeer peer);
+ }
}
</pre>

Back to the top