--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+ <name>org.eclipse.linuxtools.lttng.feature</name>
+ <comment></comment>
+ <projects>
+ </projects>
+ <buildSpec>
+ <buildCommand>
+ <name>org.eclipse.pde.FeatureBuilder</name>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ </buildSpec>
+ <natures>
+ <nature>org.eclipse.pde.FeatureNature</nature>
+ </natures>
+</projectDescription>
--- /dev/null
+bin.includes = feature.xml
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="Compile org.eclipse.linuxtools.lttng.feature" default="main">
+ <target name="main">
+ <ant antfile="build.xml" dir="../org.eclipse.linuxtools.lttng" target="build.jars"/>
+ <ant antfile="build.xml" dir="../org.eclipse.linuxtools.lttng.ui" target="build.jars"/>
+ </target>
+</project>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<feature
+ id="org.eclipse.linuxtools.lttng.feature"
+ label="Linux Tracing Toolkit"
+ version="0.1.0.qualifier"
+ os="linux">
+
+ <description url="http://www.example.com/description">
+ [Enter Feature Description here.]
+ </description>
+
+ <copyright url="http://www.example.com/copyright">
+ [Enter Copyright Description here.]
+ </copyright>
+
+ <license url="http://www.example.com/license">
+ [Enter License Description here.]
+ </license>
+
+ <requires>
+ <import feature="org.eclipse.linuxtools.tmf.feature" version="0.1.0.qualifier"/>
+ </requires>
+
+ <plugin
+ id="org.eclipse.linuxtools.lttng"
+ download-size="0"
+ install-size="0"
+ version="0.0.0"
+ unpack="false"/>
+
+ <plugin
+ id="org.eclipse.linuxtools.lttng.ui"
+ download-size="0"
+ install-size="0"
+ version="0.0.0"
+ unpack="false"/>
+
+</feature>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+ <name>org.eclipse.linuxtools.lttng.help</name>
+ <comment></comment>
+ <projects>
+ </projects>
+ <buildSpec>
+ <buildCommand>
+ <name>org.eclipse.pde.ManifestBuilder</name>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ <buildCommand>
+ <name>org.eclipse.pde.SchemaBuilder</name>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ </buildSpec>
+ <natures>
+ <nature>org.eclipse.pde.PluginNature</nature>
+ </natures>
+</projectDescription>
--- /dev/null
+Manifest-Version: 1.0
+Bundle-ManifestVersion: 2
+Bundle-Name: LTTng Help
+Bundle-SymbolicName: org.eclipse.linuxtools.lttng.help; singleton:=true
+Bundle-Version: 0.1.0.qualifier
+Bundle-Vendor: Ericsson
--- /dev/null
+bin.includes = plugin.xml,\
+ META-INF/,\
+ html/,\
+ *.xml
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Control Flow View</title>
+</head>
+
+<body>
+<h1>Control Flow View</h1>
+<p>It shows a process table of the traced system as well as the state transitions over time</p>
+<p>The dotted vertical lines in the state area represent "more information" i.e. There is at least one state that could not be represented in one pixel with the current scale</p>
+
+<p>The tool bar options from right to left are:</p>
+<dl>
+<dt>Home</dt>
+<dd>Reset the time scale to Default</dd>
+<p></p>
+<dt>Next Event</dt>
+<dd>Moves to the next event over the highlighted process</dd>
+<p></p>
+<dt>Previous Event</dt>
+<dd>Moves to the previous event overt the highlighted process</dd>
+<p></p>
+<dt>Next Process</dt>
+<dd>Moves from the currently highlighted process to the next down in the list</dd>
+<p></p>
+<dt>Previous Process</dt>
+<dd>Moves from the currently highlighted process to the next up in the list</dd>
+<p></p>
+<dt>Zoom In</dt>
+<dd>Maintains the same width while reducing the visible time range in order to see a bigger representation of the states</dd>
+<p></p>
+<dt>Zoom Out</dt>
+<dd>Maintains the same width while increasing the visible time range in order to see a smaller representation of the states</dd>
+<p></p>
+<dt>Synchronize</dt>
+<dd><ul><li>Notify time selections to synchronized views</li><li>Listens and apply time selections from other synchronized views</li></ul></dd>
+
+</dl>
+<p>Note: Due to the large size of the LTTng traces, this view does not keep all state information in memory</p>
+<br> <img alt="Control Flow View" src="../images/controlFlowView2.png" width="1059" height="343">
+
+<p>Additional mouse controls</p>
+<dl>
+<dt>Mouse Scroll wheel</dt>
+<dd>
+<ul>
+<li>Forward - One Zoom In order per step</li>
+<li>Backward - One Zoom Out order per step</li>
+</ul>
+</dd>
+<dt>Mouse drag</dt>
+<dd>
+<ul>
+<li>States Area - Moves the time window in the direction of the drag keeping current scale</li>
+<li>Time Scale Area - Changes the time scale to the time range from the start to the end of the drag action</li>
+</ul>
+</dd>
+<dt>Mouse Hovering</dt>
+<dd>Hovering the mouse selection over a state will trigger a tooltip display with additional information,
+including the start and end times as well as the name of the state associated to the color</dd>
+
+</dl>
+<br> <img alt="Control Flow View hover tool tip" src="../images/controlFlowViewTooltip.png">
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Events View</title>
+</head>
+
+<body>
+<h1>Events View</h1>
+<p>
+The Events views shows the basic experiment data in chronological order in
+a tabular format. The following fields are displayed:
+<ul>
+<li>Timestamp: the event timestamp
+<li>Source: the component that generated the event
+<li>Type: the event type
+<li>Reference: the trace that holds the event
+<li>Content: the raw event content
+</ul>
+<p>
+
+<br> <img alt="Events View" src="../images/eventsView.png">
+
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Experiment</title>
+</head>
+
+<body>
+<h1>Experiment</h1>
+<p>
+An experiment consists in an arbitrary number of aggregated
+<a href="trace.html">LTTng traces</a>. In the degenerate case, an experiment
+can consist of a single trace.
+<p>
+The experiment provides a unified, time-ordered stream of the individual LTTng
+trace events.
+<p>
+Since the individual traces are likely to have unsynchronized clocks (or at
+least skewed with respect to each other), the experiment supports a timestamp
+adjustment scheme that synchronizes all the events against a common reference
+clock. This simplifies events correlation between traces.
+
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Main Topic</title>
+</head>
+
+<body>
+<h1>LTTng</h1>
+LTTng is a kernel tracer for Linux. It helps tracking down performance issues and debugging problems involving multiple concurrent processes and threads.
+<br>Its trace analysis counterpart, The LTTng Eclipse plug-in, permits to analyze and show the traces gathered by LTTng.
+
+<br><br> <img alt="Lttng in Eclipse" src="../images/lttngEclipse1.png">
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>LTTv</title>
+</head>
+
+<body>
+<h1>LTTv</h1>
+<p>LTTv is the former trace analysis counterpart of LTTng</p>
+<p>The LTTng Eclipse plug-in replaces LTTv by providing its analysis features in the Eclipse framework</p>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Perspective</title>
+</head>
+
+<body>
+<h1>LTTng perspective</h1>
+<p>
+The screenshot below shows the LTTng perspective. It holds the following specific views:
+<ul>
+<li><a href="projectView.html">Project View</a>
+<li><a href="controlFlowView.html">Control Flow View</a>
+<li><a href="resourcesView.html">Resources View</a>
+<li><a href="statisticsView.html">Statistics View</a>
+<li><a href="timeFrameView.html">Time Frame View</a>
+<li><a href="eventsView.html">Events View</a>
+<li>Histogram View (not implemented)
+<li>Control View (not implemented)
+</ul>
+<p>
+The analysis views are synchronized i.e. selecting a raw event, a timestamp, etc,
+will position the other views accordingly.
+<p>
+
+<br> <img alt="LTTng Perspective" src="../images/perspective.png">
+
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Project View</title>
+</head>
+
+<body>
+<h1>Project View</h1>
+<p>
+The project view displays the LTTng projects of the current workspace.
+<p>
+Two folders are always present: <code>Traces</code> and <code>Experiments</code>.
+<p>
+<br> <img alt="Project View" src="../images/projectView.png">
+<p>
+<br>
+The <code>Traces</code> folder holds the set of traces available for experiments.
+Traces are imported in the LTTng project using an import wizard triggered by a
+context menu.
+<p>
+<u>Note</u>: An LTTng trace is actually a composite of multiple channel traces grouped
+under a folder. It is the <u>folder</u> that has to be imported.
+<p>
+<br> <img alt="Import Traces" src="../images/importTraces.png">
+<p>
+The <code>Experiment</code> folder holds the set of experiments of the project.
+Experiments are created from the <code>Experiment</code> context menu and are
+configured from the experiment's context menu.
+<p>
+<br> <img alt="Select Traces" src="../images/selectTraces.png">
+
+
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+\r
+<html>\r
+<head>\r
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">\r
+ <title>Resources View</title>\r
+</head>\r
+\r
+<body>\r
+<h1>Resources View</h1>\r
+<p>It shows a resources list of the traced system as well as the state transitions over time</p>\r
+<p>The dotted vertical lines in the state area represent "more information" i.e. There is at least one state that could not be represented in one pixel with the current scale</p>\r
+\r
+<p>The tool bar options from right to left are:</p>\r
+<dl>\r
+<dt>Home</dt>\r
+<dd>Reset the time scale to Default</dd>\r
+<p></p>\r
+<dt>Next Event</dt>\r
+<dd>Moves to the next event over the highlighted process</dd>\r
+<p></p>\r
+<dt>Previous Event</dt>\r
+<dd>Moves to the previous event overt the highlighted process</dd>\r
+<p></p>\r
+<dt>Next Resource</dt>\r
+<dd>Moves from the currently highlighted resource to the next down in the list</dd>\r
+<p></p>\r
+<dt>Previous Resource</dt>\r
+<dd>Moves from the currently highlighted resource to the next up in the list</dd>\r
+<p></p>\r
+<dt>Zoom In</dt>\r
+<dd>Maintains the same width while reducing the visible time range in order to see a bigger representation of the states</dd>\r
+<p></p>\r
+<dt>Zoom Out</dt>\r
+<dd>Maintains the same width while increasing the visible time range in order to see a smaller representation of the states</dd>\r
+<p></p>\r
+<dt>Synchronize</dt>\r
+<dd><ul><li>Notify time selections to synchronized views</li><li>Listens and apply time selections from other synchronized views</li></ul></dd>\r
+\r
+</dl> \r
+<p>Note: Due to the large size of the Lttng traces, this view does not keep all state information in memory</p>\r
+<br> <img alt="Resources View" src="../images/resourcesView1.png">\r
+\r
+<p>Additional mouse controls</p>\r
+<dl>\r
+<dt>Mouse Scroll wheel</dt>\r
+<dd>\r
+<ul>\r
+<li>Forward - One Zoom In order per step</li>\r
+<li>Backward - One Zoom Out order per step</li>\r
+</ul>\r
+</dd>\r
+<dt>Mouse drag</dt>\r
+<dd>\r
+<ul>\r
+<li>States Area - Moves the time window in the direction of the drag keeping current scale</li>\r
+<li>Time Scale Area - Changes the time scale to the time range from the start to the end of the drag action</li>\r
+</ul>\r
+</dd>\r
+<dt>Mouse Hovering</dt>\r
+<dd>Hovering the mouse selection over a state will trigger a tooltip display with additional information, \r
+including the start and end times as well as the name of the state associated to the color</dd>\r
+\r
+</dl>\r
+<br> <img alt="Resources View hover tool tip" src="../images/resourcesTooltip.png">\r
+</body>\r
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+\r
+<html>\r
+<head>\r
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">\r
+ <title>Statistics View</title>\r
+</head>\r
+\r
+<body>\r
+<h1>Statistics View</h1>\r
+<p>This view represents in a tree format the multiple statistics related to the current <a href="experiment.html">Experiment</a>.</p>\r
+\r
+<br> <img alt="Statistics View" src="../images/statistics1.png">\r
+\r
+</body>\r
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Time Frame View</title>
+</head>
+
+<body>
+<h1>Time Frame View</h1>
+<p>
+This view displays some general time characteristics about the selected
+experiment. All times are expressed in seconds (sec) and nanoseconds (ns).
+
+<ul>
+<li>Start Time
+<ul>
+<li>The start time of the interval of interest
+<li>Can take any value within the experiment time range
+<li>Initial value: the timestamp of the first event
+</ul>
+
+<li>End Time
+<ul>
+<li>The end time of the interval of interest
+<li>Can take any value within the experiment time range
+<li>Initial value: the timestamp of the last event
+</ul>
+
+<li>Interval
+<ul>
+<li>The interval length (End Time - Start Time)
+<li>Can take any value between 0 and the experiment time range
+<li>Initial value: the experiment time range
+</ul>
+
+<li>Current time
+<ul>
+<li>The currently selected time
+<li>Can take any value between Start Time and End Time
+<li>Initial value: Start Time
+</ul>
+
+</ul>
+
+The times can be modified, within their valid range, using the spinner buttons.
+Additionally, the Current Time can be modified by using the slider bar.
+<p>
+
+<br> <img alt="Time Frame View" src="../images/timeFrameView.png">
+
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Concepts</title>
+</head>
+
+<body>
+<h1>Concepts</h1>
+ <ul>
+ <li><a href="toc_general.html"> General</a></li>
+ <li><a href="toc_userInterface.html"> User Interface</a></li>
+ </ul>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>General</title>
+</head>
+
+<body>
+<h1>General</h1>
+<ul>
+ <li><a href="lttng.html"> LTTng</a></li>
+ <li><a href="lttv.html"> LTTv</a></li>
+ <li><a href="trace.html">Trace</a></li>
+ <li><a href="experiment.html">Experiment</a></li>
+</ul>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>User Interface</title>
+</head>
+
+<body>
+<h1>User Interface</h1>
+<ul>
+ <li><a href="perspective.html"> Perspective</a></li>
+ <li><a href="projectView.html"> Project View</a></li>
+ <li><a href="eventsView.html"> Events View</a></li>
+ <li><a href="timeFrameView.html"> Time Frame View</a></li>
+ <li><a href="controlFlowView.html"> Control Flow View</a></li>
+ <li><a href="resourcesView.html"> Resources View</a></li>
+ <li><a href="statisticsView.html"> Statistics View</a></li>
+</ul>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Trace</title>
+</head>
+
+<body>
+<h1>Trace</h1>
+<p>
+Tracing is a technique used to understand what is going on in a system in
+order to debug or monitor it. A tracer is the software used for tracing.
+Tracing can be used to debug a wide range of bugs that are otherwise extremely
+challenging. These include, for example, performance problems in complex
+parallel systems or real-time systems.
+<p>
+Tracing is similar to logging: it consists in recording events that happen
+in a system. However, compared to logging, it usually records much lower-level
+events that occur much more frequently. Tracers must therefore be optimized
+to handle a lot of data while having a small impact on the system. Tracers
+typically generate thousands of events per second. They frequently contain
+millions of events and have sizes from many megabytes to tens of gigabytes.
+<p>
+Traces may include events from the operating system kernel (IRQ handler
+entry/exit, system call entry/exit, scheduling activity, network activity,
+etc). They may also include events from any application.
+<p>
+The list of events of a trace may be read manually like a log file, for the
+maximum level of detail. However, trace analyzers and viewers are available
+to produce graphs and statistics from this enormous amount of data. These
+programs must be specially designed to handle quickly the enormous amount of
+data traces contain.
+<p>
+In the case of LTTng, low tracing overhead is achieved by instrumenting the
+Linux kernel with a set of custom patches. The same set of patches can be
+used for both Linux kernel as well as user space (i.e application) tracing.
+<p>
+Refer to the <a href="http://lttng.org">LTTng Project</a> for more information
+on tracing and LTTng.
+<p>
+In the scope of the Linux Tools LTTng project, a trace is essentially a (very)
+large set of time-ordered LTTng events. The LTTng set of plugins accepts these
+traces and provides a number of standard views to analyze their contents
+either individually or through an <a href="experiment.html">experiment</a>.
+
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+ <TITLE>Main Topic</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.1 (Linux)">
+ <META NAME="CREATED" CONTENT="0;0">
+ <META NAME="CHANGED" CONTENT="20091008;17334500">
+</HEAD>
+<BODY LANG="en-CA" DIR="LTR">
+<H1>Samples</H1>
+<P>The following LTTng traces are provided as reference examples.
+</P>
+<P>Each trace as its own feature and complexity. The size given
+refers to the size of the trace once "untarred", the actual tar size
+should be around 10 times smaller.
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="http://dev.eclipse.org/viewsvn/index.cgi/lttng/trunk/org.eclipse.linuxtools.lttng.tests/traceset/trace-1021events-nolost-1cpu.tar.gz?root=Technology_LINUXTOOLS&view=co">trace-1021events-nolost-1cpu
+ (2.1MB)</A>
+ </P>
+ <P STYLE="margin-bottom: 0cm">Very small trace made from a single
+ marker. Recorded under a VirtualBox system with 1 processor.</P>
+ <P STYLE="margin-bottom: 0cm"></P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="http://dev.eclipse.org/viewsvn/index.cgi/lttng/trunk/org.eclipse.linuxtools.lttng.tests/traceset/trace-399747events-nolost-1cpu.tar.gz?root=Technology_LINUXTOOLS&view=co">trace-399747events-nolost-1cpu
+ (28MB)</A>
+ </P>
+ <P STYLE="margin-bottom: 0cm">Trace of several markers, that has no
+ lost event. Recorded under VirtualBox with 1 processor.</P>
+ <P STYLE="margin-bottom: 0cm"></P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="http://dev.eclipse.org/viewsvn/index.cgi/lttng/trunk/org.eclipse.linuxtools.lttng.tests/traceset/trace-618339events-1293lost-1cpu.tar.gz?root=Technology_LINUXTOOLS&view=co">trace-618339events-1293lost-1cpu
+ (11MB)</A></P>
+ <P STYLE="margin-bottom: 0cm">Trace of several markers, with some
+ lost events. Recorded under VirtualBox with 1 processor.</P>
+ <P STYLE="margin-bottom: 0cm"></P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="http://dev.eclipse.org/viewsvn/index.cgi/lttng/trunk/org.eclipse.linuxtools.lttng.tests/traceset/trace-698650events_3029lost-8CPU.tar.gz?root=Technology_LINUXTOOLS&view=co">trace-698650events_3029lost-8CPU
+ (41MB)</A> <FONT COLOR="#ff0000"><B>(Multi-cpu is currently
+ experimental)</B></FONT></P>
+ <P STYLE="margin-bottom: 0cm">Trace of several markers, with some
+ lost events. Recorded on a native system with 8 processors.</P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<P STYLE="margin-bottom: 0cm">The smaller is the trace, the faster it
+will load in Eclipse. All traces should load correctly, but only the
+first one and the third one were extensively tested.
+</P>
+<P STYLE="margin-bottom: 0cm">Note that recording of a new trace
+directly in Eclipse is currently work under progress. If you would
+like to record your own trace, you need to install LTTng kernel
+patches and LTTv application.
+</P>
+<P STYLE="margin-bottom: 0cm">You can get more information about that
+at <A HREF="http://www.lttng.org/">http://www.lttng.org</A>.
+</P>
+</BODY>
+</HTML>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Getting Started</title>
+</head>
+
+<body>
+<h1>Getting Started</h1>
+<p>The following steps will help you start the analysis of an LTTng example trace</p>
+
+<ol>
+ <li>See introduction to <a href="lttng.html">LTTng </a> under the
+ concepts section.</li>
+ <li>Obtain LTTng traces to the file system <br>
+ Link References to Examples are available from section <a href="samples.html">Samples</a></li>
+ <li>Open the <a href="../concepts/lttng.html">LTTng
+ perspective</a> from the Eclipse menu <br>
+ Windows -> Open <a href="../concepts/perspective.html">Perspective</a>
+ -> Other -> LTTng</li>
+ <li>Add a New LTTng Project<br>
+ Right click from the Project View</li>
+ <li>Import LTTng traces from the file system to the LTTng project<br>
+ Right click on the Traces folder and select the location</li>
+ <li>Add a new <a href="../concepts/experiment.html">Experiment</a><br>
+ Right click on the Experiments Folder</li>
+ <li>Add Traces to the Experiment<br>
+ Right click on an Experiment folder</li>
+ <li>Populate the LTTng views with the Experiment data<br>
+ Double click on an Experiment folder</li>
+</ol>
+
+<br> <img alt="Lttng in Eclipse" src="../images/lttngEclipse1.png">
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Getting Started</title>
+</head>
+
+<body>
+<h1>Getting Started</h1>
+<ul>
+ <li><a href="starting.html"> General</a></li>
+ <li><a href="samples.html"> Samples</a></li>
+</ul>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+ <TITLE>Limitations</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.1 (Linux)">
+ <META NAME="CREATED" CONTENT="0;0">
+ <META NAME="CHANGED" CONTENT="20091008;18193600">
+</HEAD>
+<BODY LANG="en-CA" DIR="LTR">
+<H1>Limitations</H1>
+<P>The current implementation is still under heavy development and
+some important features are still missing.<BR>Here is a list of the
+known bugs and missing features that are worked on.</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>Thread issues affect
+ performance</B></P>
+ <P STYLE="margin-bottom: 0cm; font-weight: normal">The multi-thread
+ access to the traces is mostly turned off for now so the user might
+ experiment a very long load time when opening a trace and/or
+ zooming. Of course, this is especially true for big trace.</P>
+ <P STYLE="margin-bottom: 0cm"><SPAN STYLE="font-weight: normal">In
+ the future, the traces with be opened and indexed asynchronously,
+ with the result of greatly improved performance.</SPAN></P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>No support for individual traces</B></P>
+ <P STYLE="margin-bottom: 0cm">The code for loading and parsing an individual
+ trace (not part of an experiment) is currently disabled. As a workaround,
+ just create an experiment with the single trace you want to analyze.
+ </P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>One trace per experiment is
+ currently supported</B></P>
+ <P STYLE="margin-bottom: 0cm">Work to be able to merge and index
+ several traces into a single experiment have not being completed
+ yet.
+ </P>
+ <P STYLE="margin-bottom: 0cm">In the future, it will be possible to
+ process several traces at once and to compare them in the views.</P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>Time Frame View</B></P>
+ <P STYLE="margin-bottom: 0cm">In some cases, the End Time of the Time
+ Frame view is not set correctly (symptom: the nanoseconds are identical
+ to the Start Time nanoseconds and the Interval nanoseconds = 0).
+ <P STYLE="margin-bottom: 0cm">
+ To set it properly, just spin up the End Time seconds field.
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>Simultaneous data requests</B></P>
+ <P STYLE="margin-bottom: 0cm">All views are currently working on a
+ standalone basis. Therefore, time selection synchronization among
+ views does not trigger simultaneous data requests, which heavily
+ hurts the performance of the application.
+ </P>
+ <P STYLE="margin-bottom: 0cm">In the future, data request will be
+ centralized in the application, resulting in better response time in
+ and between views.</P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>No trace recording capability
+ in Eclipse yet</B></P>
+ <P STYLE="margin-bottom: 0cm">It is not currently possible to record
+ a new trace directly in Eclipse, an user that would like to record a
+ new trace would need to use external tools, like LTTv.</P>
+ <P STYLE="margin-bottom: 0cm">In the future, a “Control view”
+ will be provided for the user to allow him to easily a new trace
+ inside Eclipse. It should also be possible to start the recording on
+ a remote host from that view.</P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>Experimental Multi-CPU support</B></P>
+ <P STYLE="margin-bottom: 0cm">Although working, some more work need
+ to be done on trace that handle multiple processors. It is reputed
+ to work already but this feature is mostly untested for now.</P>
+ <P STYLE="margin-bottom: 0cm">In the future, multi-CPU should be
+ supported and work as well as uni-CPU traces.</P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>Experimental 64 bits and/or non
+ x86 architecture implementation</B></P>
+ <P STYLE="margin-bottom: 0cm">The code used to read and parse files
+ have not been extensively tested on 64 bits and was not tested at
+ all on architecture different than x86 computer. The code is
+ believed to work on a broad horizon of architecture but this cannot
+ be certified for now.</P>
+ <P STYLE="margin-bottom: 0cm">In the future, all x86 (32 and 64
+ bits) as well as all PPC (32 and 64 bits) should work and possibly
+ some (all?) models of SPARC.
+ </P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>Missing filters and ordering on
+ all views</B></P>
+ <P STYLE="margin-bottom: 0cm">There is currently no way to filter
+ events following some criteria or to dynamically sort the different
+ fields.
+ </P>
+ <P STYLE="margin-bottom: 0cm">In the future, both should be
+ implemented.
+ </P>
+</UL>
+<P STYLE="margin-bottom: 0cm"><BR>
+</P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><B>Some views missing and/or need
+ more work</B></P>
+ <P>Some more views (“Control”, “Histogram”,
+ etc...) are currently missing but planned in the Eclipse
+ implementation and some others (“Statistics”) are
+ working but need more work to be brought were they need to be.<BR>In
+ the future, all views provided by LTTv will be supported in Eclipse
+ and more!</P>
+</UL>
+<P><BR><BR>
+</P>
+</BODY>
+</HTML>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<title>Limitations</title>
+</head>
+
+<body>
+<h1>Limitations</h1>
+<ul>
+ <li><a href="limitations.html"> Limitations</a></li>
+</ul>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+ <TITLE>References</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.1 (Linux)">
+ <META NAME="CREATED" CONTENT="0;0">
+ <META NAME="CHANGED" CONTENT="20091008;18210200">
+</HEAD>
+<BODY LANG="en-CA" DIR="LTR">
+<H1>References</H1>
+<UL>
+ <LI><A HREF="http://www.eclipse.org/linuxtools/projectPages/lttng/">Linux
+ Tools Project - LTTng Integration</A></LI>
+
+ <LI><A HREF="http://www.lttng.org/">LTTng
+ Project</A></LI>
+
+ <LI><A HREF="http://lttng.org/cgi-bin/gitweb.cgi?p=lttv.git;a=blob_plain;f=LTTngManual.html">LTTng
+ Manual</A> </LI>
+
+</UL>
+</BODY>
+</HTML>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Reference</title>
+</head>
+
+<body>
+<h1>Reference</h1>
+<ul>
+ <li><a href="references.html"> References</a></li>
+</ul>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Table of Contents</title>
+</head>
+
+<body>
+<h1>Table of Contents</h1>
+<ul>
+ <li><a href="concepts/toc_concepts.html"> Concepts</a>
+ <ul>
+ <li><a href="concepts/toc_general.html"> General </a>
+ <ul>
+ <li><a href="concepts/lttng.html"> LTTng</a></li>
+ <li><a href="concepts/lttv.html"> LTTv</a></li>
+ <li><a href="concepts/trace.html">Trace</a></li>
+ <li><a href="concepts/experiment.html">Experiment</a></li>
+ </ul>
+ </li>
+ <li><a href="concepts/toc_userInterface.html"> User Interface </a>
+ <ul>
+ <li><a href="concepts/perspective.html"> Perspective</a></li>
+ <li><a href="concepts/projectView.html"> Project View</a></li>
+ <li><a href="concepts/eventsView.html"> Events View</a></li>
+ <li><a href="concepts/timeFrameView.html"> Time Frame View</a></li>
+ <li><a href="concepts/controlFlowView.html"> Control Flow
+ View</a></li>
+ <li><a href="concepts/resourcesView.html"> Resources View</a></li>
+ <li><a href="concepts/statisticsView.html"> Statistics View</a></li>
+ </ul>
+ </li>
+ </ul>
+
+ </li>
+ <li><a href="gettingstarted/toc_gettingStarted.html"> Getting Started</a>
+ <ul>
+ <li><a href="gettingstarted/starting.html"> General</a></li>
+ <li><a href="gettingstarted/samples.html"> Samples</a></li>
+ </ul>
+ </li>
+
+ <li><a href="limitations/toc_limitations.html"> Limitations </a>
+ <ul>
+ <li><a href="limitations/limitations.html"> Limitations</a></li>
+ </ul>
+ </li>
+
+ <li><a href="reference/toc_reference.html"> Reference </a>
+ <ul>
+ <li><a href="reference/references.html"> References</a></li>
+ </ul>
+ </li>
+</ul>
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<?eclipse version="3.4"?>
+<plugin>
+
+ <extension
+ point="org.eclipse.help.toc">
+ <toc
+ file="toc.xml"
+ primary="true">
+ </toc>
+ <toc
+ file="tocconcepts.xml">
+ </toc>
+ <toc
+ file="tocgettingstarted.xml">
+ </toc>
+ <toc
+ file="tocreference.xml">
+ </toc>
+ <toc
+ file="toclimitations.xml">
+ </toc>
+ </extension>
+
+</plugin>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<?NLS TYPE="org.eclipse.help.toc"?>
+
+<toc label="LTTng User Guide" topic="html/toc.html">
+ <topic label="Concepts">
+ <anchor id="concepts"/>
+ </topic>
+ <topic label="Getting Started">
+ <anchor id="gettingstarted"/>
+ </topic>
+ <topic label="Limitations">
+ <anchor id="limitations"/>
+ </topic>
+ <topic label="Reference">
+ <anchor id="reference"/>
+ </topic>
+</toc>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<?NLS TYPE="org.eclipse.help.toc"?>
+
+<toc label="Concepts" link_to="toc.xml#concepts">
+ <topic label="General">
+ <topic label="LTTng" href="html/concepts/lttng.html" />
+ <topic label="LTTv" href="html/concepts/lttv.html" />
+ <topic label="Trace" href="html/concepts/trace.html" />
+ <topic label="Experiment" href="html/concepts/experiment.html" />
+ </topic>
+ <topic label="User Interface">
+ <topic label="Perspective" href="html/concepts/perspective.html" />
+ <topic label="Project View" href="html/concepts/projectView.html" />
+ <topic label="Events View" href="html/concepts/eventsView.html" />
+ <topic label="Time Frame View" href="html/concepts/timeFrameView.html" />
+ <topic label="Control Flow View" href="html/concepts/controlFlowView.html" />
+ <topic label="Resources View" href="html/concepts/resourcesView.html" />
+ <topic label="Statistics View" href="html/concepts/statisticsView.html" />
+ </topic>
+</toc>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<?NLS TYPE="org.eclipse.help.toc"?>
+
+<toc label="Getting Started" link_to="toc.xml#gettingstarted">
+ <topic label="General" href="html/gettingstarted/starting.html" />
+ <topic label="Samples" href="html/gettingstarted/samples.html" />
+</toc>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<?NLS TYPE="org.eclipse.help.toc"?>
+
+<toc label="Limitations" link_to="toc.xml#limitations">
+ <topic label="Limitations" href="html/limitations/limitations.html" />
+</toc>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<?NLS TYPE="org.eclipse.help.toc"?>
+
+<toc label="Reference" link_to="toc.xml#reference">
+ <topic label="References" href="html/reference/references.html" />
+</toc>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+ <name>org.eclipse.linuxtools.tmf.feature</name>
+ <comment></comment>
+ <projects>
+ </projects>
+ <buildSpec>
+ <buildCommand>
+ <name>org.eclipse.pde.FeatureBuilder</name>
+ <arguments>
+ </arguments>
+ </buildCommand>
+ </buildSpec>
+ <natures>
+ <nature>org.eclipse.pde.FeatureNature</nature>
+ </natures>
+</projectDescription>
--- /dev/null
+bin.includes = feature.xml
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="Compile org.eclipse.linuxtools.tmf.feature" default="main">
+ <target name="main">
+ <ant antfile="build.xml" dir="../org.eclipse.linuxtools.tmf" target="build.jars"/>
+ <ant antfile="build.xml" dir="../org.eclipse.linuxtools.tmf.ui" target="build.jars"/>
+ </target>
+</project>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<feature
+ id="org.eclipse.linuxtools.tmf.feature"
+ label="Tracing and Monitoring Framework (TMF)"
+ version="0.1.0.qualifier"
+ provider-name="Ericsson">
+
+ <description url="http://www.example.com/description">
+ Tracing and Monitoring Framework
+ </description>
+
+ <copyright url="http://www.example.com/copyright">
+ Copyright (c) 2009 Ericsson
+
+All rights reserved. This program and the accompanying materials
+are made available under the terms of the Eclipse Public License
+v1.0 which accompanies this distribution, and is available at
+http://www.eclipse.org/legal/epl-v10.html
+ </copyright>
+
+ <license url="http://www.example.com/license">
+ [Enter License Description here.]
+ </license>
+
+ <plugin
+ id="org.eclipse.linuxtools.tmf"
+ download-size="0"
+ install-size="0"
+ version="0.0.0"
+ unpack="false"/>
+
+ <plugin
+ id="org.eclipse.linuxtools.tmf.ui"
+ download-size="0"
+ install-size="0"
+ version="0.0.0"
+ unpack="false"/>
+
+</feature>