diff options
Diffstat (limited to 'docs/TCF Services.html')
-rw-r--r-- | docs/TCF Services.html | 108 |
1 files changed, 108 insertions, 0 deletions
diff --git a/docs/TCF Services.html b/docs/TCF Services.html new file mode 100644 index 000000000..38377555c --- /dev/null +++ b/docs/TCF Services.html @@ -0,0 +1,108 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> + <title>Target Communication Framework Services</title> +</head> + +<body lang='EN-US'> + +<h1>Target Communication Framework Services</h1> + +<p>Copyright (c) 2007 Wind River Systems, Inc. Made available under the EPL v1.0 +<p>Direct comments, questions to the <a href="mailto:dsdp-tm-dev@eclipse.org">dsdp-tm-dev@eclipse.org</a> mailing list + +<h2>Table of Contents</h2> +<ul> + <li><a href='#Overview'>Overview</a> + <li><a href='#Syntax'>Syntax Rules Notation</a> + <li><a href='#ErrorFormat'>Error Report Format</a> + <li><a href='#Services'>Services</a> +</ul> + +<h2><a name='Overview'>Overview</a></h2> + +TCF communication model is based on the idea of services. A service is a group of related commands, events and semantics. +For example, <a href='TCF Service - Memory.html'>Memory Service</a> defines group of command and events for +reading and writing target memory. +Service definitions are not part of the <a href='TCF Specification.html'>framework specification</a>, and new services +are expected to be defined by developers of tools and target agents. +Defenitions of standard services are provided to achieve certain level of compatibility between tools and targets. + +<h2><a name='Syntax'>Syntax Rules Notation</a></h2> + +<p>Format of the protocol messages is defined by syntax rules. Syntax is described +using a simple variant of Backus-Naur Form. In particular:</p> + +<ul type='disc'> + <li>Italic lower case words in a courier font, enclosed into angular brackets, are + used to denote syntactic categories, for example: <b><i><font face="Courier New" size=2 color=#333399><token>. + </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><int: + error code></font></i></b> has same meaning as <b><i><font face="Courier New" size=2 color=#333399><int></font></i></b>, + but denotes that the integer number used to indicate an "error code". + + <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: +</ul> + +<pre><b><font face="Courier New" size=2 color=#333399> +<i><chars></i> + <font face=Wingdings>Ø</font> <i><char></i> + <font face=Wingdings>Ø</font> <i><chars> <char></i> +</font></b></pre> + +<ul type='disc'> + <li>Spaces are added for readability only and they are not part of the syntax. + + <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. +</ul> + +<h2><a name='ErrorFormat'>Error Report Format</a></h2> + +<p>Most of TCF standard services use same format for error reporting:</p> + +<pre><b><font face="Courier New" size=2 color=#333399> +<i><error report></i> + <font face=Wingdings>Ø</font> <i><int: error code></i> • <i><error description></i> +</font></b></pre> + +<p>Error code zero means success. Error description provides a short, localizable, +human readable explanation of error.</p> + +<pre><b><font face="Courier New" size=2 color=#333399> +<i><error description></i> + <font face=Wingdings>Ø</font> null + <font face=Wingdings>Ø</font> <i><string></i> + <font face=Wingdings>Ø</font> { "format" : <i><string></i> , "params" : [ <i><params></i> ] } + +<i><params></i> + <font face=Wingdings>Ø</font> <i><value></i> + <font face=Wingdings>Ø</font> <i><params></i> , <i><value></i> +</font></b></pre> + +<p>For <b><i><font face="Courier New" size=2 color=#333399><string></font></i></b> +and <b><i><font face="Courier New" size=2 color=#333399><value></font></i></b> encoding see +<a href='TCF Specification.html#JSON'>JSON - Preferred Marshaling</a>. +Error description format supports separation between constant and variable parts +of the message ("format" and "params"). This is done to support localization. See +Java class <b><font face="Courier New" size=2>java.text.MessageFormat</font></b> for details.</p> + +<h2><a name='Services'>Services</h2> +<ul> + <li><a href='TCF Service - Memory.html'>Memory Service</a> + <li><a href='TCF Service - Processes.html'>Processes Service</a> + <li><a href='TCF Service - Run Control.html'>Run Control Service</a> + <li><a href='TCF Service - Registers.html'>Registers Service</a> + <li><a href='TCF Service - Stack Trace.html'>Stack Trace Service</a> + <li><a href='TCF Service - Breakpoints.html'>Breakpoints Service</a> + <li><a href='TCF Service - File System.html'>File System Service</a> + <li><a href='TCF Service - System Monitor.html'>System Monitor Service</a> +</ul> + +</body> +</html> +
\ No newline at end of file |