aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBernd Hufmann2012-11-26 09:04:56 (EST)
committerBernd Hufmann2012-11-28 09:48:58 (EST)
commit87a43b7c150eda36f21ddf79caa370f365be8441 (patch)
tree2c16345333e276b6e09d445e12dea8a2afe0ab6a
parent5f6d0623b0bf348ba1c74389d1b34693047a8a91 (diff)
downloadorg.eclipse.linuxtools-87a43b7c150eda36f21ddf79caa370f365be8441.zip
org.eclipse.linuxtools-87a43b7c150eda36f21ddf79caa370f365be8441.tar.gz
org.eclipse.linuxtools-87a43b7c150eda36f21ddf79caa370f365be8441.tar.bz2
Change LTTng help plugin generation refs/changes/94/8794/3
The generation of the LTTng help plugin used to be done from a wiki stored at Eclipse.org. This wiki matches the latest delivered source code. However, when developing new features or updating existing features it is required to document the new or updated feature. But this cannot be done on the wiki web page. This causes that the writing of documentation is often postponed before the next official release. This commit changes the way the help plugin is build. The source wiki text file along with the relevant images as part of are stored as part of the git repository. The build-helper.xml was updated to build the help from the local wiki file. This allows the designer to update the documentation along with the feature implementation. Note, that the local wiki can be edited with the MyLyn wiki text editor. When a release to open source is done and these new or updated feature are part of it, then the open source wiki at Eclipse.org needs to be aligned to the wiki which is stored in the git repository. How to know if someone updated the open source wiki independent to the one in the git repository? For that, the build-helper.xml file also builds the help plugin files as it used to be done. After a Ant build with the build-helper.xml file the changes will show as changes in the git repository. Knowing what changed, it can be easily transfered to the local wiki stored in git. Note that the legacy help files were removed from the repository. Change-Id: Iba1b140a78a5e4aaa2b2a7ffbdb0cf852f9b6030 Reviewed-on: https://git.eclipse.org/r/8794 Tested-by: Hudson CI Reviewed-by: Alexandre Montplaisir <alexmonthy@voxpopuli.im> IP-Clean: Alexandre Montplaisir <alexmonthy@voxpopuli.im> Tested-by: Alexandre Montplaisir <alexmonthy@voxpopuli.im>
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html229
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Perspective.html528
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Tracer-Control.html349
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Limitations.html73
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/User-Guide.html73
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ControlFlowView.pngbin60719 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/EventsView.pngbin61301 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsActions.pngbin63574 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsKernelDialog.pngbin39070 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsUstDialog.pngbin17293 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersAction.pngbin37676 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersDialog.pngbin60740 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceAction.pngbin39473 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceDialog.pngbin44247 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConnectToRemoteSystem.pngbin51857 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlFlowColorLegend.pngbin29167 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlRsePerspective.pngbin69313 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceAction.pngbin33958 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceDialog.pngbin44185 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceAction.pngbin38978 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceConfirm.pngbin13814 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportLocalTrace.pngbin15996 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportRemoteTrace.pngbin14716 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportTraceAction.pngbin39376 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngLoginDialog.pngbin21672 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard1.pngbin43017 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard2.pngbin30442 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard3.pngbin33831 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard4.pngbin36162 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard5.pngbin34234 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard6.pngbin38557 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPauseTraceAction.pngbin38924 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspective.pngbin189624 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspectiveOpen.pngbin32957 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProcessStateInfo.pngbin23976 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog-2.pngbin47084 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog.pngbin34883 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewWizard.pngbin36339 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectProperty.pngbin70537 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemConfiguredTrace.pngbin39930 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsNewConnection.pngbin22128 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsWithLTTng.pngbin26891 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngResourcesColorLegend.pngbin23363 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStartTraceAction.pngbin39448 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStopTraceAction.pngbin39051 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceImportDialog.pngbin57815 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceProperties.pngbin26195 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceSelectDialog.pngbin20474 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyAddMatchingDialog.pngbin60516 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDeleteMatchingDialog.pngbin43170 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionHover.pngbin36505 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionZoom.pngbin34375 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyGraphHover.pngbin39190 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyListMatchingDialog.pngbin42502 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyToolbar.pngbin43940 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyView.pngbin30314 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ProjectExplorer.pngbin25287 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ResourcesView.pngbin26653 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/StatisticsView.pngbin73989 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Filter.pngbin56603 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Search.pngbin63012 -> 0 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/Installation.html3
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html30
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/build-helper.xml30
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/build.properties7
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/How-to-use-LTTng-to-diagnose-problems.html79
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/Installation.html182
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng-Kernel-Analysis.html294
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng.html1742
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/Limitations.html59
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/References.html (renamed from lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/References.html)26
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/Updating-This-Document.html (renamed from lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Updating-This-Document.html)15
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide-toc.xml107
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.html108
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki1341
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Bookmarks.png (renamed from lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/Bookmarks.png)bin84691 -> 84691 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_global.pngbin0 -> 164693 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_legend.pngbin0 -> 10144 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_process_tree.pngbin0 -> 29979 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.pngbin0 -> 28960 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_small_dots.pngbin0 -> 3952 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_toolbar.pngbin0 -> 20400 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_tooltip.pngbin0 -> 21123 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom.pngbin0 -> 5607 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.pngbin0 -> 4975 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel.gifbin0 -> 200 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel_disabled.gifbin0 -> 370 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ColorsView.pngbin0 -> 101625 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyExperimentDialog.pngbin0 -> 18328 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceAction.pngbin0 -> 36556 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceDialog.pngbin0 -> 14803 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserInput.pngbin0 -> 86369 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserOutput.pngbin0 -> 44215 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserInput.pngbin0 -> 83881 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserOutput.pngbin0 -> 41243 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultEventsView.pngbin0 -> 85567 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Filter.pngbin0 -> 91994 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Search.pngbin0 -> 84012 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExpSupplementaryFilesDialog.pngbin0 -> 15122 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentAction.pngbin0 -> 44032 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentConfirmationDialog.pngbin0 -> 14806 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesAction.pngbin0 -> 36311 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesDialog.pngbin0 -> 13059 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Environment_variables.pngbin0 -> 30455 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_disabled.gifbin0 -> 130 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_enabled.gifbin0 -> 183 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithAssociatedTraceType.pngbin0 -> 18771 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithExperiment.pngbin0 -> 30038 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/FiltersView.pngbin0 -> 86129 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/HistogramView.png (renamed from lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/HistogramView.png)bin52773 -> 52773 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextDialog.pngbin0 -> 28542 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnChannelAction.pngbin0 -> 30935 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnDomainAction.pngbin0 -> 26672 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextToEventsAction.pngbin0 -> 39652 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventAction.pngbin0 -> 47123 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventDialog.pngbin0 -> 14552 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignedEvents.pngbin0 -> 30527 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CalibrateAction.pngbin0 -> 33536 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewConnect.pngbin0 -> 14947 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDelete.pngbin0 -> 14888 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDisconnect.pngbin0 -> 29688 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewFilled.pngbin0 -> 49082 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelAction.pngbin0 -> 32896 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelDialog.pngbin0 -> 30182 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainAction.pngbin0 -> 33753 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainDialog.pngbin0 -> 30277 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionAction.pngbin0 -> 15969 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionDialog.pngbin0 -> 11299 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroyConfirmationDialog.pngbin0 -> 15749 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroySessionAction.pngbin0 -> 42072 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableChannelAction.pngbin0 -> 24699 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableEventAction.pngbin0 -> 48337 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EditConnection.pngbin0 -> 18244 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableChannelAction.pngbin0 -> 24993 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableEventAction.pngbin0 -> 48542 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledAllUstTracepoints.pngbin0 -> 17700 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledFunctionProbeEvent.pngbin0 -> 31304 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelProbeEvent.pngbin0 -> 29444 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelSyscalls.pngbin0 -> 27709 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelTracepoints.pngbin0 -> 25535 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstLoglevelEvents.pngbin0 -> 20351 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstWildcardEvents.pngbin0 -> 23734 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnterPassword.pngbin0 -> 20550 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnChannelAction.pngbin0 -> 37611 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnDomainAction.pngbin0 -> 27214 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionAction.pngbin0 -> 33492 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionDialog.pngbin0 -> 34160 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2FunctionEventDialog.pngbin0 -> 35808 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportAction.pngbin0 -> 36172 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportDialog.pngbin0 -> 27932 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportOverwriteConfirmationDialog.pngbin0 -> 15199 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportRenameDialog.pngbin0 -> 15362 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2NewConnection.pngbin0 -> 17166 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2Preferences.pngbin0 -> 51508 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesGroup.pngbin0 -> 47469 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesLogging.pngbin0 -> 49111 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ProbeEventDialog.pngbin0 -> 35501 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PropertyView.pngbin0 -> 14317 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2RefreshAction.pngbin0 -> 42080 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SelectConnection.pngbin0 -> 22290 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StartTracingAction.pngbin0 -> 43450 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StatisticsView.pngbin0 -> 65762 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StopTracingAction.pngbin0 -> 41437 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SyscallsDialog.pngbin0 -> 32424 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2TracepointEventsDialog.pngbin0 -> 43221 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstLoglevelEventsDialog.pngbin0 -> 32082 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstTracepointEventsDialog.pngbin0 -> 39337 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstWildcardEventsDialog.pngbin0 -> 28831 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlView.pngbin0 -> 7078 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlViewConnect.pngbin0 -> 7242 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelEventsViewer.pngbin0 -> 65955 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelPerspective.pngbin0 -> 155332 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ManageCustomParsers.pngbin0 -> 17031 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentAction.pngbin0 -> 29821 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentDialog.pngbin0 -> 12855 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewProjectExplorer.pngbin0 -> 9882 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage1.pngbin0 -> 40338 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage2.pngbin0 -> 36421 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenLTTngKernelPerspective.pngbin0 -> 34911 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenTraceAction.pngbin0 -> 36247 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceAction.pngbin0 -> 19110 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceDialog.pngbin0 -> 52088 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox1.pngbin0 -> 35317 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox2.pngbin0 -> 36184 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/RemoveTracesAction.pngbin0 -> 33255 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameExperimentDialog.pngbin0 -> 16680 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceAction.pngbin0 -> 33933 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceDialog.pngbin0 -> 13999 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_example.pngbin0 -> 31223 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_legend.pngbin0 -> 24898 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectGenericCTFTraceType.pngbin0 -> 42180 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectLTTngKernelTraceType.pngbin0 -> 39559 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesAction.pngbin0 -> 31729 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesDialog.pngbin0 -> 24386 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_active.gifbin0 -> 970 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_inactive.gifbin0 -> 1004 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingPerspective.pngbin0 -> 32763 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingViews.pngbin0 -> 44155 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_connected.gifbin0 -> 374 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_disconnected.gifbin0 -> 605 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/TimeChartView.pngbin0 -> 12745 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/TmfEventFilter.gif (renamed from lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEventFilter.gif)bin220 -> 220 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/TmfEventSearch.gif (renamed from lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEventSearch.gif)bin347 -> 347 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/TracingPerspective.pngbin0 -> 132506 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/home.gifbin0 -> 582 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/next.gifbin0 -> 327 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/images/prev.gifbin0 -> 327 bytes
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/doc/notice.html11
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/plugin.xml2
-rw-r--r--lttng/org.eclipse.linuxtools.lttng.help/toc.xml4
210 files changed, 3991 insertions, 1301 deletions
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html
deleted file mode 100644
index 19969bb..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Getting-Started.html
+++ /dev/null
@@ -1,229 +0,0 @@
-<?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 (legacy) - 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 (legacy)">
- <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="LTTng-Perspective.html" title="LTTng Perspective">
- <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 (legacy)</td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">LTTng Perspective</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_of_the_LTTng_Agent">Installation of the LTTng Agent</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>If you are using Ubuntu, you might want to use the LTTng PPA and avoid the detailed library installation. See the instalaltion video at
- <a href="http://lttng.org/eclipse">http://lttng.org/eclipse</a> for more information.
- </p>
- <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">LTTng trace format 2.3 parser</a>
- <br/>
-
- <a href="http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=shortlog;h=refs/heads/traceformat-2.5">LTTng trace format 2.5 parser</a>
- <br/>
-
- <a href="http://git.dorsal.polymtl.ca/?p=liblttngtrace.git;a=shortlog;h=refs/heads/traceformat-2.6">LTTng trace format 2.6 parser</a>
- <br/>
- </p>
- <p>If you wish to stream LTTng traces (format 2.6 only), you will need to install the following library instead:</p>
- <p>
- <a href="http://git.dorsal.polymtl.ca/~ybrosseau?p=lttv.git;a=shortlog;h=refs/heads/livetraceread-patch4">LTTng trace format 2.6 parser with live trace read</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 &amp;&amp; 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 -&gt; liblttvtraceread_loader-2.6.so
-lrwxrwxrwx. 1 root root 23 2010-06-07 11:25 liblttvtraceread.so -&gt; 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
-...
- &lt;more options&gt;
-</pre>
- <p>Once the parsing libraries are installed, it is necessary to let Eclipse know where they sit otherwise the LTTng plugin won't be able to parse the traces. You basically have 3 options at this point:</p>
- <p>a) Eclipse.ini</p>
- <p>In the eclipse.ini (in the Eclipse folder), add the following line to the VM arguments:</p>
- <pre>
--Djava.library.path=/usr/local/lib
-</pre>
- <p>b) LD_LIBRARY_PATH</p>
- <p>Alternatively, you can specify the libraries location using LD_LIBRARY_PATH on the command line/script when you start your Eclipse.</p>
- <pre>
-&gt; LD_LIBRARY_PATH="/usr/local/lib:$LD_LIBRARY_PATH" ./eclipse
-</pre>
- <p>c) Project trace library path</p>
- <p>If you are customizing your own LTTng parsing libraries, you might have a number of variants sitting on your system and you might want to have the freedom to dynamically associate a parser to a project. The LTTng plugin allows you to do so (see
- <a href="http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng/User_Guide#Project_View">Project View</a>).
- </p>
- <p>However, in this case, the RUNPATH of the library loader (liblttvtraceread_loader-X.Y.so) needs to be doctored a little so it can find the actual parsing libraries. This is done using the
- <i>patchelf</i> utility (available from
- <a href="http://nixos.org/patchelf.html">here</a>). Note that the library loader has to reside in the same directory as the parsing library (
- <i>make install</i> takes care of that).
- </p>
- <pre>
-&gt; cd &lt;wherever&gt;
-&gt; patchelf --set-rpath '.:$ORIGIN' liblttvtraceread_loader-X.Y.so
-</pre>
- <p>Alternatively, you can tweak the library's makefile and set the RUNPATH directly.</p>
- <h2 id="Downloading_Sample_Traces">Downloading Sample Traces</h2>
- <p>To verify that your installation is functional, you can download sample traces from GitHub. 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. To download a trace: click on the selected trace and then click on the "Downloads" button.</p>
- <p>The following LTTng traces are provided as samples:</p>
- <p>
- <a href="https://github.com/fchouinard/LTTng/blob/master/samples/trace-2.5-15316.tar.gz">trace-2.5-15316 (360K)</a> Very small trace (format 2.5 - 15316 events) made from a single LTTng marker. Recorded with a VirtualBox system with 1 processor.
- </p>
- <p>
- <a href="https://github.com/fchouinard/LTTng/blob/master/samples/trace-2.5-15471.tar.gz">trace-2.5-15471 (365K)</a> Very small trace (format 2.5 - 15471 events) made from a single LTTng marker. Recorded with a VirtualBox system with 1 processor.
- </p>
- <p>
- <a href="https://github.com/fchouinard/LTTng/blob/master/samples/trace-2.6-22K.tar.gz">trace-2.6-22K (1.1M)</a> Small trace (format 2.6 - 22K events).
- </p>
- <p>(More sample traces to come)</p>
- <h2 id="Installation_of_the_LTTng_Agent">Installation of the LTTng Agent</h2>
- <p>For the trace control version v0.x an LTTng agent has to be running on the remote system. To download the source code from the relevant git repository, use
- <b>git clone git://git.dorsal.polymtl.ca/git/lttng-agent.git</b> from a Linux command shell. Then go to directory
- <b>lttng-agent/manual</b> in the cloned git repository and type
- <b>make</b>. This will generate the
- <b>LTTng Agent Manual</b> in HTML format. Please follow the instructions in this manual for the manual installation of the agent.
- </p>
- <p>To install an agent on Ubuntu using a PPA package follow the instruction of the web site
- <a href="https://launchpad.net/~lttng/+archive/ppa">LTTng PPA</a>. However, this version won't always include the latest bugfixes. To get the latest version, the user should download the source code, compile and install the agent manually.
- </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="LTTng-Perspective.html#LTTng_Perspective">LTTng Perspective</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="LTTng-Perspective.html#LTTng_Perspective">LTTng Perspective</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 (legacy)">
- <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 (legacy)">
- <img alt="LTTng Plug-in User Guide (legacy)" border="0" src="../../../images/home.gif"/>
- </a>
- </td>
- <td style="width: 20%" align="right">
- <a href="LTTng-Perspective.html" title="LTTng Perspective">
- <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 (legacy)</td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">LTTng Perspective</td>
- </tr>
- </table>
- </body>
-</html> \ No newline at end of file
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Perspective.html b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Perspective.html
deleted file mode 100644
index ed533f2..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Perspective.html
+++ /dev/null
@@ -1,528 +0,0 @@
-<?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 (legacy) - LTTng Perspective</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 Perspective</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="LTTng-Tracer-Control.html" title="LTTng Tracer Control">
- <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">LTTng Tracer Control</td>
- </tr>
- </table><hr/>
- <h1 id="LTTng_Perspective">LTTng Perspective</h1>
- <p>The LTTng perspective groups the LTTng specific views, namely:</p>
- <ul>
- <li>
- <a href="LTTng-Perspective.html#Project_View">Project View</a>
- </li>
- <li>
- <a href="LTTng-Perspective.html#Events_View">Events View</a>
- </li>
- <li>
- <a href="LTTng-Perspective.html#Histogram_View">Histogram View</a>
- </li>
- <li>
- <a href="LTTng-Perspective.html#Control_Flow_View">Control Flow View</a>
- </li>
- <li>
- <a href="LTTng-Perspective.html#Resources_View">Resources View</a>
- </li>
- <li>
- <a href="LTTng-Perspective.html#Statistics_View">Statistics View</a>
- </li>
- <li>
- <a href="LTTng-Perspective.html#Latency_View">Latency 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 &gt; Open Perspective... &gt; Other).</p>
- <p>
- <img border="0" src="images/LTTngPerspectiveOpen.png"/>
- </p>
- <h2 id="Project_View">Project View</h2>
- <p>The project view is the standard Eclipse Project Explorer. LTTng being a tracing project, it is shown with a small "T" decorator in the upper right of the project folder icon.</p>
- <p>
- <img border="0" src="images/ProjectExplorer.png"/>
- </p>
- <p>Tracing projects have two sub-folders:
- <b>Traces</b> which holds the individual traces, and
- <b>Experiments</b> which holds sets of traces that we want to correlate.
- </p>
- <h3 id="Creating_a_Project">Creating a Project</h3>
- <p>A new LTTng project can be created using the LTTng Project dialog (File &gt; New &gt; 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>At this point, you can press Finish and complete the project creation or you can press Next to provide a project-specific parser library path.</p>
- <p>
- <img border="0" src="images/LTTngProjectNewDialog-2.png"/>
- </p>
- <p>Once the project is created, you can modify the parser library path at any time by selecting the project's property page (right-click on the project, Properties).</p>
- <p>
- <img border="0" src="images/LTTngProjectProperty.png"/>
- </p>
- <h3 id="Importing_Traces_in_a_Project">Importing Traces in a Project</h3>
- <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>
- <h3 id="Drag_and_Drop">Drag and Drop</h3>
- <p>Traces can be also be imported to a project by dragging from another tracing project and dropping to the project's trace folder. The trace will be copied and the trace type will be set.</p>
- <p>Any resource can be dragged and dropped from a non-tracing project, and any file or folder can be dragged from an external tool, into a tracing project's trace folder. The resource will be copied or imported as a new trace, however the trace type will be unknown and need to be set manually by the user.</p>
- <p>It is also possible to drop a trace, resource, file or folder into an existing experiment. If the item does not already exist as a trace in the project's trace folder, it will first be copied or imported, then the trace will be added to the experiment.</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>When opened, the Events view displays the events of the currently selected trace or experiment.</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>Trace</b>: the trace that holds the event (e.g. experiments typically hold multiple traces)
- </li>
- <li>
- <b>Marker</b>: the event type and localization
- </li>
- <li>
- <b>Content</b>: the raw event content
- </li>
- </ul>
- <p>The first row of the table is the header row a.k.a. the Search and Filter row.</p>
- <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>
- <h3 id="Searching_and_Filtering">Searching and Filtering</h3>
- <p>Searching and filtering of events in the table can be performed by entering matching conditions in one or multiple columns in the header row (the first row below the column header).</p>
- <p>To toggle between searching and filtering, click on the 'search' (
- <img border="0" src="images/TmfEventSearch.gif"/>) or 'filter' (
- <img border="0" src="images/TmfEventFilter.gif"/>) icon in the header row's left margin, or right-click on the header row and select
- <b>Show Filter Bar</b> or
- <b>Show Search Bar</b> in the context menu.
- </p>
- <p>To apply a matching condition to a specific column, click on the column's header row cell, type in a
- <a href="http://download.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">regular expression</a> and press the
- <b>ENTER</b> key. You can also enter a simple text string and it will be automatically be replaced with a 'contains' regular expression.
- </p>
- <p>When matching conditions are applied to two or more columns, all conditions must be met for the event to match (i.e. 'and' behavior).</p>
- <p>To clear all matching conditions in the header row, press the
- <b>DEL</b> key.
- </p>
- <h4 id="Searching">Searching</h4>
- <p>When a searching condition is applied to the header row, the table will select the next matching event starting from the top currently displayed event. Wrapping will occur if there is no match until the end of the trace.</p>
- <p>All matching events will have a 'search match' icon in their left margin. Non-matching events will be dimmed.</p>
- <p>
- <img border="0" src="images/TmfEvents-Search.png"/>
- </p>
- <p>Pressing the
- <b>ENTER</b> key will search and select the next matching event. Pressing the
- <b>SHIFT-ENTER</b> key will search and select the previous matching event. Wrapping will occur in both directions.
- </p>
- <p>Press
- <b>ESC</b> to cancel an ongoing search.
- </p>
- <p>Press
- <b>DEL</b> to clear the header row and reset all events to normal.
- </p>
- <h4 id="Filtering">Filtering</h4>
- <p>When a filtering condition is entered in the head row, the table will clear all events and fill itself with matching events as they are found from the beginning of the trace.</p>
- <p>A status row will be displayed before and after the matching events, dynamically showing how many matching events were found and how many events were processed so far. Once the filtering is completed, the status row icon in the left margin will change from a 'stop' to a 'filter' icon.</p>
- <p>
- <img border="0" src="images/TmfEvents-Filter.png"/>
- </p>
- <p>Press
- <b>ESC</b> to stop an ongoing filtering. In this case the status row icon will remain as a 'stop' icon to indicate that not all events were processed.
- </p>
- <p>Press
- <b>DEL</b> or right-click on the table and select
- <b>Clear Filters</b> from the context menu to clear the header row and remove the filtering. All trace events will be now shown in the table. Note that the currently selected event will remain selected even after the filter is removed.
- </p>
- <p>You can also search on the subset of filtered events by toggling the header row to the Search Bar while a filter is applied. Searching and filtering conditions are independent of each other.</p>
- <h4 id="Bookmarking">Bookmarking</h4>
- <p>Any event of interest can be tagged with a bookmark.</p>
- <p>To add a bookmark, double-click the left margin next to an event, or right-click the margin and select
- <b>Add bookmark...</b>. Alternatively use the
- <b>Edit</b> &gt;
- <b>Add bookmark...</b> menu. Edit the bookmark description as desired and press
- <b>OK</b>.
- </p>
- <p>The bookmark will be displayed in the left margin, and hovering the mouse over the bookmark icon will display the description in a tooltip.</p>
- <p>The bookmark will be added to the
- <b>Bookmarks</b> view. In this view the bookmark description can be edited, and the bookmark can be deleted. Double-clicking the bookmark or selecting
- <b>Go to</b> from its context menu will open the trace or experiment and go directly to the event that was bookmarked.
- </p>
- <p>To remove a bookmark, double-click its icon, select
- <b>Remove Bookmark</b> from the left margin context menu, or select
- <b>Delete</b> from the Bookmarks view.
- </p>
- <p>
- <img border="0" src="images/Bookmarks.png"/>
- </p>
- <h2 id="Histogram_View">Histogram View</h2>
- <p>The Histogram View displays the trace events distribution with respect to time. When streaming a trace, this view is dynamically updated as the events are received.</p>
- <p>
- <img border="0" src="images/HistogramView.png"/>
- </p>
- <p>On the top left, there are two data controls:</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>
- </ul>
- <p>Both control can be used to modify their respective value. After validation, the other controls and views will be synchronized and updated accordingly.</p>
- <p>The large histogram, at the bottom, shows the event distribution over the whole trace or set of traces. It also has a smaller semi-transparent window, with a cross-hair, that shows the currently selected time range window. The time range window can be zoomed in/out by using the mouse wheel. It can also be selected by the mouse and dragged to another region of the trace.</p>
- <p>The smaller histogram, on top right, corresponds to the currently selected time range window, a sub-range of the event set. Its size can also be zoomed in/out using the mouse wheel.</p>
- <p>The x-axis of each histogram corresponds to the events timestamps. The timestamp of the first and the last event of the respective ranges is displayed. The y-axis of each histogram shows the minimum/maximum number of events in the corresponding histogram bars.</p>
- <p>The dashed vertical magenta bar, on the right, shows the position of the last event. The dashed vertical red bar shows the relative position of the currently selected event. The current event can be changed by clicking on the histogram.</p>
- <p>Hovering the mouse over an histogram bar pops up an information window that displays the start/end time of the corresponding bar as well as the number of events it represents.</p>
- <p>In each histogram, the following keys are handled:</p>
- <ul>
- <li>
- <b>Left</b>: Moves the current event to the previous non-empty bar
- </li>
- <li>
- <b>Right</b>: Moves the current event to the next non-empty bar
- </li>
- <li>
- <b>Home</b>: Displays the current event to the first histogram bar
- </li>
- <li>
- <b>End</b>: Displays the current event to the last non-empty histogram bar
- </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="LTTng-Perspective.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>
- <h2 id="Latency_View">Latency View</h2>
- <p>The Latency View is applicable to kernel trace data. The Latency View initiates the analysis of an LTTng trace to determine the elapsed time between 2 related events (the latency), and then to plot the distribution of the latencies. </p>
- <p>
- <img border="0" src="images/LatencyView.png"/>
- </p>
- <p>The analysis is done to the current active time range of the LTTng perspective. The Latency View consists of 2 different graphs. The left graph shows the latency in respect to the event time (start event). The right graph shows the latency distribution.</p>
- <h3 id="Latency_vs_Time_Graph">Latency vs Time Graph</h3>
- <p>This graph shows the latency in respect of the event time of the first event of the 2 related events. The x-axis of the graph corresponds to the start event time in seconds. The y-axis shows the latency in milli-seconds. Hovering the mouse over an plotted item pops up an information window that displays the start/end event time of the corresponding area in the horizontal direction, the start/end latecny time of the corresponding area in vertical direction as well as the number of latencies that fall into this square.</p>
- <p>
- <img border="0" src="images/LatencyGraphHover.png"/>
- </p>
- <h3 id="Latency_Distribution">Latency Distribution</h3>
- <p>This graph shows the latency distribution. The number of latency values that fall in the corresponding latency range are displayed. The x-axis of the distribution graph shows the latency in milli-seconds. The y-axis corresponds to the number of events (latency occurances). Hovering the mouse over a histogram bar pops up an information window that displays the number of events as well as the number of events it represents.</p>
- <p>
- <img border="0" src="images/LatencyDistributionHover.png"/>
- </p>
- <h3 id="Mouse_Control_3">Mouse Control</h3>
- <p>The mouse control is only applicaple for the
- <b>Latency Distribution</b> graph.
- </p>
- <ul>
- <li>Mouse Wheel
- <ul>
- <li>Forward - Zoom in (in y-axix only).</li>
- <li>Backward - Zoom out (in y-axis only).</li>
- </ul>
- </li>
- </ul>
- <p>After zooming in the zoom factor is displayed in brackets besides the title
- <b>Latency Distribution</b>. Additionally, besides the y-axis a warning icon is drawn to indicate that the maximum height is not displayed. Hovering over this icon pops up an information window about warning icon.
- </p>
- <p>
- <img border="0" src="images/LatencyDistributionZoom.png"/>
- </p>
- <h3 id="Tool_Bar_Menu">Tool Bar Menu</h3>
- <p>The latency view comes with serveral tool bar buttons and menu items for changing the bar width as well as for listing, adding and deleting of matching events.</p>
- <p>
- <img border="0" src="images/LatencyToolbar.png"/>
- </p>
- <ul>
- <li>
- <b>Increase bar width/height</b>: To increase the bar width of the
- <b>Latency Distribution</b> and the square width and hight of the
- <b>Latency vs Time</b> graph, select the button
- <b>Increase bar width/height</b>. By default, the size is 2 pixels. The maximum size is 16.
- </li>
- </ul>
- <ul>
- <li>
- <b>Decrease bar width/height</b>: To decrease the bar width of the
- <b>Latency Distribution</b> and the square width and hight of the
- <b>Latency vs Time</b> graph, select the button
- <b>Decrease bar width/height</b>. By default, the size is 2 pixels. The minimum size is 1.
- </li>
- </ul>
- <ul>
- <li>
- <b>List matching events</b>: To display the current list of event pairs to be matched, select the button
- <b>List matching events</b>. A new dialog display will open with the list of matching events. To reset to the default list of matchin pairs, press button
- <b>Reset to default pairs</b>.
- </li>
- </ul>
- <p>
- <img border="0" src="images/LatencyListMatchingDialog.png"/>
- </p>
- <ul>
- <li>
- <b>Add matching events</b>: To add a new pair of events to be matched, select the button
- <b>Add matching events</b>. A new display will open for selecting a new pair of events. First select the start event from the provided list on the left. The select an end event on the right side. After that, press
- <b>Add</b>. This will add a new entry to the list in the lower part of the display. After closing the dialog box, the trace will be parsed again using the new list of event pairs.
- </li>
- </ul>
- <p>
- <img border="0" src="images/LatencyAddMatchingDialog.png"/>
- </p>
- <ul>
- <li>
- <b>Delete matching events</b>: To delete a pair of events to be matched, select the button
- <b>Delete matching events</b>. A new display will open for selecting of pairs of events. First select the event pair to be deleted, then press button
- <b>Delete</b>. After closing the dialog box, the trace will be parsed again using the new list of event pairs.
- </li>
- </ul>
- <p>
- <img border="0" src="images/LatencyDeleteMatchingDialog.png"/>
- </p>
- <p>
- <b>Note</b> that the list of event pairs are presisted in the workspace and will be available after restart of Eclipse.
- </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 (legacy)">
- <img alt="LTTng Plug-in User Guide (legacy)" border="0" src="../../../images/home.gif"/>
- </a>
- </td>
- <td style="width: 20%" align="right">
- <a href="LTTng-Tracer-Control.html" title="LTTng Tracer Control">
- <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">LTTng Tracer Control</td>
- </tr>
- </table>
- </body>
-</html> \ No newline at end of file
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Tracer-Control.html b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Tracer-Control.html
deleted file mode 100644
index 9c5fd66..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/LTTng-Tracer-Control.html
+++ /dev/null
@@ -1,349 +0,0 @@
-<?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 (legacy) - LTTng Tracer Control</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 Tracer Control</th>
- </tr>
- <tr>
- <td style="width: 20%" align="left">
- <a href="LTTng-Perspective.html" title="LTTng Perspective">
- <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">LTTng Perspective</td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">Limitations</td>
- </tr>
- </table><hr/>
- <h1 id="LTTng_Tracer_Control">LTTng Tracer Control</h1>
- <p>The LTTng Tracer toolchains version v0.x requires and LTTng agent running on the remote host. The functions to control the LTTng tracer (e.g. start, pause, resume), either locally or remotely, are available from the Remote Systems view (See
- <a href="LTTng-Tracer-Control.html#Remote_Systems_View">Remote Systems View</a>, an RSE view).
- </p>
- <p>
- <img border="0" src="images/LTTngControlRsePerspective.png"/>
- </p>
- <h3 id="Remote_Systems_View">Remote Systems View</h3>
- <p>The LTTng tracer is controlled by the UI through an LTTng agent running on the tracer system.</p>
- <h4 id="Create_a_Remote_Connection">Create a Remote Connection</h4>
- <p>A new connection to a remote system can be created using the new connection wizard of the Remote System Explorer. For this, a toolbar button exists on the top left corner of the Remote System view. Alternatively, this wizard can be started using File -&gt; New -&gt; Other ... -&gt; Remote System Explorer -&gt; Connection).</p>
- <p>
- <img border="0" src="images/LTTngNewConnectionWizard1.png"/>
- </p>
- <p>For LTTng control, select connection type LTTng and press Next to define the connection.</p>
- <p>
- <img border="0" src="images/LTTngNewConnectionWizard2.png"/>
- </p>
- <p>The
- <b>Host name</b> holds the IP address or DNS name of the remote system.
- The
- <b>Connection name</b> is the name to be displayed in the Remote Systems view.
- The
- <b>Description</b> is optional.
- Unless the user wants to use a specific
- <b>Profile</b>, the default profile is sufficient.
- The checkbox
- <b>Verfiy host name</b> enable or disables the verification of the remote system.
- </p>
- <p>By default, when pressing "Finish" the new connection contains the following sub systems: </p>
- <ul>
- <li>
- <b>Files</b>: This subsystem allows the user to browse the file system on the remote system. Amongst others the user has the possibility to open, create files, download or upload files.
- </li>
- </ul>
- <ul>
- <li>
- <b>Processes</b>: This subsystem allows the user to browse and control processes on the remote system.
- </li>
- </ul>
- <ul>
- <li>
- <b>Shells</b>: This subsystem allows the user to open command shells to issue commands on the remote system.
- </li>
- </ul>
- <ul>
- <li>
- <b>Terminals</b>: This subsystem allows the user to open command terminals to issue commands on the remote system.
- </li>
- </ul>
- <ul>
- <li>
- <b>LTTng Tracing</b>: With this subsystem the user can control the LTTng tracer on the remote system. It supports the control of kernel and userspace traces.
- </li>
- </ul>
- <p>The user has the possibility to configure or omit the subsystems
- <b>Files</b>,
- <b>Processes</b>,
- <b>Shells</b> and
- <b>Terminals</b> by pressing "Next" and deselecting the relevant subsystem.
- </p>
- <p>
- <img border="0" src="images/LTTngNewConnectionWizard3.png"/>
- </p>
- <p>
- <img border="0" src="images/LTTngNewConnectionWizard4.png"/>
- </p>
- <p>
- <img border="0" src="images/LTTngNewConnectionWizard5.png"/>
- </p>
- <p>
- <img border="0" src="images/LTTngNewConnectionWizard6.png"/>
- </p>
- <p>After finishing the new connection the Remote System view will be updated:</p>
- <p>
- <img border="0" src="images/LTTngRemoteSystemsNewConnection.png"/>
- </p>
- <h4 id="General">General</h4>
- <p>All actions are on elements in the Remote Systems view are accessible through context sensitive menu. By selecting a tree element and pressing the right mouse button a context sensitive menu is shown. Some of the actions are also available through toolbar buttons and toolbar menu. </p>
- <h4 id="Connect_to_Remote_Host">Connect to Remote Host</h4>
- <p>The connection to the remote host can be established by selecting the connection in the tree, click the right mouse button and select Connect.</p>
- <p>
- <img border="0" src="images/LTTngConnectToRemoteSystem.png"/>
- </p>
- <p>A login dialog will be opened, where the user needs to specify the user name and password.</p>
- <p>
- <img border="0" src="images/LTTngLoginDialog.png"/>
- </p>
- <p>After logging in the LTTng Trace Control will retrieve LTTng Remote System information. First it will read the supported providers. The providers will be one or both of the following: "kernel" for kernel tracing and "ust" for user space tracing. After that the trace controls reads the currently available targets. For kernel tracing, there is only one target with ID "0". For user space tracing each target is the corresponding process ID of a user space application with user space tracing enabled. Without any traces created the Remote System view will look like this (after expanding the tree):</p>
- <p>
- <img border="0" src="images/LTTngRemoteSystemsWithLTTng.png"/>
- </p>
- <h4 id="Configure_Kernel_Markers">Configure Kernel Markers</h4>
- <p>The marker of a given target can be configured by selecting the kernel target "0", clicking the right mouse button and selecting the
- <b>Configure Markers</b> menu item of the context sensitive menu.
- </p>
- <p>
- <img border="0" src="images/LTTngConfigureMarkersAction.png"/>
- </p>
- <p>A new dialog box will show for the configuration of the relevant markers. All markers are listed in a table. The first column contains a checkbox to enable or disable a marker. The second column shows the name of the marker and all other columns display marker details.</p>
- <p>
- <img border="0" src="images/LTTngConfigureMarkersDialog.png"/>
- </p>
- <h4 id="Create_a_New_Kernel_Trace">Create a New Kernel Trace</h4>
- <p>A new trace can be created by selecting the kernel target "0", clicking the right mouse button and selecting the
- <b>New Trace</b> menu item of the context sensitive menu.
- </p>
- <p>
- <img border="0" src="images/LTTngCreateNewTraceAction.png"/>
- </p>
- <p>A new dialog box will show for the configuration of the relevant parameter. </p>
- <p>
- <img border="0" src="images/LTTngCreateNewTraceDialog.png"/>
- </p>
- <ul>
- <li>
- <b>Name</b>: holds the name of the trace.
- </li>
- </ul>
- <ul>
- <li>
- <b>Transport type</b>: it is set by default to "relay" and cannot be changed.
- </li>
- </ul>
- <ul>
- <li>
- <b>Trace Location</b>:
- <ul>
- <li>
- <b>Target</b>: means that the trace is stored on the remote system where the trace is collected.
- </li>
- <li>
- <b>Host</b>: means that the trace is transfered to the local host where the eclipse application is running.
- </li>
- <li>
- <b>Trace path</b>: holds the path where the trace shall be stored. The
- <b>Browse</b> button is only active for
- <b>Local</b> and can be used to open a dialog box to select the trace path directory.
- </li>
- </ul>
- </li>
- </ul>
- <ul>
- <li>
- <b>Tracing project</b>: defines the LTTng Tracing project where a streaming (host) trace will be added at trace start.
- </li>
- <li>
- <b>Number of lttd threads</b>: defines the number of threads to be used by the ltt daemon during tracing.
- </li>
- <li>
- <b>Append</b>: can be used to append the new trace to an existing trace.
- </li>
- <li>
- <b>Trace mode</b>: can be either
- <b>Normal</b> or
- <b>Flight Recorder</b>. In normal mode, the subbuffers are constantly written while the trace is started. In flight recorder mode, only the latest subbuffers are written when the trace is stopped.
- </li>
- </ul>
- <p>If all inputs are valid the
- <b>Finish</b> button will be active and can be used to create the trace. The LTTng trace control will setup the trace using the connection to the remote agent.
- </p>
- <p>After creating a new trace, the Remote Systems view will be updated. When selecting the newly created trace in the tree, the buttons to start, stop and configure the trace will be enabled.</p>
- <p>
- <img border="0" src="images/LTTngRemoteSystemConfiguredTrace.png"/>
- </p>
- <h4 id="Configure_a_Trace_and_Trace_Channels">Configure a Trace and Trace Channels</h4>
- <p>Some of the trace parameters can be changed if the trace has not been previously started. A trace can be configured by selecting the relevant kernel trace, clicking the right mouse button and selecting the "Configure Trace" menu item of the context sensitive menu. </p>
- <p>
- <img border="0" src="images/LTTngConfigureTraceAction.png"/>
- </p>
- <p>A new dialog box with a wizard page will show for the configuration of the relevant parameter. For explanation of the parameters see
- <a href="LTTng-Tracer-Control.html#Create_a_New_Kernel_Trace">Create_a_New_Kernel_Trace</a>
- </p>
- <p>
- <img border="0" src="images/LTTngConfigureTraceDialog.png"/>
- </p>
- <p>After entering valid parameters the
- <b>Next</b> and
- <b>Finish</b> buttons will be active. To finalize the configuration of the trace select the
- <b>Finish</b> button. To configure channel parameters select the
- <b>Next</b> button. A new wizard page will show for the configuration of channel parameters. For provider
- <b>kernel</b> the following display will show:
- </p>
- <p>
- <img border="0" src="images/LTTngConfigureChannelsKernelDialog.png"/>
- </p>
- <p>All channels can be configured at once by clicking the right mouse button in the table and selecting one of the menu items of the context sensitive menu.</p>
- <p>
- <img border="0" src="images/LTTngConfigureChannelsActions.png"/>
- </p>
- <p>For provider
- <b>ust</b> only the channel parameter
- <b>Channel Timer</b> can be configured and the following display will show after selecting the
- <b>Next</b> button of the
- <b>Trace configuration</b> page.
- </p>
- <p>
- <img border="0" src="images/LTTngConfigureChannelsUstDialog.png"/>
- </p>
- <p>Please note that channel parameters cannot be retrieved from the LTTng agent. Therefore they cannot be displayed in the table unless they have been previously configured through Eclipse. However, this information will be lost after closing Eclipse. A question mark will indicate that the relevant value is not known and it will be ignored after selecting the
- <b>Finish</b> button.
- </p>
- <ul>
- <li>
- <b>Name</b> column: holds the name of the channel.
- </li>
- <li>
- <b>Enabled</b> column: a checkbox indicates whether the channel is enabled or not.
- </li>
- <li>
- <b>Buffer Override</b> column: a checkbox indicates whether channel buffer overwrite is enabled or not.
- </li>
- <li>
- <b>Number of Sub Buffers</b> column: holds the number of sub-buffers of the channel.
- </li>
- <li>
- <b>Sub Buffer size</b> column: holds the size of the sub-buffer of the channel (in bytes).
- </li>
- <li>
- <b>Channel Timer</b> column: holds the channel timer value (in milliseconds) for periodically flushing all collected data for the channel, whether the sub-buffers are full or not. The provider
- <b>ust</b> only supports a single timer for all channels, traces and targets it is monitoring.
- </li>
- </ul>
- <p>Please note that the
- <b>Configure Trace</b> item of the context sensitive menu of a trace can be used to display the trace and channel parameters at any time. However, they can only be changed if the trace has not been previously started.
- </p>
- <h4 id="Start_a_Trace">Start a Trace</h4>
- <p>A configured or paused trace can be started by selecting the kernel trace, clicking the right mouse button and selecting the
- <b>Start</b> menu item of the context sensitive menu. Alternatively, the start button in the toolbar can be used to start the trace. If the trace location is host (streaming trace), it will be automatically added to the tracing project that was selected at trace creation.
- </p>
- <p>
- <img border="0" src="images/LTTngStartTraceAction.png"/>
- </p>
- <h4 id="Pause_a_Trace">Pause a Trace</h4>
- <p>A started trace can be paused by selecting the relevant trace, clicking the right mouse button and selecting the
- <b>Pause</b> menu item of the context sensitive menu. Alternatively, the pause button in the toolbar can be used to pause the trace.
- </p>
- <p>
- <img border="0" src="images/LTTngPauseTraceAction.png"/>
- </p>
- <h4 id="Stop_a_Trace">Stop a Trace</h4>
- <p>A non-started trace can be stopped by selecting the relevant trace, clicking the right mouse button and selecting the
- <b>Stop</b> menu item of the context sensitive menu. Alternatively, the stop button in the toolbar can be used to stop the trace. This will destroy the trace on the remote system, all allocated memory will be deallocated and all relevant trace files will be finalized. This step is need to be able to import a trace into the LTTng Perspective.
- </p>
- <p>
- <img border="0" src="images/LTTngStopTraceAction.png"/>
- </p>
- <h4 id="Import_a_Trace_in_the_LTTng_Perspective">Import a Trace in the LTTng Perspective</h4>
- <p>A streaming or stopped trace can be imported to the LTTng Perspective for viewing by selecting the relevant trace, clicking the right mouse button and selecting the
- <b>Import To Project</b> menu item of the context sensitive menu. A new dialog box will show to select the LTTng Project.
- </p>
- <p>
- <img border="0" src="images/LTTngImportTraceAction.png"/>
- </p>
- <p>For local trace path (streamed to the host):</p>
- <p>
- <img border="0" src="images/LTTngImportLocalTrace.png"/>
- </p>
- <p>For remote trace path (stored on the target):</p>
- <p>
- <img border="0" src="images/LTTngImportRemoteTrace.png"/>
- </p>
- <ul>
- <li>
- <b>Import to project</b>: All existing LTTng tracing projects in the workspace are displayed in a table and the user has to select the destination. If no projects are available the user has to create a new project first (see
- <a href="LTTng-Perspective.html#Project_View">Project_View</a>)
- </li>
- <li>
- <b>Trace name</b>: specifies the name that the imported trace shall have in the LTTng project.
- </li>
- <li>
- <b>Link only</b>: For a trace streamed to the host the user has the option to create a symbolic link to the trace path or, if the trace is stopped, to copy the trace into the LTTng project.
- </li>
- </ul>
- <p>After pressing button
- <b>Import</b> the trace will be stored in the selected project. For a trace stored on the target, it will be downloaded from the remote system.
- </p>
- <h4 id="Delete_a_Trace">Delete a Trace</h4>
- <p>A stopped trace can be deleted by selecting the relevant trace, clicking the right mouse button and selecting the
- <b>Delete</b> menu item of the context sensitive menu. A new dialog box will show for the user to confirm that the selected trace should be deleted.
- </p>
- <p>
- <img border="0" src="images/LTTngDeleteTraceAction.png"/>
- </p>
- <p>
- <img border="0" src="images/LTTngDeleteTraceConfirm.png"/>
- </p>
- <h3 id="Property_View">Property View</h3>
- <p>The Property view displays the properties of the selected resource in the tree. For traces it displays all configuration parameters.</p>
- <p>
- <img border="0" src="images/LTTngTraceProperties.png"/>
- </p><hr/>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <td style="width: 20%" align="left">
- <a href="LTTng-Perspective.html" title="LTTng Perspective">
- <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 (legacy)">
- <img alt="LTTng Plug-in User Guide (legacy)" 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">LTTng Perspective</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
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Limitations.html b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Limitations.html
deleted file mode 100644
index daeb977..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Limitations.html
+++ /dev/null
@@ -1,73 +0,0 @@
-<?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 (legacy) - 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="LTTng-Tracer-Control.html" title="LTTng Tracer Control">
- <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">LTTng Tracer Control</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). 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>Tracer control limitations (for LTTng Tracer Toolchain v0.x)</b>
- </p>
- <p>Due to errors in the LTTng remote agent, controlling of user space traces is currently not possible.</p>
- <p>The LTTng agent doesn't allow to retrieve the trace state, i.e. whether a trace is started or stopped. Therefore, when reconnecting with Eclipse, the LTTng control is not able to display the correct state. Currently, the trace is considered as started.</p>
- <p>For kernel traces, it's currently not possible to configure the channels. This will be added in the next release. </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><hr/>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <td style="width: 20%" align="left">
- <a href="LTTng-Tracer-Control.html" title="LTTng Tracer Control">
- <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 (legacy)">
- <img alt="LTTng Plug-in User Guide (legacy)" 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">LTTng Tracer Control</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
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/User-Guide.html b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/User-Guide.html
deleted file mode 100644
index 2c23505..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/User-Guide.html
+++ /dev/null
@@ -1,73 +0,0 @@
-<?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 (legacy)</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 (legacy)</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 2.0 (Linux Trace Toolkit, next generation 2.0) is a highly efficient tracing tool for Linux that can be used to track down kernel and application performance issues as well as debug problems involving multiple concurrent processes and threads. It consists of a set of kernel modules, a daemon - to collect the raw tracing data - and a set of tools to control, visualize and analyze the generated data.</p>
- <p>The LTTng plug-in for Eclipse provides an Eclipse integration for the control, fetching and visualization of LTTng traces. It also provides the foundation for user-defined analysis tools.</p>
- <p>At present, the LTTng Eclipse plug-in for Eclipse supports the following kernel-oriented analyses:</p>
- <ul>
- <li>
- <i>Control Flow</i> - to visualize processes state transition
- </li>
- <li>
- <i>Resources</i> - to visualize system resources state transitions
- </li>
- <li>
- <i>Statistics</i> - to provide simple statistics on event occurences
- </li>
- </ul>
- <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 troubleshooting technique used to understand the behavior of an instrumented application by collecting information on its execution path. 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 at selected execution locations. However, compared to logging, it is generally aimed at developers and it usually records low-level events at a high rate. Tracers can typically generate thousands of events per second. The generated traces can easily contain millions of events and have sizes from many megabytes to tens of gigabytes. Tracers must therefore be optimized to handle a lot of data while having a small impact on the system.</p>
- <p>Traces may include events from the operating system kernel (IRQ handler entry/exit, system call entry/exit, scheduling activity, network activity, etc). They 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, 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 a trace may 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 tracing both the Linux kernel and user applications (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 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
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ControlFlowView.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ControlFlowView.png
deleted file mode 100644
index 838933c..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ControlFlowView.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/EventsView.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/EventsView.png
deleted file mode 100644
index 073db67..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/EventsView.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsActions.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsActions.png
deleted file mode 100644
index 8ce9b2f..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsActions.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsKernelDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsKernelDialog.png
deleted file mode 100644
index 7b428d6..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsKernelDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsUstDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsUstDialog.png
deleted file mode 100644
index 0b63ad0..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureChannelsUstDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersAction.png
deleted file mode 100644
index 9754287..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersDialog.png
deleted file mode 100644
index fceedda..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureMarkersDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceAction.png
deleted file mode 100644
index 6b5c70f..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceDialog.png
deleted file mode 100644
index c53d77b..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConfigureTraceDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConnectToRemoteSystem.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConnectToRemoteSystem.png
deleted file mode 100644
index da63d93..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngConnectToRemoteSystem.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlFlowColorLegend.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlFlowColorLegend.png
deleted file mode 100644
index 1d47f6b..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlFlowColorLegend.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlRsePerspective.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlRsePerspective.png
deleted file mode 100644
index b6d4573..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngControlRsePerspective.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceAction.png
deleted file mode 100644
index e5d0b47..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceDialog.png
deleted file mode 100644
index 959f7fc..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngCreateNewTraceDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceAction.png
deleted file mode 100644
index 591fcf8..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceConfirm.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceConfirm.png
deleted file mode 100644
index 8e55b83..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngDeleteTraceConfirm.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportLocalTrace.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportLocalTrace.png
deleted file mode 100644
index a8a0669..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportLocalTrace.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportRemoteTrace.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportRemoteTrace.png
deleted file mode 100644
index f08f164..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportRemoteTrace.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportTraceAction.png
deleted file mode 100644
index 2c4c1e6..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngImportTraceAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngLoginDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngLoginDialog.png
deleted file mode 100644
index 69aa9fb..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngLoginDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard1.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard1.png
deleted file mode 100644
index 7f8b9ae..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard1.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard2.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard2.png
deleted file mode 100644
index 9be6439..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard2.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard3.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard3.png
deleted file mode 100644
index effa82a..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard3.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard4.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard4.png
deleted file mode 100644
index b607609..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard4.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard5.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard5.png
deleted file mode 100644
index 36f480e..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard5.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard6.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard6.png
deleted file mode 100644
index 085a0eb..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngNewConnectionWizard6.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPauseTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPauseTraceAction.png
deleted file mode 100644
index 2f62f41..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPauseTraceAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspective.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspective.png
deleted file mode 100644
index f60ef6e..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspective.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspectiveOpen.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspectiveOpen.png
deleted file mode 100644
index 0800c49..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngPerspectiveOpen.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProcessStateInfo.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProcessStateInfo.png
deleted file mode 100644
index fa56d2d..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProcessStateInfo.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog-2.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog-2.png
deleted file mode 100644
index 3ed0a79..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog-2.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog.png
deleted file mode 100644
index c6732aa..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewWizard.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewWizard.png
deleted file mode 100644
index d3b575b..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectNewWizard.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectProperty.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectProperty.png
deleted file mode 100644
index 733ccc5..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngProjectProperty.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemConfiguredTrace.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemConfiguredTrace.png
deleted file mode 100644
index 2f3e638..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemConfiguredTrace.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsNewConnection.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsNewConnection.png
deleted file mode 100644
index 7884b8e..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsNewConnection.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsWithLTTng.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsWithLTTng.png
deleted file mode 100644
index 7d358ef..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngRemoteSystemsWithLTTng.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngResourcesColorLegend.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngResourcesColorLegend.png
deleted file mode 100644
index 77b2b88..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngResourcesColorLegend.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStartTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStartTraceAction.png
deleted file mode 100644
index bcc0af3..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStartTraceAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStopTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStopTraceAction.png
deleted file mode 100644
index 3c3d9e6..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngStopTraceAction.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceImportDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceImportDialog.png
deleted file mode 100644
index 7040659..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceImportDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceProperties.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceProperties.png
deleted file mode 100644
index bb3894e..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceProperties.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceSelectDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceSelectDialog.png
deleted file mode 100644
index 09bc377..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LTTngTraceSelectDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyAddMatchingDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyAddMatchingDialog.png
deleted file mode 100644
index 3cb6d21..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyAddMatchingDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDeleteMatchingDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDeleteMatchingDialog.png
deleted file mode 100644
index 9b673d6..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDeleteMatchingDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionHover.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionHover.png
deleted file mode 100644
index 805b713..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionHover.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionZoom.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionZoom.png
deleted file mode 100644
index 74af4f7..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyDistributionZoom.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyGraphHover.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyGraphHover.png
deleted file mode 100644
index 5362e62..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyGraphHover.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyListMatchingDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyListMatchingDialog.png
deleted file mode 100644
index b12c2a7..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyListMatchingDialog.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyToolbar.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyToolbar.png
deleted file mode 100644
index 99b2e86..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyToolbar.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyView.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyView.png
deleted file mode 100644
index d1ab3f6..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/LatencyView.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ProjectExplorer.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ProjectExplorer.png
deleted file mode 100644
index d483b5f..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ProjectExplorer.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ResourcesView.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ResourcesView.png
deleted file mode 100644
index b2000d8..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/ResourcesView.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/StatisticsView.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/StatisticsView.png
deleted file mode 100644
index 3cd66c1..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/StatisticsView.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Filter.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Filter.png
deleted file mode 100644
index c9c7551..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Filter.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Search.png b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Search.png
deleted file mode 100644
index b2ab877..0000000
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEvents-Search.png
+++ /dev/null
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/Installation.html b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/Installation.html
index 29a8cdb..19201b1 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/Installation.html
+++ b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/Installation.html
@@ -110,7 +110,8 @@
<i>ssh</i> connection even if the tracer is running locally (the 'degenerate' case).
</p>
<p>Therefore, the target system (where the tracer runs) needs to run an
- <i>ssh</i> server to which you have permission to connect.
+ <i>ssh</i> server as well as
+ <i>sftp</i> server (for file transfer) to which you have permission to connect.
</p>
<p>On the host side (where Eclipse is running), you also need to have Eclipse RSE (Remote System Explorer) installed to handle the SSH connection and transport. The RSE can be installed the standard way (
<i>Help</i> &gt;
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html
index ddc55fb..0ebbccb 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html
+++ b/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html
@@ -80,7 +80,7 @@
<b><span style="color: #AD77D7;">toolbar</span></b>.
</p>
<p>The following sections provide detailed information for each part of the Control Flow View.</p>
- <h3 id="Process_Tree_and_Information">Process Tree and Information</h3>
+ <h3 id="Process_tree_and_informations">Process tree and informations</h3>
<p>Processes are organized as a tree within this view. This way, child and parent processes are easy to identify.</p>
<p>
<img border="0" src="images/Cfv_process_tree.png"/>
@@ -88,17 +88,17 @@
<p>The layout is based on the states computed from the trace events.</p>
<p>A given process may be shown at different places within the tree since the nodes are
<b>unique (TID, birth time) couples</b>. This means that if process B of parent A dies, you'll still see it in the tree. If process A forks process B again, it will be shown as a different node since it won't have the same birth time (and probably not the same TID). This has the advantage that the tree, once loaded, never changes: horizontal scrolling within the
- <a href="#anc-cfw-states-flow">states flow</a> remains possible.
+ <a href="LTTng-Kernel-Analysis.html#States_flow">states flow</a> remains possible.
</p>
<p>The TID column shows the process node's
<b>thread ID</b> and the PTID column shows its
<b>parent thread ID</b> (nothing is shown if the process has no parent).
</p>
- <h3 id="States_Flow">States Flow</h3>
+ <h3 id="States_flow">States flow</h3>
<p>This part of the Control Flow View is probably the most interesting one. Using the mouse, you can navigate through the trace (go left, right) and zoom on a specific region to inspect its details.</p>
<p>The colored bars you see represent
<b>states</b> for the associated process node. When a process state changes in time, so does the color. States colors legend is available through a
- <a href="#anc-cfw-toolbar">toolbar button</a>:
+ <a href="LTTng-Kernel-Analysis.html#Toolbar">toolbar button</a>:
</p>
<p>
<img border="0" src="images/Cfv_legend.png"/>
@@ -224,17 +224,25 @@
<a href="LTTng-Kernel-Analysis.html#Control_Flow_View">control flow view</a>, etc.
</p>
<h3 id="Navigation">Navigation</h3>
- <p>See
- <a href="LTTng-Kernel-Analysis.html#Using_the_mouse">using the mouse </a> and
- <a href="LTTng-Kernel-Analysis.html#Zoom_region">zoom region </a>.
+ <p>See Control Flow View's
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Using_the_mouse">Using the mouse</a>
+ </b> and
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Zoom_region">Zoom region</a>
+ </b>.
</p>
<h3 id="Incomplete_regions_2">Incomplete regions</h3>
- <p>See
- <a href="LTTng-Kernel-Analysis.html#Incomplete_regions">Incomplete regions</a>.
+ <p>See Control Flow View's
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Incomplete_regions">Incomplete regions</a>
+ </b>.
</p>
<h3 id="Toolbar_2">Toolbar</h3>
- <p>See
- <a href="LTTng-Kernel-Analysis.html#Toolbar">Toolbar</a>.
+ <p>See Control Flow View's
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Toolbar">Toolbar</a>
+ </b>.
</p>
<h2 id="Events_View_2">Events View</h2>
<p>The LTTng Kernel Events View
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/build-helper.xml b/lttng/org.eclipse.linuxtools.lttng.help/build-helper.xml
index b80be96..45d7e4a 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/build-helper.xml
+++ b/lttng/org.eclipse.linuxtools.lttng.help/build-helper.xml
@@ -18,11 +18,34 @@
<include name="org.eclipse.mylyn.wikitext.*core*.jar" />
</fileset>
</path>
-
+
+ <!-- Uncomment and set proxy host and port if necessary -->
+ <!--
+ <setproxy proxyhost="host" proxyport="port"/>
+ -->
+
<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">
+ <sequential>
+
+ <wikitext-to-eclipse-help markupLanguage="MediaWiki"
+ validate="true"
+ failonvalidationerror="true"
+ overwrite="true"
+ multipleOutputFiles="true"
+ navigationimages="true"
+ title="${ug.title}"
+ formatoutput="true"
+ helpPrefix="doc">
+ <fileset dir="./doc">
+ <include name="User-Guide.mediawiki" />
+ </fileset>
+ <stylesheet url="book.css" />
+ </wikitext-to-eclipse-help>
+ <antcall target="test" />
+
<mediawiki-to-eclipse-help wikiBaseUrl="${help.doc.url.base}" title="${ug.title}" formatoutput="true" dest="." templateExcludes="*eclipseproject*">
<path name="${ug.path}" title="${ug.title}" generateToc="false" />
<stylesheet url="book.css" />
@@ -33,7 +56,8 @@ This document is maintained in a collaborative wiki. If you wish to update or m
http://wiki.eclipse.org/Linux_Tools_Project/LTTng2/User_Guide.
</pageAppendum>
</mediawiki-to-eclipse-help>
- <antcall target="test" />
+
+ </sequential>
</target>
<target name="test" description="Verify that all of the HTML files are well-formed XML">
@@ -55,7 +79,7 @@ or inadvertently starting a line with a space character (in MediaWiki this start
-->
<echo file="${temp.dir}/__empty.dtd" message="" />
<xmlvalidate lenient="true">
- <fileset dir="Linux_Tools_Project">
+ <fileset dir="doc">
<include name="**/*.html" />
</fileset>
<dtd publicid="-//W3C//DTD XHTML 1.0 Transitional//EN" location="${temp.dir}/__empty.dtd" />
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/build.properties b/lttng/org.eclipse.linuxtools.lttng.help/build.properties
index cf19114..d02ac6c 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/build.properties
+++ b/lttng/org.eclipse.linuxtools.lttng.help/build.properties
@@ -1,11 +1,8 @@
bin.includes = plugin.xml,\
META-INF/,\
about.html,\
- toc.xml,\
- Linux_Tools_Project/,\
- doc/,\
toc-doc.xml,\
plugin.properties,\
- images/,\
- book.css
+ book.css,\
+ doc/
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/How-to-use-LTTng-to-diagnose-problems.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/How-to-use-LTTng-to-diagnose-problems.html
new file mode 100644
index 0000000..3d20c23
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/How-to-use-LTTng-to-diagnose-problems.html
@@ -0,0 +1,79 @@
+<?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 - How to use LTTng to diagnose problems</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">How to use LTTng to diagnose problems</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="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">Limitations</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">References</td>
+ </tr>
+ </table><hr/>
+ <h1 id="How_to_use_LTTng_to_diagnose_problems">How to use LTTng to diagnose problems</h1>
+ <p>LTTng is a tracer, it will give an enormous amount of information about the system it is running on. This means it can solve many types of problems.</p>
+ <p>The following are examples of problems that can be solved with a tracer. </p>
+ <h2 id="Random_stutters">Random stutters</h2>
+ <p>Bob is running a computer program and it stutters periodically every 2 minutes. The CPU load is relatively low and Bob isn't running low on RAM.</p>
+ <p>He decides to trace his complete system for 10 minutes. He opens the LTTng view in eclipse. From the control, he creates a session and enables all kernel tracepoints.</p>
+ <p>He now has a 10 GB trace file. He imports the trace to his viewer and loads it up.</p>
+ <p>A cursory look at the histogram bar on the bottom show relatively even event distribution, there are no interesting spikes, so he will have to dig deeper to find the issue. If he had seen a spike every 2 minutes, there would be strong chances this would be the first thing to investigate as it would imply a lot of kernel activity at the same period as his glitch, this would have been a path to investigate.</p>
+ <p>As Bob suspects that he may be having some hardware raising IRQs or some other hardware based issue and adding delays. He looks at the ressource view and doesn't see anything abnormal.</p>
+ <p>Bob did note an exact second one glitch occured: 11:58:03. He zooms into the time range or 11:58:02-11:58:04 using the histogram.He is happy to see the time is human readable local wall clock time and no longer in "nanseconds since the last reboot".
+ <br/>In the resource view, once again, he sees many soft irqs being raised at the same time, around the time his gui would freeze. He changes views and looks at the control flow view at that time and sees a process spending a lot of time in the kernel: FooMonitor- his temperature monitoring software.
+ </p>
+ <p>At this point he closes FooMonitor and notices the bug dissapeared. He could call it a day but he wants to see what was causing the system to freeze. He cannot justify closing a piece of software without understanding the issue. It may be a conflict that HIS software is causing after all.</p>
+ <p>The system freezes around the time this program is running. He clicks on the process in the control flow view and looks at the corresponding events in the detailed events view. He sees: open - read - close repeated hundreds of times on the same file. The file being read was /dev/HWmonitor. He sends a report to the FooMonitor team and warns his team that FooMonitor was glitching their performance.</p>
+ <p>The FooMonitor team finds that they were calling a system bus call that would halt a cpu while reading the temperature so that the core would not induce an 0.1 degree error in the reading, by disabling this feature, they improve their software and stop the glitches from occurring on their custommer's machine. They also optimize their code to open the file read and clone it once.</p>
+ <p>By using system wide kernel tracing, even without deep kernel knowledge Bob was able to isolate a bug in a rogue piece of software in his system.</p>
+ <h2 id="Slow_I.2FO">Slow I/O</h2>
+ <p>Alice is running her server. She noticed that one of her nodes was slowing down, and wasn't sure why, upon reading the trace she noticed that her time between a block request and complete was around 10ms.</p>
+ <p>This is abnormal, normally her server handles IOs in under 100us, since they are quite local.</p>
+ <p>She walks up to the server and hears the hard drive thrashing, This prompts her to look up in the events view the sectors being read in the block complete requests. There are her requests interleaved with other ones at the opposite side of the hard drive.</p>
+ <p>She sees the tracer writing but there is another process that is writing to the server disk non stop. She looks in the control flow view and sees that there's a program from another fellow engineer, "Wally" that is writing in his home in a loop "All work and no play makes Jack a dull boy.".</p>
+ <p>Alice kills the program, and immediately the server speeds up. She then goes to discuss this with Wally and implements strict hard disk quotas on the server.</p><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="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">Limitations</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
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/Installation.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/Installation.html
new file mode 100644
index 0000000..dcbfe03
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/Installation.html
@@ -0,0 +1,182 @@
+<?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 - Installation</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">Installation</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="User-Guide.html" title="Overview">
+ <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="LTTng.html" title="LTTng">
+ <img alt="Next" border="0" src="images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Overview</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">LTTng</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Installation">Installation</h1>
+ <p>This section describes the installation of the LTTng tracer and the LTTng Eclipse plug-ins as well as their dependencies.</p>
+ <h2 id="LTTng_Tracer">LTTng Tracer</h2>
+ <p>While the Eclipse plug-ins can run on the standard Eclipse platforms (Linux, Mac, Windows), the LTTng tracer and its accompanying tools run on Linux.</p>
+ <p>The tracer and tools have been available for download in Ubuntu since 12.04. They can easily be installed with the following command:</p>
+ <pre>
+ &gt; sudo apt-get install lttng-tools
+</pre>
+ <p>For other distributions, older Ubuntu distributions, or the latest, bleeding edge LTTng tracer, please refer to the
+ <a href="http://lttng.org/download">LTTng website</a> for installation information.
+ </p>
+ <p>
+ <b>Note</b>: The LTTng tracer (and accompanying tools) is required only if you want to create your own traces (the usual case). If you intend to simply analyze existing traces then it is not necessary to install the tracer.
+ </p>
+ <h2 id="LTTng_Eclipse_Plug-ins">LTTng Eclipse Plug-ins</h2>
+ <p>The easiest way to install the LTTng plug-ins for Eclipse is through the Software Updates and Add-ons menu. For information on how to use this menu, refer to this
+ <a href="http://wiki.eclipse.org/Linux_Tools_Project/PluginInstallHelp#Installing_Updates_From_the_Linux_Tools_Update_Site">link</a>.
+ </p>
+ <p>The legacy (
+ <i>Classic</i> :-)) Eclipse LTTng (v0.x) is also available as an optional download. Refer to
+ <a href="http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng/User_Guide">here</a> for installation and verification instructions.
+ </p>
+ <p>The LTTng plug-ins are structured as a stack of features/plug-ins as following:</p>
+ <ul>
+ <li>
+ <b>CTF</b> - A CTF parser that can also be used as a standalone component
+ <ul>
+ <li>
+ <i>Feature</i>: org.eclipse.linuxtools.ctf
+ </li>
+ <li>
+ <i>Plug-ins</i>: org.eclipse.linuxtools.ctf.core, org.eclipse.linuxtools.ctf.parser
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <ul>
+ <li>
+ <b>TMF</b> -
+ <i>Tracing and Monitoring Framework</i> a framework for generic trace processing
+ <ul>
+ <li>
+ <i>Feature</i>: org.eclipse.linuxtools.tmf
+ </li>
+ <li>
+ <i>Plug-ins</i>: org.eclipse.linuxtools.tmf.core, org.eclipse.linuxtools.tmf.ui
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <ul>
+ <li>
+ <b>LTTng</b> - The wrapper for the LTTng tracer control. Can be used for kernel or application tracing.
+ <ul>
+ <li>
+ <i>Feature</i>: org.eclipse.linuxtools.lttng2
+ </li>
+ <li>
+ <i>Plug-ins</i>: org.eclipse.linuxtools.lttng2.core, org.eclipse.linuxtools.lttng2.ui
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <ul>
+ <li>
+ <b>LTTng Kernel</b> - Analysis components specific to Linux kernel traces
+ <ul>
+ <li>
+ <i>Feature</i>: org.eclipse.linuxtools.lttng2.kernel
+ </li>
+ <li>
+ <i>Plug-ins</i>: org.eclipse.linuxtools.lttng2.kernel.core, org.eclipse.linuxtools.lttng2.kernel.ui
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <h2 id="LTTng_Eclipse_Dependencies">LTTng Eclipse Dependencies</h2>
+ <p>The Eclipse LTTng controls the LTTng tracer through an
+ <i>ssh</i> connection even if the tracer is running locally (the 'degenerate' case).
+ </p>
+ <p>Therefore, the target system (where the tracer runs) needs to run an
+ <i>ssh</i> server as well as
+ <i>sftp</i> server (for file transfer) to which you have permission to connect.
+ </p>
+ <p>On the host side (where Eclipse is running), you also need to have Eclipse RSE (Remote System Explorer) installed to handle the SSH connection and transport. The RSE can be installed the standard way (
+ <i>Help</i> &gt;
+ <i>Install New Software...</i> &gt;
+ <i>General Purpose Tools</i> &gt;
+ <i>Remote System Explorer End-User Runtime</i>).
+ </p>
+ <h2 id="Installation_Verification">Installation Verification</h2>
+ <p>Here are the quick steps to verify that your installation is functional:</p>
+ <ul>
+ <li>Start Eclipse</li>
+ <li>Open the LTTng perspective</li>
+ <li>Create a Tracing 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 "Traces" folder and select "Import..."</li>
+ <li>Navigate to the sample LTTng trace that you want to visualize</li>
+ <li>Select that trace (check box), select the trace type (e.g. CTF: Kernel Trace), and press "Finish"</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>If an error message is displayed, you might want to double-check that the trace type is correctly set (right-click on the trace and "Select Trace Type...").</p>
+ <p>Refer to
+ <a href="LTTng.html#Tracing_Perspective">Tracing Perspective</a> for detailed description of the views and their usage.
+ </p>
+ <p>To download sample LTTng traces, go to
+ <a href="http://lttng.org/download">http://lttng.org/download</a>. At the bottom of the page there is a link to some sample LTTng 2.0 kernel traces.
+ </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="Overview">
+ <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="LTTng.html" title="LTTng">
+ <img alt="Next" border="0" src="images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Overview</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">LTTng</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng-Kernel-Analysis.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng-Kernel-Analysis.html
new file mode 100644
index 0000000..ad935d2
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng-Kernel-Analysis.html
@@ -0,0 +1,294 @@
+<?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 - LTTng Kernel Analysis</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 Kernel Analysis</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="LTTng.html" title="LTTng">
+ <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">LTTng</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Limitations</td>
+ </tr>
+ </table><hr/>
+ <h1 id="LTTng_Kernel_Analysis">LTTng Kernel Analysis</h1>
+ <p>Historically, LTTng was developped to trace the Linux kernel and, over time, a number of kernel-oriented analysis views were developped and organized in a perspective.</p>
+ <p>This section presents a description of the LTTng Kernel Perspective.</p>
+ <h2 id="LTTng_Kernel_Perspective">LTTng Kernel Perspective</h2>
+ <p>The
+ <b>LTTng Kernel</b> perspective is built upon the
+ <a href="LTTng.html#Tracing_Perspective">Tracing Perspective</a>, re-organizes them slightly and adds the following views:
+ </p>
+ <ul>
+ <li>
+ <a href="LTTng-Kernel-Analysis.html#Control_Flow_View">Control Flow View</a> - to visualize processes state transitions
+ </li>
+ <li>
+ <a href="LTTng-Kernel-Analysis.html#Resources_View">Resources View</a> - to visualize system resources state transitions
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/LTTngKernelPerspective.png"/>
+ </p>
+ <p>The perspective can be opened from the Eclipse Open Perspective dialog (
+ <b>Window &gt; Open Perspective... &gt; Other</b>).
+ </p>
+ <p>
+ <img border="0" src="images/OpenLTTngKernelPerspective.png"/>
+ </p>
+ <h2 id="Control_Flow_View">Control Flow View</h2>
+ <p>The
+ <b>
+ <i>Control Flow View</i>
+ </b> is a LTTng-specific view that shows per-process events graphically. To enable it, select
+ <i>Control Flow</i> under
+ <i>LTTng</i> within the
+ <i>Show View</i> window (
+ <b>Window</b> -&gt;
+ <b>Show View</b> -&gt;
+ <b>Other...</b>):
+ </p>
+ <p>
+ <img border="0" src="images/Cfv_show_view.png"/>
+ </p>
+ <p>You should get something like this:</p>
+ <p>
+ <img border="0" src="images/Cfv_global.png"/>
+ </p>
+ <p>The view is divided into the following important sections:
+ <b><span style="color: #C84545;">process tree</span></b>,
+ <b><span style="color: #A1C81A;">process TID, PTID and birth time</span></b>,
+ <b><span style="color: #67A3DC;">states flow</span></b> and the
+ <b><span style="color: #AD77D7;">toolbar</span></b>.
+ </p>
+ <p>The following sections provide detailed information for each part of the Control Flow View.</p>
+ <h3 id="Process_tree_and_informations">Process tree and informations</h3>
+ <p>Processes are organized as a tree within this view. This way, child and parent processes are easy to identify.</p>
+ <p>
+ <img border="0" src="images/Cfv_process_tree.png"/>
+ </p>
+ <p>The layout is based on the states computed from the trace events.</p>
+ <p>A given process may be shown at different places within the tree since the nodes are
+ <b>unique (TID, birth time) couples</b>. This means that if process B of parent A dies, you'll still see it in the tree. If process A forks process B again, it will be shown as a different node since it won't have the same birth time (and probably not the same TID). This has the advantage that the tree, once loaded, never changes: horizontal scrolling within the
+ <a href="LTTng-Kernel-Analysis.html#States_flow">states flow</a> remains possible.
+ </p>
+ <p>The TID column shows the process node's
+ <b>thread ID</b> and the PTID column shows its
+ <b>parent thread ID</b> (nothing is shown if the process has no parent).
+ </p>
+ <h3 id="States_flow">States flow</h3>
+ <p>This part of the Control Flow View is probably the most interesting one. Using the mouse, you can navigate through the trace (go left, right) and zoom on a specific region to inspect its details.</p>
+ <p>The colored bars you see represent
+ <b>states</b> for the associated process node. When a process state changes in time, so does the color. States colors legend is available through a
+ <a href="LTTng-Kernel-Analysis.html#Toolbar">toolbar button</a>:
+ </p>
+ <p>
+ <img border="0" src="images/Cfv_legend.png"/>
+ </p>
+ <p>This dark yellow is what you'll see most of the time since scheduling puts processes on hold while others run.</p>
+ <p>The vertical blue line is the
+ <b>current time indicator</b>.
+ </p>
+ <h4 id="Using_the_mouse">Using the mouse</h4>
+ <p>The states flow is usable with the mouse. The following actions are set:</p>
+ <ul>
+ <li>
+ <b>drag horizontally</b>: pan left or right
+ </li>
+ <li>
+ <b>click on a colored bar</b>: the associated process node is selected and the current time indicator is moved where the click happened
+ </li>
+ <li>
+ <b>mouse wheel up/down</b>: zoom in or out
+ </li>
+ <li>
+ <b>drag the time ruler horizontally</b>: zoom in or out
+ </li>
+ <li>
+ <b>drag the time ruler horizontally with the right button</b>:
+ <a href="LTTng-Kernel-Analysis.html#Zoom_region">zoom region</a>
+ </li>
+ <li>
+ <b>double-click the time ruler</b>: reset zoom
+ </li>
+ </ul>
+ <p>When the current time indicator is changed (when clicking in the states flow), all the other views are
+ <b>synchronized</b>. For example, the
+ <a href="LTTng-Kernel-Analysis.html#Events_View_2">Events View</a> will show the event matching the current time indicator. The reverse behaviour is also implemented: selecting an event within the Events View will update the Control Flow View current time indicator.
+ </p>
+ <h4 id="Incomplete_regions">Incomplete regions</h4>
+ <p>You'll notice
+ <b>small dots</b> over the colored bars at some places:
+ </p>
+ <p>
+ <img border="0" src="images/Cfv_small_dots.png"/>
+ </p>
+ <p>Those dots mean the underlying region is
+ <b>incomplete</b>: there's not enough pixels to view all the events. In other words, you have to zoom in.
+ </p>
+ <p>When zooming in, small dots start to disappear:</p>
+ <p>
+ <img border="0" src="images/Cfv_zoom.png"/>
+ </p>
+ <p>When no dots are left, you are viewing
+ <b>all the events and states</b> within that region.
+ </p>
+ <h4 id="Zoom_region">Zoom region</h4>
+ <p>To zoom in on a specific region,
+ <b>right-click and drag the time ruler</b> in order to draw a time range:
+ </p>
+ <p>
+ <img border="0" src="images/Cfv_zoom_region.png"/>
+ </p>
+ <p>The states flow horizontal space will only show the selected region.</p>
+ <h4 id="Tooltips">Tooltips</h4>
+ <p>Hover the cursor over a colored bar and a
+ <b>tooltip</b> will pop up:
+ </p>
+ <p>
+ <img border="0" src="images/Cfv_tooltip.png"/>
+ </p>
+ <p>The tooltip indicates:</p>
+ <ul>
+ <li>the process name</li>
+ <li>the pointed state name</li>
+ <li>the pointed state date and start/stop times</li>
+ <li>the pointed state duration (seconds)</li>
+ </ul>
+ <h3 id="Toolbar">Toolbar</h3>
+ <p>The Control Flow View
+ <b>toolbar</b>, located at the top right of the view, has shortcut buttons to perform common actions:
+ </p>
+ <p>
+ <img border="0" src="images/Cfv_toolbar.png"/>
+ </p>
+ <p>The
+ <b>Previous event</b> and
+ <b>Next event</b> buttons update the current time indicator so that it's on the previous or next event.
+ </p>
+ <p>The
+ <b>Previous process</b> and
+ <b>Next process</b> buttons select the previous and next process node within the process tree.
+ </p>
+ <h2 id="Resources_View">Resources View</h2>
+ <p>This view is specific to kernel trace. To open it, go in
+ <b>Window</b> -&gt;
+ <b>Show View</b> -&gt;
+ <b>Other...</b> and select
+ <b>LTTng/Resources</b> in the list.
+ </p>
+ <p>
+ <img title=" Example of resources view with all trace points and syscalls enabled" alt=" Example of resources view with all trace points and syscalls enabled" border="0" src="images/Rv example.png"/>
+ </p>
+ <p>This view shows the state of system resources i.e. if changes occured during the trace either on
+ <b>CPUs</b>,
+ <b>IRQs</b> or
+ <b>soft IRQs</b>, it will appear in this view. The left side of the view present a list of resources that are affected by at least one event of the trace. The right side illustrate the state in which each resource is at some point in time.
+ </p>
+ <p>Just like other views, according to which trace points and system calls are activated, the content of this view may change from one trace to another.</p>
+ <p>Each state are represented by one color so it is faster to say what is happening.</p>
+ <p>
+ <img title="Color for each state" alt="Color for each state" border="0" src="images/Rv_legend.png"/>
+ </p>
+ <p>To go through the state of a resource, you first have to select the resource and the timestamp that interest you. For the latter, you can pick some time before the interesting part of the trace.</p>
+ <p>
+ <img title="Shows the state of an IRQ" alt="Shows the state of an IRQ" border="0" src="images/RV_infobox1.png"/>
+ </p>
+ <p>Then, by selecting
+ <b>Next Event</b>, it will show the next state transition and the event that occured at this time.
+ </p>
+ <p>
+ <img title="Shows the next state of the IRQ" alt="Shows the next state of the IRQ" border="0" src="images/RV_infobox2.png"/>
+ </p>
+ <p>This view is also synchronized with the others :
+ <a href="LTTng.html#Histogram_View">histogram</a>,
+ <a href="LTTng-Kernel-Analysis.html#Events_View_2">events view</a>,
+ <a href="LTTng-Kernel-Analysis.html#Control_Flow_View">control flow view</a>, etc.
+ </p>
+ <h3 id="Navigation">Navigation</h3>
+ <p>See Control Flow View's
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Using_the_mouse">Using the mouse</a>
+ </b> and
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Zoom_region">Zoom region</a>
+ </b>.
+ </p>
+ <h3 id="Incomplete_regions_2">Incomplete regions</h3>
+ <p>See Control Flow View's
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Incomplete_regions">Incomplete regions</a>
+ </b>.
+ </p>
+ <h3 id="Toolbar_2">Toolbar</h3>
+ <p>See Control Flow View's
+ <b>
+ <a href="LTTng-Kernel-Analysis.html#Toolbar">Toolbar</a>
+ </b>.
+ </p>
+ <h2 id="Events_View_2">Events View</h2>
+ <p>The LTTng Kernel Events View
+ <b>is</b> the plain TMF
+ <a href="LTTng.html#Events_View">Events Views</a> except that it provide its own specialized viewer to replace the standard one. In short, it has exactly the same behaviour but the layout is slightly different:
+ </p>
+ <ul>
+ <li>
+ <b>Timestamp</b>: the event timestamp
+ </li>
+ <li>
+ <b>Channel</b>: the event channel (data collector)
+ </li>
+ <li>
+ <b>Event Type</b>: the event type (or kernel marker)
+ </li>
+ <li>
+ <b>Content</b>: the raw event content
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/LTTngKernelEventsViewer.png"/>
+ </p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="LTTng.html" title="LTTng">
+ <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">LTTng</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
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng.html
new file mode 100644
index 0000000..bf2a730
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/LTTng.html
@@ -0,0 +1,1742 @@
+<?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 - LTTng</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</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Installation.html" title="Installation">
+ <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="LTTng-Kernel-Analysis.html" title="LTTng Kernel Analysis">
+ <img alt="Next" border="0" src="images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Installation</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">LTTng Kernel Analysis</td>
+ </tr>
+ </table><hr/>
+ <h1 id="LTTng">LTTng</h1>
+ <h2 id="Tracing_Perspective">Tracing Perspective</h2>
+ <p>The
+ <b>Tracing</b> perspective is part of the
+ <b>Tracing and Monitoring Framework (TMF)</b> and groups the following views:
+ </p>
+ <ul>
+ <li>
+ <a href="LTTng.html#Project_View">Project View</a>
+ </li>
+ <li>
+ <a href="LTTng.html#Events_View">Events View</a>
+ </li>
+ <li>
+ <a href="LTTng.html#Histogram_View">Histogram View</a>
+ </li>
+ <li>
+ <a href="LTTng.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/TracingPerspective.png"/>
+ </p>
+ <p>The perspective can be opened from the Eclipse Open Perspective dialog (
+ <b>Window &gt; Open Perspective... &gt; Other</b>).
+ </p>
+ <p>
+ <img border="0" src="images/ShowTracingPerspective.png"/>
+ </p>
+ <p>On top to these views, the
+ <b>Tracing and Monitoring Framework (TMF)</b> feature provides a set of generic tracing specific views, such as:
+ </p>
+ <ul>
+ <li>
+ <a href="LTTng.html#Colors_View">Colors View</a>
+ </li>
+ <li>
+ <a href="LTTng.html#Filters_View">Filters View</a>
+ </li>
+ <li>
+ <a href="LTTng.html#Time_Chart_View">Time Chart View</a>
+ </li>
+ <li>
+ <a href="LTTng.html#Environment_Variables_View">Environment Variables View</a>
+ </li>
+ <li>
+ <a href="LTTng.html#Custom_Parser">Custom Parser</a>
+ </li>
+ </ul>
+ <p>To open one of the above
+ <b>Tracing</b> view, use the Eclipse Show View dialog (
+ <b>Window &gt; Show View &gt; Other...</b>. Then select the relevant view from the
+ <b>Tracing</b>.
+ </p>
+ <p>
+ <img border="0" src="images/ShowTracingViews.png"/>
+ </p>
+ <p>Additionally, the
+ <b>LTTng</b> feature provides a
+ <b>LTTng Tracer Control</b>. It comes with a dedicated
+ <b>Control View</b>.
+ </p>
+ <ul>
+ <li>
+ <a href="LTTng.html#LTTng_Tracer_Control">LTTng Tracer Control</a>
+ </li>
+ </ul>
+ <h2 id="Project_View">Project View</h2>
+ <p>The project view is the standard Eclipse Project Explorer.
+ <b>Tracing</b> projects are well integrated in the Eclipse's Common Navigator Framework. The Project Explorer shows
+ <b>Tracing</b> project with a small "T" decorator in the upper right of the project folder icon.
+ </p>
+ <h3 id="Creating_a_Tracing_Project">Creating a Tracing Project</h3>
+ <p>A new
+ <b>Tracing</b> project can be created using the New Tracing Project wizard. To create a new
+ <b>Tracing</b> select
+ <b>File &gt; New &gt; Project...</b> from the main menu bar or alternatively form the context-sensitive menu (click with right mouse button in the
+ <b>Project Explorer</b>.
+ </p>
+ <p>The first page of project wizard will open. </p>
+ <p>
+ <img border="0" src="images/NewTracingProjectPage1.png"/>
+ </p>
+ <p>In the list of project categories, expand category
+ <b>Tracing</b> and select
+ <b>Tracing Project</b> and the click on
+ <b>Next &gt;</b>. A second page of the wizard will show. Now enter the a name in the field
+ <b>Project Name</b>, select a location if required and the press on
+ <b>Finish</b>.
+ </p>
+ <p>
+ <img border="0" src="images/NewTracingProjectPage2.png"/>
+ </p>
+ <p>A new project will appear in the
+ <b>Project Explorer</b> view.
+ </p>
+ <p>
+ <img border="0" src="images/NewProjectExplorer.png"/>
+ </p>
+ <p>Tracing projects have two sub-folders:
+ <b>Traces</b> which holds the individual traces, and
+ <b>Experiments</b> which holds sets of traces that we want to correlate.
+ </p>
+ <h3 id="Importing_Traces_in_a_Project">Importing Traces in a Project</h3>
+ <p>The
+ <b>Traces</b> folder holds the set of traces available for experiments. To import a trace to the traces folder, select the Traces folder and click the right mouse button. Then select
+ <b>Import...</b> menu item in the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/ProjectImportTraceAction.png"/>
+ </p>
+ <p>A new display will show for selecting traces to import. By default, it shows the correct destination directory where the traces will be imported to. Now, specify the location of the traces by entering the path directly in the
+ <b>Source Directory</b> or by browsing the file system (click on button browse). Then select the traces to import in the list of files and folders. Optionally, select the
+ <b>Trace Type</b> from the drop-down menu, select or deselect the checkboxes for
+ <b>Overwrite existing trace without warning</b> and
+ <b>Create links into workspace</b>. When all options are configured, click on
+ <b>Finish</b>.
+ </p>
+ <p>Note, that traces of certain types (e.g. LTTng Kernel) are 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/ProjectImportTraceDialog.png"/>
+ </p>
+ <p>Upon successful importing the traces will be stored in the
+ <b>Traces</b> folder. If a trace type was selected in the import dialog, then the corresponding icon will be displayed. Linked traces will have a little arrow as decorator on the right bottom corner.
+ </p>
+ <p>Note that trace type is an extension point of the
+ <b>Tracing and Monitoring Framework (TMF)</b>. Depending on the which features are loaded, the list of trace types can vary.
+ </p>
+ <h3 id="Selecting_a_Trace_Type">Selecting a Trace Type</h3>
+ <p>If no trace type was selected a trace type as to be associated to a trace before it can be opened. To select a trace type select the relevant trace and click the right mouse button. In the context-sensitive menu, select
+ <b>Select Trace Type...</b> menu item. A sub-menu will show will all available trace type categories. From the relevant category select the required trace type. The examples, below show how to select the
+ <b>Common Trace Format</b> types
+ <b>LTTng Kernel</b> and
+ <b>Generic CTF trace</b>.
+ </p>
+ <p>
+ <img border="0" src="images/SelectLTTngKernelTraceType.png"/>
+ </p>
+ <p>
+ <img border="0" src="images/SelectGenericCTFTraceType.png"/>
+ </p>
+ <p>After selecting the trace type, the trace icon will be updated with the corresponding trace type icon.</p>
+ <p>
+ <img border="0" src="images/ExplorerWithAssociatedTraceType.png"/>
+ </p>
+ <h3 id="Creating_a_Experiment">Creating a Experiment</h3>
+ <p>An experiment consists in an arbitrary number of aggregated traces for purpose of correlation. In the degenerate case, an experiment can consist of a single trace. The experiment provides a unified, time-ordered stream of the individual trace events. </p>
+ <p>To create an experiment, select the folder
+ <b>Experiments</b> and click the right mouse button. Then select
+ <b>New...</b>.
+ </p>
+ <p>
+ <img border="0" src="images/NewExperimentAction.png"/>
+ </p>
+ <p>A new display will open for entering the experiment name. Type the name of the experiment in the text field
+ <b>Experiment Name</b> and the click on
+ <b>OK</b>.
+ </p>
+ <p>
+ <img border="0" src="images/NewExperimentDialog.png"/>
+ </p>
+ <h3 id="Selecting_Traces_for_an_Experiment">Selecting Traces for an Experiment</h3>
+ <p>After creating an experiment, traces need to be added to the experiment. To select traces for an experiment select the newly create experiment and click the right mouse button. Select
+ <b>Select Traces...</b> from the context sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/SelectTracesAction.png"/>
+ </p>
+ <p>A new dialog box will open with a list of available traces. Select the traces to add from the list and then click on
+ <b>Finish</b>.
+ </p>
+ <p>
+ <img border="0" src="images/SelectTracesDialog.png"/>
+ </p>
+ <p>Now the selected traces will be linked to the experiment and will be shown under the
+ <b>Experiments</b> folder.
+ </p>
+ <p>
+ <img border="0" src="images/ExplorerWithExperiment.png"/>
+ </p>
+ <p>Alternatively, traces can be added to an experiment using
+ <a href="LTTng.html#Drag_and_Drop">Drag and Drop</a>.
+ </p>
+ <h3 id="Removing_Traces_from_an_Experiment">Removing Traces from an Experiment</h3>
+ <p>To remove one or more traces for an experiment select the trace(s) to remove under the Experiment folder and click the right mouse button. Select
+ <b>Remove</b> from the context sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/RemoveTracesAction.png"/>
+ </p>
+ <p>After that the selected trace(s) are removed from the experiment. Note that the traces are still in the
+ <b>Traces</b> folder.
+ </p>
+ <h3 id="Renaming_a_Trace_or_Experiment">Renaming a Trace or Experiment</h3>
+ <p>Traces and Experiment can be renamed from the
+ <b>Project Explorer</b> view. To rename a trace or experiment select the relevant trace and click the right mouse button. Then select
+ <b>Rename...</b> from the context sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/RenameTraceAction.png"/>
+ </p>
+ <p>A new dialog box will show for entering a new name. Enter a new trace or experiment name respectively in the relevant text field and click on
+ <b>OK</b>. If the new name already exists the dialog box will show an error and a different name has to be entered.
+ </p>
+ <p>
+ <img border="0" src="images/RenameTraceDialog.png"/>
+ </p>
+ <p>
+ <img border="0" src="images/RenameExperimentDialog.png"/>
+ </p>
+ <p>After successful renaming the new name will show in the
+ <b>Project Explorer</b>. In case of a trace all reference links to that trace will be updated too. Note that linked traces only changes the display name, the underlying trace resource will stay the original name.
+ </p>
+ <p>Note that all supplementary files will be also handled accordingly (see also
+ <a href="LTTng.html#Deleting_Supplementary_Files">Deleting Supplementary Files</a>).
+ </p>
+ <h3 id="Copying_a_Trace_or_Experiment">Copying a Trace or Experiment</h3>
+ <p>To copy a trace or experiment select the relevant trace or experiment in the
+ <b>Project Explorer</b> view and click the right mouse button. Then select
+ <b>Copy...</b> from the context sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/CopyTraceAction.png"/>
+ </p>
+ <p>A new dialog box will show for entering a new name. Enter a new trace or experiment name respectively in the relevant text field and click on
+ <b>OK</b>. If the new name already exists the dialog box will show an error and a different name has to be entered.
+ </p>
+ <p>
+ <img border="0" src="images/CopyTraceDialog.png"/>
+ </p>
+ <p>
+ <img border="0" src="images/CopyExperimentDialog.png"/>
+ </p>
+ <p>After successful copy operation the new trace or experiment respectively will show in the
+ <b>Project Explorer</b>. In case of a linked trace, the copied trace will be a link to the original trace too.
+ </p>
+ <p>Note that the directory for all supplementary files will be copied, too. (see also
+ <a href="LTTng.html#Deleting_Supplementary_Files">Deleting Supplementary Files</a>).
+ </p>
+ <h3 id="Deleting_a_Trace_or_Experiment">Deleting a Trace or Experiment</h3>
+ <p>To delete a trace or experiment select the relevant trace or experiment in the
+ <b>Project Explorer</b> view and click the right mouse button. Then select
+ <b>Delete...</b> from the context sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/DeleteExperimentAction.png"/>
+ </p>
+ <p>A confirmation dialog box will open. To perform the deletion press
+ <b>OK</b> otherwise select
+ <b>Cancel</b>.
+ </p>
+ <p>
+ <img border="0" src="images/DeleteExperimentConfirmationDialog.png"/>
+ </p>
+ <p>After successful operation the selected trace or experiment will be removed from the project. In case of a linked trace only the link will be removed. The actual trace resource remain on the disk. </p>
+ <p>Note that the directory for all supplementary files will be deleted, too. (see also
+ <a href="LTTng.html#Deleting_Supplementary_Files">Deleting Supplementary Files</a>).
+ </p>
+ <h3 id="Deleting_Supplementary_Files">Deleting Supplementary Files</h3>
+ <p>Supplementary files are by definition trace specific files that accompany a trace. These file could be temporary files, persistent indexes or any other persistent data files created by the LTTng integration in Eclipse during parsing a trace. For the LTTng 2.0 trace viewer a persistent state history of the Linux Kernel is created and is stored under the name
+ <b>stateHistroy.ht</b>.
+ </p>
+ <p>All supplementary file are hidden from the user and are handled internally by the TMF. However, there is a possibility to delete the supplementary files so that there are recreated when opening a trace.</p>
+ <p>To delete all supplementary files from a single trace, select the relevant trace in the
+ <b>Project Explorer</b> view and click the right mouse button. Then select the
+ <b>Delete Supplementary Files...</b> menu item from the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/DeleteSupplementaryFilesAction.png"/>
+ </p>
+ <p>A new dialog box will open with a list of supplementary files. Select the file(s) to delete from the list and press
+ <b>OK</b>.
+ </p>
+ <p>
+ <img border="0" src="images/DeleteSupplementaryFilesDialog.png"/>
+ </p>
+ <p>To delete all supplementary files from all traces of a experiment, select the relevant experiment in the
+ <b>Project Explorer</b> view and click the right mouse button. In the context-sensitive menu select
+ <b>Delete Supplementary Files...</b> menu item.
+ </p>
+ <p>A new dialog box will open with a list of supplementary files. Note that the supplementary files are prefixed with the trace name to indicate the trace they belong to. Select the file(s) to delete from the list and press
+ <b>OK</b>.
+ </p>
+ <p>
+ <img border="0" src="images/DeleteExpSupplementaryFilesDialog.png"/>
+ </p>
+ <h3 id="Opening_a_Trace_or_Experiment">Opening a Trace or Experiment</h3>
+ <p>A trace or experiment can be open by double-clicking the left mouse button on the trace or experiment in the
+ <b>Project Explorer</b> view. Alternatively, select the trace or experiment in the in the
+ <b>Project Explorer</b> view and click the right mouse button. Then select
+ <b>Open</b> menu item of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/OpenTraceAction.png"/>
+ </p>
+ <p>When opening a trace or experiment all currently open view will be filled which are defined for the corresponding trace type. Additionally, an internal index will be created for fast navigation within a trace. For LTTng 2.0 kernel traces a persistent state history will also be build. This state history will be used in different views to display kernel state information.</p>
+ <h3 id="Drag_and_Drop">Drag and Drop</h3>
+ <p>Traces can be also be imported to a project by dragging from another tracing project and dropping to the project's trace folder. The trace will be copied and the trace type will be set.</p>
+ <p>Any resource can be dragged and dropped from a non-tracing project, and any file or folder can be dragged from an external tool, into a tracing project's trace folder. The resource will be copied or imported as a new trace, however the trace type will be unknown and need to be set manually by the user.</p>
+ <p>It is also possible to drop a trace, resource, file or folder into an existing experiment. If the item does not already exist as a trace in the project's trace folder, it will first be copied or imported, then the trace will be added to the experiment.</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>When opened, the Events view displays the events of the currently selected trace or experiment.</p>
+ <p>The header displays the current trace (or experiment) name. </p>
+ <p>Being part of the
+ <b>Tracing and Monitoring</b> Framework, the default table displays the following fields:
+ </p>
+ <ul>
+ <li>
+ <b>Timestamp</b>: the event timestamp
+ </li>
+ <li>
+ <b>Source</b>: the source of the event
+ </li>
+ <li>
+ <b>Type</b>: the event type and localization
+ </li>
+ <li>
+ <b>Reference</b> the event reference
+ </li>
+ <li>
+ <b>Content</b>: the raw event content
+ </li>
+ </ul>
+ <p>The first row of the table is the header row a.k.a. the Search and Filter row.</p>
+ <p>
+ <img border="0" src="images/DefaultEventsView.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>
+ <h3 id="Searching_and_Filtering">Searching and Filtering</h3>
+ <p>Searching and filtering of events in the table can be performed by entering matching conditions in one or multiple columns in the header row (the first row below the column header).</p>
+ <p>To toggle between searching and filtering, click on the 'search' (
+ <img border="0" src="images/TmfEventSearch.gif"/>) or 'filter' (
+ <img border="0" src="images/TmfEventFilter.gif"/>) icon in the header row's left margin, or right-click on the header row and select
+ <b>Show Filter Bar</b> or
+ <b>Show Search Bar</b> in the context menu.
+ </p>
+ <p>To apply a matching condition to a specific column, click on the column's header row cell, type in a
+ <a href="http://download.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">regular expression</a> and press the
+ <b>ENTER</b> key. You can also enter a simple text string and it will be automatically be replaced with a 'contains' regular expression.
+ </p>
+ <p>When matching conditions are applied to two or more columns, all conditions must be met for the event to match (i.e. 'and' behavior).</p>
+ <p>To clear all matching conditions in the header row, press the
+ <b>DEL</b> key.
+ </p>
+ <h4 id="Searching">Searching</h4>
+ <p>When a searching condition is applied to the header row, the table will select the next matching event starting from the top currently displayed event. Wrapping will occur if there is no match until the end of the trace.</p>
+ <p>All matching events will have a 'search match' icon in their left margin. Non-matching events will be dimmed.</p>
+ <p>
+ <img border="0" src="images/DefaultTmfEvents-Search.png"/>
+ </p>
+ <p>Pressing the
+ <b>ENTER</b> key will search and select the next matching event. Pressing the
+ <b>SHIFT-ENTER</b> key will search and select the previous matching event. Wrapping will occur in both directions.
+ </p>
+ <p>Press
+ <b>ESC</b> to cancel an ongoing search.
+ </p>
+ <p>Press
+ <b>DEL</b> to clear the header row and reset all events to normal.
+ </p>
+ <h4 id="Filtering">Filtering</h4>
+ <p>When a filtering condition is entered in the head row, the table will clear all events and fill itself with matching events as they are found from the beginning of the trace.</p>
+ <p>A status row will be displayed before and after the matching events, dynamically showing how many matching events were found and how many events were processed so far. Once the filtering is completed, the status row icon in the left margin will change from a 'stop' to a 'filter' icon.</p>
+ <p>
+ <img border="0" src="images/DefaultTmfEvents-Filter.png"/>
+ </p>
+ <p>Press
+ <b>ESC</b> to stop an ongoing filtering. In this case the status row icon will remain as a 'stop' icon to indicate that not all events were processed.
+ </p>
+ <p>Press
+ <b>DEL</b> or right-click on the table and select
+ <b>Clear Filters</b> from the context menu to clear the header row and remove the filtering. All trace events will be now shown in the table. Note that the currently selected event will remain selected even after the filter is removed.
+ </p>
+ <p>You can also search on the subset of filtered events by toggling the header row to the Search Bar while a filter is applied. Searching and filtering conditions are independent of each other.</p>
+ <h4 id="Bookmarking">Bookmarking</h4>
+ <p>Any event of interest can be tagged with a bookmark.</p>
+ <p>To add a bookmark, double-click the left margin next to an event, or right-click the margin and select
+ <b>Add bookmark...</b>. Alternatively use the
+ <b>Edit</b> &gt;
+ <b>Add bookmark...</b> menu. Edit the bookmark description as desired and press
+ <b>OK</b>.
+ </p>
+ <p>The bookmark will be displayed in the left margin, and hovering the mouse over the bookmark icon will display the description in a tooltip.</p>
+ <p>The bookmark will be added to the
+ <b>Bookmarks</b> view. In this view the bookmark description can be edited, and the bookmark can be deleted. Double-clicking the bookmark or selecting
+ <b>Go to</b> from its context menu will open the trace or experiment and go directly to the event that was bookmarked.
+ </p>
+ <p>To remove a bookmark, double-click its icon, select
+ <b>Remove Bookmark</b> from the left margin context menu, or select
+ <b>Delete</b> from the Bookmarks view.
+ </p>
+ <p>
+ <img border="0" src="images/Bookmarks.png"/>
+ </p>
+ <h2 id="Histogram_View">Histogram View</h2>
+ <p>The Histogram View displays the trace events distribution with respect to time. When streaming a trace, this view is dynamically updated as the events are received.</p>
+ <p>
+ <img border="0" src="images/HistogramView.png"/>
+ </p>
+ <p>On the top left, there are two data controls:</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>
+ </ul>
+ <p>Both control can be used to modify their respective value. After validation, the other controls and views will be synchronized and updated accordingly.</p>
+ <p>The large histogram, at the bottom, shows the event distribution over the whole trace or set of traces. It also has a smaller semi-transparent window, with a cross-hair, that shows the currently selected time range window. The time range window can be zoomed in/out by using the mouse wheel. It can also be selected by the mouse and dragged to another region of the trace.</p>
+ <p>The smaller histogram, on top right, corresponds to the currently selected time range window, a sub-range of the event set. Its size can also be zoomed in/out using the mouse wheel.</p>
+ <p>The x-axis of each histogram corresponds to the events timestamps. The timestamp of the first and the last event of the respective ranges is displayed. The y-axis of each histogram shows the minimum/maximum number of events in the corresponding histogram bars.</p>
+ <p>The dashed vertical magenta bar, on the right, shows the position of the last event. The dashed vertical red bar shows the relative position of the currently selected event. The current event can be changed by clicking on the histogram.</p>
+ <p>Hovering the mouse over an histogram bar pops up an information window that displays the start/end time of the corresponding bar as well as the number of events it represents.</p>
+ <p>In each histogram, the following keys are handled:</p>
+ <ul>
+ <li>
+ <b>Left</b>: Moves the current event to the previous non-empty bar
+ </li>
+ <li>
+ <b>Right</b>: Moves the current event to the next non-empty bar
+ </li>
+ <li>
+ <b>Home</b>: Displays the current event to the first histogram bar
+ </li>
+ <li>
+ <b>End</b>: Displays the current event to the last non-empty histogram bar
+ </li>
+ </ul>
+ <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. To open the Statistics View, select Windows -&gt; Show View -&gt; Other... -&gt; Tracing -&gt; Statistics. A new view will open with the name Statistics. This view shows 2 columns:
+ <i>Level</i> and
+ <i>Number of Events</i>. After parsing a trace the view will display the number of events per event type. The cells where the number of events are printed also contain a colored bar that indicates the percentage of the event count in relation to the total number of events. The statistics is collected for the whole trace. This view is part of the
+ <b>Tracing and Monitoring Framework (TMF)</b> and is generic. It will work for any trace type extensions. For the LTTng 2.0 integration the Statistics view will display statistics as shown below.:
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2StatisticsView.png"/>
+ </p>
+ <h2 id="Colors_View">Colors View</h2>
+ <p>
+ <img border="0" src="images/ColorsView.png"/>
+ </p>
+ <p>The Colors view allows the user to define a prioritized list of color settings.</p>
+ <p>A color setting associates a foreground and background color (used in any events table), and a tick color (used in the Time Chart view), with an event filter.</p>
+ <p>In an events table, any event row that matches the event filter of a color setting will be displayed with the specified foreground and background colors. If the event matches multiple filters, the color setting with the highest priority will be used.</p>
+ <p>The same principle applies to the event tick colors in the Time Chart view. If a tick represents many events, the tick color of the highest priority matching event will be used.</p>
+ <p>Color settings can be inserted, deleted, reordered, imported and exported using the buttons in the Colors view toolbar. Changes to the color settings are applied immediately, and are persisted to disk.</p>
+ <h2 id="Filters_View">Filters View</h2>
+ <p>
+ <img border="0" src="images/FiltersView.png"/>
+ </p>
+ <p>The Filters view allows the user to define preset filters that can be applied to any events table.</p>
+ <p>The filters can be more complex than what can be achieved with the filter header row in the events table. The filter is defined in a tree node structure, where the node types can be any of
+ <b>EVENTTYPE</b>,
+ <b>AND</b>,
+ <b>OR</b>,
+ <b>CONTAINS</b>,
+ <b>EQUALS</b>,
+ <b>MATCHES</b> or
+ <b>COMPARE</b>. Some nodes types have restrictions on their possible children in the tree.
+ </p>
+ <p>The
+ <b>EVENTTYPE</b> node filters against the event type of the trace as defined in a plugin extension or in a custom parsers. When used, any child node will have its field combo box restricted to the possible fields of that event type.
+ </p>
+ <p>The
+ <b>AND</b> node applies the logical
+ <i>and</i> condition on all of its children. All children conditions must be true for the filter to match. A
+ <i>not</i> operator can be applied to invert the condition.
+ </p>
+ <p>The
+ <b>OR</b> node applies the logical
+ <i>or</i> condition on all of its children. At least one children condition must be true for the filter to match. A
+ <i>not</i> operator can be applied to invert the condition.
+ </p>
+ <p>The
+ <b>CONTAINS</b> node matches when the specified event
+ <i>field</i> value contains the specified
+ <i>value</i> string. A
+ <i>not</i> operator can be applied to invert the condition. The condition can be case sensitive or insensitive.
+ </p>
+ <p>The
+ <b>EQUALS</b> node matches when the specified event
+ <i>field</i> value equals exactly the specified
+ <i>value</i> string. A
+ <i>not</i> operator can be applied to invert the condition. The condition can be case sensitive or insensitive.
+ </p>
+ <p>The
+ <b>MATCHES</b> node matches when the specified event
+ <i>field</i> value matches against the specified
+ <i>regular expression</i>. A
+ <i>not</i> operator can be applied to invert the condition.
+ </p>
+ <p>The
+ <b>COMPARE</b> node matches when the specified event
+ <i>field</i> value compared with the specified
+ <i>value</i> gives the specified
+ <i>result</i>. The result can be set to
+ <i>smaller than</i>,
+ <i>equal</i> or
+ <i>greater than</i>. The type of comparison can be numerical, alphanumerical or based on time stamp. A
+ <i>not</i> operator can be applied to invert the condition.
+ </p>
+ <p>Filters can be added, deleted, imported and exported using the buttons in the Filters view toolbar. Changes to the preset filters are only applied and persisted to disk when the
+ <b>save filters</b> button is pressed.
+ </p>
+ <p>To apply a saved preset filter in an events table, right-click on the table and select
+ <b>Apply preset filter...</b> &gt;
+ <i>filter name</i>.
+ </p>
+ <h2 id="Time_Chart_View">Time Chart View</h2>
+ <p>
+ <img border="0" src="images/TimeChartView.png"/>
+ </p>
+ <p>The Time Chart view allows the user to visualize every open trace in a common time chart. Each trace is display in its own row and ticks are display for every punctual event. As the user zooms using the mouse wheel or by right-clicking and dragging in the time scale, more detailed event data is computed from the traces.</p>
+ <p>Time synchronization is enabled between the time chart view and other trace viewers such as the events table.</p>
+ <p>Color settings defined in the Colors view can be used to change the tick color of events displayed in the Time Chart view.</p>
+ <p>When a search is applied in the events table, the ticks corresponding to matching events in the Time Chart view are decorated with a marker below the tick.</p>
+ <p>When a bookmark is applied in the events table, the ticks corresponding to the bookmarked event in the Time Chart view is decorated with a bookmark above the tick.</p>
+ <p>When a filter is applied in the events table, the non-matching ticks are removed from the Time Chart view.</p>
+ <p>The Time Chart only supports traces that are opened in an editor. The use of an editor is specified in the plugin extension for that trace type, or is enabled by default for custom traces.</p>
+ <h2 id="Environment_Variables_View">Environment Variables View</h2>
+ <p>A new feature of CTF traces is their ability to store user defined data that is not to be placed in an event. It is generally data that is per-trace specific, such as the tracer version and the trace domain. It will be populated when a trace is loaded if the trace has environment variables.
+ <br/>
+
+ <img border="0" src="images/environment_variables.png"/>
+ <br/>
+ The above picture shows a trace loaded that was collevcted with the
+ <b>lttng-modules</b> version
+ <b>2</b>.
+ <b>0</b>.
+ <b>0</b> tracer. It is a
+ <b>kernel</b> trace of the
+ <b>3.2.0-18-generic</b>
+ <b>linux</b> kernel.
+ </p>
+ <h2 id="Custom_Parser">Custom Parser</h2>
+ <p>Custom parser wizards allow the user to define their own parsers for text or XML traces. The user defines how the input should be parsed into internal trace events and identifies the event fields that should be created and displayed. Traces created using a custom parser can be correlated with other built-in traces or traces added by plug-in extension.</p>
+ <h3 id="Creating_a_custom_text_parser">Creating a custom text parser</h3>
+ <p>The
+ <b>New Custom Text Parser</b> wizard can be used to create a custom parser for text logs. It can be launched several ways:
+ </p>
+ <ul>
+ <li>Select
+ <b>File</b> &gt;
+ <b>New</b> &gt;
+ <b>Other...</b> &gt;
+ <b>Tracing</b> &gt;
+ <b>Custom Text Parser</b>
+ </li>
+ <li>Open the
+ <b>Manage Custom Parsers</b> dialog from the
+ <b>Project Explorer</b> view menu, select the
+ <b>Text</b> radio button and click the
+ <b>New...</b> button
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/CustomTextParserInput.png"/>
+ </p>
+ <p>Fill out the first wizard page with the following information:</p>
+ <ul>
+ <li>
+ <b>Log type:</b> Enter a name for the custom log entries, which is also the name of the custom parser.
+ </li>
+ <li>
+ <b>Time Stamp format:</b> Enter the date and time pattern that will be used to output the Time Stamp.
+ <br/>
+ </li>
+ </ul>
+ <p>Note: information about date and time patterns can be found here:
+ <a href="http://java.sun.com/javase/6/docs/api/java/text/SimpleDateFormat.html">http://java.sun.com/javase/6/docs/api/java/text/SimpleDateFormat.html</a>
+ </p>
+ <p>Click the
+ <b>Add next line</b>,
+ <b>Add child line</b> or
+ <b>Remove line</b> buttons to create a new line of input or delete it. For each line of input, enter the following information:
+ </p>
+ <ul>
+ <li>
+ <b>Regular expression:</b> Enter a regular expression that should match the input line in the log, using capturing groups to extract the data.
+ <br/>
+ </li>
+ </ul>
+ <p>Note: information about date and time patterns can be found here:
+ <a href="http://java.sun.com/javase/6/docs/api/java/util/regex/Pattern.html">http://java.sun.com/javase/6/docs/api/java/util/regex/Pattern.html</a>
+ </p>
+ <ul>
+ <li>
+ <b>Cardinality:</b> Enter the minimum and maximum number of lines matching this line's regular expression that must be found in the log. At least the minimum number of lines must be found before the parser will consider the next line. Child lines will always be considered first.
+ </li>
+ </ul>
+ <p><u>Important note:</u> The custom parsers identify a log entry when the first line's regular expression matches (Root Line n). Each subsequent text line in the log is attempted to be matched against the regular expression of the parser's input lines in the order that they are defined (Line n.*). Only the first matching input line will be used to process the captured data to be stored in the log entry. When a text line matches a Root Line's regular expression, a new log entry is started.</p>
+ <p>Click the
+ <b>Add group</b> or
+ <b>Remove group</b> buttons to define the data extracted from the capturing groups in the line's regular expression. For each group, enter the following information:
+ </p>
+ <ul>
+ <li>
+ <b>Name combo:</b> Select a name for the extracted data:
+ <ul>
+ <li>
+ <b>Time Stamp</b>: Select this option to identify the time stamp data. The input's data and time pattern must be entered in the format: text box.
+ </li>
+ <li>
+ <b>Message</b>: Select this option to identify the main log entry's message. This is usually a group which could have text of greater length.
+ </li>
+ <li>
+ <b>Other</b>: Select this option to identify any non-standard data. The name must be entered in the name: text box.
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <ul>
+ <li>
+ <b>Action combo:</b> Select the action to be performed on the extracted data:
+ <ul>
+ <li>
+ <b>Set</b>: Select this option to overwrite the data for the chosen name when there is a match for this group.
+ </li>
+ <li>
+ <b>Append</b>: Select this option to append to the data with the chosen name, if any, when there is a match for this group.
+ </li>
+ <li>
+ <b>Append with |</b> : Select this option to append to the data with the chosen name, if any, when there is a match for this group, using a | separator between matches.
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <p>The
+ <b>Preview input</b> text box can be used to enter any log data that will be processed against the defined custom parser. When the wizard is invoked from a selected log file resource, this input will be automatically filled with the file contents.
+ </p>
+ <p>The
+ <b>Preview:</b> text field of each capturing group and of the Time Stamp will be filled from the parsed data of the first matching log entry.
+ </p>
+ <p>In the
+ <b>Preview input</b> text box, the matching entries are highlighted with different colors:
+ </p>
+ <ul>
+ <li><code><span style="background:#FFFF00">&nbsp;Yellow&nbsp;</span></code> : indicates uncaptured text in a matching line.</li>
+ <li><code><span style="background:#00FF00">&nbsp;Green&nbsp;&nbsp;</span></code> : indicates a captured group in the matching line's regular expression for which a custom parser group is defined. This data will be stored by the custom parser.</li>
+ <li><code><span style="background:#FF00FF">&nbsp;Magenta</span></code> : indicates a captured group in the matching line's regular expression for which there is no custom parser group defined. This data will be lost.</li>
+ <li><code>&nbsp;White&nbsp;&nbsp;</code> : indicates a non-matching line.</li>
+ </ul>
+ <p>The first line of a matching entry is highlighted with darker colors.</p>
+ <p>By default only the first matching entry will be highlighted. To highlight all matching entries in the preview input data, click the
+ <b>Highlight All</b> button. This might take a few seconds to process, depending on the input size.
+ </p>
+ <p>Click the
+ <b>Next</b> button to go to the second page of the wizard.
+ </p>
+ <p>
+ <img border="0" src="images/CustomTextParserOutput.png"/>
+ </p>
+ <p>On this page, the list of default and custom data is shown, along with a preview of the custom parser log table output.</p>
+ <p>The custom data output can be modified by the following options:</p>
+ <ul>
+ <li>
+ <b>Visibility:</b> Select or unselect the checkbox to display the custom data or hide it.
+ </li>
+ </ul>
+ <ul>
+ <li>
+ <b>Column order:</b> Click
+ <b>Move before</b> or
+ <b>Move after</b> to change the display order of custom data.
+ </li>
+ </ul>
+ <p>The table at the bottom of the page shows a preview of the custom parser log table output according to the selected options, using the matching entries of the previous page's
+ <b>Preview input</b> log data.
+ </p>
+ <p>Click the
+ <b>Finish</b> button to close the wizard and save the custom parser.
+ </p>
+ <h3 id="Creating_a_custom_XML_parser">Creating a custom XML parser</h3>
+ <p>The
+ <b>New Custom XML Parser</b> wizard can be used to create a custom parser for XML logs. It can be launched several ways:
+ </p>
+ <ul>
+ <li>Select
+ <b>File</b> &gt;
+ <b>New</b> &gt;
+ <b>Other...</b> &gt;
+ <b>Tracing</b> &gt;
+ <b>Custom XML Parser</b>
+ </li>
+ <li>Open the
+ <b>Manage Custom Parsers</b> dialog from the
+ <b>Project Explorer</b> view menu, select the
+ <b>XML</b> radio button and click the
+ <b>New...</b> button
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/CustomXMLParserInput.png"/>
+ </p>
+ <p>Fill out the first wizard page with the following information:</p>
+ <ul>
+ <li>
+ <b>Log type:</b> Enter a name for the custom log entries, which is also the name of the custom parser.
+ </li>
+ <li>
+ <b>Time Stamp format:</b> Enter the date and time pattern that will be used to output the Time Stamp.
+ <br/>
+ </li>
+ </ul>
+ <p>Note: information about date and time patterns can be found here:
+ <a href="http://java.sun.com/javase/6/docs/api/java/text/SimpleDateFormat.html">http://java.sun.com/javase/6/docs/api/java/text/SimpleDateFormat.html</a>
+ </p>
+ <p>Click the
+ <b>Add document element</b> button to create a new document element and enter a name for the root-level document element of the XML file.
+ </p>
+ <p>Click the
+ <b>Add child</b> button to create a new element of input to the document element or any other element. For each element, enter the following information:
+ </p>
+ <ul>
+ <li>
+ <b>Element name:</b> Enter a name for the element that must match an element of the XML file.
+ </li>
+ <li>
+ <b>Log entry:</b> Select this checkbox to identify an element which represents a log entry. Each element with this name in the XML file will be parsed to a new log entry. At least one log entry element must be identified in the XML document. Log entry elements cannot be nested.
+ </li>
+ <li>
+ <b>Name combo:</b> Select a name for the extracted data:
+ <ul>
+ <li>
+ <b>Ignore</b>: Select this option to ignore the extracted element's data at this level. It is still possible to extract data from this element's child elements.
+ </li>
+ <li>
+ <b>Time Stamp</b>: Select this option to identify the time stamp data. The input's data and time pattern must be entered in the format: text box.
+ </li>
+ <li>
+ <b>Message</b>: Select this option to identify the main log entry's message. This is usually an input which could have text of greater length.
+ </li>
+ <li>
+ <b>Other</b>: Select this option to identify any non-standard data. The name must be entered in the name: text box. It does not have to match the element name.
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Action combo:</b> Select the action to be performed on the extracted data:
+ <ul>
+ <li>
+ <b>Set</b>: Select this option to overwrite the data for the chosen name when there is a match for this element.
+ </li>
+ <li>
+ <b>Append</b>: Select this option to append to the data with the chosen name, if any, when there is a match for this element.
+ </li>
+ <li>
+ <b>Append with |</b> : Select this option to append to the data with the chosen name, if any, when there is a match for this element, using a | separator between matches.
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <p>Note: An element's extracted data 'value' is a parsed string representation of all its attributes, children elements and their own values. To extract more specific information from an element, ignore its data value and extract the data from one or many of its attributes and children elements.</p>
+ <p>Click the
+ <b>Add attribute</b> button to create a new attribute input from the document element or any other element. For each attribute, enter the following information:
+ </p>
+ <ul>
+ <li>
+ <b>Attribute name:</b> Enter a name for the attribute that must match an attribute of this element in the XML file.
+ </li>
+ <li>
+ <b>Name combo:</b> Select a name for the extracted data:
+ <ul>
+ <li>
+ <b>Time Stamp</b>: Select this option to identify the time stamp data. The input's data and time pattern must be entered in the format: text box.
+ </li>
+ <li>
+ <b>Message</b>: Select this option to identify the main log entry's message. This is usually an input which could have text of greater length.
+ </li>
+ <li>
+ <b>Other</b>: Select this option to identify any non-standard data. The name must be entered in the name: text box. It does not have to match the element name.
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Action combo:</b> Select the action to be performed on the extracted data:
+ <ul>
+ <li>
+ <b>Set</b>: Select this option to overwrite the data for the chosen name when there is a match for this element.
+ </li>
+ <li>
+ <b>Append</b>: Select this option to append to the data with the chosen name, if any, when there is a match for this element.
+ </li>
+ <li>
+ <b>Append with |</b> : Select this option to append to the data with the chosen name, if any, when there is a match for this element, using a | separator between matches.
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <p>Note: A log entry can inherited input data from its parent elements if the data is extracted at a higher level.</p>
+ <p>Click the
+ <b>Feeling lucky</b> button to automatically and recursively create child elements and attributes for the current element, according to the XML element data found in the
+ <b>Preview input</b> text box, if any.
+ </p>
+ <p>Click the
+ <b>Remove element</b> or
+ <b>Remove attribute</b> buttons to remove the extraction of this input data. Take note that all children elements and attributes are also removed.
+ </p>
+ <p>The
+ <b>Preview input</b> text box can be used to enter any XML log data that will be processed against the defined custom parser. When the wizard is invoked from a selected log file resource, this input will be automatically filled with the file contents.
+ </p>
+ <p>The
+ <b>Preview:</b> text field of each capturing element and attribute and of the Time Stamp will be filled from the parsed data of the first matching log entry. Also, when creating a new child element or attribute, its element or attribute name will be suggested if possible from the preview input data.
+ </p>
+ <p>Click the
+ <b>Next</b> button to go to the second page of the wizard.
+ </p>
+ <p>
+ <img border="0" src="images/CustomXMLParserOutput.png"/>
+ </p>
+ <p>On this page, the list of default and custom data is shown, along with a preview of the custom parser log table output.</p>
+ <p>The custom data output can be modified by the following options:</p>
+ <ul>
+ <li>
+ <b>Visibility:</b> Select or unselect the checkbox to display the custom data or hide it.
+ </li>
+ <li>
+ <b>Column order:</b> Click
+ <b>Move before</b> or
+ <b>Move before</b> to change the display order of custom data.
+ </li>
+ </ul>
+ <p>The table at the bottom of the page shows a preview of the custom parser log table output according to the selected options, using the matching entries of the previous page's
+ <b>Preview input</b> log data.
+ </p>
+ <p>Click the
+ <b>Finish</b> button to close the wizard and save the custom parser.
+ </p>
+ <h3 id="Managing_custom_parsers">Managing custom parsers</h3>
+ <p>The
+ <b>Manage Custom Parsers</b> dialog is used to manage the list of custom parsers used by the tool. To open the dialog:
+ </p>
+ <ul>
+ <li>Select
+ <b>Manage Custom Parsers</b> from the
+ <b>Project Explorer</b> view menu.
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/ManageCustomParsers.png"/>
+ </p>
+ <p>The ordered list of currently defined custom parsers for the selected type is displayed on the left side of the dialog.</p>
+ <p>To change the type of custom parser to manage, select the
+ <b>Text</b> or
+ <b>XML</b> radio button.
+ </p>
+ <p>The following actions can be performed from this dialog:</p>
+ <ul>
+ <li>New...</li>
+ </ul>
+ <p>Click the
+ <b>New...</b> button to launch the
+ <b>New Custom Parser</b> wizard.
+ </p>
+ <ul>
+ <li>Edit...</li>
+ </ul>
+ <p>Select a custom parser from the list and click the
+ <b>Edit...</b> button to launch the
+ <b>Edit Custom Parser</b> wizard.
+ </p>
+ <ul>
+ <li>Delete</li>
+ </ul>
+ <p>Select a custom parser from the list and click the
+ <b>Delete</b> button to remove the custom parser.
+ </p>
+ <ul>
+ <li>Import...</li>
+ </ul>
+ <p>Click the
+ <b>Import...</b> button and select a file from the opened file dialog to import all its custom parsers.
+ </p>
+ <ul>
+ <li>Export...</li>
+ </ul>
+ <p>Select a custom parser from the list, click the
+ <b>Export...</b> button and enter or select a file in the opened file dialog to export the custom parser. Note that if an existing file containing custom parsers is selected, the custom parser will be appended to the file.
+ </p>
+ <h3 id="Opening_a_trace_using_a_custom_parser">Opening a trace using a custom parser</h3>
+ <p>Once a custom parser has been created, any
+ <a href="LTTng.html#Importing_Traces_in_a_Project">imported trace</a> file can be opened and parsed using it.
+ </p>
+ <p>To do so:</p>
+ <ul>
+ <li>Select a trace in the
+ <b>Project Explorer</b> view
+ </li>
+ <li>Right-click the trace and select
+ <b>Select Trace Type...</b> &gt;
+ <b>Custom Text</b> or
+ <b>Custom XML</b> &gt;
+ <i>parser name</i>
+ </li>
+ <li>Double-click the trace or right-click it and select
+ <b>Open</b>
+ </li>
+ </ul>
+ <p>The trace will be opened in an editor showing the events table, and an entry will be added for it in the Time Chart view.</p>
+ <h2 id="LTTng_Tracer_Control">LTTng Tracer Control</h2>
+ <p>The LTTng Tracer Control in Eclipse for the LTTng Tracer toolchain version v2.0 (or later) is done using SSH and requires an SSH server to be running on the remote host. For the SSH connection the SSH implementation of RSE is used. For that a new System Type was defined using the corresponding RSE extension. The functions to control the LTTng tracer (e.g. start and stop), either locally or remotely, are available from a dedicated Control View. </p>
+ <p>In the following sections the LTTng 2.0 tracer control integration in Eclipse is described. Please refer to the LTTng 2.0 tracer control command line manual for more details and descriptions about all commands and their command line parameters
+ <a href="References.html#References">References</a>.
+ </p>
+ <h3 id="Control_View">Control View</h3>
+ <p>To open the Control View, select '
+ <i>Window-&gt;Show View-&gt;Other...-&gt;LTTng-&gt;Control View</i>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTngControlView.png"/>
+ </p>
+ <h4 id="Creating_a_New_Connection_to_a_Remote_Host">Creating a New Connection to a Remote Host</h4>
+ <p>To connect to a remote host, select the
+ <b>New Connection</b> button in the Control View.
+ </p>
+ <p>
+ <img border="0" src="images/LTTngControlViewConnect.png"/>
+ </p>
+ <p>A new display will show for entering the remote host information. A drop down menu will filled with all existing host information which were used before. To enter the host information either select one of the hosts in the drop down menu or enter the host information manually. </p>
+ <p>
+ <img border="0" src="images/LTTng2NewConnection.png"/>
+ </p>
+ <p>To use an existing connection definition, select the relevant entry in the drop-down menu and then select
+ <b>Ok</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2SelectConnection.png"/>
+ </p>
+ <p>To enter the host information manually select first the button
+ <b>Edit connection information</b>. Then the text fields
+ <b>Connection Name</b> and
+ <b>Host Name</b> will enabled. Enter the relevant information and then select
+ <b>Ok</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EditConnection.png"/>
+ </p>
+ <p>A new display will show for providing the user name and password. This display only opens if no password had been saved before. Enter user name and password in the
+ <b>Enter Password</b> dialog box and select
+ <b>Ok</b>.
+ </p>
+ <p>The
+ <b>Host Name</b> holds the IP address or DNS name of the remote system.
+ The
+ <b>Connection Name</b> is the alias name to be displayed in the Control View.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnterPassword.png"/>
+ </p>
+ <p>After pressing
+ <b>Ok</b> the SSH connection will be established and after successful login the Control View implementation retrieves the LTTng Tracer Control information. This information will be displayed in the Control View in form of a tree structure.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ControlViewFilled.png"/>
+ </p>
+ <p>The top level tree node is the representation of the remote connection (host). The connection name of the connection will be displayed. Depending on the connection state different icons are displayed. If the node is
+ <b>CONNECTED</b> the icon is shown
+ <img border="0" src="images/Target_connected.gif"/>, otherwise (states
+ <b>CONNECTING</b>,
+ <b>DISCONNNECTING</b> or
+ <b>DISCONNECTED</b> the icon is
+ <img border="0" src="images/Target_disconnected.gif"/>.
+ </p>
+ <p>Under the host level two folder groups are located. The first one is the
+ <b>Provider</b> group. The second one is the
+ <b>Sessions</b> group.
+ </p>
+ <p>Under the
+ <b>Provider</b> group all trace providers are displayed. Trace providers are
+ <b>Kernel</b> and any user space application that supports UST tracing. Under each provider a corresponding list of events are displayed.
+ </p>
+ <p>Under the
+ <b>Sessions</b> group all current sessions will be shown. The level under the sessions show the configured domains. Currently the LTTng 2.0 Tracer Toolchan supports domain
+ <b>Kernel</b> and
+ <b>UST global</b>. Under each domain the configured channels will be displayed. The last level is under the channels where the configured events are displayed.
+ </p>
+ <p>Each session can be
+ <b>ACTIVE</b> or
+ <b>INACTIVE</b>. Active means that tracing has been started, inactive means that the tracing has been stopped. Depending on the state of a session a different icon is displayed. The icon for an active session is
+ <img border="0" src="images/Session_active.gif"/>. The icon for an inactive session is
+ <img border="0" src="images/Session_inactive.gif"/>.
+ </p>
+ <p>Each channel can be
+ <b>ENABLED</b> or
+ <b>DISABLED</b>. An enabled channel means that all configured events of that channel will be traced and a disabled channel won't trace any of its configured events. Different icons are displayed depending on the state of the channel. The icon for an enabled channel is
+ <img border="0" src="images/Channel.gif"/> and the icon for a disabled channel is
+ <img border="0" src="images/Channel_disabled.gif"/>.
+ </p>
+ <p>Events within a channel can be in state
+ <b>ENABLED</b> or
+ <b>DISABLED</b>. Enabled events are stored in the trace when passed during program execution. Disabled events on the other hand won't be traced. Depending on the state of the event the icons for the event is different. An enabled event has the icon
+ <img border="0" src="images/Event_enabled.gif"/> and a disabled event the icon
+ <img border="0" src="images/Event_disabled.gif"/>.
+ </p>
+ <h4 id="Disconnecting_from_a_Remote_Host">Disconnecting from a Remote Host</h4>
+ <p>To disconnect from a remote host, select the host in the Control View and press the
+ <b>Disconnect</b> button. Alternatively, press the right mouse button. A context-sensitive menu will show. Select the
+ <b>Disconnect</b> button.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ControlViewDisconnect.png"/>
+ </p>
+ <h4 id="Connecting_to_a_Remote_Host">Connecting to a Remote Host</h4>
+ <p>To connect to a remote host, select the host in the Control View and press the
+ <b>Connect</b> button. Alternatively, press the right mouse button. A context-sensitive menu will show. Select the
+ <b>Connect</b> button. This will start the connection process as discribed in
+ <a href="LTTng.html#Creating_a_New_Connection_to_a_Remote_Host">Creating a New Connection to a Remote Host</a>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ControlViewConnect.png"/>
+ </p>
+ <h4 id="Deleting_to_a_Remote_Host_Connection">Deleting to a Remote Host Connection</h4>
+ <p>To delete a remote host connection, select the host in the Control View and press the
+ <b>Delete</b> button. Alternatively, press the right mouse button. A context-sensitive menu will show. Select the
+ <b>Delete</b> button. For that command to be active the connection state has to be
+ <b>DISCONNECTED</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ControlViewDelete.png"/>
+ </p>
+ <h4 id="Creating_a_Tracing_Session">Creating a Tracing Session</h4>
+ <p>To create a tracing session, select the tree node
+ <b>Sessions</b> and press the right mouse button. Then select the
+ <b>Create Session...</b> button of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2CreateSessionAction.png"/>
+ </p>
+ <p>A dialog box will open for entering information about the session to be created. </p>
+ <p>
+ <img border="0" src="images/LTTng2CreateSessionDialog.png"/>
+ </p>
+ <p>Fill in the
+ <b>Session Name</b> and optionally the
+ <b>Session Path</b> and press
+ <b>Ok</b>. Upon successful operation a new session will be created and added under the tree node
+ <b>Sessions</b>.
+ </p>
+ <h4 id="Enabling_Channels_-_General">Enabling Channels - General</h4>
+ <p>Enabling channels can be done using a session tree node when the domain hasn't be created in the session or, alternatively on a domain tree node of a session in case the domain is already available. </p>
+ <h4 id="Enabling_Channels_On_Session_Level">Enabling Channels On Session Level</h4>
+ <p>To enable a channel, select the tree node of the relevant session and press the right mouse button. Then select the
+ <b>Enable Channel...</b> button of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2CreateChannelAction.png"/>
+ </p>
+ <p>A dialog box will open for entering information about the channel to be created.</p>
+ <p>
+ <img border="0" src="images/LTTng2CreateChannelDialog.png"/>
+ </p>
+ <p>By default the domain
+ <b>Kernel</b> is selected and the corresponding default values are shown. To create a UST channel, select
+ <b>UST</b> under the domain section. To get the default values of UST, then press button
+ <b>Default</b>.
+ </p>
+ <p>If required update the following channel information and then press
+ <b>Ok</b>.
+ </p>
+ <ul>
+ <li>
+ <b>Channel Name</b>: The name of the channel.
+ </li>
+ <li>
+ <b>Number of Sub Buffers</b>: The number of sub-buffers of the channel.
+ </li>
+ <li>
+ <b>Overwrite Mode</b>: The channel overwrite mode (
+ <b>true</b> or
+ <b>false</b>)
+ </li>
+ <li>
+ <b>Read Timer Interval</b>: The read timer interval.
+ </li>
+ <li>
+ <b>Sub Buffer size</b>: The size of the sub-buffers of the channel (in bytes).
+ </li>
+ <li>
+ <b>Switch Timer Interval</b>: The switch timer interval.
+ </li>
+ </ul>
+ <p>Upon successful operation, the requested domain will be created under the session tree node as well as the requested channel will be added under the domain. The channel will be
+ <b>ENABLED</b>.
+ </p>
+ <h4 id="Enabling_Channels_On_Domain_Level">Enabling Channels On Domain Level</h4>
+ <p>Once a domain is available, channels can be enabled directly using the domain. To enable a channel under an existing domain, select the tree node of the relevant domain and press the right mouse button. Then select the
+ <b>Enable Channel...</b> button of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2CreateChannelOnDomainAction.png"/>
+ </p>
+ <p>The dialog box for enabling channel will open for entering information about the channel to be created. Note that the domain is pre-selected and cannot be changed.</p>
+ <p>
+ <img border="0" src="images/LTTng2CreateChannelOnDomainDialog.png"/>
+ </p>
+ <p>Fill the relevant information and press
+ <b>Ok</b>.
+ </p>
+ <h4 id="Enabling_and_Disabling_Channels">Enabling and Disabling Channels</h4>
+ <p>To disable one or more enabled channels, select the tree nodes of the relevant channels and press the right mouse button. Then select the
+ <b>Disable Channel</b> menu item of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2DisableChannelAction.png"/>
+ </p>
+ <p>Upon successful operation, the selected channels will be
+ <b>DISABLED</b> and the icons for the channels will be updated.
+ </p>
+ <p>To enable one or more disabled channels, select the tree nodes of the relevant channels and press the right mouse button. Then select the
+ <b>Enable Channel</b> menu item of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnableChannelAction.png"/>
+ </p>
+ <p>Upon successful operation, the selected channels will be
+ <b>ENABLED</b> and the icons for the channels will be updated.
+ </p>
+ <h4 id="Enabling_Events_-_General">Enabling Events - General</h4>
+ <p>Enabling events can be done using different levels in the tree node. It can be done on the session, domain level and channel level. For the case of session or domain, i.e. when no specific channels is assigned then enabling of events is done on the default channel with the name
+ <b>channel0</b> which created, if not already exists, by the LTTng tracer control on the server side.
+ </p>
+ <h4 id="Enabling_Kernel_Events_On_Session_Level">Enabling Kernel Events On Session Level</h4>
+ <p>To enable events, select the tree node of the relevant session and press the right mouse button. Then select the
+ <b>Enable Event (default channel)...</b> button of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EventOnSessionAction.png"/>
+ </p>
+ <p>A dialog box will open for entering information about events to be enabled.</p>
+ <p>
+ <img border="0" src="images/LTTng2EventOnSessionDialog.png"/>
+ </p>
+ <p>By default the domain
+ <b>Kernel</b> is selected and the kernel specific data sections are created. From this dialog box kernel
+ <b>Tracepoint</b> events,
+ <b>System calls (Syscall)</b>, a
+ <b>Dynamic Probe</b> or a
+ <b>Dynamic Function entry/return</b> probe can be enabled. Note that events of one of these types at a time can be enabled.
+ </p>
+ <p>To enable
+ <b>Tracepoint</b> events, first select the corresponding
+ <b>Select</b> button, then select either all tracepoins (select
+ <b>All</b>) or select selectively one or more tracepoints in the displayed tree of tracepoints and finally press
+ <b>Ok</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2TracepointEventsDialog.png"/>
+ </p>
+ <p>Upon successful operation, the domain
+ <b>Kernel</b> will be created in the tree (if neccessary), the default channel with name "channel0" will be added under the domain (if necessary) as well as all requested events of type
+ <b>TRACEPOINT</b> under the channel. The channel and events will be
+ <b>ENABLED</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnabledKernelTracepoints.png"/>
+ </p>
+ <p>To enable all
+ <b>Syscalls</b>, select the corresponding
+ <b>Select</b> button and press
+ <b>Ok</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2SyscallsDialog.png"/>
+ </p>
+ <p>Upon successful operation, the event with the name
+ <b>syscalls</b> and event type
+ <b>SYSCALL</b> will be added under the default channel (channel0). If necessary the domain
+ <b>Kernel</b> and the channel
+ <b>channel0</b> will be created.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnabledKernelSyscalls.png"/>
+ </p>
+ <p>To enable a
+ <b>Dynamic Probe</b> event, select the corresponding
+ <b>Select</b> button, fill the
+ <b>Event Name</b> and
+ <b>Probe</b> fields and press
+ <b>Ok</b>. Note that the probe can be an address, symbol or a symbol+offset where the address and offset can be octal (0NNN...), decimal (NNN...) or hexadecimal (0xNNN...).
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ProbeEventDialog.png"/>
+ </p>
+ <p>Upon successful operation, the dynamic probe event with the given name and event type
+ <b>PROBE</b> will be added under the default channel (channel0). If necessary the domain
+ <b>Kernel</b> and the channel
+ <b>channel0</b> will be created.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnabledKernelProbeEvent.png"/>
+ </p>
+ <p>To enable a
+ <b>Dynamic Function entry/return Probe</b> event, select the corresponding
+ <b>Select</b> button, fill the
+ <b>Event Name</b> and
+ <b>Function</b> fields and press
+ <b>Ok</b>. Note that the funtion probe can be an address, symbol or a symbol+offset where the address and offset can be octal (0NNN...), decimal (NNN...) or hexadecimal (0xNNN...).
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2FunctionEventDialog.png"/>
+ </p>
+ <p>Upon successful operation, the dynamic function probe event with the given name and event type
+ <b>PROBE</b> will be added under the default channel (channel0). If necessary the domain
+ <b>Kernel</b> and the channel
+ <b>channel0</b> will be created.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnabledFunctionProbeEvent.png"/>
+ </p>
+ <h4 id="Enabling_UST_Events_On_Session_Level">Enabling UST Events On Session Level</h4>
+ <p>For enabling UST events, first open the enable events dialog as described in section
+ <a href="LTTng.html#Enabling_Kernel_Events_On_Session_Level">Enabling Kernel Events On Session Level</a> and select domain
+ <b>UST</b>.
+ </p>
+ <p>To enable
+ <b>Tracepoint</b> events, first select the corresponding
+ <b>Select</b> button, then select either all tracepoins (select
+ <b>All</b>) or select selectively one or more tracepoints in the displayed tree of tracepoints and finally press
+ <b>Ok</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2UstTracepointEventsDialog.png"/>
+ </p>
+ <p>Upon successful operation, the domain
+ <b>UST global</b> will be created in the tree (if neccessary), the default channel with name "channel0" will be added under the domain (if necessary) as well as all requested events under the channel. The channel and events will be
+ <b>ENABLED</b>. Note that for the case that
+ <b>All</b> tracepoints were selected the wildcard
+ <b>*</b> is used which will be shown in the Control View as below.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnabledAllUstTracepoints.png"/>
+ </p>
+ <p>For UST it is possible to enable
+ <b>Tracepoint</b> events using a wildcard. To enable
+ <b>Tracepoint</b> events with a wildcard, select first the corresponding
+ <b>Select</b> button, fill the
+ <b>Wildcard</b> field and press
+ <b>Ok</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2UstWildcardEventsDialog.png"/>
+ </p>
+ <p>Upon successful operation, the event with the given wildcard and event type
+ <b>TRACEPOINT</b> will be added under the default channel (channel0). If necessary the domain
+ <b>UST global</b> and the channel
+ <b>channel0</b> will be created.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnabledUstWildcardEvents.png"/>
+ </p>
+ <p>For UST it is possible to enable
+ <b>Tracepoint</b> events using log levels. To enable
+ <b>Tracepoint</b> events using log levels, select first the corresponding
+ <b>Select</b> button, select a log level from the drop down menu, fill in the relevant information (see below) and press
+ <b>Ok</b>.
+ </p>
+ <ul>
+ <li>
+ <b>Event Name</b>: Name to display
+ </li>
+ <li>
+ <b>loglevel</b>: To specify if a range of log levels (0 to selected log level) shall be configured
+ </li>
+ <li>
+ <b>loglevel-only</b>: To specify that only the specified log level shall be configured
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/LTTng2UstLoglevelEventsDialog.png"/>
+ </p>
+ <p>Upon successful operation, the event with the given event name and event type
+ <b>TRACEPOINT</b> will be added under the default channel (channel0). If necessary the domain
+ <b>UST global</b> and the channel
+ <b>channel0</b> will be created.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnabledUstLoglevelEvents.png"/>
+ </p>
+ <h4 id="Enabling_Events_On_Domain_Level">Enabling Events On Domain Level</h4>
+ <p>Kernel events can also be enabled on the domain level. For that select the relevant domain tree node, click the right mouse button and the select
+ <b>Enable Event (default channel)...</b>. A new dialog box will open for providing information about the events to be enabled. Depending on the domain,
+ <b>Kernel</b> or
+ <b>UST global</b>, the domain specifc fields are shown and the domain selector is preselected and read-only.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EventOnDomainAction.png"/>
+ </p>
+ <p>To enable events for domain
+ <b>Kernel</b> follow the instructions in section
+ <a href="LTTng.html#Enabling_Kernel_Events_On_Session_Level">Enabling Kernel Events On Session Level</a>, for domain
+ <b>UST global</b>
+ <a href="LTTng.html#Enabling_UST_Events_On_Session_Level">Enabling UST Events On Session Level</a>.
+ </p>
+ <p>When enabling events on the domain level, the events will be add to the default channel
+ <b>channel0</b>. This channel will be created by on the server side if neccessary.
+ </p>
+ <h4 id="Enabling_Events_On_Channel_Level">Enabling Events On Channel Level</h4>
+ <p>Kernel events can also be enabled on the channel level. If necessary, create a channel as described in sections
+ <a href="LTTng.html#Enabling_Channels_On_Session_Level">Creating Channels On Session Level</a> or
+ <a href="LTTng.html#Enabling_Channels_On_Domain_Level">Creating Channels On Domain Level</a>.
+ </p>
+ <p>Then select the relevant channel tree node, click the right mouse button and the select
+ <b>Enable Event...</b>. A new dialog box will open for providing information about the events to be enabled. Depending on the domain,
+ <b>Kernel</b> or
+ <b>UST global</b>, the domain specifc fields are shown and the domain selector is preselected and read-only.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EventOnChannelAction.png"/>
+ </p>
+ <p>To enable events for domain
+ <b>Kernel</b> follow the instructions in section
+ <a href="LTTng.html#Enabling_Kernel_Events_On_Session_Level">Enabling Kernel Events On Session Level</a>, for domain
+ <b>UST global</b>
+ <a href="LTTng.html#Enabling_UST_Events_On_Session_Level">Enabling UST Events On Session Level</a>.
+ </p>
+ <p>When enabling events on the channel level, the events will be add to the selected channel.</p>
+ <h4 id="Enabling_and_Disabling_Events">Enabling and Disabling Events</h4>
+ <p>To disable one or more enabled events, select the tree nodes of the relevant events and click the right mouse button. Then select
+ <b>Disable Event</b> menu item in the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2DisableEventAction.png"/>
+ </p>
+ <p>Upon successful operation, the selected events will be
+ <b>DISABLED</b> and the icons for these events will be updated.
+ </p>
+ <p>To enable one or more disabled events, select the tree nodes of the relevant events and press the right mouse button. Then select the
+ <b>Enable Event</b> menu item of the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2EnableEventAction.png"/>
+ </p>
+ <p>Upon successful operation, the selected events will be
+ <b>ENABLED</b> and the icons for these events will be updated.
+ </p>
+ <p>
+ <b>Note</b>: There is currently a limitation for kernel event of type
+ <b>SYSCALL</b>. This kernel event can not be disabled. An error will appear when trying to disable this type of event. A work-around for that is to have the syscall event in a separate channel and disable the channel instead of the event.
+ </p>
+ <h4 id="Enabling_Tracepoint_Events_From_Provider">Enabling Tracepoint Events From Provider</h4>
+ <p>It is possible to enable events of type
+ <b>Tracepoint</b> directly from the providers and assign the enabled event to a session and channel. Before doing that a session has to be created as described in section
+ <a href="LTTng.html#Creating_a_Tracing_Session">Creating a Tracing Session</a>. Also, if other than default channel
+ <b>channel0</b> is required, create a channel as described in sections
+ <a href="LTTng.html#Enabling_Channels_On_Session_Level">Creating Channels On Session Level</a> or
+ <a href="LTTng.html#Enabling_Channels_On_Domain_Level">Creating Channels On Domain Level</a>.
+ </p>
+ <p>To assign tracepoint events to a session and channel, select the events to be enabled under the provider (e.g. provider
+ <b>Kernel</b>), click right mouse button and then select
+ <b>Enable Event...</b> menu item from the context sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2AssignEventAction.png"/>
+ </p>
+ <p>A new display will open for defining the session and channel. </p>
+ <p>
+ <img border="0" src="images/LTTng2AssignEventDialog.png"/>
+ </p>
+ <p>Select a session from the
+ <b>Session List</b> drop-down menu, a channel from the
+ <b>Channel List</b> drop-down menu and the press
+ <b>Ok</b>. Upon successful operation, the selected events will be added to the selected session and channel of the domain that the selected provider belongs to. In case that there was no channel available, the domain and the default channel
+ <b>channel0</b> will be created for corresponding session. The newly added events will be
+ <b>ENABLED</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2AssignedEvents.png"/>
+ </p>
+ <h4 id="Adding_Contexts_to_Channels_and_Events_of_a_Domain">Adding Contexts to Channels and Events of a Domain</h4>
+ <p>It is possible to add contexts to channels and events. Adding contexts on channels and events from the domain level, will enable the specified contexts to all channels of the domain and all their events. To add contexts on the domain level, select a domain, click right mouse button on a domain tree node (e.g. provider
+ <b>Kernel</b>) and select the menu item
+ <b>Add Context...</b> from the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2AddContextOnDomainAction.png"/>
+ </p>
+ <p>A new display will open for selecting one or more contexts to add.</p>
+ <p>
+ <img border="0" src="images/LTTng2AddContextDialog.png"/>
+ </p>
+ <p>The tree shows all available context that can be added. Select one or more context and the press
+ <b>Ok</b>. Upon successful operation, the selected context will be added to all channels and their events of the selected domain.
+ </p>
+ <p>
+ <b>Note</b>: The LTTng UST tracer only supports contexts
+ <b>procname</b>,
+ <b>pthread_id</b>,
+ <b>vpid</b>
+ <b>vtid</b>. Adding any other contexts in the UST domina will fail.
+ </p>
+ <h4 id="Adding_Contexts_to_All_Events_of_a_Channel">Adding Contexts to All Events of a Channel</h4>
+ <p>Adding contexts on channels and events from the channel level, will enable the specified contexts to all events of the selected channel. To add contexts on the channel level, select a channel, click right mouse button on a channel tree node and select the menu item
+ <b>Add Context...</b> from the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2AddContextOnChannelAction.png"/>
+ </p>
+ <p>A new display will open for selecting one or more contexts to add. Select one or more contexts as described in chapter
+ <a href="LTTng.html#Adding_Contexts_to_Channels_and_Events_of_a_Domain">Adding Contexts to Channels and Events of a Domain</a>. Upon successful operation, the selected context will be added to all channels and their events of the selected domain.
+ <b>Note</b> that the LTTng 2.0 tracer control on the remote host doesn't provide a way to retrieve added contexts. Hence it's not possible to display the context information in the GUI.
+ </p>
+ <h4 id="Adding_Contexts_to_a_Event_of_a_Specific_Channel">Adding Contexts to a Event of a Specific Channel</h4>
+ <p>Adding contexts to a event of a channel, select an event of a channel, click right mouse button on the corresponding event tree node and select the menu item
+ <b>Add Context...</b> from the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2AddContextToEventsAction.png"/>
+ </p>
+ <p>A new display will open for selecting one or more contexts to add. Select one or more contexts as described in chapter
+ <a href="LTTng.html#Adding_Contexts_to_Channels_and_Events_of_a_Domain">Adding Contexts to Channels and Events of a Domain</a>. Upon successful operation, the selected context will be added to the selected event.
+ </p>
+ <h4 id="Start_Tracing">Start Tracing</h4>
+ <p>To start tracing, select one or more sessions to start in the Control View and press the
+ <b>Start</b> button. Alternatively, press the right mouse button on the session tree nodes. A context-sensitive menu will show. Then select the
+ <b>Start</b> menu item.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2StartTracingAction.png"/>
+ </p>
+ <p>Upon successful operation, the tracing session will be
+ <b>ACTIVE</b> and the icon of the session will be updated.
+ </p>
+ <h4 id="Stop_Tracing">Stop Tracing</h4>
+ <p>To stop tracing, select one or more sessions to stop in the Control View and press the
+ <b>Stop</b> button. Alternatively, click the right mouse button on the session tree nodes. A context-sensitive menu will show. Then select the
+ <b>Stop</b> menu item.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2StopTracingAction.png"/>
+ </p>
+ <p>Upon successful operation, the tracing session will be
+ <b>INACTIVE</b> and the icon of the session will be updated.
+ </p>
+ <h4 id="Destroying_a_Tracing_Session">Destroying a Tracing Session</h4>
+ <p>To destroy a tracing session, select one or more sessions to destroy in the Control View and press the
+ <b>Destroy</b> button. Alternatively, click the right mouse button on the session tree node. A context-sensitive menu will show. Then select the
+ <b>Destroy...</b> menu item. Note that the session has to be
+ <b>INACTIVE</b> for this operation.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2DestroySessionAction.png"/>
+ </p>
+ <p>A confirmation dialog box will open. Click on
+ <b>Ok</b> to destroy the session otherwise click on
+ <b>Cancel</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2DestroyConfirmationDialog.png"/>
+ </p>
+ <p>Upon successful operation, the tracing session will be destroyed and removed from the tree.</p>
+ <h4 id="Refreshing_the_Node_Information">Refreshing the Node Information</h4>
+ <p>To refresh the remote host information, select any node in the tree of the Control View and press the
+ <b>Refresh</b> button. Alternatively, click the right mouse button on any tree node. A context-sensitive menu will show. Then select the
+ <b>Refresh</b> menu item.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2RefreshAction.png"/>
+ </p>
+ <p>Upon successful operation, the tree in the Control View will be refreshed with the remote host configuration.</p>
+ <h4 id="Quantifing_LTTng_overhead_.28Calibrate.29">Quantifing LTTng overhead (Calibrate)</h4>
+ <p>The LTTng calibrate command can be used to find out the combined average overhead of the LTTng tracer and the instrumentation mechanisms used. For now, the only calibration implemented is that of the kernel function
+ instrumentation (kretprobes). To run the calibrate command, select the a domain (e.g.
+ <b>Kernel</b>), click the right mouse button on the domain tree node. A context-sensitive menu will show. Select the
+ <b>Calibrate</b> menu item.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2CalibrateAction.png"/>
+ </p>
+ <p>Upon successful operation, the calibrate command is executed and relevant information is stored in the trace. Note: that the trace has to be active so that to command as any effect.</p>
+ <h4 id="Importing_Session_Traces_to_a_Tracing_Project">Importing Session Traces to a Tracing Project</h4>
+ <p>To import traces from a tracing session, select the relevant session and click on the
+ <b>Import</b> Button. Alternatively, click the right mouse button on the session tree node and select the menu item
+ <b>Import...</b> from the context-sensitive menu.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ImportAction.png"/>
+ </p>
+ <p>A new display will open for selecting the traces to import.</p>
+ <p>
+ <img border="0" src="images/LTTng2ImportDialog.png"/>
+ </p>
+ <p>Select the trace to be imported by selecting the relevant traces in the tree viewer, select a tracing project from the
+ <b>Available Projects</b> combo box and select the Overwrite button (
+ <b>Overwrite existing trace without warning</b>) if required. Then press button
+ <b>Ok</b>. Upon successful import operation the the selected traces will be stored in the
+ <b>Traces</b> directory of the specified tracing project. From the
+ <b>Project Explorer</b> view, the trace can be analyzed further.
+ </p>
+ <p>
+ <b>Note</b>: If the overwrite button (
+ <b>Overwrite existing trace without warning</b>) was not selected and a trace with the same name of a trace to be imported already exists in the project, then a new confirmation dialog box will open.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ImportOverwriteConfirmationDialog.png"/>
+ </p>
+ <p>To Overwrite select the
+ <b>Overwrite</b> Button and press
+ <b>Ok</b>.
+ </p>
+ <p>If the existing trace should not be overwritten select, then select the
+ <b>Rename</b> option of the confirmation dialog box above, enter a new name and then press
+ <b>Ok</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2ImportRenameDialog.png"/>
+ </p>
+ <h3 id="Properties_View">Properties View</h3>
+ <p>The Control View provides property information of selected tree component. Depending on the selected tree component different properties are displayed in the property view. For example, when selecting the node level the property view will be filled as followed:</p>
+ <p>
+ <img border="0" src="images/LTTng2PropertyView.png"/>
+ </p>
+ <p>
+ <b>List of properties</b>:
+ </p>
+ <ul>
+ <li>
+ <b>Host</b> Properties
+ <ul>
+ <li>
+ <b>Connection Name</b>: The alias name to be displayed in the Control View.
+ </li>
+ <li>
+ <b>Host Name</b>: The IP address or DNS name of the remote system.
+ </li>
+ <li>
+ <b>State</b>: The state of the connection (
+ <b>CONNECTED</b>,
+ <b>CONNECTING</b>,
+ <b>DISCONNNECTING</b> or
+ <b>DISCONNECTED</b>).
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Kernel Provider</b> Properties
+ <ul>
+ <li>
+ <b>Provider Name</b>: The name of the provider.
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>UST Provider</b> Properties
+ <ul>
+ <li>
+ <b>Provider Name</b>: The name of the provider.
+ </li>
+ <li>
+ <b>Process ID</b>: The process ID of the provider.
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Event</b> Properties (Provider)
+ <ul>
+ <li>
+ <b>Event Name</b>: The name of the event.
+ </li>
+ <li>
+ <b>Event Type</b>: The event type (
+ <b>TRACEPOINT</b> only).
+ </li>
+ <li>
+ <b>Log Level</b>: The log level of the event.
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Session</b> Properties
+ <ul>
+ <li>
+ <b>Session Name</b>: The name of the Session.
+ </li>
+ <li>
+ <b>Session Path</b>: The path on the remote host where the traces will be stored.
+ </li>
+ <li>
+ <b>State</b>: The state of the session (
+ <b>ACTIVE</b> or
+ <b>INACTIVE</b>)
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Domain</b> Properties
+ <ul>
+ <li>
+ <b>Domain Name</b>: The name of the domain.
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Channel</b> Properties
+ <ul>
+ <li>
+ <b>Channel Name</b>: The name of the channel.
+ </li>
+ <li>
+ <b>Number of Sub Buffers</b>: The number of sub-buffers of the channel.
+ </li>
+ <li>
+ <b>Output type</b>: The output type for the trace (e.g.
+ <i>splice()</i> or
+ <i>mmap()</i>)
+ </li>
+ <li>
+ <b>Overwrite Mode</b>: The channel overwrite mode (
+ <b>true</b> for overwrite mode,
+ <b>false</b> for discard)
+ </li>
+ <li>
+ <b>Read Timer Interval</b>: The read timer interval.
+ </li>
+ <li>
+ <b>State</b>: The channel state (
+ <b>ENABLED</b> or
+ <b>DISABLED</b>)
+ </li>
+ <li>
+ <b>Sub Buffer size</b>: The size of the sub-buffers of the channel (in bytes).
+ </li>
+ <li>
+ <b>Switch Timer Interval</b>: The switch timer interval.
+ </li>
+ </ul>
+ </li>
+ <li>
+ <b>Event</b> Properties (Channel)
+ <ul>
+ <li>
+ <b>Event Name</b>: The name of the event.
+ </li>
+ <li>
+ <b>Event Type</b>: The event type (
+ <b>TRACEPOINT</b>,
+ <b>SYSCALL</b> or
+ <b>PROBE</b>)..
+ </li>
+ <li>
+ <b>Log Level</b>: The log level of the event.
+ </li>
+ <li>
+ <b>State</b>: The Event state (
+ <b>ENABLED</b> or
+ <b>DISABLED</b>)
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <h3 id="LTTng_Tracer_Control_Preferences">LTTng Tracer Control Preferences</h3>
+ <p>Serveral LTTng 2.0 tracer control preferences exists which can be configured. To configure these preferences, select
+ <b>Window-&gt;Preferences</b> from the top level menu. The preference display will open. Then select
+ <b>Tracing-&gt;LTTng Tracer Control Preferences</b>. This preferences page allows the user to specify the tracing group of the user and allows the user to configure the logging of LTTng 2.0 tracer control commands and results to a file.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2Preferences.png"/>
+ </p>
+ <p>To change the tracing group of the user which will be specified on each command line, enter the new group name in the
+ <b>Tracing Group</b> text field and click ok. The default tracing group is
+ <b>tracing</b> and can be restored by pressing the
+ <b>Restore Defaults</b> button.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2PreferencesGroup.png"/>
+ </p>
+ <p>To configure logging of trace control commands and the corresponding command result to a file, selected the button
+ <b>Logging</b>. To append to an existing log file, select the
+ <b>Append</b> button. Deselect the
+ <b>Append</b> button to overwrite any existing log file. It's possible to specify a verbose level. There are 3 levels with inceasing verbosity from
+ <b>Level 1</b> to
+ <b>Level 3</b>. To change the verbosity level, select the relevant level or select
+ <b>None</b>. If
+ <b>None</b> is selected only commands and command results are logged. Then press on button
+ <b>Ok</b>. The log file will be stored in the users home directory with the name
+ <i>lttng_tracer_control.log</i>. The name and location cannot be changed. To reset to default preferences, click on the button
+ <b>Restore Defaults</b>.
+ </p>
+ <p>
+ <img border="0" src="images/LTTng2PreferencesLogging.png"/>
+ </p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Installation.html" title="Installation">
+ <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="LTTng-Kernel-Analysis.html" title="LTTng Kernel Analysis">
+ <img alt="Next" border="0" src="images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Installation</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">LTTng Kernel Analysis</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/Limitations.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/Limitations.html
new file mode 100644
index 0000000..07515ee
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/Limitations.html
@@ -0,0 +1,59 @@
+<?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="LTTng-Kernel-Analysis.html" title="LTTng Kernel Analysis">
+ <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="How-to-use-LTTng-to-diagnose-problems.html" title="How to use LTTng to diagnose problems">
+ <img alt="Next" border="0" src="images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">LTTng Kernel Analysis</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">How to use LTTng to diagnose problems</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Limitations">Limitations</h1>
+ <p>TBD</p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="LTTng-Kernel-Analysis.html" title="LTTng Kernel Analysis">
+ <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="How-to-use-LTTng-to-diagnose-problems.html" title="How to use LTTng to diagnose problems">
+ <img alt="Next" border="0" src="images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">LTTng Kernel Analysis</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">How to use LTTng to diagnose problems</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/References.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/References.html
index 816aced..b65195e 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/References.html
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/References.html
@@ -2,8 +2,8 @@
<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 (legacy) - References</title>
- <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ <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">
@@ -12,19 +12,19 @@
</tr>
<tr>
<td style="width: 20%" align="left">
- <a href="Limitations.html" title="Limitations">
- <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ <a href="How-to-use-LTTng-to-diagnose-problems.html" title="How to use LTTng to diagnose problems">
+ <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"/>
+ <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: 20%" align="left" valign="top">How to use LTTng to diagnose problems</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
@@ -38,7 +38,7 @@
<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 (Legacy)</a>
+ <a href="http://lttng.org/files/doc/man-pages/man1/lttng.1.html">LTTng 2.0 Tracer Control Command Line Tool</a>
</li>
<li>
<a href="http://wiki.eclipse.org/Linux_Tools_Project/TMF/User_Guide">TMF User Guide</a>
@@ -47,23 +47,23 @@
<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 href="How-to-use-LTTng-to-diagnose-problems.html" title="How to use LTTng to diagnose problems">
+ <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 (legacy)">
- <img alt="LTTng Plug-in User Guide (legacy)" border="0" src="../../../images/home.gif"/>
+ <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"/>
+ <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: 20%" align="left" valign="top">How to use LTTng to diagnose problems</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Updating-This-Document.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/Updating-This-Document.html
index 7b88a70..b0f0fc2 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/Updating-This-Document.html
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/Updating-This-Document.html
@@ -2,8 +2,8 @@
<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 (legacy) - Updating This Document</title>
- <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ <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">
@@ -13,7 +13,7 @@
<tr>
<td style="width: 20%" align="left">
<a href="References.html" title="References">
- <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ <img alt="Previous" border="0" src="images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center"></td>
@@ -27,19 +27,18 @@
</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> .
+ <a href="http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng2/User_Guide">http://wiki.eclipse.org/Linux_Tools_Project/LTTng2/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"/>
+ <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 (legacy)">
- <img alt="LTTng Plug-in User Guide (legacy)" border="0" src="../../../images/home.gif"/>
+ <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>
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide-toc.xml b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide-toc.xml
new file mode 100644
index 0000000..f279514
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide-toc.xml
@@ -0,0 +1,107 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<toc topic="doc/User-Guide.html" label="LTTng Plug-in User Guide">
+ <topic href="doc/User-Guide.html" label="Overview">
+ <topic href="doc/User-Guide.html#About_Tracing" label="About Tracing"></topic>
+ <topic href="doc/User-Guide.html#LTTng_integration" label="LTTng integration"></topic>
+ <topic href="doc/User-Guide.html#Features" label="Features"></topic>
+ </topic>
+ <topic href="doc/Installation.html" label="Installation">
+ <topic href="doc/Installation.html#LTTng_Tracer" label="LTTng Tracer"></topic>
+ <topic href="doc/Installation.html#LTTng_Eclipse_Plug-ins" label="LTTng Eclipse Plug-ins"></topic>
+ <topic href="doc/Installation.html#LTTng_Eclipse_Dependencies" label="LTTng Eclipse Dependencies"></topic>
+ <topic href="doc/Installation.html#Installation_Verification" label="Installation Verification"></topic>
+ </topic>
+ <topic href="doc/LTTng.html" label="LTTng">
+ <topic href="doc/LTTng.html#Tracing_Perspective" label="Tracing Perspective"></topic>
+ <topic href="doc/LTTng.html#Project_View" label="Project View">
+ <topic href="doc/LTTng.html#Creating_a_Tracing_Project" label="Creating a Tracing Project"></topic>
+ <topic href="doc/LTTng.html#Importing_Traces_in_a_Project" label="Importing Traces in a Project"></topic>
+ <topic href="doc/LTTng.html#Selecting_a_Trace_Type" label="Selecting a Trace Type"></topic>
+ <topic href="doc/LTTng.html#Creating_a_Experiment" label="Creating a Experiment"></topic>
+ <topic href="doc/LTTng.html#Selecting_Traces_for_an_Experiment" label="Selecting Traces for an Experiment"></topic>
+ <topic href="doc/LTTng.html#Removing_Traces_from_an_Experiment" label="Removing Traces from an Experiment"></topic>
+ <topic href="doc/LTTng.html#Renaming_a_Trace_or_Experiment" label="Renaming a Trace or Experiment"></topic>
+ <topic href="doc/LTTng.html#Copying_a_Trace_or_Experiment" label="Copying a Trace or Experiment"></topic>
+ <topic href="doc/LTTng.html#Deleting_a_Trace_or_Experiment" label="Deleting a Trace or Experiment"></topic>
+ <topic href="doc/LTTng.html#Deleting_Supplementary_Files" label="Deleting Supplementary Files"></topic>
+ <topic href="doc/LTTng.html#Opening_a_Trace_or_Experiment" label="Opening a Trace or Experiment"></topic>
+ <topic href="doc/LTTng.html#Drag_and_Drop" label="Drag and Drop"></topic>
+ </topic>
+ <topic href="doc/LTTng.html#Events_View" label="Events View">
+ <topic href="doc/LTTng.html#Searching_and_Filtering" label="Searching and Filtering">
+ <topic href="doc/LTTng.html#Searching" label="Searching"></topic>
+ <topic href="doc/LTTng.html#Filtering" label="Filtering"></topic>
+ <topic href="doc/LTTng.html#Bookmarking" label="Bookmarking"></topic>
+ </topic>
+ </topic>
+ <topic href="doc/LTTng.html#Histogram_View" label="Histogram View"></topic>
+ <topic href="doc/LTTng.html#Statistics_View" label="Statistics View"></topic>
+ <topic href="doc/LTTng.html#Colors_View" label="Colors View"></topic>
+ <topic href="doc/LTTng.html#Filters_View" label="Filters View"></topic>
+ <topic href="doc/LTTng.html#Time_Chart_View" label="Time Chart View"></topic>
+ <topic href="doc/LTTng.html#Environment_Variables_View" label="Environment Variables View"></topic>
+ <topic href="doc/LTTng.html#Custom_Parser" label="Custom Parser">
+ <topic href="doc/LTTng.html#Creating_a_custom_text_parser" label="Creating a custom text parser"></topic>
+ <topic href="doc/LTTng.html#Creating_a_custom_XML_parser" label="Creating a custom XML parser"></topic>
+ <topic href="doc/LTTng.html#Managing_custom_parsers" label="Managing custom parsers"></topic>
+ <topic href="doc/LTTng.html#Opening_a_trace_using_a_custom_parser" label="Opening a trace using a custom parser"></topic>
+ </topic>
+ <topic href="doc/LTTng.html#LTTng_Tracer_Control" label="LTTng Tracer Control">
+ <topic href="doc/LTTng.html#Control_View" label="Control View">
+ <topic href="doc/LTTng.html#Creating_a_New_Connection_to_a_Remote_Host" label="Creating a New Connection to a Remote Host"></topic>
+ <topic href="doc/LTTng.html#Disconnecting_from_a_Remote_Host" label="Disconnecting from a Remote Host"></topic>
+ <topic href="doc/LTTng.html#Connecting_to_a_Remote_Host" label="Connecting to a Remote Host"></topic>
+ <topic href="doc/LTTng.html#Deleting_to_a_Remote_Host_Connection" label="Deleting to a Remote Host Connection"></topic>
+ <topic href="doc/LTTng.html#Creating_a_Tracing_Session" label="Creating a Tracing Session"></topic>
+ <topic href="doc/LTTng.html#Enabling_Channels_-_General" label="Enabling Channels - General"></topic>
+ <topic href="doc/LTTng.html#Enabling_Channels_On_Session_Level" label="Enabling Channels On Session Level"></topic>
+ <topic href="doc/LTTng.html#Enabling_Channels_On_Domain_Level" label="Enabling Channels On Domain Level"></topic>
+ <topic href="doc/LTTng.html#Enabling_and_Disabling_Channels" label="Enabling and Disabling Channels"></topic>
+ <topic href="doc/LTTng.html#Enabling_Events_-_General" label="Enabling Events - General"></topic>
+ <topic href="doc/LTTng.html#Enabling_Kernel_Events_On_Session_Level" label="Enabling Kernel Events On Session Level"></topic>
+ <topic href="doc/LTTng.html#Enabling_UST_Events_On_Session_Level" label="Enabling UST Events On Session Level"></topic>
+ <topic href="doc/LTTng.html#Enabling_Events_On_Domain_Level" label="Enabling Events On Domain Level"></topic>
+ <topic href="doc/LTTng.html#Enabling_Events_On_Channel_Level" label="Enabling Events On Channel Level"></topic>
+ <topic href="doc/LTTng.html#Enabling_and_Disabling_Events" label="Enabling and Disabling Events"></topic>
+ <topic href="doc/LTTng.html#Enabling_Tracepoint_Events_From_Provider" label="Enabling Tracepoint Events From Provider"></topic>
+ <topic href="doc/LTTng.html#Adding_Contexts_to_Channels_and_Events_of_a_Domain" label="Adding Contexts to Channels and Events of a Domain"></topic>
+ <topic href="doc/LTTng.html#Adding_Contexts_to_All_Events_of_a_Channel" label="Adding Contexts to All Events of a Channel"></topic>
+ <topic href="doc/LTTng.html#Adding_Contexts_to_a_Event_of_a_Specific_Channel" label="Adding Contexts to a Event of a Specific Channel"></topic>
+ <topic href="doc/LTTng.html#Start_Tracing" label="Start Tracing"></topic>
+ <topic href="doc/LTTng.html#Stop_Tracing" label="Stop Tracing"></topic>
+ <topic href="doc/LTTng.html#Destroying_a_Tracing_Session" label="Destroying a Tracing Session"></topic>
+ <topic href="doc/LTTng.html#Refreshing_the_Node_Information" label="Refreshing the Node Information"></topic>
+ <topic href="doc/LTTng.html#Quantifing_LTTng_overhead_.28Calibrate.29" label="Quantifing LTTng overhead (Calibrate)"></topic>
+ <topic href="doc/LTTng.html#Importing_Session_Traces_to_a_Tracing_Project" label="Importing Session Traces to a Tracing Project"></topic>
+ </topic>
+ <topic href="doc/LTTng.html#Properties_View" label="Properties View"></topic>
+ <topic href="doc/LTTng.html#LTTng_Tracer_Control_Preferences" label="LTTng Tracer Control Preferences"></topic>
+ </topic>
+ </topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html" label="LTTng Kernel Analysis">
+ <topic href="doc/LTTng-Kernel-Analysis.html#LTTng_Kernel_Perspective" label="LTTng Kernel Perspective"></topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Control_Flow_View" label="Control Flow View">
+ <topic href="doc/LTTng-Kernel-Analysis.html#Process_tree_and_informations" label="Process tree and informations"></topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#States_flow" label="States flow">
+ <topic href="doc/LTTng-Kernel-Analysis.html#Using_the_mouse" label="Using the mouse"></topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Incomplete_regions" label="Incomplete regions"></topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Zoom_region" label="Zoom region"></topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Tooltips" label="Tooltips"></topic>
+ </topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Toolbar" label="Toolbar"></topic>
+ </topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Resources_View" label="Resources View">
+ <topic href="doc/LTTng-Kernel-Analysis.html#Navigation" label="Navigation"></topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Incomplete_regions_2" label="Incomplete regions"></topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Toolbar_2" label="Toolbar"></topic>
+ </topic>
+ <topic href="doc/LTTng-Kernel-Analysis.html#Events_View_2" label="Events View"></topic>
+ </topic>
+ <topic href="doc/Limitations.html" label="Limitations"></topic>
+ <topic href="doc/How-to-use-LTTng-to-diagnose-problems.html" label="How to use LTTng to diagnose problems">
+ <topic href="doc/How-to-use-LTTng-to-diagnose-problems.html#Random_stutters" label="Random stutters"></topic>
+ <topic href="doc/How-to-use-LTTng-to-diagnose-problems.html#Slow_I.2FO" label="Slow I/O"></topic>
+ </topic>
+ <topic href="doc/References.html" label="References"></topic>
+ <topic href="doc/Updating-This-Document.html" label="Updating This Document"></topic>
+</toc> \ No newline at end of file
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.html
new file mode 100644
index 0000000..77b57d5
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.html
@@ -0,0 +1,108 @@
+<?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="Installation.html" title="Installation">
+ <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">Installation</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Overview">Overview</h1>
+ <p>LTTng (Linux Trace Toolkit, next generation) is a highly efficient tracing tool for Linux that can be used to track down kernel and application performance issues as well as troubleshoot problems involving multiple concurrent processes and threads. It consists of a set of kernel modules, daemons - to collect the raw tracing data - and a set of tools to control, visualize and analyze the generated data. It also provides support for user space application instrumentation.</p>
+ <p>For more information about LTTng, refer to the project
+ <a href="http://lttng.org">site</a>
+ </p>
+ <p>
+ <b>Note</b>: This User Guide covers the integration of the latest LTTng (v2.0) in Eclipse. The legacy version (v0.x) of both the tracer and the LTTng integration are no longer being maintained but are still available for download. The User Guide for the legacy LTTng integration is available
+ <a href="http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng/User_Guide">here</a>.
+ </p>
+ <h2 id="About_Tracing">About Tracing</h2>
+ <p>Tracing is a troubleshooting technique used to understand the behavior of an instrumented application by collecting information on its execution path. A tracer is the software used for tracing. Tracing can be used to troubleshoot 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 at selected execution locations. However, compared to logging, it is generally aimed at developers and it usually records low-level events at a high rate. Tracers can typically generate thousands of events per second. The generated traces can easily contain millions of events and have sizes from many megabytes to tens of gigabytes. Tracers must therefore be optimized to handle a lot of data while having a small impact on the system.</p>
+ <p>Traces may include events from the operating system kernel (IRQ handler entry/exit, system call entry/exit, scheduling activity, network activity, etc). They 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, tracing events may be viewed like a log file. However, trace analyzers and viewers are available to derive useful information from the raw data. These programs must be specially designed to handle quickly the enormous amount of data a trace may contain.</p>
+ <h2 id="LTTng_integration">LTTng integration</h2>
+ <p>The LTTng plug-in for Eclipse provides an Eclipse integration for the control of the LTTng tracer as well as fetching and visualization of the traces produced. It also provides the foundation for user-defined analysis tools.</p>
+ <p>The LTTng Eclipse plug-in provides the following views:</p>
+ <ul>
+ <li>
+ <i>Project</i> - an extension to the standard Eclipse Project view tailored for tracing projects
+ </li>
+ <li>
+ <i>Control</i> - to control the tracer and configure the tracepoints
+ </li>
+ <li>
+ <i>Events</i> - a versatile view that presents the raw events in tabular format with support for searching, filtering and bookmarking
+ </li>
+ <li>
+ <i>Statistics</i> - a view that that provides simple statistics on event occurrences by type
+ </li>
+ <li>
+ <i>Histogram</i> - a view that displays the event density with respect to time in traces
+ </li>
+ </ul>
+ <p>These views can be extended or tailored for specific trace types (e.g. kernel, HW, user app).</p>
+ <p>At present, the LTTng Eclipse plug-in for Eclipse supports the following kernel-oriented analysis:</p>
+ <ul>
+ <li>
+ <i>Control Flow</i> - to visualize processes state transitions
+ </li>
+ <li>
+ <i>Resources</i> - to visualize system resources state transitions
+ </li>
+ </ul>
+ <p>Although the control and fetching parts are targeted at the LTTng tracer, the underlying framework can also be used to process any trace that complies with the
+ <i>Common Trace Format</i> (
+ <a href="http://www.efficios.com/ctf">CTF</a>). CTF specifies a very efficient and compact binary trace format that is meant to be application-, architecture-, and language-agnostic.
+ </p>
+ <h2 id="Features">Features</h2>
+ <p>The LTTng Eclipse plug-in has a number of features to allow efficient handling of very large traces (and sets of large traces):</p>
+ <ul>
+ <li>Support for arbitrarily large traces (larger than available memory)</li>
+ <li>Support for correlating multiple time-ordered traces</li>
+ <li>Support for zooming down to the nanosecond on any part of a trace or set of traces</li>
+ <li>Views synchronization of currently selected event</li>
+ <li>Efficient searching and filtering of events</li>
+ <li>Support for trace bookmarks</li>
+ </ul>
+ <p>There is also support for the integration of non-LTTng trace types:</p>
+ <ul>
+ <li>Built-in CTF parser</li>
+ <li>Dynamic creation of customized parsers (for XML and text traces)</li>
+ </ul><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="Installation.html" title="Installation">
+ <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">Installation</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki
new file mode 100644
index 0000000..733433a
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki
@@ -0,0 +1,1341 @@
+
+= Overview =
+
+LTTng (Linux Trace Toolkit, next generation) is a highly efficient tracing tool for Linux that can be used to track down kernel and application performance issues as well as troubleshoot problems involving multiple concurrent processes and threads. It consists of a set of kernel modules, daemons - to collect the raw tracing data - and a set of tools to control, visualize and analyze the generated data. It also provides support for user space application instrumentation.
+
+For more information about LTTng, refer to the project [http://lttng.org site]
+
+'''Note''': This User Guide covers the integration of the latest LTTng (v2.0) in Eclipse. The legacy version (v0.x) of both the tracer and the LTTng integration are no longer being maintained but are still available for download. The User Guide for the legacy LTTng integration is available [http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng/User_Guide here].
+
+== About Tracing ==
+
+Tracing is a troubleshooting technique used to understand the behavior of an instrumented application by collecting information on its execution path. A tracer is the software used for tracing. Tracing can be used to troubleshoot a wide range of bugs that are otherwise extremely challenging. These include, for example, performance problems in complex parallel systems or real-time systems.
+
+Tracing is similar to logging: it consists in recording events that happen in a system at selected execution locations. However, compared to logging, it is generally aimed at developers and it usually records low-level events at a high rate. Tracers can typically generate thousands of events per second. The generated traces can easily contain millions of events and have sizes from many megabytes to tens of gigabytes. Tracers must therefore be optimized to handle a lot of data while having a small impact on the system.
+
+Traces may include events from the operating system kernel (IRQ handler entry/exit, system call entry/exit, scheduling activity, network activity, etc). They can also consists of application events (a.k.a UST - User Space Tracing) or a mix of the two.
+
+For the maximum level of detail, tracing events may be viewed like a log file. However, trace analyzers and viewers are available to derive useful information from the raw data. These programs must be specially designed to handle quickly the enormous amount of data a trace may contain.
+
+== LTTng integration ==
+
+The LTTng plug-in for Eclipse provides an Eclipse integration for the control of the LTTng tracer as well as fetching and visualization of the traces produced. It also provides the foundation for user-defined analysis tools.
+
+The LTTng Eclipse plug-in provides the following views:
+
+* ''Project'' - an extension to the standard Eclipse Project view tailored for tracing projects
+* ''Control'' - to control the tracer and configure the tracepoints
+* ''Events'' - a versatile view that presents the raw events in tabular format with support for searching, filtering and bookmarking
+* ''Statistics'' - a view that that provides simple statistics on event occurrences by type
+* ''Histogram'' - a view that displays the event density with respect to time in traces
+
+These views can be extended or tailored for specific trace types (e.g. kernel, HW, user app).
+
+At present, the LTTng Eclipse plug-in for Eclipse supports the following kernel-oriented analysis:
+
+* ''Control Flow'' - to visualize processes state transitions
+* ''Resources'' - to visualize system resources state transitions
+
+Although the control and fetching parts are targeted at the LTTng tracer, the underlying framework can also be used to process any trace that complies with the ''Common Trace Format'' ([http://www.efficios.com/ctf CTF]). CTF specifies a very efficient and compact binary trace format that is meant to be application-, architecture-, and language-agnostic.
+
+== Features ==
+
+The LTTng Eclipse plug-in has a number of features to allow efficient handling of very large traces (and sets of large traces):
+
+* Support for arbitrarily large traces (larger than available memory)
+* Support for correlating multiple time-ordered traces
+* Support for zooming down to the nanosecond on any part of a trace or set of traces
+* Views synchronization of currently selected event
+* Efficient searching and filtering of events
+* Support for trace bookmarks
+
+There is also support for the integration of non-LTTng trace types:
+
+* Built-in CTF parser
+* Dynamic creation of customized parsers (for XML and text traces)
+
+= Installation =
+
+This section describes the installation of the LTTng tracer and the LTTng Eclipse plug-ins as well as their dependencies.
+
+== LTTng Tracer ==
+
+While the Eclipse plug-ins can run on the standard Eclipse platforms (Linux, Mac, Windows), the LTTng tracer and its accompanying tools run on Linux.
+
+The tracer and tools have been available for download in Ubuntu since 12.04. They can easily be installed with the following command:
+
+<pre>
+ > sudo apt-get install lttng-tools
+</pre>
+
+For other distributions, older Ubuntu distributions, or the latest, bleeding edge LTTng tracer, please refer to the [http://lttng.org/download LTTng website] for installation information.
+
+'''Note''': The LTTng tracer (and accompanying tools) is required only if you want to create your own traces (the usual case). If you intend to simply analyze existing traces then it is not necessary to install the tracer.
+
+== LTTng Eclipse Plug-ins ==
+
+The easiest way to install the LTTng plug-ins for Eclipse is through the Software Updates and Add-ons menu. For information on how to use this menu, refer to this [http://wiki.eclipse.org/Linux_Tools_Project/PluginInstallHelp#Installing_Updates_From_the_Linux_Tools_Update_Site link].
+
+The legacy (''Classic'' :-)) Eclipse LTTng (v0.x) is also available as an optional download. Refer to [http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng/User_Guide here] for installation and verification instructions.
+
+The LTTng plug-ins are structured as a stack of features/plug-ins as following:
+
+* '''CTF''' - A CTF parser that can also be used as a standalone component
+** ''Feature'': org.eclipse.linuxtools.ctf
+** ''Plug-ins'': org.eclipse.linuxtools.ctf.core, org.eclipse.linuxtools.ctf.parser
+
+* '''TMF''' - ''Tracing and Monitoring Framework'' a framework for generic trace processing
+** ''Feature'': org.eclipse.linuxtools.tmf
+** ''Plug-ins'': org.eclipse.linuxtools.tmf.core, org.eclipse.linuxtools.tmf.ui
+
+* '''LTTng''' - The wrapper for the LTTng tracer control. Can be used for kernel or application tracing.
+** ''Feature'': org.eclipse.linuxtools.lttng2
+** ''Plug-ins'': org.eclipse.linuxtools.lttng2.core, org.eclipse.linuxtools.lttng2.ui
+
+* '''LTTng Kernel''' - Analysis components specific to Linux kernel traces
+** ''Feature'': org.eclipse.linuxtools.lttng2.kernel
+** ''Plug-ins'': org.eclipse.linuxtools.lttng2.kernel.core, org.eclipse.linuxtools.lttng2.kernel.ui
+
+== LTTng Eclipse Dependencies ==
+
+The Eclipse LTTng controls the LTTng tracer through an ''ssh'' connection even if the tracer is running locally (the 'degenerate' case).
+
+Therefore, the target system (where the tracer runs) needs to run an ''ssh'' server as well as ''sftp'' server (for file transfer) to which you have permission to connect.
+
+On the host side (where Eclipse is running), you also need to have Eclipse RSE (Remote System Explorer) installed to handle the SSH connection and transport. The RSE can be installed the standard way (''Help'' > ''Install New Software...'' > ''General Purpose Tools'' > ''Remote System Explorer End-User Runtime'').
+
+== Installation Verification ==
+
+Here are the quick steps to verify that your installation is functional:
+
+* Start Eclipse
+* Open the LTTng perspective
+* Create a Tracing project
+** Right-click in the Project view and select "New Project"
+** Enter the name of your project (e.g. "MyLTTngProject")
+** The project will be created. It will contain 2 empty folders: "Traces" and "Experiments"
+* Import a sample trace
+** Right-click on the newly created project "Traces" folder and select "Import..."
+** Navigate to the sample LTTng trace that you want to visualize
+** Select that trace (check box), select the trace type (e.g. CTF: Kernel Trace), and press "Finish"
+** The newly imported trace should appear under the Traces folder
+* Visualize the trace
+** Expand the Traces folder
+** Double-click on the trace
+** The trace should load and the views be populated
+
+If an error message is displayed, you might want to double-check that the trace type is correctly set (right-click on the trace and "Select Trace Type...").
+
+Refer to [[#Tracing Perspective | Tracing Perspective]] for detailed description of the views and their usage.
+
+To download sample LTTng traces, go to [http://lttng.org/download]. At the bottom of the page there is a link to some sample LTTng 2.0 kernel traces.
+
+= LTTng =
+
+== Tracing Perspective ==
+
+The '''Tracing''' perspective is part of the '''Tracing and Monitoring Framework (TMF)''' and groups the following views:
+
+* [[#Project_View | Project View]]
+* [[#Events_View | Events View]]
+* [[#Histogram_View | Histogram View]]
+* [[#Statistics_View | Statistics View]]
+
+The views are synchronized i.e. selecting an event, a timestamp, a time range, etc will update the other views accordingly.
+
+[[Image:images/TracingPerspective.png]]
+
+The perspective can be opened from the Eclipse Open Perspective dialog ('''Window > Open Perspective... > Other''').
+
+[[Image:images/ShowTracingPerspective.png]]
+
+On top to these views, the '''Tracing and Monitoring Framework (TMF)''' feature provides a set of generic tracing specific views, such as:
+
+* [[#Colors_View | Colors View]]
+* [[#Filters_View | Filters View]]
+* [[#Time_Chart_View | Time Chart View]]
+* [[#Environment_Variables_View | Environment Variables View]]
+* [[#Custom Parser | Custom Parser]]
+
+To open one of the above '''Tracing''' view, use the Eclipse Show View dialog ('''Window > Show View > Other...'''. Then select the relevant view from the '''Tracing'''.
+
+[[Image:images/ShowTracingViews.png]]
+
+Additionally, the '''LTTng''' feature provides a '''LTTng Tracer Control'''. It comes with a dedicated '''Control View'''.
+
+* [[#LTTng_Tracer_Control | LTTng Tracer Control]]
+
+== Project View ==
+The project view is the standard Eclipse Project Explorer. '''Tracing''' projects are well integrated in the Eclipse's Common Navigator Framework. The Project Explorer shows '''Tracing''' project with a small "T" decorator in the upper right of the project folder icon.
+
+=== Creating a Tracing Project ===
+A new '''Tracing''' project can be created using the New Tracing Project wizard. To create a new '''Tracing''' select '''File > New > Project...''' from the main menu bar or alternatively form the context-sensitive menu (click with right mouse button in the '''Project Explorer'''.
+
+The first page of project wizard will open.
+
+[[Image:images/NewTracingProjectPage1.png]]
+
+In the list of project categories, expand category '''Tracing''' and select '''Tracing Project''' and the click on '''Next >'''. A second page of the wizard will show. Now enter the a name in the field '''Project Name''', select a location if required and the press on '''Finish'''.
+
+[[Image:images/NewTracingProjectPage2.png]]
+
+A new project will appear in the '''Project Explorer''' view.
+
+[[Image:images/NewProjectExplorer.png]]
+
+Tracing projects have two sub-folders: '''Traces''' which holds the individual traces, and '''Experiments''' which holds sets of traces that we want to correlate.
+
+=== Importing Traces in a Project ===
+
+The '''Traces''' folder holds the set of traces available for experiments. To import a trace to the traces folder, select the Traces folder and click the right mouse button. Then select '''Import...''' menu item in the context-sensitive menu.
+
+[[Image:images/ProjectImportTraceAction.png]]
+
+A new display will show for selecting traces to import. By default, it shows the correct destination directory where the traces will be imported to. Now, specify the location of the traces by entering the path directly in the '''Source Directory''' or by browsing the file system (click on button browse). Then select the traces to import in the list of files and folders. Optionally, select the '''Trace Type''' from the drop-down menu, select or deselect the checkboxes for '''Overwrite existing trace without warning''' and '''Create links into workspace'''. When all options are configured, click on '''Finish'''.
+
+Note, that traces of certain types (e.g. LTTng Kernel) are actually a composite of multiple channel traces grouped under a folder. It is the folder that has to be imported.
+
+[[Image:images/ProjectImportTraceDialog.png]]
+
+Upon successful importing the traces will be stored in the '''Traces''' folder. If a trace type was selected in the import dialog, then the corresponding icon will be displayed. Linked traces will have a little arrow as decorator on the right bottom corner.
+
+Note that trace type is an extension point of the '''Tracing and Monitoring Framework (TMF)'''. Depending on the which features are loaded, the list of trace types can vary.
+
+=== Selecting a Trace Type ===
+
+If no trace type was selected a trace type as to be associated to a trace before it can be opened. To select a trace type select the relevant trace and click the right mouse button. In the context-sensitive menu, select '''Select Trace Type...''' menu item. A sub-menu will show will all available trace type categories. From the relevant category select the required trace type. The examples, below show how to select the '''Common Trace Format''' types '''LTTng Kernel''' and '''Generic CTF trace'''.
+
+[[Image:images/SelectLTTngKernelTraceType.png]]
+
+[[Image:images/SelectGenericCTFTraceType.png]]
+
+After selecting the trace type, the trace icon will be updated with the corresponding trace type icon.
+
+[[Image:images/ExplorerWithAssociatedTraceType.png]]
+
+=== Creating a Experiment ===
+
+An experiment consists in an arbitrary number of aggregated traces for purpose of correlation. In the degenerate case, an experiment can consist of a single trace. The experiment provides a unified, time-ordered stream of the individual trace events.
+
+To create an experiment, select the folder '''Experiments''' and click the right mouse button. Then select '''New...'''.
+
+[[Image:images/NewExperimentAction.png]]
+
+A new display will open for entering the experiment name. Type the name of the experiment in the text field '''Experiment Name''' and the click on '''OK'''.
+
+[[Image:images/NewExperimentDialog.png]]
+
+=== Selecting Traces for an Experiment ===
+
+After creating an experiment, traces need to be added to the experiment. To select traces for an experiment select the newly create experiment and click the right mouse button. Select '''Select Traces...''' from the context sensitive menu.
+
+[[Image:images/SelectTracesAction.png]]
+
+A new dialog box will open with a list of available traces. Select the traces to add from the list and then click on '''Finish'''.
+
+[[Image:images/SelectTracesDialog.png]]
+
+Now the selected traces will be linked to the experiment and will be shown under the '''Experiments''' folder.
+
+[[Image:images/ExplorerWithExperiment.png]]
+
+Alternatively, traces can be added to an experiment using [[#Drag_and_Drop | Drag and Drop]].
+
+=== Removing Traces from an Experiment ===
+
+To remove one or more traces for an experiment select the trace(s) to remove under the Experiment folder and click the right mouse button. Select '''Remove''' from the context sensitive menu.
+
+[[Image:images/RemoveTracesAction.png]]
+
+After that the selected trace(s) are removed from the experiment. Note that the traces are still in the '''Traces''' folder.
+
+=== Renaming a Trace or Experiment ===
+
+Traces and Experiment can be renamed from the '''Project Explorer''' view. To rename a trace or experiment select the relevant trace and click the right mouse button. Then select '''Rename...''' from the context sensitive menu.
+
+[[Image:images/RenameTraceAction.png]]
+
+A new dialog box will show for entering a new name. Enter a new trace or experiment name respectively in the relevant text field and click on '''OK'''. If the new name already exists the dialog box will show an error and a different name has to be entered.
+
+[[Image:images/RenameTraceDialog.png]]
+
+[[Image:images/RenameExperimentDialog.png]]
+
+After successful renaming the new name will show in the '''Project Explorer'''. In case of a trace all reference links to that trace will be updated too. Note that linked traces only changes the display name, the underlying trace resource will stay the original name.
+
+Note that all supplementary files will be also handled accordingly (see also [[#Deleting Supplementary Files | Deleting Supplementary Files]]).
+
+=== Copying a Trace or Experiment ===
+
+To copy a trace or experiment select the relevant trace or experiment in the '''Project Explorer''' view and click the right mouse button. Then select '''Copy...''' from the context sensitive menu.
+
+[[Image:images/CopyTraceAction.png]]
+
+A new dialog box will show for entering a new name. Enter a new trace or experiment name respectively in the relevant text field and click on '''OK'''. If the new name already exists the dialog box will show an error and a different name has to be entered.
+
+[[Image:images/CopyTraceDialog.png]]
+
+[[Image:images/CopyExperimentDialog.png]]
+
+After successful copy operation the new trace or experiment respectively will show in the '''Project Explorer'''. In case of a linked trace, the copied trace will be a link to the original trace too.
+
+Note that the directory for all supplementary files will be copied, too. (see also [[#Deleting Supplementary Files | Deleting Supplementary Files]]).
+
+=== Deleting a Trace or Experiment ===
+
+To delete a trace or experiment select the relevant trace or experiment in the '''Project Explorer''' view and click the right mouse button. Then select '''Delete...''' from the context sensitive menu.
+
+[[Image:images/DeleteExperimentAction.png]]
+
+A confirmation dialog box will open. To perform the deletion press '''OK''' otherwise select '''Cancel'''.
+
+[[Image:images/DeleteExperimentConfirmationDialog.png]]
+
+After successful operation the selected trace or experiment will be removed from the project. In case of a linked trace only the link will be removed. The actual trace resource remain on the disk.
+
+Note that the directory for all supplementary files will be deleted, too. (see also [[#Deleting Supplementary Files | Deleting Supplementary Files]]).
+
+=== Deleting Supplementary Files ===
+
+Supplementary files are by definition trace specific files that accompany a trace. These file could be temporary files, persistent indexes or any other persistent data files created by the LTTng integration in Eclipse during parsing a trace. For the LTTng 2.0 trace viewer a persistent state history of the Linux Kernel is created and is stored under the name '''stateHistroy.ht'''.
+
+All supplementary file are hidden from the user and are handled internally by the TMF. However, there is a possibility to delete the supplementary files so that there are recreated when opening a trace.
+
+To delete all supplementary files from a single trace, select the relevant trace in the '''Project Explorer''' view and click the right mouse button. Then select the '''Delete Supplementary Files...''' menu item from the context-sensitive menu.
+
+[[Image:images/DeleteSupplementaryFilesAction.png]]
+
+A new dialog box will open with a list of supplementary files. Select the file(s) to delete from the list and press '''OK'''.
+
+[[Image:images/DeleteSupplementaryFilesDialog.png]]
+
+To delete all supplementary files from all traces of a experiment, select the relevant experiment in the '''Project Explorer''' view and click the right mouse button. In the context-sensitive menu select '''Delete Supplementary Files...''' menu item.
+
+A new dialog box will open with a list of supplementary files. Note that the supplementary files are prefixed with the trace name to indicate the trace they belong to. Select the file(s) to delete from the list and press '''OK'''.
+
+[[Image:images/DeleteExpSupplementaryFilesDialog.png]]
+
+=== Opening a Trace or Experiment ===
+
+A trace or experiment can be open by double-clicking the left mouse button on the trace or experiment in the '''Project Explorer''' view. Alternatively, select the trace or experiment in the in the '''Project Explorer''' view and click the right mouse button. Then select '''Open''' menu item of the context-sensitive menu.
+
+[[Image:images/OpenTraceAction.png]]
+
+When opening a trace or experiment all currently open view will be filled which are defined for the corresponding trace type. Additionally, an internal index will be created for fast navigation within a trace. For LTTng 2.0 kernel traces a persistent state history will also be build. This state history will be used in different views to display kernel state information.
+
+=== Drag and Drop ===
+
+Traces can be also be imported to a project by dragging from another tracing project and dropping to the project's trace folder. The trace will be copied and the trace type will be set.
+
+Any resource can be dragged and dropped from a non-tracing project, and any file or folder can be dragged from an external tool, into a tracing project's trace folder. The resource will be copied or imported as a new trace, however the trace type will be unknown and need to be set manually by the user.
+
+It is also possible to drop a trace, resource, file or folder into an existing experiment. If the item does not already exist as a trace in the project's trace folder, it will first be copied or imported, then the trace will be added to the experiment.
+
+== Events View ==
+
+The Events view shows the basic trace data in chronological order in a tabular format.
+
+When opened, the Events view displays the events of the currently selected trace or experiment.
+
+The header displays the current trace (or experiment) name.
+
+Being part of the '''Tracing and Monitoring''' Framework, the default table displays the following fields:
+
+* '''Timestamp''': the event timestamp
+* '''Source''': the source of the event
+* '''Type''': the event type and localization
+* '''Reference''' the event reference
+* '''Content''': the raw event content
+
+The first row of the table is the header row a.k.a. the Search and Filter row.
+
+[[Image:images/DefaultEventsView.png]]
+
+The highlighted event is the ''current event'' and is synchronized with the other views. If you select another event, the other views will be synchronized accordingly.
+
+=== Searching and Filtering ===
+
+Searching and filtering of events in the table can be performed by entering matching conditions in one or multiple columns in the header row (the first row below the column header).
+
+To toggle between searching and filtering, click on the 'search' ([[Image:images/TmfEventSearch.gif]]) or 'filter' ([[Image:images/TmfEventFilter.gif]]) icon in the header row's left margin, or right-click on the header row and select '''Show Filter Bar''' or '''Show Search Bar''' in the context menu.
+
+To apply a matching condition to a specific column, click on the column's header row cell, type in a [http://download.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html regular expression] and press the '''ENTER''' key. You can also enter a simple text string and it will be automatically be replaced with a 'contains' regular expression.
+
+When matching conditions are applied to two or more columns, all conditions must be met for the event to match (i.e. 'and' behavior).
+
+To clear all matching conditions in the header row, press the '''DEL''' key.
+
+==== Searching ====
+
+When a searching condition is applied to the header row, the table will select the next matching event starting from the top currently displayed event. Wrapping will occur if there is no match until the end of the trace.
+
+All matching events will have a 'search match' icon in their left margin. Non-matching events will be dimmed.
+
+[[Image:images/DefaultTmfEvents-Search.png]]
+
+Pressing the '''ENTER''' key will search and select the next matching event. Pressing the '''SHIFT-ENTER''' key will search and select the previous matching event. Wrapping will occur in both directions.
+
+Press '''ESC''' to cancel an ongoing search.
+
+Press '''DEL''' to clear the header row and reset all events to normal.
+
+==== Filtering ====
+
+When a filtering condition is entered in the head row, the table will clear all events and fill itself with matching events as they are found from the beginning of the trace.
+
+A status row will be displayed before and after the matching events, dynamically showing how many matching events were found and how many events were processed so far. Once the filtering is completed, the status row icon in the left margin will change from a 'stop' to a 'filter' icon.
+
+[[Image:images/DefaultTmfEvents-Filter.png]]
+
+Press '''ESC''' to stop an ongoing filtering. In this case the status row icon will remain as a 'stop' icon to indicate that not all events were processed.
+
+Press '''DEL''' or right-click on the table and select '''Clear Filters''' from the context menu to clear the header row and remove the filtering. All trace events will be now shown in the table. Note that the currently selected event will remain selected even after the filter is removed.
+
+You can also search on the subset of filtered events by toggling the header row to the Search Bar while a filter is applied. Searching and filtering conditions are independent of each other.
+
+==== Bookmarking ====
+
+Any event of interest can be tagged with a bookmark.
+
+To add a bookmark, double-click the left margin next to an event, or right-click the margin and select '''Add bookmark...'''. Alternatively use the '''Edit''' > '''Add bookmark...''' menu. Edit the bookmark description as desired and press '''OK'''.
+
+The bookmark will be displayed in the left margin, and hovering the mouse over the bookmark icon will display the description in a tooltip.
+
+The bookmark will be added to the '''Bookmarks''' view. In this view the bookmark description can be edited, and the bookmark can be deleted. Double-clicking the bookmark or selecting '''Go to''' from its context menu will open the trace or experiment and go directly to the event that was bookmarked.
+
+To remove a bookmark, double-click its icon, select '''Remove Bookmark''' from the left margin context menu, or select '''Delete''' from the Bookmarks view.
+
+[[Image:images/Bookmarks.png]]
+
+== Histogram View ==
+
+The Histogram View displays the trace events distribution with respect to time. When streaming a trace, this view is dynamically updated as the events are received.
+
+
+[[Image:images/HistogramView.png]]
+
+
+On the top left, there are two data controls:
+
+* '''Current Event (sec)''': Displays the timestamp of the currently selected event
+* '''Window Span (sec)''': Displays the current time range window size
+
+Both control can be used to modify their respective value. After validation, the other controls and views will be synchronized and updated accordingly.
+
+
+The large histogram, at the bottom, shows the event distribution over the whole trace or set of traces. It also has a smaller semi-transparent window, with a cross-hair, that shows the currently selected time range window. The time range window can be zoomed in/out by using the mouse wheel. It can also be selected by the mouse and dragged to another region of the trace.
+
+The smaller histogram, on top right, corresponds to the currently selected time range window, a sub-range of the event set. Its size can also be zoomed in/out using the mouse wheel.
+
+The x-axis of each histogram corresponds to the events timestamps. The timestamp of the first and the last event of the respective ranges is displayed. The y-axis of each histogram shows the minimum/maximum number of events in the corresponding histogram bars.
+
+The dashed vertical magenta bar, on the right, shows the position of the last event. The dashed vertical red bar shows the relative position of the currently selected event. The current event can be changed by clicking on the histogram.
+
+Hovering the mouse over an histogram bar pops up an information window that displays the start/end time of the corresponding bar as well as the number of events it represents.
+
+In each histogram, the following keys are handled:
+
+* '''Left''': Moves the current event to the previous non-empty bar
+* '''Right''': Moves the current event to the next non-empty bar
+* '''Home''': Displays the current event to the first histogram bar
+* '''End''': Displays the current event to the last non-empty histogram bar
+
+== Statistics View ==
+
+The Statistics View displays the various event counters that are collected when analyzing a trace. The data is organized per trace. To open the Statistics View, select Windows -> Show View -> Other... -> Tracing -> Statistics. A new view will open with the name Statistics. This view shows 2 columns: ''Level'' and ''Number of Events''. After parsing a trace the view will display the number of events per event type. The cells where the number of events are printed also contain a colored bar that indicates the percentage of the event count in relation to the total number of events. The statistics is collected for the whole trace. This view is part of the '''Tracing and Monitoring Framework (TMF)''' and is generic. It will work for any trace type extensions. For the LTTng 2.0 integration the Statistics view will display statistics as shown below.:
+
+[[Image:images/LTTng2StatisticsView.png]]
+
+== Colors View ==
+
+[[Image:images/ColorsView.png]]
+
+The Colors view allows the user to define a prioritized list of color settings.
+
+A color setting associates a foreground and background color (used in any events table), and a tick color (used in the Time Chart view), with an event filter.
+
+In an events table, any event row that matches the event filter of a color setting will be displayed with the specified foreground and background colors. If the event matches multiple filters, the color setting with the highest priority will be used.
+
+The same principle applies to the event tick colors in the Time Chart view. If a tick represents many events, the tick color of the highest priority matching event will be used.
+
+Color settings can be inserted, deleted, reordered, imported and exported using the buttons in the Colors view toolbar. Changes to the color settings are applied immediately, and are persisted to disk.
+
+== Filters View ==
+
+[[Image:images/FiltersView.png]]
+
+The Filters view allows the user to define preset filters that can be applied to any events table.
+
+The filters can be more complex than what can be achieved with the filter header row in the events table. The filter is defined in a tree node structure, where the node types can be any of '''EVENTTYPE''', '''AND''', '''OR''', '''CONTAINS''', '''EQUALS''', '''MATCHES''' or '''COMPARE'''. Some nodes types have restrictions on their possible children in the tree.
+
+The '''EVENTTYPE''' node filters against the event type of the trace as defined in a plugin extension or in a custom parsers. When used, any child node will have its field combo box restricted to the possible fields of that event type.
+
+The '''AND''' node applies the logical ''and'' condition on all of its children. All children conditions must be true for the filter to match. A ''not'' operator can be applied to invert the condition.
+
+The '''OR''' node applies the logical ''or'' condition on all of its children. At least one children condition must be true for the filter to match. A ''not'' operator can be applied to invert the condition.
+
+The '''CONTAINS''' node matches when the specified event ''field'' value contains the specified ''value'' string. A ''not'' operator can be applied to invert the condition. The condition can be case sensitive or insensitive.
+
+The '''EQUALS''' node matches when the specified event ''field'' value equals exactly the specified ''value'' string. A ''not'' operator can be applied to invert the condition. The condition can be case sensitive or insensitive.
+
+The '''MATCHES''' node matches when the specified event ''field'' value matches against the specified ''regular expression''. A ''not'' operator can be applied to invert the condition.
+
+The '''COMPARE''' node matches when the specified event ''field'' value compared with the specified ''value'' gives the specified ''result''. The result can be set to ''smaller than'', ''equal'' or ''greater than''. The type of comparison can be numerical, alphanumerical or based on time stamp. A ''not'' operator can be applied to invert the condition.
+
+Filters can be added, deleted, imported and exported using the buttons in the Filters view toolbar. Changes to the preset filters are only applied and persisted to disk when the '''save filters''' button is pressed.
+
+To apply a saved preset filter in an events table, right-click on the table and select '''Apply preset filter...''' > ''filter name''.
+
+== Time Chart View ==
+
+[[Image:images/TimeChartView.png]]
+
+The Time Chart view allows the user to visualize every open trace in a common time chart. Each trace is display in its own row and ticks are display for every punctual event. As the user zooms using the mouse wheel or by right-clicking and dragging in the time scale, more detailed event data is computed from the traces.
+
+Time synchronization is enabled between the time chart view and other trace viewers such as the events table.
+
+Color settings defined in the Colors view can be used to change the tick color of events displayed in the Time Chart view.
+
+When a search is applied in the events table, the ticks corresponding to matching events in the Time Chart view are decorated with a marker below the tick.
+
+When a bookmark is applied in the events table, the ticks corresponding to the bookmarked event in the Time Chart view is decorated with a bookmark above the tick.
+
+When a filter is applied in the events table, the non-matching ticks are removed from the Time Chart view.
+
+The Time Chart only supports traces that are opened in an editor. The use of an editor is specified in the plugin extension for that trace type, or is enabled by default for custom traces.
+
+== Environment Variables View ==
+A new feature of CTF traces is their ability to store user defined data that is not to be placed in an event. It is generally data that is per-trace specific, such as the tracer version and the trace domain. It will be populated when a trace is loaded if the trace has environment variables. <br>
+[[Image:images/environment_variables.png]]<br>
+The above picture shows a trace loaded that was collevcted with the '''lttng-modules''' version '''2'''.'''0'''.'''0''' tracer. It is a '''kernel''' trace of the '''3.2.0-18-generic''' '''linux''' kernel.
+
+== Custom Parser ==
+
+Custom parser wizards allow the user to define their own parsers for text or XML traces. The user defines how the input should be parsed into internal trace events and identifies the event fields that should be created and displayed. Traces created using a custom parser can be correlated with other built-in traces or traces added by plug-in extension.
+
+=== Creating a custom text parser ===
+
+The '''New Custom Text Parser''' wizard can be used to create a custom parser for text logs. It can be launched several ways:
+
+* Select '''File''' &gt; '''New''' &gt; '''Other...''' &gt; '''Tracing''' &gt; '''Custom Text Parser'''
+* Open the '''Manage Custom Parsers''' dialog from the '''Project Explorer''' view menu, select the '''Text''' radio button and click the '''New...''' button
+
+[[Image:images/CustomTextParserInput.png]]
+
+Fill out the first wizard page with the following information:
+
+* '''Log type:''' Enter a name for the custom log entries, which is also the name of the custom parser.
+* '''Time Stamp format:''' Enter the date and time pattern that will be used to output the Time Stamp.<br>
+Note: information about date and time patterns can be found here: [http://java.sun.com/javase/6/docs/api/java/text/SimpleDateFormat.html]
+
+Click the '''Add next line''', '''Add child line''' or '''Remove line''' buttons to create a new line of input or delete it. For each line of input, enter the following information:
+
+* '''Regular expression:''' Enter a regular expression that should match the input line in the log, using capturing groups to extract the data.<br>
+Note: information about date and time patterns can be found here: [http://java.sun.com/javase/6/docs/api/java/util/regex/Pattern.html]
+
+* '''Cardinality:''' Enter the minimum and maximum number of lines matching this line's regular expression that must be found in the log. At least the minimum number of lines must be found before the parser will consider the next line. Child lines will always be considered first.
+
+<u>Important note:</u> The custom parsers identify a log entry when the first line's regular expression matches (Root Line n). Each subsequent text line in the log is attempted to be matched against the regular expression of the parser's input lines in the order that they are defined (Line n.*). Only the first matching input line will be used to process the captured data to be stored in the log entry. When a text line matches a Root Line's regular expression, a new log entry is started.
+
+Click the '''Add group''' or '''Remove group''' buttons to define the data extracted from the capturing groups in the line's regular expression. For each group, enter the following information:
+
+* '''Name combo:''' Select a name for the extracted data:
+** '''Time Stamp''': Select this option to identify the time stamp data. The input's data and time pattern must be entered in the format: text box.
+** '''Message''': Select this option to identify the main log entry's message. This is usually a group which could have text of greater length.
+** '''Other''': Select this option to identify any non-standard data. The name must be entered in the name: text box.
+
+* '''Action combo:''' Select the action to be performed on the extracted data:
+** '''Set''': Select this option to overwrite the data for the chosen name when there is a match for this group.
+** '''Append''': Select this option to append to the data with the chosen name, if any, when there is a match for this group.
+** '''Append with |''' : Select this option to append to the data with the chosen name, if any, when there is a match for this group, using a | separator between matches.
+
+The '''Preview input''' text box can be used to enter any log data that will be processed against the defined custom parser. When the wizard is invoked from a selected log file resource, this input will be automatically filled with the file contents.
+
+The '''Preview:''' text field of each capturing group and of the Time Stamp will be filled from the parsed data of the first matching log entry.
+
+In the '''Preview input''' text box, the matching entries are highlighted with different colors:
+
+* <code><span style="background:#FFFF00">&nbsp;Yellow&nbsp;</span></code> : indicates uncaptured text in a matching line.
+* <code><span style="background:#00FF00">&nbsp;Green&nbsp;&nbsp;</span></code> : indicates a captured group in the matching line's regular expression for which a custom parser group is defined. This data will be stored by the custom parser.
+* <code><span style="background:#FF00FF">&nbsp;Magenta</span></code> : indicates a captured group in the matching line's regular expression for which there is no custom parser group defined. This data will be lost.
+* <code>&nbsp;White&nbsp;&nbsp;</code> : indicates a non-matching line.
+
+The first line of a matching entry is highlighted with darker colors.
+
+By default only the first matching entry will be highlighted. To highlight all matching entries in the preview input data, click the '''Highlight All''' button. This might take a few seconds to process, depending on the input size.
+
+Click the '''Next''' button to go to the second page of the wizard.
+
+[[Image:images/CustomTextParserOutput.png]]
+
+On this page, the list of default and custom data is shown, along with a preview of the custom parser log table output.
+
+The custom data output can be modified by the following options:
+
+* '''Visibility:''' Select or unselect the checkbox to display the custom data or hide it.
+
+* '''Column order:''' Click '''Move before''' or '''Move after''' to change the display order of custom data.
+
+The table at the bottom of the page shows a preview of the custom parser log table output according to the selected options, using the matching entries of the previous page's '''Preview input''' log data.
+
+Click the '''Finish''' button to close the wizard and save the custom parser.
+
+=== Creating a custom XML parser ===
+
+The '''New Custom XML Parser''' wizard can be used to create a custom parser for XML logs. It can be launched several ways:
+
+* Select '''File''' &gt; '''New''' &gt; '''Other...''' &gt; '''Tracing''' &gt; '''Custom XML Parser'''
+* Open the '''Manage Custom Parsers''' dialog from the '''Project Explorer''' view menu, select the '''XML''' radio button and click the '''New...''' button
+
+[[Image:images/CustomXMLParserInput.png]]
+
+Fill out the first wizard page with the following information:
+
+* '''Log type:''' Enter a name for the custom log entries, which is also the name of the custom parser.
+* '''Time Stamp format:''' Enter the date and time pattern that will be used to output the Time Stamp.<br>
+
+Note: information about date and time patterns can be found here: [http://java.sun.com/javase/6/docs/api/java/text/SimpleDateFormat.html]
+
+Click the '''Add document element''' button to create a new document element and enter a name for the root-level document element of the XML file.
+
+Click the '''Add child''' button to create a new element of input to the document element or any other element. For each element, enter the following information:
+
+* '''Element name:''' Enter a name for the element that must match an element of the XML file.
+* '''Log entry:''' Select this checkbox to identify an element which represents a log entry. Each element with this name in the XML file will be parsed to a new log entry. At least one log entry element must be identified in the XML document. Log entry elements cannot be nested.
+* '''Name combo:''' Select a name for the extracted data:
+** '''Ignore''': Select this option to ignore the extracted element's data at this level. It is still possible to extract data from this element's child elements.
+** '''Time Stamp''': Select this option to identify the time stamp data. The input's data and time pattern must be entered in the format: text box.
+** '''Message''': Select this option to identify the main log entry's message. This is usually an input which could have text of greater length.
+** '''Other''': Select this option to identify any non-standard data. The name must be entered in the name: text box. It does not have to match the element name.
+* '''Action combo:''' Select the action to be performed on the extracted data:
+** '''Set''': Select this option to overwrite the data for the chosen name when there is a match for this element.
+** '''Append''': Select this option to append to the data with the chosen name, if any, when there is a match for this element.
+** '''Append with |''' : Select this option to append to the data with the chosen name, if any, when there is a match for this element, using a | separator between matches.
+
+Note: An element's extracted data 'value' is a parsed string representation of all its attributes, children elements and their own values. To extract more specific information from an element, ignore its data value and extract the data from one or many of its attributes and children elements.
+
+Click the '''Add attribute''' button to create a new attribute input from the document element or any other element. For each attribute, enter the following information:
+
+* '''Attribute name:''' Enter a name for the attribute that must match an attribute of this element in the XML file.
+* '''Name combo:''' Select a name for the extracted data:
+** '''Time Stamp''': Select this option to identify the time stamp data. The input's data and time pattern must be entered in the format: text box.
+** '''Message''': Select this option to identify the main log entry's message. This is usually an input which could have text of greater length.
+** '''Other''': Select this option to identify any non-standard data. The name must be entered in the name: text box. It does not have to match the element name.
+* '''Action combo:''' Select the action to be performed on the extracted data:
+** '''Set''': Select this option to overwrite the data for the chosen name when there is a match for this element.
+** '''Append''': Select this option to append to the data with the chosen name, if any, when there is a match for this element.
+** '''Append with |''' : Select this option to append to the data with the chosen name, if any, when there is a match for this element, using a | separator between matches.
+
+Note: A log entry can inherited input data from its parent elements if the data is extracted at a higher level.
+
+Click the '''Feeling lucky''' button to automatically and recursively create child elements and attributes for the current element, according to the XML element data found in the '''Preview input''' text box, if any.
+
+Click the '''Remove element''' or '''Remove attribute''' buttons to remove the extraction of this input data. Take note that all children elements and attributes are also removed.
+
+The '''Preview input''' text box can be used to enter any XML log data that will be processed against the defined custom parser. When the wizard is invoked from a selected log file resource, this input will be automatically filled with the file contents.
+
+The '''Preview:''' text field of each capturing element and attribute and of the Time Stamp will be filled from the parsed data of the first matching log entry. Also, when creating a new child element or attribute, its element or attribute name will be suggested if possible from the preview input data.
+
+Click the '''Next''' button to go to the second page of the wizard.
+
+[[Image:images/CustomXMLParserOutput.png]]
+
+On this page, the list of default and custom data is shown, along with a preview of the custom parser log table output.
+
+The custom data output can be modified by the following options:
+
+* '''Visibility:''' Select or unselect the checkbox to display the custom data or hide it.
+* '''Column order:''' Click '''Move before''' or '''Move before''' to change the display order of custom data.
+
+The table at the bottom of the page shows a preview of the custom parser log table output according to the selected options, using the matching entries of the previous page's '''Preview input''' log data.
+
+Click the '''Finish''' button to close the wizard and save the custom parser.
+
+=== Managing custom parsers ===
+
+The '''Manage Custom Parsers''' dialog is used to manage the list of custom parsers used by the tool. To open the dialog:
+
+* Select '''Manage Custom Parsers''' from the '''Project Explorer''' view menu.
+
+[[Image:images/ManageCustomParsers.png]]
+
+The ordered list of currently defined custom parsers for the selected type is displayed on the left side of the dialog.
+
+To change the type of custom parser to manage, select the '''Text''' or '''XML''' radio button.
+
+The following actions can be performed from this dialog:
+
+* New...
+
+Click the '''New...''' button to launch the '''New Custom Parser''' wizard.
+
+* Edit...
+
+Select a custom parser from the list and click the '''Edit...''' button to launch the '''Edit Custom Parser''' wizard.
+
+* Delete
+
+Select a custom parser from the list and click the '''Delete''' button to remove the custom parser.
+
+* Import...
+
+Click the '''Import...''' button and select a file from the opened file dialog to import all its custom parsers.
+
+* Export...
+
+Select a custom parser from the list, click the '''Export...''' button and enter or select a file in the opened file dialog to export the custom parser. Note that if an existing file containing custom parsers is selected, the custom parser will be appended to the file.
+
+=== Opening a trace using a custom parser ===
+
+Once a custom parser has been created, any [[#Importing Traces in a Project|imported trace]] file can be opened and parsed using it.
+
+To do so:
+
+* Select a trace in the '''Project Explorer''' view
+* Right-click the trace and select '''Select Trace Type...''' &gt; '''Custom Text''' or '''Custom XML''' &gt; ''parser name''
+* Double-click the trace or right-click it and select '''Open'''
+
+The trace will be opened in an editor showing the events table, and an entry will be added for it in the Time Chart view.
+
+== LTTng Tracer Control ==
+
+The LTTng Tracer Control in Eclipse for the LTTng Tracer toolchain version v2.0 (or later) is done using SSH and requires an SSH server to be running on the remote host. For the SSH connection the SSH implementation of RSE is used. For that a new System Type was defined using the corresponding RSE extension. The functions to control the LTTng tracer (e.g. start and stop), either locally or remotely, are available from a dedicated Control View.
+
+In the following sections the LTTng 2.0 tracer control integration in Eclipse is described. Please refer to the LTTng 2.0 tracer control command line manual for more details and descriptions about all commands and their command line parameters [[#References | References]].
+
+=== Control View ===
+To open the Control View, select '''Window->Show View->Other...->LTTng->Control View''.
+
+[[Image:images/LTTngControlView.png]]
+
+==== Creating a New Connection to a Remote Host ====
+
+To connect to a remote host, select the '''New Connection''' button in the Control View.
+
+[[Image:images/LTTngControlViewConnect.png]]
+
+A new display will show for entering the remote host information. A drop down menu will filled with all existing host information which were used before. To enter the host information either select one of the hosts in the drop down menu or enter the host information manually.
+
+[[Image:images/LTTng2NewConnection.png]]
+
+To use an existing connection definition, select the relevant entry in the drop-down menu and then select '''Ok'''.
+
+[[Image:images/LTTng2SelectConnection.png]]
+
+To enter the host information manually select first the button '''Edit connection information'''. Then the text fields '''Connection Name''' and '''Host Name''' will enabled. Enter the relevant information and then select '''Ok'''.
+
+[[Image:images/LTTng2EditConnection.png]]
+
+A new display will show for providing the user name and password. This display only opens if no password had been saved before. Enter user name and password in the '''Enter Password''' dialog box and select '''Ok'''.
+
+The '''Host Name''' holds the IP address or DNS name of the remote system.
+The '''Connection Name''' is the alias name to be displayed in the Control View.
+
+[[Image:images/LTTng2EnterPassword.png]]
+
+After pressing '''Ok''' the SSH connection will be established and after successful login the Control View implementation retrieves the LTTng Tracer Control information. This information will be displayed in the Control View in form of a tree structure.
+
+[[Image:images/LTTng2ControlViewFilled.png]]
+
+The top level tree node is the representation of the remote connection (host). The connection name of the connection will be displayed. Depending on the connection state different icons are displayed. If the node is '''CONNECTED''' the icon is shown [[Image:images/Target_connected.gif]], otherwise (states '''CONNECTING''', '''DISCONNNECTING''' or '''DISCONNECTED''' the icon is [[Image:images/Target_disconnected.gif]].
+
+Under the host level two folder groups are located. The first one is the '''Provider''' group. The second one is the '''Sessions''' group.
+
+Under the '''Provider''' group all trace providers are displayed. Trace providers are '''Kernel''' and any user space application that supports UST tracing. Under each provider a corresponding list of events are displayed.
+
+Under the '''Sessions''' group all current sessions will be shown. The level under the sessions show the configured domains. Currently the LTTng 2.0 Tracer Toolchan supports domain '''Kernel''' and '''UST global'''. Under each domain the configured channels will be displayed. The last level is under the channels where the configured events are displayed.
+
+Each session can be '''ACTIVE''' or '''INACTIVE'''. Active means that tracing has been started, inactive means that the tracing has been stopped. Depending on the state of a session a different icon is displayed. The icon for an active session is [[Image:images/Session_active.gif]]. The icon for an inactive session is [[Image:images/Session_inactive.gif]].
+
+Each channel can be '''ENABLED''' or '''DISABLED'''. An enabled channel means that all configured events of that channel will be traced and a disabled channel won't trace any of its configured events. Different icons are displayed depending on the state of the channel. The icon for an enabled channel is [[Image:images/Channel.gif]] and the icon for a disabled channel is [[Image:images/Channel_disabled.gif]].
+
+Events within a channel can be in state '''ENABLED''' or '''DISABLED'''. Enabled events are stored in the trace when passed during program execution. Disabled events on the other hand won't be traced. Depending on the state of the event the icons for the event is different. An enabled event has the icon [[Image:images/Event_enabled.gif]] and a disabled event the icon [[Image:images/Event_disabled.gif]].
+
+==== Disconnecting from a Remote Host ====
+
+To disconnect from a remote host, select the host in the Control View and press the '''Disconnect''' button. Alternatively, press the right mouse button. A context-sensitive menu will show. Select the '''Disconnect''' button.
+
+[[Image:images/LTTng2ControlViewDisconnect.png]]
+
+==== Connecting to a Remote Host ====
+
+To connect to a remote host, select the host in the Control View and press the '''Connect''' button. Alternatively, press the right mouse button. A context-sensitive menu will show. Select the '''Connect''' button. This will start the connection process as discribed in [[#Creating a New Connection to a Remote Host | Creating a New Connection to a Remote Host]].
+
+[[Image:images/LTTng2ControlViewConnect.png]]
+
+==== Deleting to a Remote Host Connection ====
+
+To delete a remote host connection, select the host in the Control View and press the '''Delete''' button. Alternatively, press the right mouse button. A context-sensitive menu will show. Select the '''Delete''' button. For that command to be active the connection state has to be '''DISCONNECTED'''.
+
+[[Image:images/LTTng2ControlViewDelete.png]]
+
+==== Creating a Tracing Session ====
+To create a tracing session, select the tree node '''Sessions''' and press the right mouse button. Then select the '''Create Session...''' button of the context-sensitive menu.
+
+[[Image:images/LTTng2CreateSessionAction.png]]
+
+A dialog box will open for entering information about the session to be created.
+
+[[Image:images/LTTng2CreateSessionDialog.png]]
+
+Fill in the '''Session Name''' and optionally the '''Session Path''' and press '''Ok'''. Upon successful operation a new session will be created and added under the tree node '''Sessions'''.
+
+==== Enabling Channels - General ====
+
+Enabling channels can be done using a session tree node when the domain hasn't be created in the session or, alternatively on a domain tree node of a session in case the domain is already available.
+
+==== Enabling Channels On Session Level ====
+
+To enable a channel, select the tree node of the relevant session and press the right mouse button. Then select the '''Enable Channel...''' button of the context-sensitive menu.
+
+[[Image:images/LTTng2CreateChannelAction.png]]
+
+A dialog box will open for entering information about the channel to be created.
+
+[[Image:images/LTTng2CreateChannelDialog.png]]
+
+By default the domain '''Kernel''' is selected and the corresponding default values are shown. To create a UST channel, select '''UST''' under the domain section. To get the default values of UST, then press button '''Default'''.
+
+If required update the following channel information and then press '''Ok'''.
+
+* '''Channel Name''': The name of the channel.
+* '''Number of Sub Buffers''': The number of sub-buffers of the channel.
+* '''Overwrite Mode''': The channel overwrite mode ('''true''' or '''false''')
+* '''Read Timer Interval''': The read timer interval.
+* '''Sub Buffer size''': The size of the sub-buffers of the channel (in bytes).
+* '''Switch Timer Interval''': The switch timer interval.
+
+Upon successful operation, the requested domain will be created under the session tree node as well as the requested channel will be added under the domain. The channel will be '''ENABLED'''.
+
+==== Enabling Channels On Domain Level ====
+
+Once a domain is available, channels can be enabled directly using the domain. To enable a channel under an existing domain, select the tree node of the relevant domain and press the right mouse button. Then select the '''Enable Channel...''' button of the context-sensitive menu.
+
+[[Image:images/LTTng2CreateChannelOnDomainAction.png]]
+
+The dialog box for enabling channel will open for entering information about the channel to be created. Note that the domain is pre-selected and cannot be changed.
+
+[[Image:images/LTTng2CreateChannelOnDomainDialog.png]]
+
+Fill the relevant information and press '''Ok'''.
+
+==== Enabling and Disabling Channels ====
+
+To disable one or more enabled channels, select the tree nodes of the relevant channels and press the right mouse button. Then select the '''Disable Channel''' menu item of the context-sensitive menu.
+
+[[Image:images/LTTng2DisableChannelAction.png]]
+
+Upon successful operation, the selected channels will be '''DISABLED''' and the icons for the channels will be updated.
+
+To enable one or more disabled channels, select the tree nodes of the relevant channels and press the right mouse button. Then select the '''Enable Channel''' menu item of the context-sensitive menu.
+
+[[Image:images/LTTng2EnableChannelAction.png]]
+
+Upon successful operation, the selected channels will be '''ENABLED''' and the icons for the channels will be updated.
+
+==== Enabling Events - General ====
+
+Enabling events can be done using different levels in the tree node. It can be done on the session, domain level and channel level. For the case of session or domain, i.e. when no specific channels is assigned then enabling of events is done on the default channel with the name '''channel0''' which created, if not already exists, by the LTTng tracer control on the server side.
+
+==== Enabling Kernel Events On Session Level ====
+
+To enable events, select the tree node of the relevant session and press the right mouse button. Then select the '''Enable Event (default channel)...''' button of the context-sensitive menu.
+
+[[Image:images/LTTng2EventOnSessionAction.png]]
+
+A dialog box will open for entering information about events to be enabled.
+
+[[Image:images/LTTng2EventOnSessionDialog.png]]
+
+By default the domain '''Kernel''' is selected and the kernel specific data sections are created. From this dialog box kernel '''Tracepoint''' events, '''System calls (Syscall)''', a '''Dynamic Probe''' or a '''Dynamic Function entry/return''' probe can be enabled. Note that events of one of these types at a time can be enabled.
+
+To enable '''Tracepoint''' events, first select the corresponding '''Select''' button, then select either all tracepoins (select '''All''') or select selectively one or more tracepoints in the displayed tree of tracepoints and finally press '''Ok'''.
+
+[[Image:images/LTTng2TracepointEventsDialog.png]]
+
+Upon successful operation, the domain '''Kernel''' will be created in the tree (if neccessary), the default channel with name "channel0" will be added under the domain (if necessary) as well as all requested events of type '''TRACEPOINT''' under the channel. The channel and events will be '''ENABLED'''.
+
+[[Image:images/LTTng2EnabledKernelTracepoints.png]]
+
+To enable all '''Syscalls''', select the corresponding '''Select''' button and press '''Ok'''.
+
+[[Image:images/LTTng2SyscallsDialog.png]]
+
+Upon successful operation, the event with the name '''syscalls''' and event type '''SYSCALL''' will be added under the default channel (channel0). If necessary the domain '''Kernel''' and the channel '''channel0''' will be created.
+
+[[Image:images/LTTng2EnabledKernelSyscalls.png]]
+
+To enable a '''Dynamic Probe''' event, select the corresponding '''Select''' button, fill the '''Event Name''' and '''Probe''' fields and press '''Ok'''. Note that the probe can be an address, symbol or a symbol+offset where the address and offset can be octal (0NNN...), decimal (NNN...) or hexadecimal (0xNNN...).
+
+[[Image:images/LTTng2ProbeEventDialog.png]]
+
+Upon successful operation, the dynamic probe event with the given name and event type '''PROBE''' will be added under the default channel (channel0). If necessary the domain '''Kernel''' and the channel '''channel0''' will be created.
+
+[[Image:images/LTTng2EnabledKernelProbeEvent.png]]
+
+To enable a '''Dynamic Function entry/return Probe''' event, select the corresponding '''Select''' button, fill the '''Event Name''' and '''Function''' fields and press '''Ok'''. Note that the funtion probe can be an address, symbol or a symbol+offset where the address and offset can be octal (0NNN...), decimal (NNN...) or hexadecimal (0xNNN...).
+
+[[Image:images/LTTng2FunctionEventDialog.png]]
+
+Upon successful operation, the dynamic function probe event with the given name and event type '''PROBE''' will be added under the default channel (channel0). If necessary the domain '''Kernel''' and the channel '''channel0''' will be created.
+
+[[Image:images/LTTng2EnabledFunctionProbeEvent.png]]
+
+==== Enabling UST Events On Session Level ====
+
+For enabling UST events, first open the enable events dialog as described in section [[#Enabling Kernel Events On Session Level | Enabling Kernel Events On Session Level]] and select domain '''UST'''.
+
+To enable '''Tracepoint''' events, first select the corresponding '''Select''' button, then select either all tracepoins (select '''All''') or select selectively one or more tracepoints in the displayed tree of tracepoints and finally press '''Ok'''.
+
+[[Image:images/LTTng2UstTracepointEventsDialog.png]]
+
+Upon successful operation, the domain '''UST global''' will be created in the tree (if neccessary), the default channel with name "channel0" will be added under the domain (if necessary) as well as all requested events under the channel. The channel and events will be '''ENABLED'''. Note that for the case that '''All''' tracepoints were selected the wildcard '''*''' is used which will be shown in the Control View as below.
+
+[[Image:images/LTTng2EnabledAllUstTracepoints.png]]
+
+For UST it is possible to enable '''Tracepoint''' events using a wildcard. To enable '''Tracepoint''' events with a wildcard, select first the corresponding '''Select''' button, fill the '''Wildcard''' field and press '''Ok'''.
+
+[[Image:images/LTTng2UstWildcardEventsDialog.png]]
+
+Upon successful operation, the event with the given wildcard and event type '''TRACEPOINT''' will be added under the default channel (channel0). If necessary the domain '''UST global''' and the channel '''channel0''' will be created.
+
+[[Image:images/LTTng2EnabledUstWildcardEvents.png]]
+
+For UST it is possible to enable '''Tracepoint''' events using log levels. To enable '''Tracepoint''' events using log levels, select first the corresponding '''Select''' button, select a log level from the drop down menu, fill in the relevant information (see below) and press '''Ok'''.
+
+* '''Event Name''': Name to display
+* '''loglevel''': To specify if a range of log levels (0 to selected log level) shall be configured
+* '''loglevel-only''': To specify that only the specified log level shall be configured
+
+[[Image:images/LTTng2UstLoglevelEventsDialog.png]]
+
+Upon successful operation, the event with the given event name and event type '''TRACEPOINT''' will be added under the default channel (channel0). If necessary the domain '''UST global''' and the channel '''channel0''' will be created.
+
+[[Image:images/LTTng2EnabledUstLoglevelEvents.png]]
+
+==== Enabling Events On Domain Level ====
+
+Kernel events can also be enabled on the domain level. For that select the relevant domain tree node, click the right mouse button and the select '''Enable Event (default channel)...'''. A new dialog box will open for providing information about the events to be enabled. Depending on the domain, '''Kernel''' or '''UST global''', the domain specifc fields are shown and the domain selector is preselected and read-only.
+
+[[Image:images/LTTng2EventOnDomainAction.png]]
+
+To enable events for domain '''Kernel''' follow the instructions in section [[#Enabling Kernel Events On Session Level | Enabling Kernel Events On Session Level]], for domain '''UST global''' [[#Enabling UST Events On Session Level | Enabling UST Events On Session Level]].
+
+When enabling events on the domain level, the events will be add to the default channel '''channel0'''. This channel will be created by on the server side if neccessary.
+
+==== Enabling Events On Channel Level ====
+
+Kernel events can also be enabled on the channel level. If necessary, create a channel as described in sections [[#Enabling Channels On Session Level | Creating Channels On Session Level]] or [[#Enabling Channels On Domain Level | Creating Channels On Domain Level]].
+
+Then select the relevant channel tree node, click the right mouse button and the select '''Enable Event...'''. A new dialog box will open for providing information about the events to be enabled. Depending on the domain, '''Kernel''' or '''UST global''', the domain specifc fields are shown and the domain selector is preselected and read-only.
+
+[[Image:images/LTTng2EventOnChannelAction.png]]
+
+To enable events for domain '''Kernel''' follow the instructions in section [[#Enabling Kernel Events On Session Level | Enabling Kernel Events On Session Level]], for domain '''UST global''' [[#Enabling UST Events On Session Level | Enabling UST Events On Session Level]].
+
+When enabling events on the channel level, the events will be add to the selected channel.
+
+==== Enabling and Disabling Events ====
+
+To disable one or more enabled events, select the tree nodes of the relevant events and click the right mouse button. Then select '''Disable Event''' menu item in the context-sensitive menu.
+
+[[Image:images/LTTng2DisableEventAction.png]]
+
+Upon successful operation, the selected events will be '''DISABLED''' and the icons for these events will be updated.
+
+To enable one or more disabled events, select the tree nodes of the relevant events and press the right mouse button. Then select the '''Enable Event''' menu item of the context-sensitive menu.
+
+[[Image:images/LTTng2EnableEventAction.png]]
+
+Upon successful operation, the selected events will be '''ENABLED''' and the icons for these events will be updated.
+
+'''Note''': There is currently a limitation for kernel event of type '''SYSCALL'''. This kernel event can not be disabled. An error will appear when trying to disable this type of event. A work-around for that is to have the syscall event in a separate channel and disable the channel instead of the event.
+
+==== Enabling Tracepoint Events From Provider ====
+
+It is possible to enable events of type '''Tracepoint''' directly from the providers and assign the enabled event to a session and channel. Before doing that a session has to be created as described in section [[#Creating a Tracing Session | Creating a Tracing Session]]. Also, if other than default channel '''channel0''' is required, create a channel as described in sections [[#Enabling Channels On Session Level | Creating Channels On Session Level]] or [[#Enabling Channels On Domain Level | Creating Channels On Domain Level]].
+
+To assign tracepoint events to a session and channel, select the events to be enabled under the provider (e.g. provider '''Kernel'''), click right mouse button and then select '''Enable Event...''' menu item from the context sensitive menu.
+
+[[Image:images/LTTng2AssignEventAction.png]]
+
+A new display will open for defining the session and channel.
+
+[[Image:images/LTTng2AssignEventDialog.png]]
+
+Select a session from the '''Session List''' drop-down menu, a channel from the '''Channel List''' drop-down menu and the press '''Ok'''. Upon successful operation, the selected events will be added to the selected session and channel of the domain that the selected provider belongs to. In case that there was no channel available, the domain and the default channel '''channel0''' will be created for corresponding session. The newly added events will be '''ENABLED'''.
+
+[[Image:images/LTTng2AssignedEvents.png]]
+
+==== Adding Contexts to Channels and Events of a Domain ====
+
+It is possible to add contexts to channels and events. Adding contexts on channels and events from the domain level, will enable the specified contexts to all channels of the domain and all their events. To add contexts on the domain level, select a domain, click right mouse button on a domain tree node (e.g. provider '''Kernel''') and select the menu item '''Add Context...''' from the context-sensitive menu.
+
+[[Image:images/LTTng2AddContextOnDomainAction.png]]
+
+A new display will open for selecting one or more contexts to add.
+
+[[Image:images/LTTng2AddContextDialog.png]]
+
+The tree shows all available context that can be added. Select one or more context and the press '''Ok'''. Upon successful operation, the selected context will be added to all channels and their events of the selected domain.
+
+'''Note''': The LTTng UST tracer only supports contexts '''procname''', '''pthread_id''', '''vpid''' '''vtid'''. Adding any other contexts in the UST domina will fail.
+
+==== Adding Contexts to All Events of a Channel ====
+
+Adding contexts on channels and events from the channel level, will enable the specified contexts to all events of the selected channel. To add contexts on the channel level, select a channel, click right mouse button on a channel tree node and select the menu item '''Add Context...''' from the context-sensitive menu.
+
+[[Image:images/LTTng2AddContextOnChannelAction.png]]
+
+A new display will open for selecting one or more contexts to add. Select one or more contexts as described in chapter [[#Adding Contexts to Channels and Events of a Domain | Adding Contexts to Channels and Events of a Domain]]. Upon successful operation, the selected context will be added to all channels and their events of the selected domain. '''Note''' that the LTTng 2.0 tracer control on the remote host doesn't provide a way to retrieve added contexts. Hence it's not possible to display the context information in the GUI.
+
+==== Adding Contexts to a Event of a Specific Channel ====
+
+Adding contexts to a event of a channel, select an event of a channel, click right mouse button on the corresponding event tree node and select the menu item '''Add Context...''' from the context-sensitive menu.
+
+[[Image:images/LTTng2AddContextToEventsAction.png]]
+
+A new display will open for selecting one or more contexts to add. Select one or more contexts as described in chapter [[#Adding Contexts to Channels and Events of a Domain | Adding Contexts to Channels and Events of a Domain]]. Upon successful operation, the selected context will be added to the selected event.
+
+==== Start Tracing ====
+
+To start tracing, select one or more sessions to start in the Control View and press the '''Start''' button. Alternatively, press the right mouse button on the session tree nodes. A context-sensitive menu will show. Then select the '''Start''' menu item.
+
+[[Image:images/LTTng2StartTracingAction.png]]
+
+Upon successful operation, the tracing session will be '''ACTIVE''' and the icon of the session will be updated.
+
+==== Stop Tracing ====
+
+To stop tracing, select one or more sessions to stop in the Control View and press the '''Stop''' button. Alternatively, click the right mouse button on the session tree nodes. A context-sensitive menu will show. Then select the '''Stop''' menu item.
+
+[[Image:images/LTTng2StopTracingAction.png]]
+
+Upon successful operation, the tracing session will be '''INACTIVE''' and the icon of the session will be updated.
+
+==== Destroying a Tracing Session ====
+
+To destroy a tracing session, select one or more sessions to destroy in the Control View and press the '''Destroy''' button. Alternatively, click the right mouse button on the session tree node. A context-sensitive menu will show. Then select the '''Destroy...''' menu item. Note that the session has to be '''INACTIVE''' for this operation.
+
+[[Image:images/LTTng2DestroySessionAction.png]]
+
+A confirmation dialog box will open. Click on '''Ok''' to destroy the session otherwise click on '''Cancel'''.
+
+[[Image:images/LTTng2DestroyConfirmationDialog.png]]
+
+Upon successful operation, the tracing session will be destroyed and removed from the tree.
+
+==== Refreshing the Node Information ====
+
+To refresh the remote host information, select any node in the tree of the Control View and press the '''Refresh''' button. Alternatively, click the right mouse button on any tree node. A context-sensitive menu will show. Then select the '''Refresh''' menu item.
+
+[[Image:images/LTTng2RefreshAction.png]]
+
+Upon successful operation, the tree in the Control View will be refreshed with the remote host configuration.
+
+==== Quantifing LTTng overhead (Calibrate) ====
+
+The LTTng calibrate command can be used to find out the combined average overhead of the LTTng tracer and the instrumentation mechanisms used. For now, the only calibration implemented is that of the kernel function
+instrumentation (kretprobes). To run the calibrate command, select the a domain (e.g. '''Kernel'''), click the right mouse button on the domain tree node. A context-sensitive menu will show. Select the '''Calibrate''' menu item.
+
+[[Image:images/LTTng2CalibrateAction.png]]
+
+Upon successful operation, the calibrate command is executed and relevant information is stored in the trace. Note: that the trace has to be active so that to command as any effect.
+
+==== Importing Session Traces to a Tracing Project ====
+
+To import traces from a tracing session, select the relevant session and click on the '''Import''' Button. Alternatively, click the right mouse button on the session tree node and select the menu item '''Import...''' from the context-sensitive menu.
+
+[[Image:images/LTTng2ImportAction.png]]
+
+A new display will open for selecting the traces to import.
+
+[[Image:images/LTTng2ImportDialog.png]]
+
+Select the trace to be imported by selecting the relevant traces in the tree viewer, select a tracing project from the '''Available Projects''' combo box and select the Overwrite button ('''Overwrite existing trace without warning''') if required. Then press button '''Ok'''. Upon successful import operation the the selected traces will be stored in the '''Traces''' directory of the specified tracing project. From the '''Project Explorer''' view, the trace can be analyzed further.
+
+'''Note''': If the overwrite button ('''Overwrite existing trace without warning''') was not selected and a trace with the same name of a trace to be imported already exists in the project, then a new confirmation dialog box will open.
+
+[[Image:images/LTTng2ImportOverwriteConfirmationDialog.png]]
+
+To Overwrite select the '''Overwrite''' Button and press '''Ok'''.
+
+If the existing trace should not be overwritten select, then select the '''Rename''' option of the confirmation dialog box above, enter a new name and then press '''Ok'''.
+
+[[Image:images/LTTng2ImportRenameDialog.png]]
+
+=== Properties View ===
+
+The Control View provides property information of selected tree component. Depending on the selected tree component different properties are displayed in the property view. For example, when selecting the node level the property view will be filled as followed:
+
+[[Image:images/LTTng2PropertyView.png]]
+
+'''List of properties''':
+
+* '''Host''' Properties
+** '''Connection Name''': The alias name to be displayed in the Control View.
+** '''Host Name''': The IP address or DNS name of the remote system.
+** '''State''': The state of the connection ('''CONNECTED''', '''CONNECTING''', '''DISCONNNECTING''' or '''DISCONNECTED''').
+* '''Kernel Provider''' Properties
+** '''Provider Name''': The name of the provider.
+* '''UST Provider''' Properties
+** '''Provider Name''': The name of the provider.
+** '''Process ID''': The process ID of the provider.
+* '''Event''' Properties (Provider)
+** '''Event Name''': The name of the event.
+** '''Event Type''': The event type ('''TRACEPOINT''' only).
+** '''Log Level''': The log level of the event.
+* '''Session''' Properties
+** '''Session Name''': The name of the Session.
+** '''Session Path''': The path on the remote host where the traces will be stored.
+** '''State''': The state of the session ('''ACTIVE''' or '''INACTIVE''')
+* '''Domain''' Properties
+** '''Domain Name''': The name of the domain.
+* '''Channel''' Properties
+** '''Channel Name''': The name of the channel.
+** '''Number of Sub Buffers''': The number of sub-buffers of the channel.
+** '''Output type''': The output type for the trace (e.g. ''splice()'' or ''mmap()'')
+** '''Overwrite Mode''': The channel overwrite mode ('''true''' for overwrite mode, '''false''' for discard)
+** '''Read Timer Interval''': The read timer interval.
+** '''State''': The channel state ('''ENABLED''' or '''DISABLED''')
+** '''Sub Buffer size''': The size of the sub-buffers of the channel (in bytes).
+** '''Switch Timer Interval''': The switch timer interval.
+* '''Event''' Properties (Channel)
+** '''Event Name''': The name of the event.
+** '''Event Type''': The event type ('''TRACEPOINT''', '''SYSCALL''' or '''PROBE''')..
+** '''Log Level''': The log level of the event.
+** '''State''': The Event state ('''ENABLED''' or '''DISABLED''')
+
+=== LTTng Tracer Control Preferences ===
+
+Serveral LTTng 2.0 tracer control preferences exists which can be configured. To configure these preferences, select '''Window->Preferences''' from the top level menu. The preference display will open. Then select '''Tracing->LTTng Tracer Control Preferences'''. This preferences page allows the user to specify the tracing group of the user and allows the user to configure the logging of LTTng 2.0 tracer control commands and results to a file.
+
+[[Image:images/LTTng2Preferences.png]]
+
+To change the tracing group of the user which will be specified on each command line, enter the new group name in the '''Tracing Group''' text field and click ok. The default tracing group is '''tracing''' and can be restored by pressing the '''Restore Defaults''' button.
+
+[[Image:images/LTTng2PreferencesGroup.png]]
+
+To configure logging of trace control commands and the corresponding command result to a file, selected the button '''Logging'''. To append to an existing log file, select the '''Append''' button. Deselect the '''Append''' button to overwrite any existing log file. It's possible to specify a verbose level. There are 3 levels with inceasing verbosity from '''Level 1''' to '''Level 3'''. To change the verbosity level, select the relevant level or select '''None'''. If '''None''' is selected only commands and command results are logged. Then press on button '''Ok'''. The log file will be stored in the users home directory with the name ''lttng_tracer_control.log''. The name and location cannot be changed. To reset to default preferences, click on the button '''Restore Defaults'''.
+
+[[Image:images/LTTng2PreferencesLogging.png]]
+
+= LTTng Kernel Analysis =
+
+Historically, LTTng was developped to trace the Linux kernel and, over time, a number of kernel-oriented analysis views were developped and organized in a perspective.
+
+This section presents a description of the LTTng Kernel Perspective.
+
+== LTTng Kernel Perspective ==
+
+The '''LTTng Kernel''' perspective is built upon the [[#Tracing_Perspective | Tracing Perspective]], re-organizes them slightly and adds the following views:
+
+* [[#Control_Flow_View | Control Flow View]] - to visualize processes state transitions
+* [[#Resources_View | Resources View]] - to visualize system resources state transitions
+
+
+[[Image:images/LTTngKernelPerspective.png]]
+
+
+The perspective can be opened from the Eclipse Open Perspective dialog ('''Window > Open Perspective... > Other''').
+
+
+[[Image:images/OpenLTTngKernelPerspective.png]]
+
+== Control Flow View ==
+
+The '''''Control Flow View''''' is a LTTng-specific view that shows per-process events graphically. To enable it, select ''Control Flow'' under ''LTTng'' within the ''Show View'' window ('''Window''' -> '''Show View''' -> '''Other...'''):
+
+[[Image:images/Cfv_show_view.png]]
+
+You should get something like this:
+
+[[Image:images/Cfv_global.png]]
+
+The view is divided into the following important sections: '''<span style="color: #C84545;">process tree</span>''', '''<span style="color: #A1C81A;">process TID, PTID and birth time</span>''', '''<span style="color: #67A3DC;">states flow</span>''' and the '''<span style="color: #AD77D7;">toolbar</span>'''.
+
+The following sections provide detailed information for each part of the Control Flow View.
+
+=== Process tree and informations ===
+
+Processes are organized as a tree within this view. This way, child and parent processes are easy to identify.
+
+[[Image:images/Cfv_process_tree.png]]
+
+The layout is based on the states computed from the trace events.
+
+A given process may be shown at different places within the tree since the nodes are '''unique (TID, birth time) couples'''. This means that if process B of parent A dies, you'll still see it in the tree. If process A forks process B again, it will be shown as a different node since it won't have the same birth time (and probably not the same TID). This has the advantage that the tree, once loaded, never changes: horizontal scrolling within the [[#States flow|states flow]] remains possible.
+
+The TID column shows the process node's '''thread ID''' and the PTID column shows its '''parent thread ID''' (nothing is shown if the process has no parent).
+
+=== States flow ===
+
+This part of the Control Flow View is probably the most interesting one. Using the mouse, you can navigate through the trace (go left, right) and zoom on a specific region to inspect its details.
+
+The colored bars you see represent '''states''' for the associated process node. When a process state changes in time, so does the color. States colors legend is available through a [[#Toolbar|toolbar button]]:
+
+[[Image:images/Cfv_legend.png]]
+
+This dark yellow is what you'll see most of the time since scheduling puts processes on hold while others run.
+
+The vertical blue line is the '''current time indicator'''.
+
+==== Using the mouse ====
+
+The states flow is usable with the mouse. The following actions are set:
+
+* '''drag horizontally''': pan left or right
+* '''click on a colored bar''': the associated process node is selected and the current time indicator is moved where the click happened
+* '''mouse wheel up/down''': zoom in or out
+* '''drag the time ruler horizontally''': zoom in or out
+* '''drag the time ruler horizontally with the right button''': [[#Zoom region|zoom region]]
+* '''double-click the time ruler''': reset zoom
+
+When the current time indicator is changed (when clicking in the states flow), all the other views are '''synchronized'''. For example, the [[#Events_View_2|Events View]] will show the event matching the current time indicator. The reverse behaviour is also implemented: selecting an event within the Events View will update the Control Flow View current time indicator.
+
+==== Incomplete regions ====
+
+You'll notice '''small dots''' over the colored bars at some places:
+
+[[Image:images/Cfv_small_dots.png]]
+
+Those dots mean the underlying region is '''incomplete''': there's not enough pixels to view all the events. In other words, you have to zoom in.
+
+When zooming in, small dots start to disappear:
+
+[[Image:images/Cfv_zoom.png]]
+
+When no dots are left, you are viewing '''all the events and states''' within that region.
+
+==== Zoom region ====
+
+To zoom in on a specific region, '''right-click and drag the time ruler''' in order to draw a time range:
+
+[[Image:images/Cfv_zoom_region.png]]
+
+The states flow horizontal space will only show the selected region.
+
+==== Tooltips ====
+
+Hover the cursor over a colored bar and a '''tooltip''' will pop up:
+
+[[Image:images/Cfv_tooltip.png]]
+
+The tooltip indicates:
+
+* the process name
+* the pointed state name
+* the pointed state date and start/stop times
+* the pointed state duration (seconds)
+
+=== Toolbar ===
+
+The Control Flow View '''toolbar''', located at the top right of the view, has shortcut buttons to perform common actions:
+
+[[Image:images/Cfv_toolbar.png]]
+
+The '''Previous event''' and '''Next event''' buttons update the current time indicator so that it's on the previous or next event.
+
+The '''Previous process''' and '''Next process''' buttons select the previous and next process node within the process tree.
+
+== Resources View ==
+This view is specific to kernel trace. To open it, go in '''Window''' -> '''Show View''' -> '''Other...''' and select '''LTTng/Resources''' in the list.
+
+[[Image:images/Rv example.png| Example of resources view with all trace points and syscalls enabled]]
+
+This view shows the state of system resources i.e. if changes occured during the trace either on '''CPUs''', '''IRQs''' or '''soft IRQs''', it will appear in this view. The left side of the view present a list of resources that are affected by at least one event of the trace. The right side illustrate the state in which each resource is at some point in time.
+
+Just like other views, according to which trace points and system calls are activated, the content of this view may change from one trace to another.
+
+Each state are represented by one color so it is faster to say what is happening.
+
+[[Image:images/Rv_legend.png|Color for each state]]
+
+To go through the state of a resource, you first have to select the resource and the timestamp that interest you. For the latter, you can pick some time before the interesting part of the trace.
+
+[[Image:images/RV_infobox1.png|Shows the state of an IRQ]]
+
+Then, by selecting '''Next Event''', it will show the next state transition and the event that occured at this time.
+
+[[Image:images/RV_infobox2.png|Shows the next state of the IRQ]]
+
+This view is also synchronized with the others : [[#Histogram_View | histogram]], [[#Events_View_2 | events view]], [[#Control_Flow_View | control flow view]], etc.
+
+=== Navigation ===
+
+See Control Flow View's '''[[#Using_the_mouse|Using the mouse]]''' and '''[[#Zoom_region|Zoom region]]'''.
+
+=== Incomplete regions ===
+
+See Control Flow View's '''[[#Incomplete_regions|Incomplete regions]]'''.
+
+=== Toolbar ===
+
+See Control Flow View's '''[[#Toolbar|Toolbar]]'''.
+
+== Events View ==
+
+The LTTng Kernel Events View '''is''' the plain TMF [[#Events_View | Events Views]] except that it provide its own specialized viewer to replace the standard one. In short, it has exactly the same behaviour but the layout is slightly different:
+
+* '''Timestamp''': the event timestamp
+* '''Channel''': the event channel (data collector)
+* '''Event Type''': the event type (or kernel marker)
+* '''Content''': the raw event content
+
+
+[[Image:images/LTTngKernelEventsViewer.png]]
+
+= Limitations =
+
+TBD
+
+= How to use LTTng to diagnose problems =
+
+LTTng is a tracer, it will give an enormous amount of information about the system it is running on. This means it can solve many types of problems.
+
+The following are examples of problems that can be solved with a tracer.
+
+== Random stutters ==
+
+Bob is running a computer program and it stutters periodically every 2 minutes. The CPU load is relatively low and Bob isn't running low on RAM.
+
+He decides to trace his complete system for 10 minutes. He opens the LTTng view in eclipse. From the control, he creates a session and enables all kernel tracepoints.
+
+He now has a 10 GB trace file. He imports the trace to his viewer and loads it up.
+
+A cursory look at the histogram bar on the bottom show relatively even event distribution, there are no interesting spikes, so he will have to dig deeper to find the issue. If he had seen a spike every 2 minutes, there would be strong chances this would be the first thing to investigate as it would imply a lot of kernel activity at the same period as his glitch, this would have been a path to investigate.
+
+As Bob suspects that he may be having some hardware raising IRQs or some other hardware based issue and adding delays. He looks at the ressource view and doesn't see anything abnormal.
+
+Bob did note an exact second one glitch occured: 11:58:03. He zooms into the time range or 11:58:02-11:58:04 using the histogram.He is happy to see the time is human readable local wall clock time and no longer in "nanseconds since the last reboot". <br>In the resource view, once again, he sees many soft irqs being raised at the same time, around the time his gui would freeze. He changes views and looks at the control flow view at that time and sees a process spending a lot of time in the kernel: FooMonitor- his temperature monitoring software.
+
+At this point he closes FooMonitor and notices the bug dissapeared. He could call it a day but he wants to see what was causing the system to freeze. He cannot justify closing a piece of software without understanding the issue. It may be a conflict that HIS software is causing after all.
+
+The system freezes around the time this program is running. He clicks on the process in the control flow view and looks at the corresponding events in the detailed events view. He sees: open - read - close repeated hundreds of times on the same file. The file being read was /dev/HWmonitor. He sends a report to the FooMonitor team and warns his team that FooMonitor was glitching their performance.
+
+The FooMonitor team finds that they were calling a system bus call that would halt a cpu while reading the temperature so that the core would not induce an 0.1 degree error in the reading, by disabling this feature, they improve their software and stop the glitches from occurring on their custommer's machine. They also optimize their code to open the file read and clone it once.
+
+By using system wide kernel tracing, even without deep kernel knowledge Bob was able to isolate a bug in a rogue piece of software in his system.
+
+== Slow I/O ==
+
+Alice is running her server. She noticed that one of her nodes was slowing down, and wasn't sure why, upon reading the trace she noticed that her time between a block request and complete was around 10ms.
+
+This is abnormal, normally her server handles IOs in under 100us, since they are quite local.
+
+She walks up to the server and hears the hard drive thrashing, This prompts her to look up in the events view the sectors being read in the block complete requests. There are her requests interleaved with other ones at the opposite side of the hard drive.
+
+She sees the tracer writing but there is another process that is writing to the server disk non stop. She looks in the control flow view and sees that there's a program from another fellow engineer, "Wally" that is writing in his home in a loop "All work and no play makes Jack a dull boy.".
+
+Alice kills the program, and immediately the server speeds up. She then goes to discuss this with Wally and implements strict hard disk quotas on the server.
+
+= References =
+
+* [http://www.eclipse.org/linuxtools/projectPages/lttng/ Linux Tools - LTTng integration]
+* [http://www.lttng.org/ LTTng project]
+* [http://lttng.org/files/doc/man-pages/man1/lttng.1.html LTTng 2.0 Tracer Control Command Line Tool]
+* [http://wiki.eclipse.org/Linux_Tools_Project/TMF/User_Guide TMF User Guide]
+
+= 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/index.php/Linux_Tools_Project/LTTng2/User_Guide http://wiki.eclipse.org/Linux_Tools_Project/LTTng2/User_Guide]
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/Bookmarks.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Bookmarks.png
index 7fa0810..7fa0810 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/Bookmarks.png
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Bookmarks.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_global.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_global.png
new file mode 100644
index 0000000..b029041
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_global.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_legend.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_legend.png
new file mode 100644
index 0000000..7401087
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_legend.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_process_tree.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_process_tree.png
new file mode 100644
index 0000000..7f45fbb
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_process_tree.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.png
new file mode 100644
index 0000000..d0fb74d
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_small_dots.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_small_dots.png
new file mode 100644
index 0000000..c0a6704
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_small_dots.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_toolbar.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_toolbar.png
new file mode 100644
index 0000000..93ed6e6
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_toolbar.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_tooltip.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_tooltip.png
new file mode 100644
index 0000000..1a6034b
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_tooltip.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom.png
new file mode 100644
index 0000000..cfcab94
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.png
new file mode 100644
index 0000000..ae64feb
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel.gif
new file mode 100644
index 0000000..e8efe69
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel_disabled.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel_disabled.gif
new file mode 100644
index 0000000..00fa44e
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Channel_disabled.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ColorsView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ColorsView.png
new file mode 100644
index 0000000..892d3a0
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ColorsView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyExperimentDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyExperimentDialog.png
new file mode 100644
index 0000000..8c22c58
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyExperimentDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceAction.png
new file mode 100644
index 0000000..684dcc7
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceDialog.png
new file mode 100644
index 0000000..9a3c92b
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CopyTraceDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserInput.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserInput.png
new file mode 100644
index 0000000..fab35bc
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserInput.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserOutput.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserOutput.png
new file mode 100644
index 0000000..b2105f6
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomTextParserOutput.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserInput.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserInput.png
new file mode 100644
index 0000000..e920f70
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserInput.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserOutput.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserOutput.png
new file mode 100644
index 0000000..e776375
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/CustomXMLParserOutput.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultEventsView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultEventsView.png
new file mode 100644
index 0000000..e976fd9
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultEventsView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Filter.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Filter.png
new file mode 100644
index 0000000..969a5f1
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Filter.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Search.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Search.png
new file mode 100644
index 0000000..d26e9be
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DefaultTmfEvents-Search.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExpSupplementaryFilesDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExpSupplementaryFilesDialog.png
new file mode 100644
index 0000000..35f916c
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExpSupplementaryFilesDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentAction.png
new file mode 100644
index 0000000..696e449
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentConfirmationDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentConfirmationDialog.png
new file mode 100644
index 0000000..99d3edd
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteExperimentConfirmationDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesAction.png
new file mode 100644
index 0000000..9fa0329
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesDialog.png
new file mode 100644
index 0000000..cb85821
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/DeleteSupplementaryFilesDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Environment_variables.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Environment_variables.png
new file mode 100644
index 0000000..31ccfc3
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Environment_variables.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_disabled.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_disabled.gif
new file mode 100644
index 0000000..2966a28
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_disabled.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_enabled.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_enabled.gif
new file mode 100644
index 0000000..11d3d8d
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Event_enabled.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithAssociatedTraceType.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithAssociatedTraceType.png
new file mode 100644
index 0000000..512a0c9
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithAssociatedTraceType.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithExperiment.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithExperiment.png
new file mode 100644
index 0000000..2ec110c
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ExplorerWithExperiment.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/FiltersView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/FiltersView.png
new file mode 100644
index 0000000..931eaac
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/FiltersView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/HistogramView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/HistogramView.png
index 2bd2ef1..2bd2ef1 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/HistogramView.png
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/HistogramView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextDialog.png
new file mode 100644
index 0000000..1c0dd8c
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnChannelAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnChannelAction.png
new file mode 100644
index 0000000..af4c870
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnChannelAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnDomainAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnDomainAction.png
new file mode 100644
index 0000000..ebfac85
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextOnDomainAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextToEventsAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextToEventsAction.png
new file mode 100644
index 0000000..a8c5d6b
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AddContextToEventsAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventAction.png
new file mode 100644
index 0000000..0d0c80a
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventDialog.png
new file mode 100644
index 0000000..86b7c39
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignEventDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignedEvents.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignedEvents.png
new file mode 100644
index 0000000..e6aa621
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2AssignedEvents.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CalibrateAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CalibrateAction.png
new file mode 100644
index 0000000..cf9464f
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CalibrateAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewConnect.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewConnect.png
new file mode 100644
index 0000000..df18cc7
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewConnect.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDelete.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDelete.png
new file mode 100644
index 0000000..95e8f11
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDelete.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDisconnect.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDisconnect.png
new file mode 100644
index 0000000..a2283db
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewDisconnect.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewFilled.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewFilled.png
new file mode 100644
index 0000000..a8e7dfd
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ControlViewFilled.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelAction.png
new file mode 100644
index 0000000..8e09a7e
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelDialog.png
new file mode 100644
index 0000000..592c67a
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainAction.png
new file mode 100644
index 0000000..9a41ef7
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainDialog.png
new file mode 100644
index 0000000..dc2581f
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateChannelOnDomainDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionAction.png
new file mode 100644
index 0000000..87da033
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionDialog.png
new file mode 100644
index 0000000..4a0cf0b
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2CreateSessionDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroyConfirmationDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroyConfirmationDialog.png
new file mode 100644
index 0000000..26c1563
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroyConfirmationDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroySessionAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroySessionAction.png
new file mode 100644
index 0000000..ae4e9f9
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DestroySessionAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableChannelAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableChannelAction.png
new file mode 100644
index 0000000..ec82ae7
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableChannelAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableEventAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableEventAction.png
new file mode 100644
index 0000000..5a9544e
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2DisableEventAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EditConnection.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EditConnection.png
new file mode 100644
index 0000000..27a5991
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EditConnection.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableChannelAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableChannelAction.png
new file mode 100644
index 0000000..a311c33
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableChannelAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableEventAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableEventAction.png
new file mode 100644
index 0000000..dd2997f
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnableEventAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledAllUstTracepoints.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledAllUstTracepoints.png
new file mode 100644
index 0000000..83e8c30
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledAllUstTracepoints.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledFunctionProbeEvent.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledFunctionProbeEvent.png
new file mode 100644
index 0000000..039d775
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledFunctionProbeEvent.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelProbeEvent.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelProbeEvent.png
new file mode 100644
index 0000000..ab41433
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelProbeEvent.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelSyscalls.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelSyscalls.png
new file mode 100644
index 0000000..53458c1
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelSyscalls.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelTracepoints.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelTracepoints.png
new file mode 100644
index 0000000..39fe512
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledKernelTracepoints.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstLoglevelEvents.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstLoglevelEvents.png
new file mode 100644
index 0000000..74aee41
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstLoglevelEvents.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstWildcardEvents.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstWildcardEvents.png
new file mode 100644
index 0000000..ba1469f
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnabledUstWildcardEvents.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnterPassword.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnterPassword.png
new file mode 100644
index 0000000..82441e8
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EnterPassword.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnChannelAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnChannelAction.png
new file mode 100644
index 0000000..52d9712
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnChannelAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnDomainAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnDomainAction.png
new file mode 100644
index 0000000..e7b4805
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnDomainAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionAction.png
new file mode 100644
index 0000000..10cce06
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionDialog.png
new file mode 100644
index 0000000..af952a9
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2EventOnSessionDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2FunctionEventDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2FunctionEventDialog.png
new file mode 100644
index 0000000..82c49b5
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2FunctionEventDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportAction.png
new file mode 100644
index 0000000..ec933af
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportDialog.png
new file mode 100644
index 0000000..9a44b89
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportOverwriteConfirmationDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportOverwriteConfirmationDialog.png
new file mode 100644
index 0000000..5688ac3
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportOverwriteConfirmationDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportRenameDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportRenameDialog.png
new file mode 100644
index 0000000..10e39de
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ImportRenameDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2NewConnection.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2NewConnection.png
new file mode 100644
index 0000000..6f9709f
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2NewConnection.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2Preferences.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2Preferences.png
new file mode 100644
index 0000000..edc5af6
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2Preferences.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesGroup.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesGroup.png
new file mode 100644
index 0000000..84435f5
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesGroup.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesLogging.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesLogging.png
new file mode 100644
index 0000000..fc82a48
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PreferencesLogging.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ProbeEventDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ProbeEventDialog.png
new file mode 100644
index 0000000..0b44eee
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2ProbeEventDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PropertyView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PropertyView.png
new file mode 100644
index 0000000..addf1b1
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2PropertyView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2RefreshAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2RefreshAction.png
new file mode 100644
index 0000000..993eb08
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2RefreshAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SelectConnection.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SelectConnection.png
new file mode 100644
index 0000000..52a15e3
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SelectConnection.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StartTracingAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StartTracingAction.png
new file mode 100644
index 0000000..ccb4a78
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StartTracingAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StatisticsView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StatisticsView.png
new file mode 100644
index 0000000..561da06
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StatisticsView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StopTracingAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StopTracingAction.png
new file mode 100644
index 0000000..a8684d8
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2StopTracingAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SyscallsDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SyscallsDialog.png
new file mode 100644
index 0000000..c94f825
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2SyscallsDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2TracepointEventsDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2TracepointEventsDialog.png
new file mode 100644
index 0000000..55bcc75
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2TracepointEventsDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstLoglevelEventsDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstLoglevelEventsDialog.png
new file mode 100644
index 0000000..bba9206
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstLoglevelEventsDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstTracepointEventsDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstTracepointEventsDialog.png
new file mode 100644
index 0000000..11b08fc
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstTracepointEventsDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstWildcardEventsDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstWildcardEventsDialog.png
new file mode 100644
index 0000000..50d92ab
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng2UstWildcardEventsDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlView.png
new file mode 100644
index 0000000..5258363
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlViewConnect.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlViewConnect.png
new file mode 100644
index 0000000..73fd9c8
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngControlViewConnect.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelEventsViewer.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelEventsViewer.png
new file mode 100644
index 0000000..2902454
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelEventsViewer.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelPerspective.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelPerspective.png
new file mode 100644
index 0000000..e7b363f
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTngKernelPerspective.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ManageCustomParsers.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ManageCustomParsers.png
new file mode 100644
index 0000000..e3fcd91
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ManageCustomParsers.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentAction.png
new file mode 100644
index 0000000..d72b119
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentDialog.png
new file mode 100644
index 0000000..7c12173
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewExperimentDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewProjectExplorer.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewProjectExplorer.png
new file mode 100644
index 0000000..8c644d4
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewProjectExplorer.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage1.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage1.png
new file mode 100644
index 0000000..4c8d484
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage1.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage2.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage2.png
new file mode 100644
index 0000000..a0c958c
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/NewTracingProjectPage2.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenLTTngKernelPerspective.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenLTTngKernelPerspective.png
new file mode 100644
index 0000000..2692689
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenLTTngKernelPerspective.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenTraceAction.png
new file mode 100644
index 0000000..c1a96d4
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/OpenTraceAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceAction.png
new file mode 100644
index 0000000..9406d65
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceDialog.png
new file mode 100644
index 0000000..ffed369
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ProjectImportTraceDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox1.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox1.png
new file mode 100644
index 0000000..f0898c2
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox1.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox2.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox2.png
new file mode 100644
index 0000000..7adae95
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RV_infobox2.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RemoveTracesAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RemoveTracesAction.png
new file mode 100644
index 0000000..611d997
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RemoveTracesAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameExperimentDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameExperimentDialog.png
new file mode 100644
index 0000000..4d648c4
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameExperimentDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceAction.png
new file mode 100644
index 0000000..12da11b
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceDialog.png
new file mode 100644
index 0000000..e1cb4b7
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/RenameTraceDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_example.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_example.png
new file mode 100644
index 0000000..75caf00
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_example.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_legend.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_legend.png
new file mode 100644
index 0000000..2f6e42d
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Rv_legend.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectGenericCTFTraceType.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectGenericCTFTraceType.png
new file mode 100644
index 0000000..de13326
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectGenericCTFTraceType.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectLTTngKernelTraceType.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectLTTngKernelTraceType.png
new file mode 100644
index 0000000..a1a921a
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectLTTngKernelTraceType.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesAction.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesAction.png
new file mode 100644
index 0000000..a1c3157
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesAction.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesDialog.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesDialog.png
new file mode 100644
index 0000000..a766e3a
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/SelectTracesDialog.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_active.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_active.gif
new file mode 100644
index 0000000..57a42bc
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_active.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_inactive.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_inactive.gif
new file mode 100644
index 0000000..13d3f5b
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Session_inactive.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingPerspective.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingPerspective.png
new file mode 100644
index 0000000..cf868f7
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingPerspective.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingViews.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingViews.png
new file mode 100644
index 0000000..fc661e8
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/ShowTracingViews.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_connected.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_connected.gif
new file mode 100644
index 0000000..def312a
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_connected.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_disconnected.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_disconnected.gif
new file mode 100644
index 0000000..8591f40
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Target_disconnected.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TimeChartView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TimeChartView.png
new file mode 100644
index 0000000..0ead584
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TimeChartView.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEventFilter.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TmfEventFilter.gif
index ef51bd5..ef51bd5 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEventFilter.gif
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TmfEventFilter.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEventSearch.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TmfEventSearch.gif
index d540a01..d540a01 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/images/TmfEventSearch.gif
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TmfEventSearch.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TracingPerspective.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TracingPerspective.png
new file mode 100644
index 0000000..fbcaf49
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/TracingPerspective.png
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/home.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/home.gif
new file mode 100644
index 0000000..4472e8c
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/home.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/next.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/next.gif
new file mode 100644
index 0000000..e2f8c3e
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/next.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/prev.gif b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/prev.gif
new file mode 100644
index 0000000..4fb4150
--- /dev/null
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/prev.gif
Binary files differ
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/notice.html b/lttng/org.eclipse.linuxtools.lttng.help/doc/notice.html
index e764ac9..8746abc 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/doc/notice.html
+++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/notice.html
@@ -1,19 +1,20 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<?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>
<head>
-<meta name="copyright" content="&#169; Copyright 2011 Eclipse Linux Tools project committers and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
+<meta name="copyright" content="&#169; Copyright 2012 Eclipse Linux Tools project committers and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
- <LINK REL="STYLESHEET" HREF="book.css" CHARSET="ISO-8859-1" TYPE="text/css">
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
+ <LINK REL="STYLESHEET" HREF="book.css" CHARSET="ISO-8859-1" TYPE="text/css"></LINK>
<title>Legal Notices</title>
+</meta>
</head>
<body>
<h3>
<a NAME="Notices"></a>Notices</h3>
<p>
-The material in this guide is &#169; Copyright 2011 Eclipse Linux Tools project committers and others.
+The material in this guide is &#169; Copyright 2012 Eclipse Linux Tools project committers and others.
</p>
<p>
<a href="../about.html">Terms and conditions regarding the use of this guide.</a>
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/plugin.xml b/lttng/org.eclipse.linuxtools.lttng.help/plugin.xml
index a24f4a9..8236399 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/plugin.xml
+++ b/lttng/org.eclipse.linuxtools.lttng.help/plugin.xml
@@ -4,7 +4,7 @@
<!-- Configure the help contribution for this plugin -->
<extension point="org.eclipse.help.toc">
<toc
- file="toc.xml"
+ file="doc/User-Guide-toc.xml"
primary="true" />
</extension>
</plugin>
diff --git a/lttng/org.eclipse.linuxtools.lttng.help/toc.xml b/lttng/org.eclipse.linuxtools.lttng.help/toc.xml
index 11064af..15f6302 100644
--- a/lttng/org.eclipse.linuxtools.lttng.help/toc.xml
+++ b/lttng/org.eclipse.linuxtools.lttng.help/toc.xml
@@ -82,8 +82,8 @@
<topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html" label="LTTng Kernel Analysis">
<topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#LTTng_Kernel_Perspective" label="LTTng Kernel Perspective"></topic>
<topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#Control_Flow_View" label="Control Flow View">
- <topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#Process_Tree_and_Information" label="Process Tree and Information"></topic>
- <topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#States_Flow" label="States Flow">
+ <topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#Process_tree_and_informations" label="Process tree and informations"></topic>
+ <topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#States_flow" label="States flow">
<topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#Using_the_mouse" label="Using the mouse"></topic>
<topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#Incomplete_regions" label="Incomplete regions"></topic>
<topic href="Linux_Tools_Project/LTTng2/User_Guide/LTTng-Kernel-Analysis.html#Zoom_region" label="Zoom region"></topic>