From b23631efc9adfc6ebf039beb0ad08fd103164876 Mon Sep 17 00:00:00 2001 From: Marc-Andre Laperle Date: Wed, 4 Feb 2015 13:46:27 -0500 Subject: [PATCH] Update Developer Guide for Trace Compass Change-Id: I42a4ace9bdf4ef4fdbfe6feaa49ea29bd343636b Signed-off-by: Marc-Andre Laperle Reviewed-on: https://git.eclipse.org/r/41366 Reviewed-by: Hudson CI Reviewed-by: Alexandre Montplaisir Tested-by: Alexandre Montplaisir --- .../doc/Developer-Guide.mediawiki | 382 ++++++++---------- .../doc/images/AddDependencyTmf.png | Bin 71006 -> 0 bytes .../doc/images/AddDependencyTmfUi.png | Bin 69912 -> 66391 bytes .../doc/images/AddTmfUml2SDLoader.png | Bin 86908 -> 74404 bytes .../doc/images/AddViewExtension1.png | Bin 79035 -> 83006 bytes .../doc/images/AddViewExtension2.png | Bin 66845 -> 59506 bytes .../doc/images/FillSampleLoader.png | Bin 81020 -> 51448 bytes .../doc/images/FillSampleSeqDiagram.png | Bin 65357 -> 56456 bytes .../doc/images/FillSampleViewExtension.png | Bin 27277 -> 55672 bytes .../doc/images/NTTSelectProjects.png | Bin 66561 -> 45713 bytes .../doc/images/NewSampleLoaderClass.png | Bin 76655 -> 70310 bytes .../doc/images/ReferenceExtensions.png | Bin 153384 -> 139110 bytes .../doc/images/RunEclipseApplication.png | Bin 141027 -> 94020 bytes .../images/Screenshot-NewPlug-inProject1.png | Bin 69764 -> 58960 bytes .../images/Screenshot-NewPlug-inProject2.png | Bin 59787 -> 53373 bytes .../images/Screenshot-NewPlug-inProject3.png | Bin 65638 -> 50443 bytes .../doc/images/SelectManifest.png | Bin 26967 -> 14672 bytes .../doc/images/ShowTmfSDView.png | Bin 29750 -> 23594 bytes 18 files changed, 158 insertions(+), 224 deletions(-) delete mode 100644 doc/org.eclipse.tracecompass.doc.dev/doc/images/AddDependencyTmf.png diff --git a/doc/org.eclipse.tracecompass.doc.dev/doc/Developer-Guide.mediawiki b/doc/org.eclipse.tracecompass.doc.dev/doc/Developer-Guide.mediawiki index 507f322aca..f69ae8ed7f 100644 --- a/doc/org.eclipse.tracecompass.doc.dev/doc/Developer-Guide.mediawiki +++ b/doc/org.eclipse.tracecompass.doc.dev/doc/Developer-Guide.mediawiki @@ -50,7 +50,7 @@ Create a '''New''', '''Project...''', '''Plug-in Project''', set the title to '' Now the structure for the Nexus trace Plug-in is set up. -Add a dependency to TMF core and UI by opening the '''MANIFEST.MF''' in '''META-INF''', selecting the '''Dependencies''' tab and '''Add ...''' '''org.eclipse.linuxtools.tmf.core''' and '''org.eclipse.linuxtools.tmf.ui'''. +Add a dependency to TMF core and UI by opening the '''MANIFEST.MF''' in '''META-INF''', selecting the '''Dependencies''' tab and '''Add ...''' '''org.eclipse.tracecompass.tmf.core''' and '''org.eclipse.tracecompass.tmf.ui'''. [[Image:images/NTTAddDepend.png]]
[[Image:images/NTTSelectProjects.png]]
@@ -78,9 +78,9 @@ It will need to implement: * parseEvent (read the next element in the trace) For reference, there is an example implementation of the Nexus Trace file in -org.eclipse.linuxtools.tracing.examples.core.trace.nexus.NexusTrace.java. +org.eclipse.tracecompass.tracing.examples.core.trace.nexus.NexusTrace.java. -In this example, the '''validate''' function checks first checks if the file +In this example, the '''validate''' function first checks if the file exists, then makes sure that it is really a file, and not a directory. Then we attempt to read the file header, to make sure that it is really a Nexus Trace. If that check passes, we return a TmfValidationStatus with a confidence of 20. @@ -118,7 +118,7 @@ The trace location will be a long, representing the rank in the file. The '''Tmf === The ''org.eclipse.linuxtools.tmf.core.tracetype'' and ''org.eclipse.linuxtools.tmf.ui.tracetypeui'' plug-in extension point === -One should implement the ''tmf.core.tracetype'' extension in their own plug-in. +One should use the ''tmf.core.tracetype'' extension point in their own plug-in. In this example, the Nexus trace plug-in will be modified. The '''plugin.xml''' file in the ui plug-in needs to be updated if one wants users to access the given event type. It can be updated in the Eclipse plug-in editor. @@ -156,10 +156,10 @@ In the end, the extension menu should look like this. [[Image:images/NTTPluginxmlComplete.png]]
== Other Considerations == -The ''org.eclipse.linuxtools.tmf.ui.viewers.events.TmfEventsTable'' provides additional features that are active when the event class (defined in '''event type''') implements certain additional interfaces. +The ''org.eclipse.tracecompass.tmf.ui.viewers.events.TmfEventsTable'' provides additional features that are active when the event class (defined in '''event type''') implements certain additional interfaces. === Collapsing of repetitive events === -By implementing the interface ''org.eclipse.linuxtools.tmf.core.event.collapse.ITmfCollapsibleEvent'' the events table will allow to collapse repetitive events by selecting the menu item '''Collapse Events''' after pressing the right mouse button in the table. +By implementing the interface ''org.eclipse.tracecompass.tmf.core.event.collapse.ITmfCollapsibleEvent'' the events table will allow to collapse repetitive events by selecting the menu item '''Collapse Events''' after pressing the right mouse button in the table. == Best Practices == @@ -173,7 +173,7 @@ By implementing the interface ''org.eclipse.linuxtools.tmf.core.event.collapse.I == Download the Code == The described example is available in the -org.eclipse.linuxtools.tracing.examples.(tests.)trace.nexus packages with a +org.eclipse.tracecompass.tracing.examples.(tests.)trace.nexus packages with a trace generator and a quick test case. == Optional Trace Type Attributes == @@ -182,7 +182,7 @@ After defining the trace type as described in the previous chapters it is possib === Default Editor === -The '''defaultEditor''' attribute of the '''org.eclipse.tmf.ui.tracetypeui''' +The '''defaultEditor''' attribute of the '''org.eclipse.linuxtools.tmf.ui.tracetypeui''' extension point allows for configuring the editor to use for displaying the events. If omitted, the ''TmfEventsEditor'' is used as default. @@ -198,7 +198,7 @@ other pages can display other aspects of the trace. === Events Table Type === -The '''eventsTableType''' attribute of the '''org.eclipse.tmf.ui.tracetypeui''' +The '''eventsTableType''' attribute of the '''org.eclipse.linuxtools.tmf.ui.tracetypeui''' extension point allows for configuring the events table class to use in the default events editor. If omitted, the default events table will be used. @@ -208,10 +208,10 @@ This can be done by selecting the trace type in the plug-in manifest editor. Then click the right mouse button and select '''New -> eventsTableType''' in the context sensitive menu. Then select the newly added attribute and click on ''class'' on the right side of the manifest editor. The new class wizard will -open. The ''superclass'' field will be already filled with the class ''org.eclipse.linuxtools.tmf.ui.viewers.events.TmfEventsTable''. +open. The ''superclass'' field will be already filled with the class ''org.eclipse.tracecompass.tmf.ui.viewers.events.TmfEventsTable''. By using this attribute, a table with different columns than the default columns -can be defined. See the class org.eclipse.linuxtools.internal.lttng2.kernel.ui.viewers.events.Lttng2EventsTable +can be defined. See the class org.eclipse.tracecompass.internal.gdbtrace.ui.views.events.GdbEventsTable for an example implementation. = View Tutorial = @@ -225,15 +225,15 @@ This tutorial will cover concepts like: * Data requests (TmfEventRequest) * SWTChart integration -'''Note''': TMF 3.0.0 provides base implementations for generating SWTChart viewers and views. For more details please refer to chapter [[#TMF Built-in Views and Viewers]]. +'''Note''': Trace Compass 0.1.0 provides base implementations for generating SWTChart viewers and views. For more details please refer to chapter [[#TMF Built-in Views and Viewers]]. === Prerequisites === -The tutorial is based on Eclipse 4.4 (Eclipse Luna), TMF 3.0.0 and SWTChart 0.7.0. If you are using TMF from the source repository, SWTChart is already included in the target definition file (see org.eclipse.linuxtools.lttng.target). You can also install it manually by using the Orbit update site. http://download.eclipse.org/tools/orbit/downloads/ +The tutorial is based on Eclipse 4.4 (Eclipse Luna), Trace Compass 0.1.0 and SWTChart 0.7.0. If you are using TMF from the source repository, SWTChart is already included in the target definition file (see org.eclipse.tracecompass.target). You can also install it manually by using the Orbit update site. http://download.eclipse.org/tools/orbit/downloads/ === Creating an Eclipse UI Plug-in === -To create a new project with name org.eclipse.linuxtools.tmf.sample.ui select '''File -> New -> Project -> Plug-in Development -> Plug-in Project'''.
+To create a new project with name org.eclipse.tracecompass.tmf.sample.ui select '''File -> New -> Project -> Plug-in Development -> Plug-in Project'''.
[[Image:images/Screenshot-NewPlug-inProject1.png]]
[[Image:images/Screenshot-NewPlug-inProject2.png]]
@@ -245,8 +245,8 @@ To create a new project with name org.eclipse.linuxtools.tmf.sample.ui select '' To open the plug-in manifest, double-click on the MANIFEST.MF file.
[[Image:images/SelectManifest.png]]
-Change to the Dependencies tab and select '''Add...''' of the ''Required Plug-ins'' section. A new dialog box will open. Next find plug-in ''org.eclipse.linuxtools.tmf.core'' and press '''OK'''
-Following the same steps, add ''org.eclipse.linuxtools.tmf.ui'' and ''org.swtchart''.
+Change to the Dependencies tab and select '''Add...''' of the ''Required Plug-ins'' section. A new dialog box will open. Next find plug-in ''org.eclipse.tracecompass.tmf.core'' and press '''OK'''
+Following the same steps, add ''org.eclipse.tracecompass.tmf.ui'' and ''org.swtchart''.
[[Image:images/AddDependencyTmfUi.png]]
Change to the Extensions tab and select '''Add...''' of the ''All Extension'' section. A new dialog box will open. Find the view extension ''org.eclipse.ui.views'' and press '''Finish'''.
@@ -261,7 +261,7 @@ A new view entry has been created. Fill in the fields ''id'' and ''name''. For ' This will generate an empty class. Once the quick fixes are applied, the following code is obtained:
-package org.eclipse.linuxtools.tmf.sample.ui;
+package org.eclipse.tracecompass.tmf.sample.ui;
 
 import org.eclipse.swt.widgets.Composite;
 import org.eclipse.ui.part.ViewPart;
@@ -303,7 +303,7 @@ First, we can add an empty chart to the view and initialize some of its componen
     private static final String Y_AXIS_TITLE = "Signal";
     private static final String X_AXIS_TITLE = "Time";
     private static final String FIELD = "value"; // The name of the field that we want to display on the Y axis
-    private static final String VIEW_ID = "org.eclipse.linuxtools.tmf.sample.ui.view";
+    private static final String VIEW_ID = "org.eclipse.tracecompass.tmf.sample.ui.view";
     private Chart chart;
     private ITmfTrace currentTrace;
 
@@ -560,30 +560,30 @@ In summary, we have implemented a simple TMF view using the SWTChart library. We
 
 == TMF Built-in Views and Viewers ==
 
-TMF provides base implementations for several types of views and viewers for generating custom X-Y-Charts, Time Graphs, or Trees. They are well integrated with various TMF features such as reading traces and time synchronization with other views. They also handle mouse events for navigating the trace and view, zooming or presenting detailed information at mouse position. The code can be found in the TMF UI plug-in ''org.eclipse.linuxtools.tmf.ui''. See below for a list of relevant java packages:
+TMF provides base implementations for several types of views and viewers for generating custom X-Y-Charts, Time Graphs, or Trees. They are well integrated with various TMF features such as reading traces and time synchronization with other views. They also handle mouse events for navigating the trace and view, zooming or presenting detailed information at mouse position. The code can be found in the TMF UI plug-in ''org.eclipse.tracecompass.tmf.ui''. See below for a list of relevant java packages:
 
 * Generic
-** ''org.eclipse.linuxtools.tmf.ui.views'': Common TMF view base classes
+** ''org.eclipse.tracecompass.tmf.ui.views'': Common TMF view base classes
 * X-Y-Chart
-** ''org.eclipse.linuxtools.tmf.ui.viewers.xycharts'': Common base classes for X-Y-Chart viewers based on SWTChart
-** ''org.eclipse.linuxtools.tmf.ui.viewers.xycharts.barcharts'': Base classes for bar charts
-** ''org.eclipse.linuxtools.tmf.ui.viewers.xycharts.linecharts'': Base classes for line charts
+** ''org.eclipse.tracecompass.tmf.ui.viewers.xycharts'': Common base classes for X-Y-Chart viewers based on SWTChart
+** ''org.eclipse.tracecompass.tmf.ui.viewers.xycharts.barcharts'': Base classes for bar charts
+** ''org.eclipse.tracecompass.tmf.ui.viewers.xycharts.linecharts'': Base classes for line charts
 * Time Graph View
-** ''org.eclipse.linuxtools.tmf.ui.widgets.timegraph'': Base classes for time graphs e.g. Gantt-charts
+** ''org.eclipse.tracecompass.tmf.ui.widgets.timegraph'': Base classes for time graphs e.g. Gantt-charts
 * Tree Viewer
-** ''org.eclipse.linuxtools.tmf.ui.viewers.tree'': Base classes for TMF specific tree viewers
+** ''org.eclipse.tracecompass.tmf.ui.viewers.tree'': Base classes for TMF specific tree viewers
 
 Several features in TMF and the Eclipse LTTng integration are using this framework and can be used as example for further developments:
 * X-Y- Chart
-** ''org.eclipse.linuxtools.internal.lttng2.ust.ui.views.memusage.MemUsageView.java''
-** ''org.eclipse.linuxtools.internal.lttng2.kernel.ui.views.cpuusage.CpuUsageView.java''
-** ''org.eclipse.linuxtools.tracing.examples.ui.views.histogram.NewHistogramView.java''
+** ''org.eclipse.tracecompass.internal.lttng2.ust.ui.views.memusage.MemUsageView.java''
+** ''org.eclipse.tracecompass.analysis.os.linux.ui.views.cpuusage.CpuUsageView.java''
+** ''org.eclipse.tracecompass.tracing.examples.ui.views.histogram.NewHistogramView.java''
 * Time Graph View
-** ''org.eclipse.linuxtools.internal.lttng2.kernel.ui.views.controlflow.ControlFlowView.java''
-** ''org.eclipse.linuxtools.internal.lttng2.kernel.ui.views.resources.ResourcesView.java''
+** ''org.eclipse.tracecompass.analysis.os.linux.ui.views.controlflow.ControlFlowView.java''
+** ''org.eclipse.tracecompass.analysis.os.linux.ui.views.resources.ResourcesView.java''
 * Tree Viewer
-** ''org.eclipse.linuxtools.tmf.ui.views.statesystem.TmfStateSystemExplorer.java''
-** ''org.eclipse.linuxtools.internal.lttng2.kernel.ui.views.cpuusage.CpuUsageComposite.java''
+** ''org.eclipse.tracecompass.tmf.ui.views.statesystem.TmfStateSystemExplorer.java''
+** ''org.eclipse.tracecompass.analysis.os.linux.ui.views.cpuusage.CpuUsageComposite.java''
 
 = Component Interaction =
 
@@ -865,7 +865,7 @@ Received by views that analyze packet streams.
 
 == Debugging ==
 
-TMF has built-in Eclipse tracing support for the debugging of signal interaction between components. To enable it, open the '''Run/Debug Configuration...''' dialog, select a configuration, click the '''Tracing''' tab, select the plug-in '''org.eclipse.linuxtools.tmf.core''', and check the '''signal''' item.
+TMF has built-in Eclipse tracing support for the debugging of signal interaction between components. To enable it, open the '''Run/Debug Configuration...''' dialog, select a configuration, click the '''Tracing''' tab, select the plug-in '''org.eclipse.tracecompass.tmf.core''', and check the '''signal''' item.
 
 All signals sent and received will be logged to the file TmfTrace.log located in the Eclipse home directory.
 
@@ -948,7 +948,7 @@ have both a value and sub-attributes, so they are like files and directories at
 the same time. We are then able to refer to every single attribute with its
 path in the tree.
 
-For example, in the attribute tree for LTTng kernel traces, we use the following
+For example, in the attribute tree for Linux kernel traces, we use the following
 attributes, among others:
 
 
@@ -1115,7 +1115,7 @@ of the same attribute over a time range).
 This section will describe the public interface and classes that can be used if
 you want to use the state system.
 
-=== Main classes in org.eclipse.linuxtools.tmf.core.statesystem ===
+=== Main classes in org.eclipse.tracecompass.tmf.core.statesystem ===
 
 ==== ITmfStateProvider / AbstractTmfStateProvider ====
 
@@ -1270,7 +1270,7 @@ automatically when it reaches the end of the trace.
 
 === Other relevant interfaces ===
 
-==== o.e.l.tmf.core.statevalue.ITmfStateValue ====
+==== ITmfStateValue ====
 
 This is the interface used to represent state values. Those are used when
 inserting state changes in the provider, and is also part of the state intervals
@@ -1282,7 +1282,7 @@ object inside the state value, one can use the .unbox* methods.
 
 Note: Do not instantiate null values manually, use TmfStateValue.nullValue()
 
-==== o.e.l.tmf.core.interval.ITmfStateInterval ====
+==== ITmfStateInterval ====
 
 This is the interface to represent the state intervals, which are stored in the
 state history backend, and are returned when doing state system queries. A very
@@ -1291,7 +1291,7 @@ self-descriptive.
 
 === Exceptions ===
 
-The following exceptions, found in o.e.l.tmf.core.exceptions, are related to
+The following exceptions, found in o.e.t.statesystem.core.exceptions, are related to
 state system activities.
 
 ==== AttributeNotFoundException ====
@@ -1468,24 +1468,22 @@ Also, we will use integer state values to represent "running" or "idle", instead
 of saving the strings that would get repeated every time. This will help in
 reducing the size of the history file.
 
-First we will define a state provider in MyStateProvider. Then, assuming we
-have already implemented a custom trace type extending CtfTmfTrace, we will add
-a section to it to make it build a state system using the provider we defined
-earlier. Finally, we will show some example code that can query the state
-system, which would normally go in a view or analysis module.
+First we will define a state provider in MyStateProvider. Then, we define an
+analysis module that takes care of creating the state provider. The analysis
+module will also contain code that can query the state system.
 
 === State Provider ===
 
 
-import org.eclipse.linuxtools.tmf.core.ctfadaptor.CtfTmfEvent;
-import org.eclipse.linuxtools.tmf.core.event.ITmfEvent;
-import org.eclipse.linuxtools.tmf.core.exceptions.AttributeNotFoundException;
-import org.eclipse.linuxtools.tmf.core.exceptions.StateValueTypeException;
-import org.eclipse.linuxtools.tmf.core.exceptions.TimeRangeException;
-import org.eclipse.linuxtools.tmf.core.statesystem.AbstractTmfStateProvider;
-import org.eclipse.linuxtools.tmf.core.statevalue.ITmfStateValue;
-import org.eclipse.linuxtools.tmf.core.statevalue.TmfStateValue;
-import org.eclipse.linuxtools.tmf.core.trace.ITmfTrace;
+import org.eclipse.tracecompass.statesystem.core.exceptions.AttributeNotFoundException;
+import org.eclipse.tracecompass.statesystem.core.exceptions.StateValueTypeException;
+import org.eclipse.tracecompass.statesystem.core.exceptions.TimeRangeException;
+import org.eclipse.tracecompass.statesystem.core.statevalue.ITmfStateValue;
+import org.eclipse.tracecompass.statesystem.core.statevalue.TmfStateValue;
+import org.eclipse.tracecompass.tmf.core.event.ITmfEvent;
+import org.eclipse.tracecompass.tmf.core.statesystem.AbstractTmfStateProvider;
+import org.eclipse.tracecompass.tmf.core.trace.ITmfTrace;
+import org.eclipse.tracecompass.tmf.ctf.core.event.CtfTmfEvent;
 
 /**
  * Example state system provider.
@@ -1541,7 +1539,8 @@ public class MyStateProvider extends AbstractTmfStateProvider {
 
         try {
 
-            if (event.getEventName().equals("sched_switch")) {
+            if (event.getType().getName().equals("sched_switch")) {
+                ITmfStateSystemBuilder ss = getStateSystemBuilder();
                 int quark = ss.getQuarkAbsoluteAndAdd("CPUs", String.valueOf(event.getCPU()), "Status");
                 ITmfStateValue value;
                 if (nextTid > 0) {
@@ -1577,96 +1576,38 @@ public class MyStateProvider extends AbstractTmfStateProvider {
 }
 
-=== Trace type definition === +=== Analysis module definition ===
-import java.io.File;
-
-import org.eclipse.core.resources.IProject;
-import org.eclipse.core.runtime.IStatus;
-import org.eclipse.core.runtime.Status;
-import org.eclipse.linuxtools.tmf.core.ctfadaptor.CtfTmfTrace;
-import org.eclipse.linuxtools.tmf.core.exceptions.TmfTraceException;
-import org.eclipse.linuxtools.tmf.core.statesystem.ITmfStateProvider;
-import org.eclipse.linuxtools.tmf.core.statesystem.ITmfStateSystem;
-import org.eclipse.linuxtools.tmf.core.statesystem.TmfStateSystemFactory;
-import org.eclipse.linuxtools.tmf.core.trace.TmfTraceManager;
+import static org.eclipse.tracecompass.common.core.NonNullUtils.checkNotNull;
 
-/**
- * Example of a custom trace type using a custom state provider.
- *
- * @author Alexandre Montplaisir
- */
-public class MyTraceType extends CtfTmfTrace {
-
-    /** The file name of the history file  */
-    public final static String HISTORY_FILE_NAME = "mystatefile.ht";
-
-    /** ID of the state system we will build */
-    public static final String STATE_ID = "org.eclipse.linuxtools.lttng2.example";
-
-    /**
-     * Default constructor
-     */
-    public MyTraceType() {
-        super();
-    }
-
-    @Override
-    public IStatus validate(final IProject project, final String path)  {
-        /*
-         * Add additional validation code here, and return a IStatus.ERROR if
-         * validation fails.
-         */
-        return Status.OK_STATUS;
-    }
-
-    @Override
-    protected void buildStateSystem() throws TmfTraceException {
-        super.buildStateSystem();
-
-        /* Build the custom state system for this trace */
-        String directory = TmfTraceManager.getSupplementaryFileDir(this);
-        final File htFile = new File(directory + HISTORY_FILE_NAME);
-        final ITmfStateProvider htInput = new MyStateProvider(this);
-
-        ITmfStateSystem ss = TmfStateSystemFactory.newFullHistory(htFile, htInput, false);
-        fStateSystems.put(STATE_ID, ss);
-    }
-
-}
-
- -=== Query code === - -
 import java.util.List;
 
-import org.eclipse.linuxtools.tmf.core.exceptions.AttributeNotFoundException;
-import org.eclipse.linuxtools.tmf.core.exceptions.StateSystemDisposedException;
-import org.eclipse.linuxtools.tmf.core.exceptions.TimeRangeException;
-import org.eclipse.linuxtools.tmf.core.interval.ITmfStateInterval;
-import org.eclipse.linuxtools.tmf.core.statesystem.ITmfStateSystem;
-import org.eclipse.linuxtools.tmf.core.statevalue.ITmfStateValue;
-import org.eclipse.linuxtools.tmf.core.trace.ITmfTrace;
+import org.eclipse.tracecompass.statesystem.core.exceptions.AttributeNotFoundException;
+import org.eclipse.tracecompass.statesystem.core.exceptions.StateSystemDisposedException;
+import org.eclipse.tracecompass.statesystem.core.exceptions.TimeRangeException;
+import org.eclipse.tracecompass.statesystem.core.interval.ITmfStateInterval;
+import org.eclipse.tracecompass.statesystem.core.statevalue.ITmfStateValue;
+import org.eclipse.tracecompass.tmf.core.statesystem.ITmfStateProvider;
+import org.eclipse.tracecompass.tmf.core.statesystem.TmfStateSystemAnalysisModule;
+import org.eclipse.tracecompass.tmf.core.trace.ITmfTrace;
 
 /**
- * Class showing examples of state system queries.
+ * Class showing examples of a StateSystemAnalysisModule with state system queries.
  *
  * @author Alexandre Montplaisir
  */
-public class QueryExample {
+public class MyStateSystemAnalysisModule extends TmfStateSystemAnalysisModule {
 
-    private final ITmfStateSystem ss;
+	@Override
+	protected ITmfStateProvider createStateProvider() {
+        ITmfTrace trace = checkNotNull(getTrace());
+		return new MyStateProvider(trace);
+	}
 
-    /**
-     * Constructor
-     *
-     * @param trace
-     *            Trace that this "view" will display.
-     */
-    public QueryExample(ITmfTrace trace) {
-        ss = trace.getStateSystems().get(MyTraceType.STATE_ID);
+    @Override
+    protected StateSystemBackendType getBackendType() {
+        return StateSystemBackendType.FULL;
     }
 
     /**
@@ -1683,8 +1624,8 @@ public class QueryExample {
      */
     public boolean cpuIsRunning(int cpu, long timestamp) {
         try {
-            int quark = ss.getQuarkAbsolute("CPUs", String.valueOf(cpu), "Status");
-            ITmfStateValue value = ss.querySingleState(timestamp, quark).getStateValue();
+            int quark = getStateSystem().getQuarkAbsolute("CPUs", String.valueOf(cpu), "Status");
+            ITmfStateValue value = getStateSystem().querySingleState(timestamp, quark).getStateValue();
 
             if (value.equals(MyStateProvider.RUNNING)) {
                 return true;
@@ -1699,13 +1640,11 @@ public class QueryExample {
              * Handle the case where the attribute does not exist in the state
              * system (no CPU with this number, etc.)
              */
-             ...
         } catch (TimeRangeException e) {
             /*
              * Handle the case where 'timestamp' is outside of the range of the
              * history.
              */
-             ...
         } catch (StateSystemDisposedException e) {
             /*
              * Handle the case where the state system is being disposed. If this
@@ -1732,13 +1671,13 @@ public class QueryExample {
 
         try {
             /* Get the list of the quarks we are interested in. */
-            List quarks = ss.getQuarks("CPUs", "*", "Status");
+            List quarks = getStateSystem().getQuarks("CPUs", "*", "Status");
 
             /*
              * Get the full state at our target timestamp (it's better than
              * doing an arbitrary number of single queries).
              */
-            List state = ss.queryFullState(timestamp);
+            List state = getStateSystem().queryFullState(timestamp);
 
             /* Look at the value of the state for each quark */
             for (Integer quark : quarks) {
@@ -1753,10 +1692,8 @@ public class QueryExample {
              * Handle the case where 'timestamp' is outside of the range of the
              * history.
              */
-             ...
         } catch (StateSystemDisposedException e) {
             /* Handle the case where the state system is being disposed. */
-            ...
         }
         return count;
     }
@@ -1821,7 +1758,6 @@ The following chapters describe the Sequence Diagram Framework as well as a refe
 In the UML2 Sequence Diagram Framework an Eclipse extension point is defined so that other plug-ins can contribute code to create sequence diagram. 
 
 '''Identifier''': org.eclipse.linuxtools.tmf.ui.uml2SDLoader
-'''Since''': 1.0
'''Description''': This extension point aims to list and connect any UML2 Sequence Diagram loader.
'''Configuration Markup''':
@@ -1850,8 +1786,8 @@ default (true | false) *id - A unique identifier for this uml2SDLoader. This is not mandatory as long as the id attribute cannot be retrieved by the provider plug-in. The class attribute is the one on which the underlying algorithm relies. *name - An name of the extension instance. -*class - The implementation of this UML2 SD viewer loader. The class must implement org.eclipse.linuxtools.tmf.ui.views.uml2sd.load.IUml2SDLoader. -*view - The view ID of the view that this loader aims to populate. Either org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView itself or a extension of org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView. +*class - The implementation of this UML2 SD viewer loader. The class must implement org.eclipse.tracecompass.tmf.ui.views.uml2sd.load.IUml2SDLoader. +*view - The view ID of the view that this loader aims to populate. Either org.eclipse.tracecompass.tmf.ui.views.uml2sd.SDView itself or a extension of org.eclipse.tracecompass.tmf.ui.views.uml2sd.SDView. *default - Set to true to make this loader the default one for the view; in case of several default loaders, first one coming from extensions list is taken. @@ -1864,7 +1800,7 @@ With this extension point, a loader class is associated with a Sequence Diagram == Sequence Diagram View == -For this extension point a Sequence Diagram View has to be defined as well. The Sequence Diagram View class implementation is provided by the plug-in ''org.eclipse.linuxtools.tmf.ui'' (''org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView'') and can be used as is or can also be sub-classed. For that, a view extension has to be added to the ''plugin.xml''. +For this extension point a Sequence Diagram View has to be defined as well. The Sequence Diagram View class implementation is provided by the plug-in ''org.eclipse.tracecompass.tmf.ui'' (''org.eclipse.tracecompass.tmf.ui.views.uml2sd.SDView'') and can be used as is or can also be sub-classed. For that, a view extension has to be added to the ''plugin.xml''. === Supported Widgets === @@ -1924,7 +1860,7 @@ The tutorial is based on Eclipse 4.4 (Eclipse Luna) and TMF 3.0.0. === Creating an Eclipse UI Plug-in === -To create a new project with name org.eclipse.linuxtools.tmf.sample.ui select '''File -> New -> Project -> Plug-in Development -> Plug-in Project'''.
+To create a new project with name org.eclipse.tracecompass.tmf.sample.ui select '''File -> New -> Project -> Plug-in Development -> Plug-in Project'''.
[[Image:images/Screenshot-NewPlug-inProject1.png]]
[[Image:images/Screenshot-NewPlug-inProject2.png]]
@@ -1936,7 +1872,7 @@ To create a new project with name org.eclipse.linuxtools.tmf.sample.ui select '' To open the plug-in manifest, double-click on the MANIFEST.MF file.
[[Image:images/SelectManifest.png]]
-Change to the Dependencies tab and select '''Add...''' of the ''Required Plug-ins'' section. A new dialog box will open. Next find plug-ins ''org.eclipse.linuxtools.tmf.ui'' and ''org.eclipse.linuxtools.tmf.core'' and then press '''OK'''
+Change to the Dependencies tab and select '''Add...''' of the ''Required Plug-ins'' section. A new dialog box will open. Next find plug-ins ''org.eclipse.tracecompass.tmf.ui'' and ''org.eclipse.tracecompass.tmf.core'' and then press '''OK'''
[[Image:images/AddDependencyTmfUi.png]]
Change to the Extensions tab and select '''Add...''' of the ''All Extension'' section. A new dialog box will open. Find the view extension ''org.eclipse.ui.views'' and press '''Finish'''.
@@ -1945,7 +1881,7 @@ Change to the Extensions tab and select '''Add...''' of the ''All Extension'' se To create a Sequence Diagram View, click the right mouse button. Then select '''New -> view'''
[[Image:images/AddViewExtension2.png]]
-A new view entry has been created. Fill in the fields ''id'', ''name'' and ''class''. Note that for ''class'' the SD view implementation (''org.eclipse.linuxtools.tmf.ui.views.SDView'') of the TMF UI plug-in is used.
+A new view entry has been created. Fill in the fields ''id'', ''name'' and ''class''. Note that for ''class'' the SD view implementation (''org.eclipse.tracecompass.tmf.ui.views.SDView'') of the TMF UI plug-in is used.
[[Image:images/FillSampleSeqDiagram.png]]
The view is prepared. Run the Example. To launch the an Eclipse Application select the ''Overview'' tab and click on '''Launch an Eclipse Application'''
@@ -1963,9 +1899,6 @@ Close the Example Application. After defining the Sequence Diagram View it's time to create the ''uml2SDLoader'' Extension.
-Before doing that add a dependency to TMF. For that select '''Add...''' of the ''Required Plug-ins'' section. A new dialog box will open. Next find plug-in ''org.eclipse.linuxtools.tmf'' and press '''OK'''
-[[Image:images/AddDependencyTmf.png]]
- To create the loader extension, change to the Extensions tab and select '''Add...''' of the ''All Extension'' section. A new dialog box will open. Find the extension ''org.eclipse.linuxtools.tmf.ui.uml2SDLoader'' and press '''Finish'''.
[[Image:images/AddTmfUml2SDLoader.png]]
@@ -1975,13 +1908,13 @@ A new 'uml2SDLoader'' extension has been created. Fill in fields ''id'', ''name' Then click on ''class'' (see above) to open the new class dialog box. Fill in the relevant fields and select '''Finish'''.
[[Image:images/NewSampleLoaderClass.png]]
-A new Java class will be created which implements the interface ''org.eclipse.linuxtools.tmf.ui.views.uml2sd.load.IUml2SDLoader''.
+A new Java class will be created which implements the interface ''org.eclipse.tracecompass.tmf.ui.views.uml2sd.load.IUml2SDLoader''.
-package org.eclipse.linuxtools.tmf.sample.ui;
+package org.eclipse.tracecompass.tmf.sample.ui;
 
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.load.IUml2SDLoader;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.SDView;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.load.IUml2SDLoader;
 
 public class SampleLoader implements IUml2SDLoader {
 
@@ -2013,18 +1946,19 @@ public class SampleLoader implements IUml2SDLoader {
 Next is to implement the methods of the IUml2SDLoader interface method. The following code snippet shows how to create the major sequence diagram elements. Please note that no time information is stored.
-package org.eclipse.linuxtools.tmf.sample.ui;
-
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.AsyncMessage;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.AsyncMessageReturn;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.ExecutionOccurrence;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.Frame;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.Lifeline;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.Stop;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.SyncMessage;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.core.SyncMessageReturn;
-import org.eclipse.linuxtools.tmf.ui.views.uml2sd.load.IUml2SDLoader;
+package org.eclipse.tracecompass.tmf.sample.ui;
+
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.SDView;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.AsyncMessage;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.AsyncMessageReturn;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.EllipsisMessage;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.ExecutionOccurrence;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.Frame;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.Lifeline;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.Stop;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.SyncMessage;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.SyncMessageReturn;
+import org.eclipse.tracecompass.tmf.ui.views.uml2sd.load.IUml2SDLoader;
 
 public class SampleLoader implements IUml2SDLoader {
 
@@ -2181,7 +2115,7 @@ Now it's time to run the example application. To launch the Example Application
 
 === Adding time information ===
 
-To add time information in sequence diagram the timestamp has to be set for each message. The sequence diagram framework uses the ''TmfTimestamp'' class of plug-in ''org.eclipse.linuxtools.tmf.core''. Use ''setTime()'' on each message ''SyncMessage'' since start and end time are the same. For each ''AsyncMessage'' set start and end time separately by using methods ''setStartTime'' and ''setEndTime''. For example: 
+To add time information in sequence diagram the timestamp has to be set for each message. The sequence diagram framework uses the ''TmfTimestamp'' class of plug-in ''org.eclipse.tracecompass.tmf.core''. Use ''setTime()'' on each message ''SyncMessage'' since start and end time are the same. For each ''AsyncMessage'' set start and end time separately by using methods ''setStartTime'' and ''setEndTime''. For example:
     private void createFrame() {
@@ -2235,7 +2169,7 @@ To use the basic paging provider, first the interface methods of the ''ISDPaging
 
 public class SampleLoader implements IUml2SDLoader, ISDPagingProvider {
     //...
-    private page = 0;
+    private int page = 0;
     
     @Override
     public void dispose() {
@@ -2447,7 +2381,7 @@ public class SampleLoader implements IUml2SDLoader, ISDPagingProvider, ISDFindPr
     }
 
     @Override
-    public boolean filter(List list) {
+    public boolean filter(List list) {
         return false;
     }
     //...
@@ -2597,7 +2531,7 @@ public class OpenSDView extends AbstractHandler {
         try {
             IWorkbenchPage persp = TmfUiPlugin.getDefault().getWorkbench().getActiveWorkbenchWindow().getActivePage();
             SDView view = (SDView) persp.showView("org.eclipse.linuxtools.ust.examples.ui.componentinteraction");
-            LoadersManager.getLoadersManager().createLoader("org.eclipse.linuxtools.tmf.ui.views.uml2sd.impl.TmfUml2SDSyncLoader", view);
+            LoadersManager.getLoadersManager().createLoader("org.eclipse.tracecompass.tmf.ui.views.uml2sd.impl.TmfUml2SDSyncLoader", view);
         } catch (PartInitException e) {
             throw new ExecutionException("PartInitException caught: ", e);
         }
@@ -2608,7 +2542,7 @@ public class OpenSDView extends AbstractHandler {
 
 === Downloading the Tutorial ===
 
-Use the following link to download the source code of the tutorial [http://wiki.eclipse.org/images/e/e6/SamplePlugin.zip Plug-in of Tutorial].
+Use the following link to download the source code of the tutorial [https://wiki.eclipse.org/images/7/79/SamplePluginTC.zip Plug-in of Tutorial].
 
 == Integration of Tracing and Monitoring Framework with Sequence Diagram Framework ==
 
@@ -2659,7 +2593,7 @@ The reference loader uses TMF Experiments to access traces and to request data f
 
 The reference loader use the TMF Event Request Framework to request events from the experiment and its traces.
 
-When opening a traces (which is triggered by signal ''TmfExperimentSelected'') or when opening the Sequence Diagram View after a trace had been opened previously, a TMF background request is initiated to index the trace and to fill in the first page of the sequence diagram. The purpose of the indexing is to store time ranges for pages with 10000 messages per page. This allows quickly to move to certain pages in a trace without having to re-parse from the beginning. The request is called indexing request.
+When opening a trace (which is triggered by signal ''TmfTraceSelectedSignal'') or when opening the Sequence Diagram View after a trace had been opened previously, a TMF background request is initiated to index the trace and to fill in the first page of the sequence diagram. The purpose of the indexing is to store time ranges for pages with 10000 messages per page. This allows quickly to move to certain pages in a trace without having to re-parse from the beginning. The request is called indexing request.
 
 When switching pages, the a TMF foreground event request is initiated to retrieve the corresponding events from the experiment. It uses the time range stored in the index for the respective page.
 
@@ -2687,7 +2621,7 @@ Note that combined traces of multiple components, that contain the trace informa
 
 === Trace Format ===
 
-The reference implementation in class ''TmfUml2SDSyncLoader'' in package ''org.eclipse.linuxtools.tmf.ui.views.uml2sd.impl'' analyzes events from type ''ITmfEvent'' and creates events type ''ITmfSyncSequenceDiagramEvent'' if the ''ITmfEvent'' contains all relevant information information. The parsing algorithm looks like as follows:
+The reference implementation in class ''TmfUml2SDSyncLoader'' in package ''org.eclipse.tracecompass.tmf.ui.views.uml2sd.impl'' analyzes events from type ''ITmfEvent'' and creates events type ''ITmfSyncSequenceDiagramEvent'' if the ''ITmfEvent'' contains all relevant information information. The parsing algorithm looks like as follows:
 
 
     /**
@@ -2721,7 +2655,7 @@ The analysis looks for event type Strings containing ''SEND'' and ''RECEIVE''. I
 
 An example CTF (Common Trace Format) trace is provided that contains trace events with sequence diagram information. To download the reference trace, use the following link: [https://wiki.eclipse.org/images/3/35/ReferenceTrace.zip Reference Trace].
 
-Run an Eclipse application with TMF 3.0 or later installed. To open the Reference Sequence Diagram View, select '''Windows -> Show View -> Other... -> TMF -> Sequence Diagram''' 
+Run an Eclipse application with Trace Compass 0.1.0 or later installed. To open the Reference Sequence Diagram View, select '''Windows -> Show View -> Other... -> Tracing -> Sequence Diagram'''
[[Image:images/ShowTmfSDView.png]]
A blank Sequence Diagram View will open. @@ -2742,7 +2676,7 @@ Now the reference implementation can be explored. To demonstrate the view featur === Extending the Reference Loader === -In some case it might be necessary to change the implementation of the analysis of each ''TmfEvent'' for the generation of ''Sequence Diagram Events''. For that just extend the class ''TmfUml2SDSyncLoader'' and overwrite the method ''protected ITmfSyncSequenceDiagramEvent getSequnceDiagramEvent(TmfEvent tmfEvent)'' with your own implementation. +In some case it might be necessary to change the implementation of the analysis of each ''TmfEvent'' for the generation of ''Sequence Diagram Events''. For that just extend the class ''TmfUml2SDSyncLoader'' and overwrite the method ''protected ITmfSyncSequenceDiagramEvent getSequenceDiagramEvent(ITmfEvent tmfEvent)'' with your own implementation. = CTF Parser = @@ -2757,7 +2691,7 @@ These files can be split into two types : * Event streams === Metadata === -The metadata is either raw text or packetized text. It is tsdl encoded. it contains a description of the type of data in the event streams. It can grow over time if new events are added to a trace but it will never overwrite what is already there. +The metadata is either raw text or packetized text. It is TSDL encoded. it contains a description of the type of data in the event streams. It can grow over time if new events are added to a trace but it will never overwrite what is already there. === Event Streams === The event streams are a file per stream per cpu. These streams are binary and packet based. The streams store events and event information (ie lost events) The event data is stored in headers and field payloads. @@ -2769,17 +2703,17 @@ In order to read a CTF trace, two steps must be done. * The metadata must be read to know how to read the events. * the events must be read. -The metadata is a written in a subset of the C language called TSDL. To read it, first it is depacketized (if it is not in plain text) then the raw text is parsed by an antlr grammer. The parsing is done in two phases. There is a lexer (CTFLexer.g) which separated the metatdata text into tokens. The tokens are then pattern matched using the parser (CTFParser.g) to form an AST. This AST is walked through using "IOStructGen.java" to populate streams and traces in trace parent object. +The metadata is a written in a subset of the C language called TSDL. To read it, first it is depacketized (if it is not in plain text) then the raw text is parsed by an antlr grammar. The parsing is done in two phases. There is a lexer (CTFLexer.g) which separated the metatdata text into tokens. The tokens are then pattern matched using the parser (CTFParser.g) to form an AST. This AST is walked through using "IOStructGen.java" to populate streams and traces in trace parent object. When the metadata is loaded and read, the trace object will be populated with 3 items: * the event definitions available per stream: a definition is a description of the datatype. * the event declarations available per stream: this will save declaration creation on a per event basis. They will all be created in advance, just not populated. * the beginning of a packet index. -Now all the trace readers for the event streams have everything they need to read a trace. They will each point to one file, and read the file from packet to packet. Everytime the trace reader changes packet, the index is updated with the new packet's information. The readers are in a priority queue and sorted by timestamp. This ensures that the events are read in a sequential order. They are also sorted by file name so that in the eventuality that two events occur at the same time, they stay in the same order. +Now all the trace readers for the event streams have everything they need to read a trace. They will each point to one file, and read the file from packet to packet. Every time the trace reader changes packet, the index is updated with the new packet's information. The readers are in a priority queue and sorted by timestamp. This ensures that the events are read in a sequential order. They are also sorted by file name so that in the eventuality that two events occur at the same time, they stay in the same order. == Seeking in a trace == -The reason for maintaining an index is to speed up seeks. In the case that a user wishes to seek to a certain timestamp, they just have to find the index entry that contains the timestamp, and go there to iterate in that packet until the proper event is found. this will reduce the searches time by an order of 8000 for a 256k paket size (kernel default). +The reason for maintaining an index is to speed up seeks. In the case that a user wishes to seek to a certain timestamp, they just have to find the index entry that contains the timestamp, and go there to iterate in that packet until the proper event is found. this will reduce the searches time by an order of 8000 for a 256k packet size (kernel default). == Interfacing to TMF == The trace can be read easily now but the data is still awkward to extract. @@ -2825,7 +2759,7 @@ Trace synchronization consists in taking traces, taken on different machines, wi == Event matching interfaces == -Here's a description of the major parts involved in event matching. These classes are all in the ''org.eclipse.linuxtools.tmf.core.event.matching'' package: +Here's a description of the major parts involved in event matching. These classes are all in the ''org.eclipse.tracecompass.tmf.core.event.matching'' package: * '''ITmfEventMatching''': Controls the event matching process * '''ITmfMatchEventDefinition''': Describes how events are matched @@ -2849,17 +2783,17 @@ These are the classes that describe how to actually match specific events togeth The '''canMatchTrace''' method will tell if a definition is compatible with a given trace. -The '''getUniqueField''' method will return a list of field values that uniquely identify this event and can be used to find a previous event to match with. +The '''getEventKey''' method will return a key for an event that uniquely identifies this event and will match the key from another event. Typically, there would be a match definition abstract class/interface per event matching type. The interface '''ITmfNetworkMatchDefinition''' adds the ''getDirection'' method to indicate whether this event is a ''in'' or ''out'' event to be matched with one from the opposite direction. -As examples, two concrete network match definitions have been implemented in the ''org.eclipse.linuxtools.lttng2.kernel.core.event.matching'' package for two compatible methods of matching TCP packets (See the LTTng User Guide on ''trace synchronization'' for information on those matching methods). Each one tells which events need to be present in the metadata of a CTF trace for this matching method to be applicable. It also returns the field values from each event that will uniquely match 2 events together. +As examples, two concrete network match definitions have been implemented in the ''org.eclipse.tracecompass.internal.lttng2.kernel.core.event.matching'' package for two compatible methods of matching TCP packets (See the Trace Compass User Guide on ''trace synchronization'' for information on those matching methods). Each one tells which events need to be present in the metadata of a CTF trace for this matching method to be applicable. It also returns the field values from each event that will uniquely match 2 events together. === IMatchProcessingUnit interface and derived classes === -While matching events is an exercice in itself, it's what to do with the match that really makes this functionality interesting. This is the job of the '''IMatchProcessingUnit''' interface. +While matching events is an exercise in itself, it's what to do with the match that really makes this functionality interesting. This is the job of the '''IMatchProcessingUnit''' interface. '''TmfEventMatches''' provides a default implementation that only stores the matches to count them. When a new match is obtained, the ''addMatch'' is called with the match and the processing unit can do whatever needs to be done with it. @@ -2993,18 +2927,18 @@ public class MyAppUstEventMatching implements ITmfNetworkMatchDefinition { } @Override - public List getUniqueField(ITmfEvent event) { - List keys = new ArrayList(); + public IEventMatchingKey getEventKey(ITmfEvent event) { + IEventMatchingKey key; if (evname.equals("myapp:receive")) { - keys.add(event.getContent().getField("from").getValue()); - keys.add(event.getContent().getField("messageid").getValue()); + key = new MyEventMatchingKey(event.getContent().getField("from").getValue(), + event.getContent().getField("messageid").getValue()); } else { - keys.add(event.getContent().getField("sendto").getValue()); - keys.add(event.getContent().getField("messageid").getValue()); + key = new MyEventMatchingKey(event.getContent().getField("sendto").getValue(), + event.getContent().getField("messageid").getValue()); } - return keys; + return key; } @Override @@ -3036,7 +2970,7 @@ Now, only adding the traces in an experiment and clicking the '''Synchronize tra == Trace synchronization == -Trace synchronization classes and interfaces are located in the ''org.eclipse.linuxtools.tmf.core.synchronization'' package. +Trace synchronization classes and interfaces are located in the ''org.eclipse.tracecompass.tmf.core.synchronization'' package. === Synchronization algorithm === @@ -3086,7 +3020,7 @@ All analysis modules must implement the '''IAnalysisModule''' interface from the === Example === -This example shows how to add a simple analysis module for an LTTng kernel trace with two parameters. +This example shows how to add a simple analysis module for an LTTng kernel trace with two parameters. It also specifies two mandatory events by overriding '''getAnalysisRequirements'''. The analysis requirements are further explained in the section [[#Providing requirements to analyses]].
 public class MyLttngKernelAnalysis extends TmfAbstractAnalysisModule {
@@ -3095,17 +3029,17 @@ public class MyLttngKernelAnalysis extends TmfAbstractAnalysisModule {
     public static final String PARAM2 = "myotherparam";
 
     @Override
-    public boolean canExecute(ITmfTrace trace) {
-        /* This just makes sure the trace is an Lttng kernel trace, though
-           usually that should have been done by specifying the trace type
-           this analysis module applies to */
-        if (!LttngKernelTrace.class.isAssignableFrom(trace.getClass())) {
-            return false;
-        }
+    public Iterable getAnalysisRequirements() {
+
+        // initialize the requirement: domain and events
+        TmfAnalysisRequirement domainReq = new TmfAnalysisRequirement(SessionConfigStrings.CONFIG_ELEMENT_DOMAIN);
+        domainReq.addValue(SessionConfigStrings.CONFIG_DOMAIN_TYPE_KERNEL, ValuePriorityLevel.MANDATORY);
 
-        /* Does the trace contain the appropriate events? */
-        String[] events = { "sched_switch", "sched_wakeup" };
-        return ((LttngKernelTrace) trace).hasAllEvents(events);
+        List requiredEvents = ImmutableList.of("sched_switch", "sched_wakeup");
+        TmfAnalysisRequirement eventReq = new TmfAnalysisRequirement(SessionConfigStrings.CONFIG_ELEMENT_EVENT,
+                requiredEvents, ValuePriorityLevel.MANDATORY);
+
+        return ImmutableList.of(domainReq, eventReq);
     }
 
     @Override
@@ -3182,7 +3116,7 @@ The following code shows what the resulting plugin.xml file should look like.
                default_value="3"
                name="myotherparam">
          
+               class="org.eclipse.tracecompass.lttng2.kernel.core.trace.LttngKernelTrace">
          
       
 
@@ -3212,14 +3146,14 @@ The following code shows how to add a view output to the analysis defined above
 
       
          
          
       
       
          
@@ -3265,7 +3199,7 @@ public class MyLttngKernelParameterProvider extends TmfAbstractAnalysisParamProv
     /*
      * Constructor
      */
-    public CriticalPathParameterProvider() {
+    public MyLttngKernelParameterProvider() {
         super();
         registerListener();
     }
@@ -3281,7 +3215,7 @@ public class MyLttngKernelParameterProvider extends TmfAbstractAnalysisParamProv
             return null;
         }
         if (name.equals(MyLttngKernelAnalysis.PARAM1)) {
-            return fCurrentEntry.getThreadId()
+            return fCurrentEntry.getThreadId();
         }
         return null;
     }
@@ -3402,7 +3336,7 @@ Performance tests are unit tests and they are added to the corresponding unit te
 
 Tests are to be added to a package under the ''perf'' directory, the package name would typically match the name of the package it is testing. For each package, a class named '''AllPerfTests''' would list all the performance tests classes inside this package. And like for unit tests, a class named '''AllPerfTests''' for the plug-in would list all the packages' '''AllPerfTests''' classes.
 
-When adding performance tests for the first time in a plug-in, the plug-in's '''AllPerfTests''' class should be added to the global list of performance tests, found in package ''org.eclipse.linuxtools.lttng.alltests'', in class '''RunAllPerfTests'''. This will ensure that performance tests for the plug-in are run along with the other performance tests
+When adding performance tests for the first time in a plug-in, the plug-in's '''AllPerfTests''' class should be added to the global list of performance tests, found in package ''org.eclipse.tracecompass.alltests'', in class '''RunAllPerfTests'''. This will ensure that performance tests for the plug-in are run along with the other performance tests
 
 === How ===
 
@@ -3533,7 +3467,7 @@ Before submitting a performance test to the code review, you should run it a few
 
 CPU time: CPU time represent the total time spent on CPU by the current process, for the time of the test execution. It is the sum of the time spent by all threads. On one hand, it is more significant than the elapsed time, since it should be the same no matter how many CPU cores the computer has. But since it calculates the time of every thread, one has to make sure that only threads related to what is being tested are executed during that time, or else the results will include the times of those other threads. For an application like TMF, it is hard to control all the threads, and empirically, it is found to vary a lot more than the system time from one run to the other.
 
-System time (Elapsed time): The time between the start and the end of the execution. It will vary depending on the parallelisation of the threads and the load of the machine.
+System time (Elapsed time): The time between the start and the end of the execution. It will vary depending on the parallelization of the threads and the load of the machine.
 
 Kernel time: Time spent in kernel mode
 
@@ -3548,9 +3482,9 @@ Supporting a new network protocol in TMF is straightforward. Minimal effort is r
 === Architecture ===
 
 All the TMF pcap-related code is divided in three projects (not considering the tests plugins):
-* '''org.eclipse.linuxtools.pcap.core''', which contains the parser that will read pcap files and constructs the different packets from a ByteBuffer. It also contains means to build packet streams, which are conversation (list of packets) between two endpoints. To add a protocol, almost all of the work will be in that project.
-* '''org.eclipse.linuxtools.tmf.pcap.core''', which contains TMF-specific concepts and act as a wrapper between TMF and the pcap parsing library. It only depends on org.eclipse.linuxtools.tmf.core and org.eclipse.pcap.core. To add a protocol, one file must be edited in this project.
-* '''org.eclipse.linuxtools.tmf.pcap.ui''', which contains all TMF pcap UI-specific concepts, such as the views and perspectives. No work is needed in that project.
+* '''org.eclipse.tracecompass.pcap.core''', which contains the parser that will read pcap files and constructs the different packets from a ByteBuffer. It also contains means to build packet streams, which are conversation (list of packets) between two endpoints. To add a protocol, almost all of the work will be in that project.
+* '''org.eclipse.tracecompass.tmf.pcap.core''', which contains TMF-specific concepts and act as a wrapper between TMF and the pcap parsing library. It only depends on org.eclipse.tracecompass.tmf.core and org.eclipse.tracecompass.pcap.core. To add a protocol, one file must be edited in this project.
+* '''org.eclipse.tracecompass.tmf.pcap.ui''', which contains all TMF pcap UI-specific concepts, such as the views and perspectives. No work is needed in that project.
 
 === UDP Packet Structure ===
 
@@ -3581,7 +3515,7 @@ Knowing that, we can define an UDPPacket class that contains those fields.
 
 === Creating the UDPPacket ===
 
-First, in org.eclipse.linuxtools.pcap.core, create a new package named '''org.eclipse.linuxtools.pcap.core.protocol.name''' with name being the name of the new protocol. In our case name is udp so we create the package '''org.eclipse.linuxtools.pcap.core.protocol.udp'''. All our work is going in this package.
+First, in org.eclipse.tracecompass.pcap.core, create a new package named '''org.eclipse.tracecompass.pcap.core.protocol.name''' with name being the name of the new protocol. In our case name is udp so we create the package '''org.eclipse.tracecompass.pcap.core.protocol.udp'''. All our work is going in this package.
 
 In this package, we create a new class named UDPPacket that extends Packet. All new protocol must define a packet type that extends the abstract class Packet. We also add different fields:
 * ''Packet'' '''fChildPacket''', which is the packet encapsulated by this UDP packet, if it exists. This field will be initialized by findChildPacket().
@@ -3602,14 +3536,14 @@ We also create the UDPPacket(PcapFile file, @Nullable Packet parent, ByteBuffer
 The following class is obtained:
 
 
-package org.eclipse.linuxtools.pcap.core.protocol.udp;
+package org.eclipse.tracecompass.pcap.core.protocol.udp;
 
 import java.nio.ByteBuffer;
 import java.util.Map;
 
-import org.eclipse.linuxtools.internal.pcap.core.endpoint.ProtocolEndpoint;
-import org.eclipse.linuxtools.internal.pcap.core.packet.BadPacketException;
-import org.eclipse.linuxtools.internal.pcap.core.packet.Packet;
+import org.eclipse.tracecompass.internal.pcap.core.endpoint.ProtocolEndpoint;
+import org.eclipse.tracecompass.internal.pcap.core.packet.BadPacketException;
+import org.eclipse.tracecompass.internal.pcap.core.packet.Packet;
 
 public class UDPPacket extends Packet {
 
@@ -3639,7 +3573,7 @@ public class UDPPacket extends Packet {
      *             Thrown when the packet is erroneous.
      */
     public UDPPacket(PcapFile file, @Nullable Packet parent, ByteBuffer packet) throws BadPacketException {
-        super(file, parent, Protocol.UDP);
+        super(file, parent, PcapProtocol.UDP);
         // TODO Auto-generated constructor stub
     }
 
@@ -3960,10 +3894,10 @@ We create in our package a new class named UDPEndpoint that extends ProtocolEndp
 We obtain the following unimplemented class:
 
 
-package org.eclipse.linuxtools.pcap.core.protocol.udp;
+package org.eclipse.tracecompass.pcap.core.protocol.udp;
 
-import org.eclipse.linuxtools.internal.pcap.core.endpoint.ProtocolEndpoint;
-import org.eclipse.linuxtools.internal.pcap.core.packet.Packet;
+import org.eclipse.tracecompass.internal.pcap.core.endpoint.ProtocolEndpoint;
+import org.eclipse.tracecompass.internal.pcap.core.packet.Packet;
 
 public class UDPEndpoint extends ProtocolEndpoint {
 
@@ -4075,7 +4009,7 @@ Then we implement the methods:
 
 === Registering the UDP protocol ===
 
-The last step is to register the new protocol. There are three places where the protocol has to be registered. First, the parser has to know that a new protocol has been added. This is defined in the enum org.eclipse.linuxtools.pcap.core.protocol.PcapProtocol. Simply add the protocol name here, along with a few arguments:
+The last step is to register the new protocol. There are three places where the protocol has to be registered. First, the parser has to know that a new protocol has been added. This is defined in the enum org.eclipse.tracecompass.internal.pcap.core.protocol.PcapProtocol. Simply add the protocol name here, along with a few arguments:
 * ''String'' '''longname''', which is the long version of name of the protocol. In our case, it is "User Datagram Protocol".
 * ''String'' '''shortName''', which is the shortened name of the protocol. In our case, it is "UDP".
 * ''Layer'' '''layer''', which is the layer to which the protocol belongs in the OSI model. In our case, this is the layer 4.
@@ -4086,7 +4020,7 @@ Thus, the following line is added in the PcapProtocol enum:
     UDP("User Datagram Protocol", "udp", Layer.LAYER_4, true),
 
-Also, TMF has to know about the new protocol. This is defined in org.eclipse.linuxtools.tmf.pcap.core.protocol.TmfPcapProtocol. We simply add it, with a reference to the corresponding protocol in PcapProtocol. Thus, the following line is added in the TmfPcapProtocol enum: +Also, TMF has to know about the new protocol. This is defined in org.eclipse.tracecompass.internal.tmf.pcap.core.protocol.TmfPcapProtocol. We simply add it, with a reference to the corresponding protocol in PcapProtocol. Thus, the following line is added in the TmfPcapProtocol enum:
     UDP(PcapProtocol.UDP),
 
@@ -4136,6 +4070,6 @@ To add a stream-based View, simply monitor the TmfPacketStreamSelectedSignal in * Make adding protocol more "plugin-ish", via extension points for instance. This would make it easier to support new protocols, without modifying the source code. * Control dumpcap directly from eclipse, similar to how LTTng is controlled in the Control View. * Support pcapng. See: http://www.winpcap.org/ntar/draft/PCAP-DumpFileFormat.html for the file format. -* Add SWTBOT tests to org.eclipse.linuxtools.tmf.pcap.ui +* Add SWTBOT tests to org.eclipse.tracecompass.tmf.pcap.ui * Add a Raw Viewer, similar to Wireshark. We could use the “Show Raw” in the event editor to do that. -* Externalize strings in org.eclipse.linuxtools.pcap.core. At the moment, all the strings are hardcoded. It would be good to externalize them all. +* Externalize strings in org.eclipse.tracecompass.pcap.core. At the moment, all the strings are hardcoded. It would be good to externalize them all. diff --git a/doc/org.eclipse.tracecompass.doc.dev/doc/images/AddDependencyTmf.png b/doc/org.eclipse.tracecompass.doc.dev/doc/images/AddDependencyTmf.png deleted file mode 100644 index 8f9ac0b27aed99ef246fe2fc8e3cdb36e8286fb6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 71006 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

bnGN`aMlGi`EtiTjNqOgNrem_BnrmQ_p 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