Copyright (c) 2007, 2008 Wind River Systems, Inc. Made available under the EPL v1.0
Direct comments, questions to the dsdp-tm-dev@eclipse.org mailing list
Eclipse can be used for developing clients for TCF in Java. TCF host side code is organized into several Eclipse plug-in projects, below are steps to create and populate Eclipse workspace with TCF projects:
eclipse.exe -vm <JDK path>\bin\javaw.exe -data <Workspace path> -vmargs -Xmx200M
TCF plugins source code is stored in <TCF Root>\plugins
directory.
<TCF Root>/examples/org.eclipse.tm.tcf.examples.daytime.agent
for example code of a customized TCF agent, which implements DayTime service.
Linux is the recommended evaluation platform, since most TCF services are implemented. To build the agent:
elfutils-libelf-devel
is installed.
On Fedora, it can be installed by command:
yum install elfutils-libelf-develIt also can be built and installed from source code, e.g. http://www.mr511.de/software/libelf-0.8.9.tar.gz:
./configure make make install setenv LD_LIBRARY_PATH /usr/local/lib:$LD_LIBRARY_PATH
make
command in <TCF Root>/agent
directory.
./agent
command.
On Windows, SysMonitor service is not implemented, so RSE Processes demos will not work. For building the agent, there are two possibilities:
make -fMakefile_cygwin.makin the agent directory (the Makefile works with mingw, too).
<TCF Root>/agent/agent.dsw
and then build and run the agent using Development Studio commands. If getting an error about
IPHlpApi.h missing, you'll need to install the latest
MS Platform SDK.
For the free Visual C++ Express Edition, the
following changes in settings may be necessary:On VxWorks, the file service as well as most debug services are currently
working. Line number mapping and the SysMonitor service (required for RSE Processes
Demo) are not yet implemented.
To build the agent: Use Wind River Workbench 3.0 and VxWorks 6.6 to create a Kernel Module
project out of source code in <TCF Root>/agent
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.
On Windows, open Project Properties of the agent project, and under C/C++ General > Indexer switch the configuration to "Win32 - Cygwin" or "Win32 - DevStudio" as needed.
For VxWorks, browsing should be configured automatically through the WR Workbench Kernel Module Project.
Remote System Explorer is an Eclipse based component that allows users to create connections to remote machines and explore their file systems, see list of processes and access some other resources, like remote shells. 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.
Plugin org.eclipse.tm.tcf.rse enables use of Processes 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.
To connect a remote machine over TCF:
RSE features supported by TCF connection:
Plugins org.eclipse.tm.tcf.debug and org.eclipse.tm.tcf.debug.ui allow to start a debug session by connecting to a machine runnning TCF agent. This is not a complete debugger implementation, it is intended for demo and reference purposes.
To start a debug session over TCF:
In TCF debug session only "Debug", "Breakpoints" and "Registers" views are populated. Source level debugging in not supported at this time. Breakpoints can be planted at an absolute addresses only, using menu command "Run/Toggle Breakpoint". "Registers" view can be brought in by "Window > Show View > Registers". Registers can be shown only for top stack frame.