+++ /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"/>
- <ant antfile="build.xml" dir="../org.eclipse.linuxtools.lttng.help" target="build.jars"/>
- </target>
-</project>
<requires>
<import plugin="org.eclipse.core.runtime"/>
+ <import plugin="org.eclipse.linuxtools.tmf" version="0.3.0" match="greaterOrEqual"/>
+ <import plugin="org.eclipse.linuxtools.lttng.jni" version="0.3.0" match="greaterOrEqual"/>
<import plugin="org.eclipse.ui"/>
<import plugin="org.eclipse.ui.ide"/>
<import plugin="org.eclipse.core.resources"/>
<import plugin="org.eclipse.core.filesystem"/>
- <import plugin="org.eclipse.linuxtools.tmf" version="0.3.0" match="greaterOrEqual"/>
- <import plugin="org.eclipse.linuxtools.lttng.jni" version="0.3.0" match="greaterOrEqual"/>
<import plugin="org.eclipse.linuxtools.tmf.ui" version="0.3.0" match="greaterOrEqual"/>
<import plugin="org.eclipse.linuxtools.lttng" version="0.3.0" match="greaterOrEqual"/>
+ <import plugin="org.eclipse.help"/>
</requires>
<plugin
--- /dev/null
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>LTTng Plug-in User Guide - Getting Started</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">Getting Started</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="User-Guide.html" title="LTTng Plug-in User Guide">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="User-Interface.html" title="User Interface">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">LTTng Plug-in User Guide</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">User Interface</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Getting_Started">Getting Started</h1>
+ <p>The LTTng plug-in for Eclipse is used to visualize and analyze kernel traces produced by the LTTng tracer. Controlling the recording and fetching of an LTTng trace from Eclipse is currently a work in progress therefore,
+ <i>currently the plug-in can only be used to visualize existing LTTng traces</i>. To record your own trace, you will need to install the LTTng kernel patches and the LTTv application (refer to the LTTng
+ <a href="http://lttng.org">site</a> for more information on how to record and fetch traces).
+ </p>
+ <p>If not already installed, you can download and install the LTTng plug-ins from the Eclipse update site (search for LTTng under Linux Tools). </p>
+ <p>The rest of this section provides instructions on how to complete the LTTng for Eclipse installation and verify that it is correct.</p>
+ <ul>
+ <li>
+ <a href="Getting-Started.html#Installing_the_LTTng_parsing_library">Installing the LTTng parsing library</a>
+ </li>
+ <li>
+ <a href="Getting-Started.html#Downloading_Sample_Traces">Downloading Sample Traces</a>
+ </li>
+ <li>
+ <a href="Getting-Started.html#Installation_Verification">Installation Verification</a>
+ </li>
+ </ul>
+ <h2 id="Installing_the_LTTng_parsing_library">Installing the LTTng parsing library</h2>
+ <p>The LTTng plug-in for Eclipse requires the installation of a third-party library,
+ <i>liblttngtrace</i>, that is used to parse the binary LTTng traces. For the first Eclipse release, it was decided not to re-implemented that library in Java but to simply integrate it using JNI. As a consequence,
+ <i>you need to download, compile and install the parsing library</i>.
+ </p>
+ <p>This trace parsing library is not delivered as part of Eclipse (licensing stuff) and has to be downloaded from the LTTng site, compiled and then installed on your Linux system.</p>
+ <p>Currently, the Eclipse plug-in supports the following version of the LTTng trace format: 2.3, 2.5 and 2.6. Depending on which trace version(s) you wish to analyze, you will need to download the appropriate snapshot from the corresponding git repository (pick the "snapshot" link next to the latest commit):</p>
+ <p>
+ <a href="http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=shortlog;h=refs/heads/traceformat-2.3">Trace format 2.3</a>
+ <br/>
+
+ <a href="http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=shortlog;h=refs/heads/traceformat-2.5">Trace format 2.5</a>
+ <br/>
+
+ <a href="http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=shortlog;h=refs/heads/traceformat-2.6">Trace format 2.6</a>
+ <br/>
+ </p>
+ <p>Build and install the snapshot(s) you downloaded. If you wish to install more than one version of the library, you will have to build them in
+ <i>format version sequence</i> (e.g. build 2.6
+ <i>last</i>). For a plain library installation (in /usr/local/lib), you can execute the following commands for each version you wish to install:
+ </p>
+ <pre>
+$ cd liblttngtrace-2.n
+$ ./autogen.sh --with-jni-interface --without-lttv && make
+# make install
+</pre>
+ <p>You will end up with something like this (the
+ <i>loader</i> acts as a factory to pre-analyze the trace and load the correct parser library):
+ </p>
+ <pre>
+$ ls -l1 /usr/local/lib
+total 1048
+-rwxr-xr-x. 1 root root 210300 2010-06-07 11:24 liblttvtraceread-2.5.so
+-rwxr-xr-x. 1 root root 211052 2010-06-07 11:25 liblttvtraceread-2.6.so
+-rw-r--r--. 1 root root 316040 2010-06-07 11:25 liblttvtraceread.a
+-rwxr-xr-x. 1 root root 1175 2010-06-07 11:25 liblttvtraceread.la
+-rwxr-xr-x. 1 root root 93963 2010-06-07 11:24 liblttvtraceread_loader-2.5.so
+-rwxr-xr-x. 1 root root 93963 2010-06-07 11:25 liblttvtraceread_loader-2.6.so
+-rw-r--r--. 1 root root 125442 2010-06-07 11:25 liblttvtraceread_loader.a
+-rwxr-xr-x. 1 root root 1224 2010-06-07 11:25 liblttvtraceread_loader.la
+lrwxrwxrwx. 1 root root 30 2010-06-07 11:25 liblttvtraceread_loader.so -> liblttvtraceread_loader-2.6.so
+lrwxrwxrwx. 1 root root 23 2010-06-07 11:25 liblttvtraceread.so -> liblttvtraceread-2.6.so
+</pre>
+ <p>A number of configuration options are available to fine tune the library builds:</p>
+ <pre>
+$ ./configure -- help
+Usage: ./configure [OPTION]... [VAR=VALUE]...
+
+To assign environment variables (e.g., CC, CFLAGS...), specify them as
+VAR=VALUE. See below for descriptions of some of the useful variables.
+
+Defaults for the options are specified in brackets.
+
+Configuration:
+ -h, --help display this help and exit
+ --help=short display options specific to this package
+ --help=recursive display the short help of all the included packages
+ -V, --version display version information and exit
+ -q, --quiet, --silent do not print `checking ...' messages
+...
+ <more options>
+</pre>
+ <p>Finally, you have to set your LD_LIBRARY_PATH environment variable so Eclipse can find the parsing libraries. Otherwise, you have to specify the path when you start Eclipse:</p>
+ <pre>
+$ LD_LIBRARY_PATH="/usr/local/lib:$LD_LIBRARY_PATH" ./eclipse
+</pre>
+ <h2 id="Downloading_Sample_Traces">Downloading Sample Traces</h2>
+ <p>To verify that your installation is functional, you can download sample traces from the Eclipse repository. The following LTTng traces are provided as samples.</p>
+ <p>Each trace as its own characteristics and complexity. The size given refers to the size of the trace once "untarred", the actual tar size should be ~10 times smaller.</p>
+ <ul>
+ <li>
+ <a href="http://dev.eclipse.org/viewsvn/index.cgi/lttng/trunk/org.eclipse.linuxtools.lttng.tests/traceset/trace-15316events_nolost_newformat.tar.gz?root=Technology_LINUXTOOLS&view=log">trace-15316 (456K)</a> Very small trace (format 2.5 - 15316 events) made from a single LTTng marker. Recorded with a VirtualBox system with 1 processor.
+ </li>
+ </ul>
+ <ul>
+ <li>
+ <a href="http://dev.eclipse.org/viewsvn/index.cgi/lttng/trunk/org.eclipse.linuxtools.lttng.tests/traceset/trace-15471events_nolost_newformat.txt?root=Technology_LINUXTOOLS&view=log">trace-15471 (460K)</a> Very small trace (format 2.5 - 15471 events) made from a single LTTng marker. Recorded with a VirtualBox system with 1 processor.
+ </li>
+ </ul>
+ <p>(More sample traces to come)</p>
+ <h2 id="Installation_Verification">Installation Verification</h2>
+ <p>Here are the quick steps to verify that your installation is functional. If needed, refer to the
+ <a href="User-Interface.html#User_Interface">User Interface</a> section for clarifications.
+ </p>
+ <ul>
+ <li>Start Eclipse</li>
+ <li>Open the LTTng perspective</li>
+ <li>Create an LTTng project
+ <ul>
+ <li>Right-click in the Project view and select "New Project"</li>
+ <li>Enter the name of your project (e.g. "MyLTTngProject")</li>
+ <li>The project will be created. It will contain 2 empty folders: "Traces" and "Experiments"</li>
+ </ul>
+ </li>
+ <li>Import a sample trace
+ <ul>
+ <li>Right-click on the newly created project and select "Import Trace"</li>
+ <li>Navigate to the sample LTTng trace that you want to visualize</li>
+ <li>Note: you have to drill down into the trace directory to import the trace correctly (yes, we know that the Import function needs to be re-written...)</li>
+ <li>The newly imported trace should appear under the Traces folder</li>
+ </ul>
+ </li>
+ <li>Visualize the trace
+ <ul>
+ <li>Expand the Traces folder</li>
+ <li>Double-click on the trace</li>
+ <li>The trace should load and the views be populated</li>
+ </ul>
+ </li>
+ </ul>
+ <p>Refer to
+ <a href="User-Interface.html#User_Interface">User Interface</a> for detailed description of the views and their usage.
+ </p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="User-Guide.html" title="LTTng Plug-in User Guide">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="User-Guide.html" title="LTTng Plug-in User Guide">
+ <img alt="LTTng Plug-in User Guide" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right">
+ <a href="User-Interface.html" title="User Interface">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">LTTng Plug-in User Guide</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">User Interface</td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>LTTng Plug-in User Guide - Limitations</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">Limitations</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="User-Interface.html" title="User Interface">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="References.html" title="References">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">User Interface</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">References</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Limitations">Limitations</h1>
+ <p>The current implementation is under heavy development and some important features are still missing. Here is a list of the known bugs and missing features that are being worked on.</p>
+ <p>
+ <b>Performance</b>
+ </p>
+ <p>The current version takes 3-5 more time to fully parse a trace than the finely optimized C version (LTTv). Things are event worse when the Statistics View is open. However, once a trace/experiment is selected, the user has immediate feedback and can start navigating and visualizing the trace while the parsing takes place in the background.</p>
+ <p>
+ <b>No tracer control</b>
+ </p>
+ <p>The LTTng tracer control (
+ <i>start</i>/''suspend''/''resume''/''stop'' tracing) is not integrated yet. Also, transferring an LTTng trace from a remote target is not supported yet.
+ </p>
+ <p>
+ <b>64-bits and non-x86 host architectures</b>
+ </p>
+ <p>The parser libraries have not been extensively tested for 64-bits and not tested at all on non-x86 architectures. The code is believed to work on a broad range of architectures but this cannot be certified for now.</p>
+ <p>
+ <b>Searches and Filters</b>
+ </p>
+ <p>There is currently no way to filter events following some criteria or to dynamically sort the different fields.</p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="User-Interface.html" title="User Interface">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="User-Guide.html" title="LTTng Plug-in User Guide">
+ <img alt="LTTng Plug-in User Guide" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right">
+ <a href="References.html" title="References">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">User Interface</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">References</td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>LTTng Plug-in User Guide - References</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">References</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Limitations.html" title="Limitations">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Updating-This-Document.html" title="Updating This Document">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Limitations</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Updating This Document</td>
+ </tr>
+ </table><hr/>
+ <h1 id="References">References</h1>
+ <ul>
+ <li>
+ <a href="http://www.eclipse.org/linuxtools/projectPages/lttng/">Linux Tools - LTTng integration</a>
+ </li>
+ <li>
+ <a href="http://www.lttng.org/">LTTng project</a>
+ </li>
+ <li>
+ <a href="http://git.lttng.org/?p=lttv.git;a=blob_plain;f=LTTngManual.html">LTTng Manual</a>
+ </li>
+ </ul><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Limitations.html" title="Limitations">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="User-Guide.html" title="LTTng Plug-in User Guide">
+ <img alt="LTTng Plug-in User Guide" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right">
+ <a href="Updating-This-Document.html" title="Updating This Document">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Limitations</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Updating This Document</td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>LTTng Plug-in User Guide - Updating This Document</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">Updating This Document</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="References.html" title="References">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right"></td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">References</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top"></td>
+ </tr>
+ </table><hr/>
+ <h1 id="Updating_This_Document">Updating This Document</h1>
+ <p>This document is maintained in a collaborative wiki. If you wish to update or modify this document please visit
+
+ <a href="http://wiki.eclipse.org/Linux_Tools_Project/LTTng/User_Guide">http://wiki.eclipse.org/Linux_Tools_Project/LTTng/User_Guide</a>
+ </p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="References.html" title="References">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="User-Guide.html" title="LTTng Plug-in User Guide">
+ <img alt="LTTng Plug-in User Guide" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right"></td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">References</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top"></td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>LTTng Plug-in User Guide</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">LTTng Plug-in User Guide</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Getting-Started.html" title="Getting Started">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Getting Started</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Introduction">Introduction</h1>
+ <p>LTTng (Linux Tracing Toolkit, next generation) is a highly efficient tracing tool for Linux that can be used to track down performance issues and debug problems involving multiple concurrent processes and threads. It consists of a set of kernel patches and a daemon, to collect the raw tracing data, as well as a set of tools to control, visualize and analyze the generated data.</p>
+ <p>The LTTng plug-in for Eclipse aims at replacing LTTv (LTTng visualizer), the component used to control, fetch, analyze and visualize traces produced by the LTTng tracer. A present, the LTTng Eclipse plug-in for Eclipse supports the following analyses: Control Flow, Resources and Statistics.</p>
+ <p>For more information about LTTng, refer to the project
+ <a href="http://lttng.org">site</a>
+ </p>
+ <h2 id="About_Tracing">About Tracing</h2>
+ <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>
+ <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 generated trace frequently can easily contain millions of events and have sizes from many megabytes to tens of gigabytes.</p>
+ <p>Traces may include events from the operating system kernel (IRQ handler entry/exit, system call entry/exit, scheduling activity, network activity, etc). It can also consists of application events (a.k.a UST - User Space Tracing) or a mix of the two.</p>
+ <p>For the maximum level of detail, a tracing events may be viewed like a log file. However, trace analyzers and viewers are available to produce useful information from the raw data. These programs must be specially designed to handle quickly the enormous amount of data traces contain.</p>
+ <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 UST.</p>
+ <h2 id="Traces_and_Experiments">Traces and Experiments</h2>
+ <p>In the scope of the LTTng plug-in for Eclipse, a trace is essentially a (very) large set of time-ordered LTTng events. The LTTng application can read these traces and provide a number of standard views to analyze their contents.</p>
+ <p>An experiment consists in an arbitrary number of aggregated LTTng traces for purpose of correlation. In the degenerate case, an experiment can consist of a single trace.</p>
+ <p>The experiment provides a unified, time-ordered stream of the individual LTTng trace events.</p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Getting-Started.html" title="Getting Started">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Getting Started</td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>LTTng Plug-in User Guide - User Interface</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">User Interface</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Getting-Started.html" title="Getting Started">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Limitations.html" title="Limitations">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Getting Started</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Limitations</td>
+ </tr>
+ </table><hr/>
+ <h1 id="User_Interface">User Interface</h1>
+ <p>This section describes the LTTng perspective and its specific views.</p>
+ <h2 id="LTTng_Perspective">LTTng Perspective</h2>
+ <p>The LTTng perspective groups the LTTng specific views, namely:</p>
+ <ul>
+ <li>
+ <a href="User-Interface.html#Project_View">Project_View</a>
+ </li>
+ <li>
+ <a href="User-Interface.html#Events_View">Events_View</a>
+ </li>
+ <li>
+ <a href="User-Interface.html#Histogram_View">Histogram_View</a>
+ </li>
+ <li>
+ <a href="User-Interface.html#Control_Flow_View">Control_Flow_View</a>
+ </li>
+ <li>
+ <a href="User-Interface.html#Resources_View">Resources_View</a>
+ </li>
+ <li>
+ <a href="User-Interface.html#Statistics_View">Statistics_View</a>
+ </li>
+ </ul>
+ <p>The views are synchronized i.e. selecting an event, a timestamp, a time range, etc will update the other views accordingly.</p>
+ <p>
+ <img border="0" src="images/LTTngPerspective.png"/>
+ </p>
+ <p>The perspective can be opened from the Eclipse Open Perspective dialog (Window > Open Perspective... > Other).</p>
+ <p>
+ <img border="0" src="images/LTTngPerspectiveOpen.png"/>
+ </p>
+ <h2 id="Project_View">Project View</h2>
+ <p>The project view displays the LTTng projects of the current workspace.</p>
+ <p>Two folders are always present: Traces and Experiments. </p>
+ <p>
+ <img border="0" src="images/ProjectView.png"/>
+ </p>
+ <p>A new LTTng project can be created using the LTTng Project dialog (File > New > Project... or the context menu)</p>
+ <p>
+ <img border="0" src="images/LTTngProjectNewWizard.png"/>
+ </p>
+ <p>
+ <img border="0" src="images/LTTngProjectNewDialog.png"/>
+ </p>
+ <p>The Traces 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>
+ <p>Note: An LTTng trace is actually a composite of multiple channel traces grouped under a folder. It is the folder that has to be imported. </p>
+ <p>
+ <img border="0" src="images/LTTngTraceImportDialog.png"/>
+ </p>
+ <p>The Experiment folder holds the set of experiments of the project. Experiments are created from the Experiment context menu and are configured from the experiment's context menu.</p>
+ <p>
+ <img border="0" src="images/LTTngTraceSelectDialog.png"/>
+ </p>
+ <h2 id="Events_View">Events View</h2>
+ <p>The Events View shows the basic trace data in chronological order in a tabular format.</p>
+ <p>The header displays the current trace (or experiment) name. The table displays the following fields:</p>
+ <ul>
+ <li>
+ <b>Timestamp</b>: the event timestamp
+ </li>
+ <li>
+ <b>Source</b>: the component that generated the event
+ </li>
+ <li>
+ <b>Type</b>: the event type
+ </li>
+ <li>
+ <b>Reference</b>: the trace that holds the event (e.g. experiments typically hold multiple traces)
+ </li>
+ <li>
+ <b>Content</b>: the raw event content
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/EventsView.png"/>
+ </p>
+ <p>The highlighted event is the
+ <i>current event</i> and is synchronized with the other views. If you select another event, the other views will be synchronized accordingly.
+ </p>
+ <h2 id="Histogram_View">Histogram View</h2>
+ <p>The Histogram View displays the trace events distribution with respect to time.</p>
+ <p>
+ <img border="0" src="images/HistogramView.png"/>
+ </p>
+ <p>The large histogram, at the bottom, shows the event distribution over the whole trace. The timetamps (sec.nanosec) correspond to the first and the last event in the trace. The selected area corresponds to the current time range window. When clicking in that viewer, the mouse wheel can be used to zoom in/out and update the time range window.</p>
+ <p>The smaller histogram, on the top right of the view, is a zoom of the current time range window. It also has timestamps on the bottom that correspond to the time range. The scale of the histogram (i.e. the number of events) is displayed on the right.</p>
+ <p>On the top left, there are three elements of data:</p>
+ <ul>
+ <li>
+ <b>Current Event (sec)</b>: Displays the timestamp of the currently selected event
+ </li>
+ <li>
+ <b>Window Span (sec)</b>: Displays the current time range window size
+ </li>
+ <li>
+ <b>Window Center (sec)</b>: Displays the timestamp at the cursor
+ </li>
+ </ul>
+ <h2 id="Control_Flow_View">Control Flow View</h2>
+ <p>The Control Flow View is applicable to kernel trace data. It displays the list processes in tabular format, sorted by PID, as well as their state transitions over time in a Gantt chart format.</p>
+ <p>
+ <img border="0" src="images/ControlFlowView.png"/>
+ </p>
+ <p>The tool bar options from left to right are:</p>
+ <ul>
+ <li>
+ <b>Home</b>: reset the time window to the whole trace range.
+ </li>
+ <li>
+ <b>Next Event</b>: sets the current event to the next event of the selected process.
+ </li>
+ <li>
+ <b>Previous Event</b>: sets the current event to the previous event of the selected process.
+ </li>
+ <li>
+ <b>Next Process</b>: sets the selected process to the next down in the list.
+ </li>
+ <li>
+ <b>Previous Process</b>: sets the selected process to the next up in the list.
+ </li>
+ <li>
+ <b>Zoom In</b>: zooms in the trace (i.e. shortens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
+ </li>
+ <li>
+ <b>Zoom Out</b>: zooms out the trace (i.e. widens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
+ </li>
+ <li>
+ <b>Filter</b>: display only the processes that have a state transition in the current window.
+ </li>
+ </ul>
+ <p>The process table displays the following fields:</p>
+ <ul>
+ <li>
+ <b>Process</b>: the process name if know (
+ <i>UNNAMED</i> otherwise)
+ </li>
+ <li>
+ <b>Brand</b>:
+ </li>
+ <li>
+ <b>PID</b>: the process ID
+ </li>
+ <li>
+ <b>TGID</b>:
+ </li>
+ <li>
+ <b>PPID</b>: the parent PID
+ </li>
+ <li>
+ <b>CPU</b>: the CPU/core the process is running on
+ </li>
+ <li>
+ <b>Birth sec/nsec</b>: the birth time of the process (
+ <i>0</i> if unknown) - seconds and nanoseconds
+ </li>
+ <li>
+ <b>TRACE</b>: the name of the trace that holds this process
+ </li>
+ </ul>
+ <p>The graphical part shows the state of the corresponding process
+ <i>a la Gantt</i>: the color represents the process state and the length of the bar represents the time span during which the process was in that state. The header corresponds to a time axis.
+ Note that depending on the scale or zooming factor, some pixels might represent more (in fact many, many more) than just one state.
+ </p>
+ <p>Here's a list of possible colors and their corresponding process state:</p>
+ <p>
+ <img border="0" src="images/LTTngControlFlowColorLegend.png"/>
+ </p>
+ <ul>
+ <li>
+ <b>MODE_UNKNOWN</b> - Process state is unknown: there is not enough information in the trace to determine the state. This usually occurs for processes already alive when tracing started and the system is unable to infer the original state from the following trace events.
+ </li>
+ <li>
+ <b>USER_MODE</b> - Running in user mode: the process is executing user source code or library calls (in user space).
+ </li>
+ <li>
+ <b>SYSCALL</b> - Running in system call: the process is doing a system call to the kernel and the running mode switched from process limited rights to super user mode.
+ </li>
+ <li>
+ <b>IRQ</b> - Servicing an IRQ: the currently running process is interrupted by an IRQ. As the IRQ does not change the currently running process (on some architectures it uses the same stack as the process), the IRQ state is shown in the state of the process. IRQ can be nested: a higher priority interrupt can interrupt a lower priority interrupt.
+ </li>
+ <li>
+ <b>TRAP</b> - Running in a trap: the kernel is running a trap that services a fault. The most frequent trap is the memory page fault trap, called every time a page is missing from physical memory.
+ </li>
+ <li>
+ <b>WAIT</b> - Waiting on I/O: the process is waiting for an I/O operation to complete before it can continue its execution.
+ </li>
+ <li>
+ <b>UNNAMED</b> - Mode unnamed: see
+ <b>MODE_UNKNOWN</b>
+ </li>
+ <li>
+ <b>WAIT_FORK</b> - Waiting for fork: the process has just been created by its parent and is waiting for first scheduling.
+ </li>
+ <li>
+ <b>WAIT_CPU</b> - Waiting for CPU: the process is ready to run but waiting to get the CPU (a schedule in event).
+ </li>
+ <li>
+ <b>EXIT</b> - Process has exited: the process has exited, but still has the control of the CPU. It may happend if it has some tasks to do in the exit system call.
+ </li>
+ <li>
+ <b>ZOMBIE</b> - Zombie process: the process in in zombie state. This state happens when a process exits and then waits for the parent to wait for it (wait() or waitpid()).
+ </li>
+ <li>
+ <b>SOFTIRQ</b> - Running a soft IRQ handler: a SoftIRQ is normally triggered by an interrupt that whishes to have some work done very soon, but not "now". Doing the long part of a computation in a softirq that will be run just after the IRQ handler exits permits to do work while interrupts are enabled, without increasing the system latency.
+ </li>
+ </ul>
+ <h3 id="Mouse_Control">Mouse Control</h3>
+ <ul>
+ <li>Mouse Wheel
+ <ul>
+ <li>Forward - Zoom In.</li>
+ <li>Backward - Zoom Out.</li>
+ </ul>
+ </li>
+ </ul>
+ <ul>
+ <li>Mouse Drag
+ <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>
+ </li>
+ </ul>
+ <ul>
+ <li>Mouse Hover
+ <ul>
+ <li>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.</li>
+ </ul>
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/LTTngProcessStateInfo.png"/>
+ </p>
+ <h2 id="Resources_View">Resources View</h2>
+ <p>The Resources View is applicable to kernel trace data. It displays the list system resources in tree format, grouped by trace, as well as their state transitions over time in a Gantt chart format.</p>
+ <p>
+ <img border="0" src="images/ResourcesView.png"/>
+ </p>
+ <p>The tool bar options from left to right are:</p>
+ <ul>
+ <li>
+ <b>Home</b>: reset the time window to the whole trace range.
+ </li>
+ <li>
+ <b>Next Event</b>: sets the current event to the next event of the selected process.
+ </li>
+ <li>
+ <b>Previous Event</b>: sets the current event to the previous event of the selected process.
+ </li>
+ <li>
+ <b>Next Process</b>: sets the selected process to the next down in the list.
+ </li>
+ <li>
+ <b>Previous Process</b>: sets the selected process to the next up in the list.
+ </li>
+ <li>
+ <b>Zoom In</b>: zooms in the trace (i.e. shortens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
+ </li>
+ <li>
+ <b>Zoom Out</b>: zooms out the trace (i.e. widens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
+ </li>
+ <li>
+ <b>Filter</b>: display only the processes that have a state transition in the current window.
+ </li>
+ </ul>
+ <p>The resource tree displays the system resources whose state transitions were collected in the trace.</p>
+ <p>The graphical part shows the state of the corresponding resources
+ <i>a la Gantt</i>: the color represents the resource state and the length of the bar represents the time span during which the resource was in that state. The header corresponds to a time axis.
+ Note that depending on the scale or zooming factor, some pixels might represent more (in fact many, many more) than just one state.
+ </p>
+ <p>Here's a list of possible colors and their corresponding process state:</p>
+ <p>
+ <img border="0" src="images/LTTngResourcesColorLegend.png"/>
+ </p>
+ <h3 id="Mouse_Control_2">Mouse Control</h3>
+ <p>See
+ <a href="User-Interface.html#Control_Flow_View">Control_Flow_View</a>
+ </p>
+ <h2 id="Statistics_View">Statistics View</h2>
+ <p>The Statistics View displays the various event counters that are collected when analyzing a trace. The data is organized per trace.</p>
+ <p>
+ <img border="0" src="images/StatisticsView.png"/>
+ </p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Getting-Started.html" title="Getting Started">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="User-Guide.html" title="LTTng Plug-in User Guide">
+ <img alt="LTTng Plug-in User Guide" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right">
+ <a href="Limitations.html" title="Limitations">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Getting Started</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Limitations</td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Bundle-SymbolicName: org.eclipse.linuxtools.lttng.help; singleton:=true
Bundle-Version: 0.3.0.qualifier
Bundle-Vendor: %Bundle-Vendor
+Require-Bundle: org.eclipse.help
+Bundle-RequiredExecutionEnvironment: J2SE-1.5
Bundle-Localization: plugin
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head>
-
-
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"/>
<title>About</title>
-</head><body lang="EN-US">
+</head>
+<body lang="EN-US">
<h2>About This Content</h2>
<p>June 5, 2006</p>
<h3>License</h3>
-<p>The Eclipse Foundation makes available all content in this plug-in ("Content"). Unless otherwise
+<p>The Eclipse Foundation makes available all content in this plug-in ("Content"). Unless otherwise
indicated below, the Content is provided to you under the terms and conditions of the
-Eclipse Public License Version 1.0 ("EPL"). A copy of the EPL is available
+Eclipse Public License Version 1.0 ("EPL"). A copy of the EPL is available
at <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.
-For purposes of the EPL, "Program" will mean the Content.</p>
+For purposes of the EPL, "Program" will mean the Content.</p>
<p>If you did not receive this Content directly from the Eclipse Foundation, the Content is
-being redistributed by another party ("Redistributor") and different terms and conditions may
+being redistributed by another party ("Redistributor") and different terms and conditions may
apply to your use of any object code in the Content. Check the Redistributor's license that was
provided with the Content. If no such license exists, contact the Redistributor. Unless otherwise
indicated below, the terms and conditions of the EPL still apply to any source code in the Content
and such source code may be obtained at <a href="http://www.eclipse.org/">http://www.eclipse.org</a>.</p>
-</body></html>
\ No newline at end of file
+</body>
+</html>
\ No newline at end of file
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright (c) 2010 Red Hat, Inc.
+ 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
+
+ Contributors:
+ Red Hat - initial API and implementation
+ -->
+<project name="org.eclipse.linuxtools.lttng.help" default="all">
+ <description>
+ Generate Eclipse help content for the Linux Tools LTTng user guide
+ </description>
+
+ <property name="lttng.ug.title" value="LTTng Plug-in User Guide"/>
+ <property name="help.doc.url.base" value="http://wiki.eclipse.org"/>
+ <property name="lttng.wiki.url.base" value="${autotools.help.doc.url.base}/Linux_Tools_Project/LTTng"/>
+ <property name="imageFolder" value="images"/>
+
+ <path id="wikitext.tasks.classpath">
+ <!-- Replace dir with the dir you have wikitext installed into.-->
+ <!-- fileset dir="/usr/share/eclipse/dropins/mylyn-wikitext/eclipse/plugins" -->
+ <fileset dir="/home/francois/Eclipse/Helios/plugins">
+ <include name="org.eclipse.mylyn.wikitext.*core*.jar" />
+ </fileset>
+ </path>
+ <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/internal/wikitext/mediawiki/core/tasks/tasks.properties" />
+ <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/wikitext/core/util/anttask/tasks.properties" />
+
+ <target name="all" description="Generate Eclipse help content for the Linux Tools LTTng user guide">
+ <mediawiki-to-eclipse-help wikiBaseUrl="${help.doc.url.base}" title="${lttng.ug.title}" formatoutput="true" dest="." templateExcludes="*eclipseproject*">
+
+ <path name="Linux_Tools_Project/LTTng/User_Guide" title="${lttng.ug.title}" generateToc="false"/>
+ <stylesheet url="book.css" />
+ <pageAppendum>
+= Updating This Document =
+
+This document is maintained in a collaborative wiki. If you wish to update or modify this document please visit
+http://wiki.eclipse.org/Linux_Tools_Project/LTTng/User_Guide
+ </pageAppendum>
+ </mediawiki-to-eclipse-help>
+ <antcall target="test" />
+ </target>
+
+ <target name="test" description="verify that all of the HTML files are well-formed XML">
+ <echo level="info">
+Validating help content XML and HTML files: The Eclipse help system expects well-formed XML
+
+If validation fails it is because either:
+
+* the userguide source code is poorly formed, or
+* the WikiText MediaWiki parser has a bug
+
+Problems with userguide source are usually caused by improper use of HTML markup in the MediaWiki source,
+or inadvertently starting a line with a space character (in MediaWiki this starts a preformatted block)
+ </echo>
+
+ <!--
+ Don't bother with DTD validation: we only care if the files are well-formed.
+ We therefore provide an empty DTD
+ -->
+ <echo file="tmp/__empty.dtd" message="" />
+ <xmlvalidate lenient="true">
+ <fileset dir="Linux_Tools_Project">
+ <include name="**/*.html" />
+ </fileset>
+ <dtd publicid="-//W3C//DTD XHTML 1.0 Transitional//EN" location="${basedir}/tmp/__empty.dtd" />
+ </xmlvalidate>
+ <delete dir="tmp"/>
+ </target>
+</project>
bin.includes = plugin.xml,\
META-INF/,\
- html/,\
- *.xml,\
- about.html,\
- plugin.properties
+ about.html,\
+ toc.xml,\
+ Linux_Tools_Project/,\
+ doc/,\
+ toc-doc.xml,\
+ plugin.properties,\
+ images/
+++ /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 over 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=utf-8">
- <TITLE></TITLE>
- <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.2 (Linux)">
- <META NAME="CREATED" CONTENT="20091006;11250700">
- <META NAME="CHANGEDBY" CONTENT="Francois Godin">
- <META NAME="CHANGED" CONTENT="20100603;15264500">
- <STYLE TYPE="text/css">
- <!--
- @page { margin: 2cm }
- H1 { margin-bottom: 0.21cm }
- H1.western { font-family: "Nimbus Sans L", sans-serif; font-size: 16pt }
- H1.cjk { font-family: "Bitstream Vera Sans"; font-size: 16pt }
- H1.ctl { font-family: "Bitstream Vera Sans"; font-size: 16pt }
- H3 { margin-bottom: 0.21cm }
- H3.western { font-family: "Nimbus Roman No9 L", serif }
- A:link { so-language: zxx }
- -->
- </STYLE>
-</HEAD>
-<BODY LANG="en-CA" DIR="LTR">
-<P STYLE="margin-bottom: 0cm"><BR>
-</P>
-<H1 CLASS="western">Installing LTTv library for Eclipse LTTng plugin</H1>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">This
-document describes how to install and configure the LTTv C-code
-library in order to load and parse LTTng traces with the Eclipse LTTng plugin. </FONT>
-</P>
-<P STYLE="margin-bottom: 0cm"><BR>
-</P>
-<H3 CLASS="western">For the impatient</H3>
-<P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">For each trace format version (v2.3, v2.5 and/or v2.6) you want to process :</P>
-<UL>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Download
- LTTv application, from
- <A HREF="http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=summary">http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=summary</A></FONT></P>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Compile
- it with the JNI support activated :</FONT></P>
- <P STYLE="margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>./configure
- --with-jni-interface && make && make install</I></FONT></FONT></P>
- <LI><P STYLE="margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">Start
- Eclipse application making sure the library is in LD_LIBRARY_PATH.</FONT></P>
-</UL>
-<P STYLE="margin-bottom: 0cm"><BR></P>
-<P STYLE="text-indent: 1.27cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">
-Note: Unless you plan to process legacy traces, version 2.5 and 2.6 should be sufficient for most needs.</FONT>
-</P>
-<P STYLE="text-indent: 1.27cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">
-It didn't work? Please read “Installation steps” section. </FONT>
-</P>
-<P STYLE="text-indent: 1.27cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">
-Make sure you install the latest version last (currently v2.6).</FONT></P>
-<P STYLE="margin-bottom: 0cm"><BR>
-</P>
-<H3 CLASS="western">Why a C library ?
-</H3>
-<P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">
-LTTng and LTTv are mostly coded in C (with some parts in even more evil stuff) so
-their functionalities are not directly available in Java. Also, for
-the sake of performance, it was decided to re-use the
-native, multi-platform C library for the low-level functions rather
-than re-implement them in Java. Also, the C library
-is under constant development and it would have been a bad idea to
-branch this one just yet.</FONT></P>
-<P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">
-So right now, the normal path for an event through LTTng would be the
-following :</FONT></P>
-<P STYLE="margin-left: 0.5cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I>Linux
-Kernel -> Trace Directory</I></FONT></P>
-<P STYLE="margin-left: 0.5cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I>(Trace
-Directory read by) LTTv C Library -> JNI (C side) -> JNI (Java
-Side) -> Eclipse LTTng Plugin</I></FONT></P>
-<P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">(Note
-that the kernel is only used to record at trace). </FONT>
-</P>
-<P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">For
-all these reasons, the LTTv C library and a JNI (Java Native
-Interface) is needed for java to process LTTng trace. The JNI itself,
-however, is already included in LTTv and it should be easy to build
-and to install (using this very installation guide). </FONT>
-</P>
-<P STYLE="margin-bottom: 0cm"><BR>
-</P>
-<H3 CLASS="western">Installation steps
-</H3>
-<P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">First
-on all, we need to download and compile the source of the LTTv
-application, with the JNI support enabled. To do so, follow the 4 steps described in this section.</FONT>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I><B>Note</B>
-: LTTv is responsible of handling the trace format for Eclipse.
-However, as the trace format changed overtime, you might need to
-compile several versions of LTTv if you plan to support multiple
-trace formats. Each “branch” of LTTv should tell you by its name
-which version of the LTTng trace it supports. If you did not generate
-a trace already, you might want to stick with the latest LTTv
-version, otherwise, it is recommended to compile all available versions
-(currently v2.3, v2.5 and v2.6). </I></FONT>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm; font-style: normal">
-<FONT FACE="Nimbus Roman No9 L, serif"><FONT COLOR="#ff950e"><SPAN STYLE="text-decoration: none"><B><SPAN STYLE="background: transparent">NOTE</SPAN></B></SPAN></FONT><SPAN STYLE="text-decoration: none"><B>:</B></SPAN>
-If you don't know which trace format you need, you may want to get all
-of them to support multiple versions of traces (2.5 and 2.6 are
-more or less mandatory). Just perform the following instructions for each
-trace format.</FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm; font-style: normal">
-<FONT FACE="Nimbus Roman No9 L, serif">In all case, make sure you
-install the latest version <i><u>last</u></i> (currently v2.6).</FONT></P>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL>
- <LI><P STYLE="margin-bottom: 0.21cm; text-decoration: none"><FONT FACE="Nimbus Roman No9 L, serif"><I><B>Downloading
- LTTv</B></I></FONT></P>
-</OL>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">There
-are actually three variants of the LTTv library available for download.</FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm; font-style: normal">
-<BR><BR>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">-
-<B>Beta JNI build (git) </B><FONT COLOR="#ff950e"><B>(PLEASE USE
-THIS)</B></FONT></FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">This
-is the very beta tree of LTTv that include the newest JNI changes. It
-is under constant development, so there might be some bugs left, but
-it contains the newer JNI interface, which is probably what you need.</FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">This
-is definitely what you should use. You can get it from :</FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><A HREF="http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=summary"><FONT FACE="Nimbus Roman No9 L, serif"><I>http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=summary</I></FONT></A></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><SPAN STYLE="font-style: normal">
-Then, in the “</SPAN><I><B>heads</B></I>”<SPAN STYLE="font-style: normal"> section
-(below the “</SPAN><I><B>shortlog</B></I>”<SPAN STYLE="font-style: normal">section),
-click on the trace format that suits your need</SPAN> <SPAN STYLE="font-style: normal">.
-In the new download page, click the “</SPAN><I>snapshot</I>”<SPAN STYLE="font-style: normal"> link
-of the top entry (with a marker of the form 'traceformat-n.n') to download the corresponding archive.</SPAN></FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">-
-<B>Development build (git) </B></FONT>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">
-This is the release candidate of the LTTv application. It contains
-features that are under development or too experimental to make it to
-the main tree. It also includes the JNI interface that you need to
-use Eclipse; however, this branch could be a little late on the
-beta, so use at your own risk. </FONT>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">If
-you want to try, get it from :<BR></FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><A HREF="http://lttng.org/cgi-bin/gitweb.cgi?p=lttv.git;a=summary"><FONT FACE="Nimbus Roman No9 L, serif"><I>http://lttng.org/cgi-bin/gitweb.cgi?p=lttv.git;a=summary</I></FONT></A></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><SPAN STYLE="font-style: normal">
-Then, in the “</SPAN><I><B>heads</B></I>”<SPAN STYLE="font-style: normal"> section
-(below the “</SPAN><I><B>shortlog</B></I>”<SPAN STYLE="font-style: normal"> and “</SPAN><I><B>tags</B></I>”<SPAN STYLE="font-style: normal">section),
-click on the trace format that suits your need</SPAN> <SPAN STYLE="font-style: normal">.
-In the new download page, click the “</SPAN><I>snapshot</I>”<SPAN STYLE="font-style: normal"> link
-of the top entry (with a marker of the form 'traceformat-n.n') to download the corresponding archive.</SPAN></FONT></P>
-
-
-
-
-
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><SPAN STYLE="font-style: normal">Then,
-in the “</SPAN><I>head</I>” <SPAN STYLE="font-style: normal">section,
-click on the traceformat that suite your need</SPAN> <SPAN STYLE="font-style: normal">and
-then choose “</SPAN><I>snapshot</I>” <SPAN STYLE="font-style: normal">to
-download its archive.</SPAN></FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">-
-<B>Stable release</B></FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">This
-is the main LTTv tree. Actually missing the JNI fonctionnality but
-this might be added soon. Until this is done, you should stick with
-development version. </FONT>
-</P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">If
-you want to try it anyways, you can get it from
-</FONT><A HREF="http://www.lttng.org/?q=node/3"><FONT FACE="Nimbus Roman No9 L, serif"><I>http://www.lttng.org/?q=node/3</I></FONT></A></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Then,
-select “<I>Download the latest lttv-[version].tar.gz</I>” in the
-menu and pick the most recent (usually on top) release.</FONT></P>
-<P STYLE="margin-left: 1.22cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL START=2>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I><B>Decompressing
- the archive(s)</B></I></FONT></P>
-</OL>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">You
-now need to archive files where you want them and to uncompress them.
-You need to do this for each LTTv version you downloaded.</FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">The
-way to do it in command line would be something like : </FONT>
-</P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>mv
-archive_name.tar.gz /where/you/want</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>tar
--xvzf archive_name.tar.gz</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">As
-example, this is what I would do for myself :</FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>mv
-liblttngtrace-bcaf565bbfb26d0ac7e4647528230feb61443a01.tar.gz
-/home/william</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>tar
--xvzf liblttngtrace-bcaf565bbfb26d0ac7e4647528230feb61443a01.tar.gz</I></FONT></FONT></P>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL START=3>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I><B>Configuration</B></I></FONT></P>
-</OL>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm; font-style: normal">
-<FONT FACE="Nimbus Roman No9 L, serif"><B>At First</B></FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Enter
-one of the uncompressed directory, you should use a command like : </FONT>
-</P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>cd
-liblttngtrace</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.24cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">(Of
-course “<I>liblttngtrace</I>” need to be the name of the
-uncompressed directory).</FONT></P>
-<P STYLE="margin-left: 1.24cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.24cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.24cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">If
-you are using any “Development build” (first or second choice of
-the download section), before doing anything, you need to do the
-following : </FONT>
-</P>
-<P STYLE="margin-left: 1.24cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>./autogen.sh</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.24cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">You
-can safetly ignore any errors you get there, we will take care of
-them next. </FONT>
-</P>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm; font-style: normal">
-<FONT FACE="Nimbus Roman No9 L, serif"><B>Dependencies</B></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">To
-build LTTv, the folowing dependencies need to be met. A (very)
-incomplete list is the following. Most distribution should have most
-of this stuff, except maybe gtk-dev, glib-dev and libopt that are
-probably missing on most systems.</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Install
-the missing dependencies using your distribution package manager and
-then jump to the “<I>configure script</I>” step.</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><B>libtool
-(and its dependencies like autotools, autoconf, automake and such...)</B></FONT></FONT></P>
-<P STYLE="margin-left: 2.01cm; margin-bottom: 0.21cm; font-weight: normal">
-<FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Debian/Ubuntu
-: libtool)</I></FONT></FONT></P>
-<P STYLE="margin-left: 2.01cm; margin-bottom: 0.21cm; font-weight: normal">
-<FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Fedora/Redhat
-: libtool-2)</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><B>gcc
-3.2 (or better)</B></FONT></FONT></P>
-<P STYLE="margin-left: 1.98cm; margin-bottom: 0.21cm; font-weight: normal">
-<FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Debian/Ubuntu
-: gcc-3.2)</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.98cm; margin-bottom: 0.21cm; font-weight: normal">
-<FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Fedora/Redhat
-: gcc-3.2)</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><B>gtk
-2.4 development libraries (or better)</B></FONT></FONT></P>
-<P STYLE="margin-left: 2.04cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Debian/Ubuntu
-: libgtk2.0, libgtk2.0-dev)</I></FONT></FONT></P>
-<P STYLE="margin-left: 2.04cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Fedora/Redhat
-: gtk2, gtk2-devel)</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><B>glib
-2.4 development libraries (or better)</B></FONT></FONT></P>
-<P STYLE="margin-left: 2.09cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Debian/Ubuntu
-: libglib2.0-0, libglib2.0-dev)</I></FONT></FONT></P>
-<P STYLE="margin-left: 2.09cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Fedora/Redhat
-: glib2, glib2-devel)</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><B>libpopt
-development libraries</B></FONT></FONT></P>
-<P STYLE="margin-left: 2.17cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Debian/Ubuntu
-: libpopt0, libpopt-dev)</I></FONT></FONT></P>
-<P STYLE="margin-left: 2.17cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Fedora/Redhat
-: popt)</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><B>libpango
-development libraries</B></FONT></FONT></P>
-<P STYLE="margin-left: 2.12cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Debian
-: libpango1.0, libpango1.0-dev)</I></FONT></FONT></P>
-<P STYLE="margin-left: 2.12cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Fedora
-: pango, pango-devel)</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><B>libc6
-development librairies </B></FONT></FONT>
-</P>
-<P STYLE="margin-left: 2.09cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Debian
-: libc6, libc6-dev)</I></FONT></FONT></P>
-<P STYLE="margin-left: 2.09cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT SIZE=2><I>(Fedora
-: glibc, glibc)<BR></I></FONT></FONT><BR><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><B>Configure
-step</B></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">LTTv
-have several compile options that you can turn on/off. To see a full
-list, type the following : </FONT>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>./configure
-–help<BR></I></FONT></FONT><BR><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">The
-following option is <U><B>essential</B></U> for Eclipse to work :</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>--with-jni-interface
-Build JNI interface between C and java. Need java include files.
-[default=no]<BR></I></FONT></FONT><BR><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">The
-following options may be useful for you as well : </FONT>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>1)
---prefix=PREFIX install architecture-independent files in PREFIX
-[/usr/local] </I></FONT></FONT>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>2)
---with-lttv Build whole LTTV system, as opposed to only the trace
-reading library [default=yes]</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>3)
---with-java-jdk=DIR Use java jdk from DIR. Ex : $JAVA_HOME.</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">1)
-Change PREFIX to something in your home if you don't have root access
-on your system.</FONT></P>
-<P STYLE="margin-left: 1.85cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Use
-a flag like : --prefix=/home/your_name/a_directory</FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">2)
-Unless you need LTTv Gtk gui, you better turn off turn off LTTv UI
-compilation. </FONT>
-</P>
-<P STYLE="margin-left: 1.85cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Use
-the flag : --without-lttv</FONT></P>
-<P STYLE="margin-left: 1.27cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">3)
-On some (most?) system, configure will need you to indicate where it
-can find the java JDK to compile the JNI. </FONT>
-</P>
-<P STYLE="margin-left: 1.85cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Use
-a flag like : --with-java-jdk=/where/java-jdk/is</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">As
-example, here is what I would use :</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>./configure
---prefix=/home/william/apps --without-lttv
---with-java-jdk=/usr/local/jdk1.6.0_13 --with-jni-interface </I></FONT></FONT>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Fix
-any missing dependencies errors and move to the next step.</FONT></P>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL START=4>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I><B>Build
- and install</B></I></FONT></P>
-</OL>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Now
-that program is correctly configured, we can try to build it. Type
-the following command (this can take a while) :</FONT></P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>make</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">When
-it is over, make sure there were no error during the compilation and
-issue the following command : </FONT>
-</P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>sudo
-make install</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">OR
-if you don't have root acess AND changed the --prefix=PREFIX flag
-during the configuration :</FONT></P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>make
-install </I></FONT></FONT>
-</P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.21cm"><BR><BR>
-</P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">LTTv
-should now be installed on your system. </FONT>
-</P>
-<P STYLE="margin-left: 1.32cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Get
-back to the step <I>3) “Configuration” </I>and do the same
-operations for all the LTTv version that were downloaded to install
-them on your system. </FONT>
-</P>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL START=5>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I><B>Set
- library path</B></I></FONT></P>
-</OL>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">Now
-that LTTv is installed, we need to make sure Eclipse can find its
-library easily. The best way to do so is to ajust the
-LD_LIBRARY_PATH. </FONT>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">The
-following should work on most system if your shell is BASH or KSH <U>(in
-case of doubt try this one)</U> :</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>export
-LD_LIBRARY_PATH=”/usr/local/lib:$LD_LIBRARY_PATH”</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">OR
-if you changed the --prefix=PREFIX flag during the configuration :</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>export
-LD_LIBRARY_PATH=”/where_you_set_prefix/lib:$LD_LIBRARY_PATH”</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">If
-you are using a CSH or TCSH shell, this might be what you need : </FONT>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>setenv
-LD_LIBRARY_PATH /usr/local/lib\:$LD_LIBRARY_PATH</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">OR
-if you changed the --prefix=PREFIX flag during the configuration :</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>setenv
-LD_LIBRARY_PATH /where_you_set_prefix/lib\:$LD_LIBRARY_PATH</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">If
-you have root access on the system, if can be a good idea to run
-ldconfig as well :</FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>sudo
-ldconfig</I></FONT></FONT></P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif"><I><U>Note
-these settings will disapears on logout</U>, you mght consider adding
-this to your autostart or setting it system wide! </I></FONT>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><BR>
-</P>
-<P STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><FONT FACE="Nimbus Roman No9 L, serif">You
-should be ready to start Eclipse now.</FONT></P>
-<P STYLE="margin-bottom: 0cm"><BR>
-</P>
-<H3 CLASS="western">FAQ</H3>
-<OL>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I>When
- trying to start LTTng in Eclipse, I end up with the following
- exception :<BR></I><FONT COLOR="#000080"><FONT FACE="Monospace"><FONT SIZE=2><I><U>org.eclipse.linuxtools.lttng.trace.LTTngTraceException</U></I></FONT></FONT></FONT><FONT COLOR="#ff0000"><FONT FACE="Monospace"><FONT SIZE=2><I>:
- Failed to initialize library! Is the trace version supported?</I></FONT></FONT></FONT></FONT></P>
- <P ALIGN=LEFT><FONT COLOR="#ff0000"><FONT FACE="Monospace"><FONT SIZE=2>Make
- sure you have the correct LTTv library compiled. (openTrace)</FONT></FONT></FONT></P>
- <P STYLE="margin-top: 0.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><FONT COLOR="#000000"><FONT SIZE=3><SPAN STYLE="font-style: normal">This
- mean you do not have the correct LTTv library available on your
- system. Go back to the section </SPAN></FONT></FONT><FONT COLOR="#000000"><FONT SIZE=3><I>"1)
- – Download”</I></FONT></FONT><FONT COLOR="#000000"> </FONT><FONT COLOR="#000000"><FONT SIZE=3><SPAN STYLE="font-style: normal">and
- make sure you downloaded (and installed) the correct version of LTTv
- to support the format of trace you want to read. As example, if your
- trace is of LTTng format 2.3, you will need to download and install
- the archive marked as “traceformat-2.3”.</SPAN></FONT></FONT></FONT></P>
-</OL>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL START=2>
- <LI><P STYLE="margin-top: 0.3cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I>When
- trying to import a trace, I get an error message and I have one of
- the following exception in the Eclipse Console :
- <BR></I><FONT COLOR="#000080"><FONT FACE="Monospace"><FONT SIZE=2><I><U>org.eclipse.linuxtools.lttng.trace.LTTngTraceException</U></I></FONT></FONT></FONT><FONT COLOR="#ff0000"><FONT FACE="Monospace"><FONT SIZE=2><I>:
- ERROR : Unrecognized/unsupported trace version.</I></FONT></FONT></FONT></FONT></P>
- <P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">OR</FONT></P>
- <P STYLE="margin-bottom: 0.21cm"><FONT FACE="Monospace"><FONT SIZE=2><I><FONT COLOR="#000080"><U>org.eclipse.linuxtools.lttng.trace.LTTngTraceException</U></FONT><FONT COLOR="#ff0000">:
- ERROR : Call to JniTraceVersion() failed.</FONT></I></FONT></FONT></P>
- <P STYLE="margin-top: 0.2cm; margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">In
- that case, either your LTTv version is very old and does not
- recognize your trace version or you are using a very new trace
- version that is not yet supported. You probably want to check if
- there is a newer version of LTTv that you could use. Please refer to
- the section <I>"1) – Download” for the correct links.</I></FONT></P>
-</OL>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL START=3>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif"><I>When
- trying to start LTTng in Eclipse, I end up with the following
- exception :<BR></I><FONT COLOR="#ff0000"><FONT FACE="Monospace"><FONT SIZE=2><I>Exception
- in thread "main" java.lang.UnsatisfiedLinkError: no
- lttvtraceread in java.library.path</I></FONT></FONT></FONT></FONT></P>
- <P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">This
- basically mean that Java can not find the C library you just
- compile. To find any C library, java would normally need to be
- passed a flag like “-Djava.library.path=/somewhere/lib” but
- there seems to be a bug in Eclipse about it, as defined here :
- <A HREF="https://bugs.eclipse.org/bugs/show_bug.cgi?id=290068">https://bugs.eclipse.org/bugs/show_bug.cgi?id=290068</A></FONT></P>
- <P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">Therefore,
- the workaround is to make sure to pass a correct LD_LIBRARY_PATH to
- Eclipse (see section above about “<I>Set library path</I>”). The
- best way to make sure the flag is corerctly passed is to add it in
- front of the command that is called to start Eclipse, on the command
- line or in the desktop shortcut itself. </FONT>
- </P>
- <P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">As
- example, here is the shortcut I use to call Eclipse :</FONT></P>
- <P STYLE="margin-bottom: 0.3cm"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><I>export
- LD_LIBRARY_PATH="/usr/local/lib";
- /usr/local/eclipse/eclipse</I></FONT></FONT></P>
-</OL>
-<P STYLE="margin-bottom: 0.3cm"><BR><BR>
-</P>
-<OL START=4>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">I
- did what you said in 1) but I'm still getting the same error
- <I>:<BR></I><FONT COLOR="#ff0000"><FONT FACE="Monospace"><FONT SIZE=2><I>Exception
- in thread "main" java.lang.UnsatisfiedLinkError: no
- lttvtraceread in java.library.path</I></FONT></FONT></FONT></FONT></P>
- <P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">If
- your LD_LIBRARY_PATH is correct, then the only reason why you might
- get this error is that you did not compile the JNI interface inside
- LTTv. <BR>Go back to “<I>Installation steps</I>” and make sure
- you used the development version of LTTv and that you compiled it
- with the --<I>with-jni-interface</I> <SPAN STYLE="font-style: normal">flag</SPAN>.</FONT></P>
-</OL>
-<P STYLE="margin-bottom: 0.21cm"><BR><BR>
-</P>
-<OL START=5>
- <LI><P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">When
- I run LTTng in Eclipse, at some point, I am getting an error like
- this :</FONT></P>
- <P STYLE="margin-bottom: 0cm"><FONT COLOR="#ff0000"><FONT FACE="Monospace"><FONT SIZE=2><I>Exception
- in thread "main" java.lang.Error: Unresolved compilation
- problem: </I></FONT></FONT></FONT>
- </P>
-</OL>
-<P ALIGN=LEFT STYLE="margin-left: 1.3cm; margin-bottom: 0cm"><FONT COLOR="#ff0000"><FONT FACE="Monospace"><FONT SIZE=2><I>The
-method ltt_someFunction() is undefined for the type JniXYZ</I></FONT></FONT></FONT></P>
-<OL START=6>
- <P STYLE="margin-bottom: 0.21cm"><FONT FACE="Nimbus Roman No9 L, serif">This
- may happen if the LTTv version you are using is not recent enought.
- Make sure you are using the latest development version, recompile
- the latest one if needed. If this doesn't work, make sure you use
- the “Beta” JNI Build, as described in “<I>Download</I>”
- section. If nothing work, please submit a bug report. </FONT>
- </P>
-</OL>
-<P STYLE="margin-bottom: 0.21cm"><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>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>
- <li><a href="install_lttng.html">Installing the LTTng parsing library</a></li>
-</ul>
-
-More information can be found on our <a href="http://wiki.eclipse.org/Linux_Tools_Project/LTTng">wiki page</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>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>
- <li><a href="gettingstarted/install_lttng.html">Installing the LTTng parsing library</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
<?xml version="1.0" encoding="UTF-8"?>
-<?eclipse version="3.4"?>
<plugin>
-
- <extension
- point="org.eclipse.help.toc">
+<!-- This part should be in a documentation plugin -->
+<!-- Configure the help contribution for this 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>
+ primary="true" />
</extension>
-
</plugin>
--- /dev/null
+<?xml version='1.0' encoding='utf-8' ?>
+<toc topic="Linux_Tools_Project/ChangeLog/User_Guide/User-Guide.html" label="LTTng Plug-in User Guide">
+<link toc="toc.xml" />
+<topic href="doc/notices.html" label="Legal"> </topic>
+</toc>
-<?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>
+<?xml version='1.0' encoding='utf-8' ?>
+<toc topic="Linux_Tools_Project/LTTng/User_Guide/User-Guide.html" label="LTTng Plug-in User Guide">
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Guide.html" label="LTTng Plug-in User Guide">
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Guide.html" label="Introduction">
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Guide.html#About_Tracing" label="About Tracing"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Guide.html#Traces_and_Experiments" label="Traces and Experiments"></topic>
+ </topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html" label="Getting Started">
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html#Installing_the_LTTng_parsing_library" label="Installing the LTTng parsing library"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html#Downloading_Sample_Traces" label="Downloading Sample Traces"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html#Installation_Verification" label="Installation Verification"></topic>
+ </topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html" label="User Interface">
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#LTTng_Perspective" label="LTTng Perspective"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Project_View" label="Project View"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Events_View" label="Events View"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Histogram_View" label="Histogram View"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Control_Flow_View" label="Control Flow View">
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Mouse_Control" label="Mouse Control"></topic>
+ </topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Resources_View" label="Resources View">
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Mouse_Control_2" label="Mouse Control"></topic>
+ </topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/User-Interface.html#Statistics_View" label="Statistics View"></topic>
+ </topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/Limitations.html" label="Limitations"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/References.html" label="References"></topic>
+ <topic href="Linux_Tools_Project/LTTng/User_Guide/Updating-This-Document.html" label="Updating This Document"></topic>
+ </topic>
+</toc>
\ No newline at end of file
+++ /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"?>
-<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>
</license>
<requires>
- <import plugin="org.eclipse.ui"/>
<import plugin="org.eclipse.core.runtime"/>
+ <import plugin="org.eclipse.core.resources" version="3.6.0" match="greaterOrEqual"/>
+ <import plugin="org.eclipse.ui"/>
<import plugin="org.eclipse.linuxtools.tmf" version="0.2.0" match="greaterOrEqual"/>
- <import plugin="org.junit"/>
+ <import plugin="org.eclipse.ui.ide" version="3.6.0" match="greaterOrEqual"/>
</requires>
<plugin
projects / deliverable / tracecompass.git / commitdiff
