Skip to main content
aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorEugene Tarassov2012-05-07 15:11:22 -0400
committerEugene Tarassov2012-05-07 15:11:22 -0400
commit0256694371b12b0952ee6aa27975b501d33a35b2 (patch)
treef80453d0aa667c950005c6b289483b1ba1df8563 /docs
parent166e86d082196b5927b23ba14d4d981eada1b244 (diff)
downloadorg.eclipse.tcf-0256694371b12b0952ee6aa27975b501d33a35b2.tar.gz
org.eclipse.tcf-0256694371b12b0952ee6aa27975b501d33a35b2.tar.xz
org.eclipse.tcf-0256694371b12b0952ee6aa27975b501d33a35b2.zip
TCF Docs: updated TCF Getting Started
Diffstat (limited to 'docs')
-rw-r--r--docs/TCF Getting Started.html52
1 files changed, 37 insertions, 15 deletions
diff --git a/docs/TCF Getting Started.html b/docs/TCF Getting Started.html
index b3fa2a759..551d32a23 100644
--- a/docs/TCF Getting Started.html
+++ b/docs/TCF Getting Started.html
@@ -17,6 +17,7 @@
<li><a href='#Plugins'>TCF Plugins</a>
<li><a href='#TE_Plugins'>Target Explorer Plugins</a>
<li><a href='#Agent'>Building TCF Agent</a>
+ <li><a href='#TcfPython'>TCF Integration with Python</a>
<li><a href='#TcfLua'>TCF Integration with Lua</a>
<li><a href='#Browsing'>Browsing Agent Source Code in CDT</a>
<li><a href='#TE'>Using TCF With Target Explorer</a>
@@ -43,17 +44,17 @@ below are steps to create and populate Eclipse workspace with TCF projects:</p>
<a href='http://download.eclipse.org/tm/downloads/'>http://download.eclipse.org/tm/downloads/</a>
</ul>
<li>Clone TCF Java code from <a href='http://git.eclipse.org/c/tcf/org.eclipse.tcf.git'>Eclipse GIT repository</a>, using one of the following commands:
- <pre>
+ <pre>
git clone git://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.git
git clone ssh://&lt;user&gt;@git.eclipse.org/gitroot/tcf/org.eclipse.tcf.git
git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.git
- </pre>
+ </pre>
<li>Run Eclipse:
<pre>eclipse.exe -vm &lt;JDK path&gt;/bin/javaw.exe -data &lt;Workspace path&gt; -vmargs -Xmx400M</pre>
<li>Open "Java" perspective.
<li>In "Package Explorer" view: do right click and then select "Import...".
<li>Select "General/Existing Projects into Workspace" and click "Next".
- <li>Select root directory: &lt;TCF Root&gt;\plugins, and click "Next".
+ <li>Select root directory: &lt;TCF Root&gt;/plugins, and click "Next".
<ul>
<li>If CDT is not installed, don't import the following plugins into your workspace:
<ul>
@@ -68,8 +69,8 @@ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.git
<h2><a name='Plugins'>TCF Plugins</a></h2>
-<p>TCF plugins source code is stored in <code>&lt;TCF Root&gt;\plugins</code> directory.<br>
-Examples source code is stored in <code>&lt;TCF Root&gt;\examples</code> directory.
+<p>TCF plugins source code is stored in <code>&lt;TCF Root&gt;/plugins</code> directory.<br>
+Examples source code is stored in <code>&lt;TCF Root&gt;/examples</code> directory.
<dl>
<dt><b>org.eclipse.tcf</b>
@@ -105,13 +106,13 @@ Examples source code is stored in <code>&lt;TCF Root&gt;\examples</code> directo
<p>Pre-built TCF plugins are available at Eclipse Update site/p2 repositories. The repositories can be accessed from Eclipse using Help/Install New Software command.
<ul>
- <li>TCF 0.4 maintenance build: http://download.eclipse.org/tools/cdt/releases/indigo
- <li>TCF 1.0 nightly build: http://download.eclipse.org/tools/tcf/builds/juno/nightly
+ <li>TCF 0.4 maintenance build: http://download.eclipse.org/tools/cdt/releases/indigo
+ <li>TCF 1.0 nightly build: http://download.eclipse.org/tools/tcf/builds/juno/nightly
</ul>
<h2><a name='TE_Plugins'>Target Explorer Plugins</a></h2>
-<p>Target Explorer plugins source code is stored in the <code>&lt;TCF Root&gt;\target_explorer\plugins</code> directory.
+<p>Target Explorer plugins source code is stored in the <code>&lt;TCF Root&gt;/target_explorer/plugins</code> directory.
<p>Target Explorer 1.0 nightly build: http://download.eclipse.org/tools/tcf/builds/juno/nightly
<h2><a name='Agent'>Building TCF Agent</a></h2>
@@ -138,7 +139,7 @@ CDT .project file is located in <code>&lt;TCF Root&gt;/agent</code> directory.
<li>Building with gcc (freely available from <a href="http://wascana.sourceforge.net/">Wascana</a>,
<a href="http://www.cygwin.com">Cygwin</a> or the
<a href="http://www.mingw.org/">MinGW32 project</a>): run
-<pre>make</pre> or <pre>make SYSOP=Msys</pre>
+<pre>make</pre> or <pre>make OPSYS=Msys</pre>
in the agent directory.</li>
<li>Building with Microsoft Visual C++:
@@ -155,14 +156,18 @@ following changes in settings may be necessary:<ul>
</ul></li>
</ul></p>
-<p>On <b>VxWorks</b>, line number mapping and the SysMonitor service (needed for RSE Processes
-Demo) are not yet implemented.<br/>
+<p>On <b>VxWorks</b>, the SysMonitor service (needed for RSE Processes Demo) is not yet implemented.<br/>
To build the agent: Use Wind River Workbench 3.0 or 3.1, and VxWorks 6.6 or 6.7 to create a Kernel Module
project out of source code in <code>&lt;TCF Root&gt;/agent</code> directory. Use Workbench
commands to build and run the agent. To run the agent on VxWorks Simulator
you will need to setup a simulated network - see Networking with the VxWorks Simulator chapter
in Wind River VxWorks Simulator user's guide for details.</p>
+<h2><a name='TcfPython'>TCF Integration with Python</a></h2>
+
+<p>The TCF integration with Python allows writing TCF client and server programs in the Python programming lanugage.
+TCF Python code is stored in &lt;TCF Root&gt;/python directory.
+
<h2><a name='TcfLua'>TCF Integration with Lua</a></h2>
<p>The TCF integration with Lua allows writing TCF client and server programs in the Lua programming lanugage.
@@ -186,7 +191,10 @@ framework. The focus is on TCF remote system management, but is by no means limi
with full remote file system and remote process support, and allows to connect a terminal to the remote system using
TCF, SSH, Telnet and serial line.
-<p>Import all <b>org.eclipse.tcf.te.*</b> plug-in's to enable the Target Explorer.
+<p>If building from source, import all <b>org.eclipse.tcf.te.*</b> plug-in's to enable the Target Explorer.
+
+<p>Since Eclipse version 3.8, Target Explorer is available for download from main Eclipse p2 repository.
+The feature name is "Mobile and Device Development / Target Explorer, TCF".
<p>To connect a remote machine over TCF:</p>
<ul>
@@ -209,7 +217,10 @@ TCF, SSH, Telnet and serial line.
<h2><a name='Debugger'>Using TCF With Eclipse Debugger</a></h2>
<p>Plugins <b>org.eclipse.tcf.debug</b> and <b>org.eclipse.tcf.debug.ui</b> allow to start a debug session
-by connecting to a machine runnning TCF agent.
+by connecting to a machine runnning TCF agent. Plugin <b>org.eclipse.tcf.cdt.ui</b> handles integration of the debugger with CDT UI.
+
+<p>Since Eclipse version 3.8, TCF Debugger is available for download from main Eclipse p2 repository.
+The feature name is "Mobile and Device Development / Target Communication Framework, CDT Extender".
<p>To start a debug session over TCF:</p>
<ul>
@@ -226,7 +237,14 @@ by connecting to a machine runnning TCF agent.
<li>Press "Debug" to start the debugger.
</ul>
-<p>In TCF debug session "Debug", "Breakpoints", "Registers", "Variables" and "Expressions" views are populated.
+<p>The TCF Debugger implements advanced, asynchronous, transaction based retrieval and caching of remote data.
+The technology allows excellent data coherency and communication performance.
+
+<p>The debugger fully supports multi-threaded, multi-process, multi-core, whole system and multi-system debugging in a single debug session.
+
+<p>In TCF debug session, "Debug", "Breakpoints", "Registers", "Variables", "Expressions", "Memory" and "Modules" views are populated by the TCF debugger.
+"Disassembly" view and instruction level stepping are available if the agent supports it. Reverse execution is available if the agent supports it.
+TCF Trace view can be used to display TCF communication traffic. Remote process standard I/O is redirected to the Console view.
Source level debugging is fully supported.
</p>
@@ -237,9 +255,12 @@ explore their file systems, see list of processes and access some other resource
Remote System Explorer has been designed as a flexible, extensible framework to which Eclipse plug-in developers can
contribute their own system definitions, actions, etc.</p>
-<p>Plugin <b>org.eclipse.tcf.rse</b> enables use of Processes and Files subsystems of Remote System Explorer over TCF.
+<p>Plugin <b>org.eclipse.tcf.rse</b> enables use of Processes, Shells, Terminals and Files subsystems of Remote System Explorer over TCF.
It also extends Processes subsystem to include CPU utilization data and some other process attributes in RSE views.</p>
+<p>Since Eclipse version 3.8, TCF-RSE is available for download from main Eclipse p2 repository.
+The feature name is "Mobile and Device Development / Target Communication Framework, RSE Extender".
+
<p>To connect a remote machine over TCF:</p>
<ul>
<li>Make sure TCF agent is running on remote machine.
@@ -256,6 +277,7 @@ It also extends Processes subsystem to include CPU utilization data and some oth
<ul>
<li>File Subsystem: full support, i.e. browse, upload, download, copy, move, delete
<li>Processes: browse, including parent/child relationship
+ <li>Terminals and Shells: supported, but without authentication, TCF terminal and shell inherit credentials of the TCF agent.
</ul>
</body>

Back to the top