diff options
Diffstat (limited to 'doc')
9 files changed, 1126 insertions, 794 deletions
diff --git a/doc/org.eclipse.tracecompass.doc.user/doc/User-Guide.mediawiki b/doc/org.eclipse.tracecompass.doc.user/doc/User-Guide.mediawiki index 84ad341ab5..3077162255 100644 --- a/doc/org.eclipse.tracecompass.doc.user/doc/User-Guide.mediawiki +++ b/doc/org.eclipse.tracecompass.doc.user/doc/User-Guide.mediawiki @@ -5,10 +5,7 @@ __TOC__ = 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 (up to v2.4) in Eclipse. +Trace Compass is a Java tool for viewing and analyzing any type of logs or traces. Its goal is to provide views, graphs, metrics, etc. to help extract useful information from traces, in a way that is more user-friendly and informative than huge text dumps. == About Tracing == @@ -20,55 +17,62 @@ Traces may include events from the operating system kernel (IRQ handler entry/ex 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 coupled with knowledge of the traced program. These programs must be specially designed to handle quickly the enormous amount of data a trace may contain. -== LTTng integration == +== Features == -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. +Trace Compass has a number of features to allow efficient handling of very large traces (and sets of large traces): -The LTTng Eclipse plug-in provides the following views: +* 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 time or time range, and window time range +* Efficient searching and filtering of events +* Support for trace bookmarks +* Support for importing and exporting trace packages -* ''Project'' - an extension to the standard Eclipse Project view tailored for tracing projects -* ''Control'' - to control the tracer and configure the tracepoints +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) +* Dynamic creation of customized state systems (from XML files) +* Dynamic creation of customized views (from XML files) + +Trace Compass provides the following main views: + +* ''Project Explorer'' - an extension to the standard Eclipse Project view tailored for tracing projects * ''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 views: +== LTTng integration == + +One of the main features of Trace Compass is the LTTng integration. 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 (up to v2.4) in Eclipse. + +The LTTng plug-ins provide an 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. + +At present, the LTTng plug-ins support the following kernel-oriented views: * ''Control Flow'' - to visualize processes state transitions * ''Resources'' - to visualize system resources state transitions * ''CPU usage'' - to visualize the usage of the processor with respect to the time in traces -It also supports the following User Space traces views: +Also, the LTTng plug-ins supports the following User Space traces views: * ''Memory Usage'' - to visualize the memory usage per thread with respect to time in the traces * ''Call Stack'' - to visualize the call stack's evolution over time -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 time or time range, and window time range -* Efficient searching and filtering of events -* Support for trace bookmarks -* Support for importing and exporting trace packages - -There is also support for the integration of non-LTTng trace types: +Finally, the LTTng plug-ins supports the following Control views: +* ''Control'' - to control the tracer and configure the tracepoints -* Built-in CTF parser -* Dynamic creation of customized parsers (for XML and text traces) -* Dynamic creation of customized state systems (from XML files) -* Dynamic creation of customized views (from XML files) +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. = Installation = -This section describes the installation of the LTTng tracer and the LTTng Eclipse plug-ins as well as their dependencies. +This section describes the installation of the LTTng tracer and the Trace Compass plug-ins as well as their dependencies. == LTTng Tracer == @@ -84,79 +88,76 @@ For other distributions, older Ubuntu distributions, or the latest, bleeding edg '''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 == +== Trace Compass 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 easiest way to install the Trace Compass plug-ins for Eclipse is through the Install New Software menu. For information on how to use this menu, refer to this [http://help.eclipse.org/luna/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-124.htm link]. -The LTTng plug-ins are structured as a stack of features/plug-ins as following: +The Trace Compass main 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 +** ''Feature'': org.eclipse.tracecompass.ctf +** ''Plug-ins'': org.eclipse.tracecompass.ctf.core, org.eclipse.tracecompass.ctf.parser * '''State System Core''' - State system for TMF -** ''Plug-ins'': org.eclipse.linuxtools.statesystem.core +** ''Plug-ins'': org.eclipse.tracecompass.statesystem.core * '''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. org.eclipse.linuxtools.tmf.analysis.xml.core, org.eclipse.linuxtools.tmf.analysis.xml.ui +** ''Feature'': org.eclipse.tracecompass.tmf +** ''Plug-ins'': org.eclipse.tracecompass.tmf.core, org.eclipse.tracecompass.tmf.ui. org.eclipse.tracecompass.tmf.analysis.xml.core, org.eclipse.tracecompass.tmf.analysis.xml.ui * '''CTF support for TMF''' - CTF support for the TMF Feature -** ''Feature'': org.eclipse.linuxtools.tmf.ctf -** ''Plug-ins'': org.eclipse.linuxtools.tmf.ctf.core +** ''Feature'': org.eclipse.tracecompass.tmf.ctf +** ''Plug-ins'': org.eclipse.tracecompass.tmf.ctf.core -* '''LTTng''' - The wrapper for the LTTng tracer control. Can be used for kernel or application tracing. -** ''Feature'': org.eclipse.linuxtools.lttng2.control -** ''Plug-ins'': org.eclipse.linuxtools.lttng2.control.core, org.eclipse.linuxtools.lttng2.control.ui +* '''LTTng Control''' - The wrapper for the LTTng tracer control. Can be used for kernel or application tracing. +** ''Feature'': org.eclipse.tracecompass.lttng2.control +** ''Plug-ins'': org.eclipse.tracecompass.lttng2.control.core, org.eclipse.tracecompass.lttng2.control.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 +** ''Feature'': org.eclipse.tracecompass.lttng2.kernel +** ''Plug-ins'': org.eclipse.tracecompass.analysis.os.linux.core, org.eclipse.tracecompass.analysis.os.linux.ui, org.eclipse.tracecompass.lttng2.kernel.core, org.eclipse.tracecompass.lttng2.kernel.ui * '''LTTng UST''' - Analysis components specific to Linux userspace traces -** ''Feature'': org.eclipse.linuxtools.lttng2.ust -** ''Plug-ins'': org.eclipse.linuxtools.lttng2.ust.core, org.eclipse.linuxtools.lttng2.ust.ui +** ''Feature'': org.eclipse.tracecompass.lttng2.ust +** ''Plug-ins'': org.eclipse.tracecompass.lttng2.ust.core, org.eclipse.tracecompass.lttng2.ust.ui -== LTTng Eclipse Dependencies == +== LTTng Control Dependencies == -The Eclipse LTTng controls the LTTng tracer through an ''ssh'' connection, if the tracer is running locally it can use or bypass the ''ssh'' connection. +The Eclipse LTTng Control feature controls the LTTng tracer through an ''ssh'' connection, if the tracer is running locally it can use or bypass the ''ssh'' connection. -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. +When using ''ssh'', 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 Remote Services installed to handle the SSH connection and transport. The Remote Services can be installed the standard way (''Help'' > ''Install New Software...'' > ''General Purpose Tools'' > ''Remote Services''). +On the host side (where Eclipse is running), you also need to have Eclipse Remote Services installed to handle the SSH connection and transport. The Remote Services are installed for you as a dependency of the LTTng Control feature. If necessary, it can be installed manually with the standard way (''Help'' > ''Install New Software...'' > ''General Purpose Tools'' > ''Remote Services''). == Installation Verification == -If you do not have any, sample LTTng traces can be found here [http://lttng.org/download]. At the bottom of the page there is a link to some sample LTTng 2.0 kernel traces. The trace needs to be uncompressed to be read. +If you do not have any traces, sample LTTng traces can be found here [http://lttng.org/files/samples]. This page contains links to some sample LTTng 2.0 kernel traces. The trace needs to be uncompressed to be opened. The traces can also be imported directly as archive, see the [[#Importing|Importing]] section for more detail. -Here are the quick steps to verify that your installation is functional: +Here are the quick steps to verify that your installation is functional using a LTTng trace: * Start Eclipse * Open the LTTng perspective * Create a Tracing project -** Right-click in the Project view and select "New Project" +** Right-click in the Project Explorer view and select New, Tracing Project ** Enter the name of your project (e.g. "MyLTTngProject") ** The project will be created. It will contain 2 empty folders: "Traces" and "Experiments" -* Open a sample trace +* Open and visualize a sample trace ** Right-click on the newly created project "Traces" folder and select "Open Trace..." ** Navigate to the sample LTTng trace that you want to visualize and select any file in the trace folder ** 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]] for detailed description of the views and their usage. -= LTTng = += Trace Compass Main Features = == Tracing Perspective == -The '''Tracing''' perspective is part of the '''Tracing and Monitoring Framework (TMF)''' and groups the following views: +The '''Tracing''' perspective is part of the '''Tracing and Monitoring Framework (TMF)''' and groups the following views: -* [[#Project_View | Project View]] +* [[#Project Explorer_View | Project Explorer View]] * [[#Events_Editor | Events Editor]] * [[#Histogram_View | Histogram View]] * [[#Statistics_View | Statistics View]] @@ -183,13 +184,13 @@ To open one of the above '''Tracing''' views, use the Eclipse Show View dialog ( [[Image:images/ShowTracingViews.png]] -Additionally, the '''LTTng''' feature provides an '''LTTng Tracer Control''' functionality. It comes with a dedicated '''Control View'''. +Additionally, the '''LTTng Control''' feature provides an '''LTTng Tracer Control''' functionality. It comes with a dedicated '''Control View'''. * [[#LTTng_Tracer_Control | LTTng Tracer Control]] -== Project View == +== Project Explorer 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. +The Project Explorer 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 === @@ -331,7 +332,7 @@ When Finish is clicked, the trace is imported in the target folder. The folder s === Selecting a Trace Type === -If no trace type was selected a trace type has 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'''. +If no trace type was selected a trace type has 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 '''Linux Kernel Trace''' and '''Generic CTF trace'''. [[Image:images/SelectLTTngKernelTraceType.png]] @@ -711,7 +712,7 @@ Fill out the first wizard page with the following information: * '''Category:''' Enter a category name for the trace type. * '''Trace type:''' Enter a name for the trace type, 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: [../reference/api/org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html TmfTimestampFormat] +Note: information about date and time patterns can be found here: [../reference/api/org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html TmfTimestampFormat] 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: @@ -780,7 +781,7 @@ Fill out the first wizard page with the following information: * '''Trace type:''' Enter a name for the trace type, 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: [../reference/api/org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html TmfTimestampFormat] +Note: information about date and time patterns can be found here: [../reference/api/org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html TmfTimestampFormat] 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. @@ -994,7 +995,7 @@ Fill in all necessary information, select the radio button for '''Snapshot Mode' Refer to chapter [[#Recording a Snapshot | Recording a Snapshot]] for how to create a snapshot. -=== Creating a Live Tracing Session ==== +=== Creating a Live Tracing Session === LTTng Tools version v2.4.0 introduces the possibility to create live tracing sessions. The live mode allows you to stream the trace and view it while it's being recorded. To create such a live session, open the trace session dialog as described in chapter [[#Creating a Tracing Session | Creating a Tracing Session]]. [[Image:images/LTTng2CreateSessionDialog_Live.png]] @@ -1320,7 +1321,7 @@ A new display will open for selecting the traces to import. [[Image:images/LTTng2ImportDialog.png]] -By default all traces are selected. A default project with the name '''Remote''' is selected which will be created if necessary. Update the list of traces to be imported, if necessary, by selecting and deselecting the relevant traces in the tree viewer. Use buttons '''Select All''' or '''Deselect All''' to select or deselect all traces. Also if needed, change the tracing project from the '''Available Projects''' combo box. Select the Overwrite button ('''Overwrite existing trace without warning''') if required. Then press button '''Ok'''. Upon successful import operation the selected traces will be stored in the '''Traces''' directory of the specified tracing project. The session directory structure as well as the trace names will be preserved in the destination tracing project. For '''Kernel''' traces the trace type '''LTTng Kernel Trace''' and for '''UST''' traces the trace type '''LTTng UST Trace''' will be set. From the '''Project Explorer''' view, the trace can be analyzed further. +By default all traces are selected. A default project with the name '''Remote''' is selected which will be created if necessary. Update the list of traces to be imported, if necessary, by selecting and deselecting the relevant traces in the tree viewer. Use buttons '''Select All''' or '''Deselect All''' to select or deselect all traces. Also if needed, change the tracing project from the '''Available Projects''' combo box. Select the Overwrite button ('''Overwrite existing trace without warning''') if required. Then press button '''Ok'''. Upon successful import operation the selected traces will be stored in the '''Traces''' directory of the specified tracing project. The session directory structure as well as the trace names will be preserved in the destination tracing project. For '''Kernel''' traces the trace type '''Linux Kernel Trace''' and for '''UST''' traces the trace type '''LTTng UST Trace''' will be set. 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 destination directory of the project, then a new confirmation dialog box will open. @@ -1426,7 +1427,7 @@ The perspective can be opened from the Eclipse Open Perspective dialog ('''Windo == Control Flow View == -The '''''Control Flow''''' view is a LTTng-specific view that shows per-process events graphically. The LTTng Kernel analysis is executed the first time a LTTng Kernel is opened. After opening the trace, the element '''Control Flow''' is added under the '''LTTng Kernel Analysis''' tree element in the Project Explorer. To open the view, double-click the '''Control Flow''' tree element. +The '''''Control Flow''''' view is a LTTng-specific view that shows per-process events graphically. The Linux Kernel Analysis is executed the first time a LTTng Kernel is opened. After opening the trace, the element '''Control Flow''' is added under the '''Linux Kernel Analysis''' tree element in the Project Explorer. To open the view, double-click the '''Control Flow''' tree element. [[Image:images/Cfv_show_view.png]] @@ -1578,7 +1579,7 @@ The Control Flow View '''toolbar''', located at the top right of the view, has s == Resources View == -This view is specific to LTTng kernel traces. The LTTng Kernel analysis is executed the first time a LTTng Kernel is opened. After opening the trace, the element '''Resources''' is added under the '''LTTng Kernel Analysis''' tree element of the Project Explorer. To open the view, double-click the '''Resources''' tree element. +This view is specific to LTTng kernel traces. The Linux Kernel Analysis is executed the first time a LTTng Kernel is opened. After opening the trace, the element '''Resources''' is added under the '''Linux Kernel Analysis''' tree element of the Project Explorer. To open the view, double-click the '''Resources''' tree element. Alternatively, go in '''Window''' -> '''Show View''' -> '''Other...''' and select '''LTTng/Resources''' in the list. @@ -1651,7 +1652,7 @@ The Resources View '''toolbar''', located at the top right of the view, has shor == LTTng CPU Usage View == -The CPU Usage analysis and view is specific to LTTng Kernel traces. The CPU usage is derived from a kernel trace as long as the '''sched_switch''' event was enabled during the collection of the trace. This analysis is executed the first time that the CPU Usage view is opened after opening the trace. To open the view, double-click on the '''CPU Usage''' tree element under the '''LTTng Kernel Analysis''' tree element of the Project Explorer. +The CPU Usage analysis and view is specific to LTTng Kernel traces. The CPU usage is derived from a kernel trace as long as the '''sched_switch''' event was enabled during the collection of the trace. This analysis is executed the first time that the CPU Usage view is opened after opening the trace. To open the view, double-click on the '''CPU Usage''' tree element under the '''Linux Kernel Analysis''' tree element of the Project Explorer. [[Image:images/LTTng_OpenCpuUsageView.png]] @@ -1845,7 +1846,7 @@ The following tracepoints will be available The ones used for trace synchronization are '''inet_sock_local_in''' and '''inet_sock_local_out'''. -== Synchronize traces in TMF == +== Synchronize traces in Trace Compass == In order to synchronize traces, create a new experiment and select all traces that need to be synchronized. Right-click on the experiment and select '''Synchronize traces'''. For each trace whose time needs to be transformed, a new trace named as the original but followed by a '_' will be created with the transformed timestamps, and the original trace will be replaced in the experiment. The original trace can still be accessed under the '''Traces''' folder. @@ -1952,13 +1953,13 @@ If you already have an XML file defining state providers and/or views, you can i You will be prompted to select the file. It will be validated before importing it and if successful, the new analysis and views will be shown under the traces for which they apply. You will need to close any already opened traces and re-open them before the new analysis can be executed. -Right now, there is no way to "unimport" analyses from within the application. A UI to manage the imported analyses is currently being worked on. In the meantime, you can navigate to your workspace directory, and delete the files in .metadata/.plugins/org.eclipse.linuxtools.tmf.analysis.xml.core/xml_files . +Right now, there is no way to "unimport" analyses from within the application. A UI to manage the imported analyses is currently being worked on. In the meantime, you can navigate to your workspace directory, and delete the files in .metadata/.plugins/org.eclipse.tracecompass.tmf.analysis.xml.core/xml_files . == Defining XML components == To define XML components, you need to create a new XML file and use the XSD that comes with the XML plugin. -''For now, the XSD is only available through the source code in org.eclipse.linuxtools.tmf.analysis.xml.core/src/org/eclipse/linuxtools/tmf/analysis/xml/core/module/xmlDefinition.xsd''. +''For now, the XSD is only available through the source code in org.eclipse.tracecompass.tmf.analysis.xml.core/src/org/eclipse/tracecompass/tmf/analysis/xml/core/module/xmlDefinition.xsd''. An empty file, with no content yet would look like this: @@ -1978,7 +1979,7 @@ The state system obtained by the state provider can then be used to populate dat === Definitions and example === -Before we start, we'll define a few terms used in the following sections. The interested reader should read the [[Developer-Guide|Tmf Developer Guide]] for more complete description of the state system and state providers. +Before we start, we'll define a few terms used in the following sections. The interested reader should read the [https://wiki.eclipse.org/index.php/Trace_Compass#User_Guides Tmf Developer Guide] for more complete description of the state system and state providers. * The '''state system''' can be viewed as a model of the system, where the different elements (attributes) can be seen as a tree, and their evolution (states) is tracked through time. @@ -2089,7 +2090,7 @@ The full XML file for the example above would look like this: <pre> <?xml version="1.0" encoding="UTF-8"?> -<tmfxml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../org.eclipse.linuxtools.tmf.analysis.xml.core/src/org/eclipse/linuxtools/tmf/analysis/xml/core/module/xmlDefinition.xsd"> +<tmfxml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../org.eclipse.tracecompass.tmf.analysis.xml.core/src/org/eclipse/tracecompass/tmf/analysis/xml/core/module/xmlDefinition.xsd"> <stateProvider version="0" id="my.test.state.provider"> <head> <traceType id="my.trace.id" /> @@ -2200,7 +2201,7 @@ Also, if the values of the attributes to display are known, they can be defined, Here is the full XML for the time graph view: <pre> -<tmfxml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../org.eclipse.linuxtools.tmf.analysis.xml.core/src/org/eclipse/linuxtools/tmf/analysis/xml/core/module/xmlDefinition.xsd"> +<tmfxml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../org.eclipse.tracecompass.tmf.analysis.xml.core/src/org/eclipse/tracecompass/tmf/analysis/xml/core/module/xmlDefinition.xsd"> <timeGraphView id="my.test.time.graph.view"> <head> <analysis id="my.test.state.provider" /> @@ -2228,7 +2229,7 @@ An XY chart displays series as a set of numerical values over time. The X-axis r Such views can be defined in XML using the data in the state system. The state system itself could have been built by an XML-defined state provider or by any pre-defined Java analysis. It only requires knowing the structure of the state system, which can be explored using the [[#State System Explorer View | State System Explorer View]] (or programmatically using the methods in ''ITmfStateSystem''). -We will use the LTTng Kernel Analysis on LTTng kernel traces to show an example XY chart. In this state system, the status of each CPU is a numerical value. We will display this value as the Y axis of the series. There will be one series per CPU. The XML to display these entries would be as such: +We will use the Linux Kernel Analysis on LTTng kernel traces to show an example XY chart. In this state system, the status of each CPU is a numerical value. We will display this value as the Y axis of the series. There will be one series per CPU. The XML to display these entries would be as such: <pre> <entry path="CPUs/*"> @@ -2247,7 +2248,7 @@ Like for the time graph views, optional header information can be added to the v <pre> <head> - <analysis id="org.eclipse.linuxtools.lttng2.kernel.analysis" /> + <analysis id="org.eclipse.tracecompass.lttng2.kernel.analysis" /> <label value="CPU status XY view" /> </head> </pre> @@ -2255,10 +2256,10 @@ Like for the time graph views, optional header information can be added to the v Here is the full XML for the XY Chart that displays the CPU status over time of an LTTng Kernel Trace: <pre> -<tmfxml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../org.eclipse.linuxtools.tmf.analysis.xml.core/src/org/eclipse/linuxtools/tmf/analysis/xml/core/module/xmlDefinition.xsd"> +<tmfxml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../org.eclipse.tracecompass.tmf.analysis.xml.core/src/org/eclipse/tracecompass/tmf/analysis/xml/core/module/xmlDefinition.xsd"> <xyView id="my.test.xy.chart.view"> <head> - <analysis id="org.eclipse.linuxtools.lttng2.kernel.analysis" /> + <analysis id="org.eclipse.tracecompass.lttng2.kernel.analysis" /> <label value="CPU status XY view" /> </head> @@ -2297,13 +2298,13 @@ A cursory look at the histogram bar on the bottom show relatively even event dis 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. +Bob did note an exact second one glitch occurred: 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. +At this point he closes FooMonitor and notices the bug disappeared. 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. +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. @@ -2321,12 +2322,8 @@ Alice kills the program, and immediately the server speeds up. She then goes to = References = -* [http://www.eclipse.org/linuxtools/projectPages/lttng/ Linux Tools - LTTng integration] +* [http://www.eclipse.org/tracecompass Trace Compass project] +* [https://wiki.eclipse.org/index.php/Trace_Compass#User_Guides Trace Compass User Guides] * [http://www.lttng.org/ LTTng project] * [http://lttng.org/files/doc/man-pages/man1/lttng.1.html LTTng Tracer Control Command Line Tool User Manual] * [http://lttng.org/files/doc/man-pages/man8/lttng-relayd.8.html LTTng relayd User Manual] -* [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/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html deleted file mode 100644 index ccd6875fdb..0000000000 --- a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html +++ /dev/null @@ -1,622 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<!-- NewPage -->
-<html lang="en">
-<head>
-<!-- Generated by javadoc (version 1.7.0_51) on Sat Feb 22 08:24:16 EST 2014 -->
-<title>TmfTimestampFormat</title>
-<meta name="date" content="2014-02-22">
-<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
-</head>
-<body>
-<script type="text/javascript"><!--
- if (location.href.indexOf('is-external=true') == -1) {
- parent.document.title="TmfTimestampFormat";
- }
-//-->
-</script>
-<noscript>
-<div>JavaScript is disabled on your browser.</div>
-</noscript>
-<!-- ======== START OF CLASS DATA ======== -->
-<div class="header">
-<div class="subTitle">org.eclipse.linuxtools.tmf.core.timestamp</div>
-<h2 title="Class TmfTimestampFormat" class="title">Class TmfTimestampFormat</h2>
-</div>
-<div class="contentContainer">
-<ul class="inheritance">
-<li><a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
-<li>
-<ul class="inheritance">
-<li><a href="http://download.oracle.com/javase/7/docs/api/java/text/Format.html?is-external=true" title="class or interface in java.text">java.text.Format</a></li>
-<li>
-<ul class="inheritance">
-<li><a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true" title="class or interface in java.text">java.text.DateFormat</a></li>
-<li>
-<ul class="inheritance">
-<li><a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text">java.text.SimpleDateFormat</a></li>
-<li>
-<ul class="inheritance">
-<li>org.eclipse.linuxtools.tmf.core.timestamp.TmfTimestampFormat</li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-<div class="description">
-<ul class="blockList">
-<li class="blockList">
-<dl>
-<dt>All Implemented Interfaces:</dt>
-<dd><a href="http://download.oracle.com/javase/7/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/lang/Cloneable.html?is-external=true" title="class or interface in java.lang">Cloneable</a></dd>
-</dl>
-<hr>
-<br>
-<pre>public class <span class="strong">TmfTimestampFormat</span>
-extends <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text">SimpleDateFormat</a></pre>
-<div class="block">A formatting and parsing facility that can handle timestamps that span the - epoch with a precision down to the nanosecond. It can be understood as an - extension of SimpleDateFormat that supports seconds since the epoch (Jan 1, - 1970, 00:00:00 GMT), additional sub-second patterns and optional delimiters. - <p> - The timestamp representation is broken down into a number of optional - components that can be assembled into a fairly simple way. - - <h4>Date and Time Patterns</h4> - All date and time pattern letters defined in <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text"><code>SimpleDateFormat</code></a> are - supported with the following exceptions: - <blockquote> - <table border=0 cellspacing=3 cellpadding=0 > - <tr bgcolor="#ccccff"> - <th align=left>Format - <th align=left>Description - <th align=left>Value Range - <th align=left>Example - <tr bgcolor="#eeeeff"> - <td><code>T</code> - <td>The seconds since the epoch - <td><code>0-9223372036</code> - <td><code>1332170682</code> - <tr> - <td><code>S</code> - <td>Millisecond - <td><code>N/A</code> - <td><code>Not supported</code> - <tr bgcolor="#eeeeff"> - <td><code>W</code> - <td>Week in month - <td><code>N/A</code> - <td><code>Not supported</code> - </table> - </blockquote> - <p> - <strong>Note:</strong> When parsing, if "T" is used, no other Date and Time - pattern letter will be interpreted and the entire pre-delimiter input string - will be parsed as a number. Also, "T" should be used for time intervals. - <p> - <strong>Note:</strong> The decimal separator between the Date and Time - pattern and the Sub-Seconds pattern is mandatory (if there is a fractional - part) and must be one of the sub-second delimiters. Date and Time pattern - letters are not interpreted after the decimal separator. - <p> - <h4>Sub-Seconds Patterns</h4> - <blockquote> - <table border=0 cellspacing=3 cellpadding=0 > - <tr bgcolor="#ccccff"> - <th align=left>Format - <th align=left>Description - <th align=left>Value Range - <th align=left>Example - <tr> - <td><code>S</code> - <td>Fraction of second - <td><code>0-999999999</code> - <td><code>123456789</code> - <tr bgcolor="#eeeeff"> - <td><code>C</code> - <td>Microseconds in ms - <td><code>0-999</code> - <td><code>456</code> - <tr> - <td><code>N</code> - <td>Nanoseconds in µs - <td><code>0-999</code> - <td><code>789</code> - </table> - </blockquote> - <strong>Note:</strong> The fraction of second pattern can be split, in which - case parsing and formatting continues at the next digit. Digits beyond the - total number of pattern letters are ignored when parsing and truncated when - formatting. - <p> - <strong>Note:</strong> When parsing, "S", "C" and "N" are interchangeable - and are all handled as fraction of second ("S"). The use of "C" and "N" is - discouraged but is supported for backward compatibility. - <p> - - The recognized sub-second delimiters are: - <ul> - <li>Space ("<code> </code>") - <li>Period ("<code>.</code>") - <li>Comma ("<code>,</code>") - <li>Dash ("<code>-</code>") - <li>Underline ("<code>_</code>") - <li>Colon ("<code>:</code>") - <li>Semicolon ("<code>;</code>") - <li>Slash ("<code>/</code>") - <li>Single-quote ("<code>''</code>") - <li>Double-quote ("<code>"</code>") - </ul> - <p> - <strong>Note:</strong> When parsing, sub-second delimiters are optional if - unquoted. However, an extra delimiter or any other unexpected character in - the input string ends the parsing of digits. All other quoted or unquoted - characters in the sub-second pattern are matched against the input string. - - <h4>Examples</h4> - The following examples show how timestamp patterns are interpreted in - the U.S. locale. The given timestamp is 1332170682539677389L, the number - of nanoseconds since 1970/01/01. - - <blockquote> - <table border=0 cellspacing=3 cellpadding=0> - <tr bgcolor="#ccccff"> - <th align=left>Date and Time Pattern - <th align=left>Result - <tr> - <td><code>"yyyy-MM-dd HH:mm:ss.SSS.SSS.SSS"</code> - <td><code>2012-03-19 11:24:42.539.677.389</code> - <tr bgcolor="#eeeeff"> - <td><code>"yyyy-MM-dd HH:mm:ss.SSS.SSS"</code> - <td><code>2012-03-19 11:24:42.539.677</code> - <tr> - <td><code>"yyyy-D HH:mm:ss.SSS.SSS"</code> - <td><code>2012-79 11:24:42.539.677</code> - <tr bgcolor="#eeeeff"> - <td><code>"ss,SSSS"</code> - <td><code>42,5397</code> - <tr> - <td><code>"T.SSS SSS SSS"</code> - <td><code>1332170682.539 677 389</code> - <tr bgcolor="#eeeeff"> - <td><code>"T"</code> - <td><code>1332170682</code> - </table> - </blockquote> - <p></div>
-<dl><dt><span class="strong">Since:</span></dt>
- <dd>2.0</dd>
-<dt><span class="strong">Version:</span></dt>
- <dd>1.0</dd>
-<dt><span class="strong">Author:</span></dt>
- <dd>Francois Chouinard</dd>
-<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../serialized-form.html#org.eclipse.linuxtools.tmf.core.timestamp.TmfTimestampFormat">Serialized Form</a></dd></dl>
-</li>
-</ul>
-</div>
-<div class="summary">
-<ul class="blockList">
-<li class="blockList">
-<!-- ======== NESTED CLASS SUMMARY ======== -->
-<ul class="blockList">
-<li class="blockList"><a name="nested_class_summary">
-<!-- -->
-</a>
-<h3>Nested Class Summary</h3>
-<ul class="blockList">
-<li class="blockList"><a name="nested_classes_inherited_from_class_java.text.DateFormat">
-<!-- -->
-</a>
-<h3>Nested classes/interfaces inherited from class java.text.<a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true" title="class or interface in java.text">DateFormat</a></h3>
-<code><a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.Field.html?is-external=true" title="class or interface in java.text">DateFormat.Field</a></code></li>
-</ul>
-</li>
-</ul>
-<!-- =========== FIELD SUMMARY =========== -->
-<ul class="blockList">
-<li class="blockList"><a name="field_summary">
-<!-- -->
-</a>
-<h3>Field Summary</h3>
-<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
-<caption><span>Fields</span><span class="tabEnd"> </span></caption>
-<tr>
-<th class="colFirst" scope="col">Modifier and Type</th>
-<th class="colLast" scope="col">Field and Description</th>
-</tr>
-<tr class="altColor">
-<td class="colFirst"><code>static <a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#DEFAULT_INTERVAL_PATTERN">DEFAULT_INTERVAL_PATTERN</a></strong></code>
-<div class="block">The default interval pattern</div>
-</td>
-</tr>
-<tr class="rowColor">
-<td class="colFirst"><code>static <a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#DEFAULT_TIME_PATTERN">DEFAULT_TIME_PATTERN</a></strong></code>
-<div class="block">The default timestamp pattern</div>
-</td>
-</tr>
-</table>
-<ul class="blockList">
-<li class="blockList"><a name="fields_inherited_from_class_java.text.DateFormat">
-<!-- -->
-</a>
-<h3>Fields inherited from class java.text.<a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true" title="class or interface in java.text">DateFormat</a></h3>
-<code><a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#AM_PM_FIELD" title="class or interface in java.text">AM_PM_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#DATE_FIELD" title="class or interface in java.text">DATE_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#DAY_OF_WEEK_FIELD" title="class or interface in java.text">DAY_OF_WEEK_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#DAY_OF_WEEK_IN_MONTH_FIELD" title="class or interface in java.text">DAY_OF_WEEK_IN_MONTH_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#DAY_OF_YEAR_FIELD" title="class or interface in java.text">DAY_OF_YEAR_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#DEFAULT" title="class or interface in java.text">DEFAULT</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#ERA_FIELD" title="class or interface in java.text">ERA_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#FULL" title="class or interface in java.text">FULL</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#HOUR_OF_DAY0_FIELD" title="class or interface in java.text">HOUR_OF_DAY0_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#HOUR_OF_DAY1_FIELD" title="class or interface in java.text">HOUR_OF_DAY1_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#HOUR0_FIELD" title="class or interface in java.text">HOUR0_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#HOUR1_FIELD" title="class or interface in java.text">HOUR1_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#LONG" title="class or interface in java.text">LONG</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#MEDIUM" title="class or interface in java.text">MEDIUM</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#MILLISECOND_FIELD" title="class or interface in java.text">MILLISECOND_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#MINUTE_FIELD" title="class or interface in java.text">MINUTE_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#MONTH_FIELD" title="class or interface in java.text">MONTH_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#SECOND_FIELD" title="class or interface in java.text">SECOND_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#SHORT" title="class or interface in java.text">SHORT</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#TIMEZONE_FIELD" title="class or interface in java.text">TIMEZONE_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#WEEK_OF_MONTH_FIELD" title="class or interface in java.text">WEEK_OF_MONTH_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#WEEK_OF_YEAR_FIELD" title="class or interface in java.text">WEEK_OF_YEAR_FIELD</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#YEAR_FIELD" title="class or interface in java.text">YEAR_FIELD</a></code></li>
-</ul>
-</li>
-</ul>
-<!-- ======== CONSTRUCTOR SUMMARY ======== -->
-<ul class="blockList">
-<li class="blockList"><a name="constructor_summary">
-<!-- -->
-</a>
-<h3>Constructor Summary</h3>
-<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
-<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
-<tr>
-<th class="colOne" scope="col">Constructor and Description</th>
-</tr>
-<tr class="altColor">
-<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat()">TmfTimestampFormat</a></strong>()</code>
-<div class="block">The default constructor (uses the default pattern)</div>
-</td>
-</tr>
-<tr class="rowColor">
-<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat(java.lang.String)">TmfTimestampFormat</a></strong>(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</code>
-<div class="block">The normal constructor</div>
-</td>
-</tr>
-<tr class="altColor">
-<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat(java.lang.String, java.util.TimeZone)">TmfTimestampFormat</a></strong>(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern,
- <a href="http://download.oracle.com/javase/7/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util">TimeZone</a> timeZone)</code>
-<div class="block">The full constructor</div>
-</td>
-</tr>
-<tr class="rowColor">
-<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat(org.eclipse.linuxtools.tmf.core.timestamp.TmfTimestampFormat)">TmfTimestampFormat</a></strong>(<a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp">TmfTimestampFormat</a> other)</code>
-<div class="block">The copy constructor</div>
-</td>
-</tr>
-</table>
-</li>
-</ul>
-<!-- ========== METHOD SUMMARY =========== -->
-<ul class="blockList">
-<li class="blockList"><a name="method_summary">
-<!-- -->
-</a>
-<h3>Method Summary</h3>
-<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
-<caption><span>Methods</span><span class="tabEnd"> </span></caption>
-<tr>
-<th class="colFirst" scope="col">Modifier and Type</th>
-<th class="colLast" scope="col">Method and Description</th>
-</tr>
-<tr class="altColor">
-<td class="colFirst"><code>void</code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#applyPattern(java.lang.String)">applyPattern</a></strong>(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</code> </td>
-</tr>
-<tr class="rowColor">
-<td class="colFirst"><code><a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#format(long)">format</a></strong>(long value)</code>
-<div class="block">Format the timestamp according to its pattern.</div>
-</td>
-</tr>
-<tr class="altColor">
-<td class="colFirst"><code>static <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp">TmfTimestampFormat</a></code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#getDefaulIntervalFormat()">getDefaulIntervalFormat</a></strong>()</code> </td>
-</tr>
-<tr class="rowColor">
-<td class="colFirst"><code>static <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp">TmfTimestampFormat</a></code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#getDefaulTimeFormat()">getDefaulTimeFormat</a></strong>()</code> </td>
-</tr>
-<tr class="altColor">
-<td class="colFirst"><code>long</code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#parseValue(java.lang.String)">parseValue</a></strong>(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> source)</code>
-<div class="block">Parse a string according to the format pattern</div>
-</td>
-</tr>
-<tr class="rowColor">
-<td class="colFirst"><code>long</code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#parseValue(java.lang.String, long)">parseValue</a></strong>(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> source,
- long ref)</code>
-<div class="block">Parse a string according to the format pattern</div>
-</td>
-</tr>
-<tr class="altColor">
-<td class="colFirst"><code>static void</code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#setDefaultIntervalFormat(java.lang.String)">setDefaultIntervalFormat</a></strong>(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</code>
-<div class="block"><strong>Deprecated.</strong>
-<div class="block"><i>The default interval format pattern depends on the - preferences, see <code>TmfTimePreferences</code>. To change the - default time pattern, modify the preferences and call - <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#updateDefaultFormats()"><code>updateDefaultFormats()</code></a></i></div>
-</div>
-</td>
-</tr>
-<tr class="rowColor">
-<td class="colFirst"><code>static void</code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#setDefaultTimeFormat(java.lang.String)">setDefaultTimeFormat</a></strong>(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</code>
-<div class="block"><strong>Deprecated.</strong>
-<div class="block"><i>The default time pattern depends on the preferences, see - <code>TmfTimePreferences</code>. To change the default time - pattern, modify the preferences and call <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#updateDefaultFormats()"><code>updateDefaultFormats()</code></a></i></div>
-</div>
-</td>
-</tr>
-<tr class="altColor">
-<td class="colFirst"><code><a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#toPattern()">toPattern</a></strong>()</code> </td>
-</tr>
-<tr class="rowColor">
-<td class="colFirst"><code>static void</code></td>
-<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#updateDefaultFormats()">updateDefaultFormats</a></strong>()</code> </td>
-</tr>
-</table>
-<ul class="blockList">
-<li class="blockList"><a name="methods_inherited_from_class_java.text.SimpleDateFormat">
-<!-- -->
-</a>
-<h3>Methods inherited from class java.text.<a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text">SimpleDateFormat</a></h3>
-<code><a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#applyLocalizedPattern(java.lang.String)" title="class or interface in java.text">applyLocalizedPattern</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#clone()" title="class or interface in java.text">clone</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.text">equals</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#format(java.util.Date, java.lang.StringBuffer, java.text.FieldPosition)" title="class or interface in java.text">format</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#formatToCharacterIterator(java.lang.Object)" title="class or interface in java.text">formatToCharacterIterator</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#get2DigitYearStart()" title="class or interface in java.text">get2DigitYearStart</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#getDateFormatSymbols()" title="class or interface in java.text">getDateFormatSymbols</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#hashCode()" title="class or interface in java.text">hashCode</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#parse(java.lang.String, java.text.ParsePosition)" title="class or interface in java.text">parse</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#set2DigitYearStart(java.util.Date)" title="class or interface in java.text">set2DigitYearStart</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#setDateFormatSymbols(java.text.DateFormatSymbols)" title="class or interface in java.text">setDateFormatSymbols</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#toLocalizedPattern()" title="class or interface in java.text">toLocalizedPattern</a></code></li>
-</ul>
-<ul class="blockList">
-<li class="blockList"><a name="methods_inherited_from_class_java.text.DateFormat">
-<!-- -->
-</a>
-<h3>Methods inherited from class java.text.<a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true" title="class or interface in java.text">DateFormat</a></h3>
-<code><a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#format(java.util.Date)" title="class or interface in java.text">format</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#format(java.lang.Object, java.lang.StringBuffer, java.text.FieldPosition)" title="class or interface in java.text">format</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getAvailableLocales()" title="class or interface in java.text">getAvailableLocales</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getCalendar()" title="class or interface in java.text">getCalendar</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getDateInstance()" title="class or interface in java.text">getDateInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getDateInstance(int)" title="class or interface in java.text">getDateInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getDateInstance(int, java.util.Locale)" title="class or interface in java.text">getDateInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getDateTimeInstance()" title="class or interface in java.text">getDateTimeInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getDateTimeInstance(int, int)" title="class or interface in java.text">getDateTimeInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getDateTimeInstance(int, int, java.util.Locale)" title="class or interface in java.text">getDateTimeInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getInstance()" title="class or interface in java.text">getInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getNumberFormat()" title="class or interface in java.text">getNumberFormat</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getTimeInstance()" title="class or interface in java.text">getTimeInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getTimeInstance(int)" title="class or interface in java.text">getTimeInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getTimeInstance(int, java.util.Locale)" title="class or interface in java.text">getTimeInstance</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#getTimeZone()" title="class or interface in java.text">getTimeZone</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#isLenient()" title="class or interface in java.text">isLenient</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#parse(java.lang.String)" title="class or interface in java.text">parse</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#parseObject(java.lang.String, java.text.ParsePosition)" title="class or interface in java.text">parseObject</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#setCalendar(java.util.Calendar)" title="class or interface in java.text">setCalendar</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#setLenient(boolean)" title="class or interface in java.text">setLenient</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#setNumberFormat(java.text.NumberFormat)" title="class or interface in java.text">setNumberFormat</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/DateFormat.html?is-external=true#setTimeZone(java.util.TimeZone)" title="class or interface in java.text">setTimeZone</a></code></li>
-</ul>
-<ul class="blockList">
-<li class="blockList"><a name="methods_inherited_from_class_java.text.Format">
-<!-- -->
-</a>
-<h3>Methods inherited from class java.text.<a href="http://download.oracle.com/javase/7/docs/api/java/text/Format.html?is-external=true" title="class or interface in java.text">Format</a></h3>
-<code><a href="http://download.oracle.com/javase/7/docs/api/java/text/Format.html?is-external=true#format(java.lang.Object)" title="class or interface in java.text">format</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/text/Format.html?is-external=true#parseObject(java.lang.String)" title="class or interface in java.text">parseObject</a></code></li>
-</ul>
-<ul class="blockList">
-<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
-<!-- -->
-</a>
-<h3>Methods inherited from class java.lang.<a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
-<code><a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://download.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</a></code></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="details">
-<ul class="blockList">
-<li class="blockList">
-<!-- ============ FIELD DETAIL =========== -->
-<ul class="blockList">
-<li class="blockList"><a name="field_detail">
-<!-- -->
-</a>
-<h3>Field Detail</h3>
-<a name="DEFAULT_TIME_PATTERN">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>DEFAULT_TIME_PATTERN</h4>
-<pre>public static final <a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> DEFAULT_TIME_PATTERN</pre>
-<div class="block">The default timestamp pattern</div>
-<dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.eclipse.linuxtools.tmf.core.timestamp.TmfTimestampFormat.DEFAULT_TIME_PATTERN">Constant Field Values</a></dd></dl>
-</li>
-</ul>
-<a name="DEFAULT_INTERVAL_PATTERN">
-<!-- -->
-</a>
-<ul class="blockListLast">
-<li class="blockList">
-<h4>DEFAULT_INTERVAL_PATTERN</h4>
-<pre>public static final <a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> DEFAULT_INTERVAL_PATTERN</pre>
-<div class="block">The default interval pattern</div>
-<dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.eclipse.linuxtools.tmf.core.timestamp.TmfTimestampFormat.DEFAULT_INTERVAL_PATTERN">Constant Field Values</a></dd></dl>
-</li>
-</ul>
-</li>
-</ul>
-<!-- ========= CONSTRUCTOR DETAIL ======== -->
-<ul class="blockList">
-<li class="blockList"><a name="constructor_detail">
-<!-- -->
-</a>
-<h3>Constructor Detail</h3>
-<a name="TmfTimestampFormat()">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>TmfTimestampFormat</h4>
-<pre>public TmfTimestampFormat()</pre>
-<div class="block">The default constructor (uses the default pattern)</div>
-</li>
-</ul>
-<a name="TmfTimestampFormat(java.lang.String)">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>TmfTimestampFormat</h4>
-<pre>public TmfTimestampFormat(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</pre>
-<div class="block">The normal constructor</div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pattern</code> - the format pattern</dd></dl>
-</li>
-</ul>
-<a name="TmfTimestampFormat(java.lang.String, java.util.TimeZone)">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>TmfTimestampFormat</h4>
-<pre>public TmfTimestampFormat(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern,
- <a href="http://download.oracle.com/javase/7/docs/api/java/util/TimeZone.html?is-external=true" title="class or interface in java.util">TimeZone</a> timeZone)</pre>
-<div class="block">The full constructor</div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pattern</code> - the format pattern</dd><dd><code>timeZone</code> - the time zone</dd><dt><span class="strong">Since:</span></dt>
- <dd>2.1</dd></dl>
-</li>
-</ul>
-<a name="TmfTimestampFormat(org.eclipse.linuxtools.tmf.core.timestamp.TmfTimestampFormat)">
-<!-- -->
-</a>
-<ul class="blockListLast">
-<li class="blockList">
-<h4>TmfTimestampFormat</h4>
-<pre>public TmfTimestampFormat(<a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp">TmfTimestampFormat</a> other)</pre>
-<div class="block">The copy constructor</div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>other</code> - the other format pattern</dd></dl>
-</li>
-</ul>
-</li>
-</ul>
-<!-- ============ METHOD DETAIL ========== -->
-<ul class="blockList">
-<li class="blockList"><a name="method_detail">
-<!-- -->
-</a>
-<h3>Method Detail</h3>
-<a name="updateDefaultFormats()">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>updateDefaultFormats</h4>
-<pre>public static void updateDefaultFormats()</pre>
-<dl><dt><span class="strong">Since:</span></dt>
- <dd>2.1</dd></dl>
-</li>
-</ul>
-<a name="setDefaultTimeFormat(java.lang.String)">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>setDefaultTimeFormat</h4>
-<pre><a href="http://download.oracle.com/javase/7/docs/api/java/lang/Deprecated.html?is-external=true" title="class or interface in java.lang">@Deprecated</a>
-public static void setDefaultTimeFormat(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</pre>
-<div class="block"><span class="strong">Deprecated.</span> <i>The default time pattern depends on the preferences, see - <code>TmfTimePreferences</code>. To change the default time - pattern, modify the preferences and call <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#updateDefaultFormats()"><code>updateDefaultFormats()</code></a></i></div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pattern</code> - the new default time pattern</dd></dl>
-</li>
-</ul>
-<a name="getDefaulTimeFormat()">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>getDefaulTimeFormat</h4>
-<pre>public static <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp">TmfTimestampFormat</a> getDefaulTimeFormat()</pre>
-<dl><dt><span class="strong">Returns:</span></dt><dd>the default time format pattern</dd></dl>
-</li>
-</ul>
-<a name="setDefaultIntervalFormat(java.lang.String)">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>setDefaultIntervalFormat</h4>
-<pre><a href="http://download.oracle.com/javase/7/docs/api/java/lang/Deprecated.html?is-external=true" title="class or interface in java.lang">@Deprecated</a>
-public static void setDefaultIntervalFormat(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</pre>
-<div class="block"><span class="strong">Deprecated.</span> <i>The default interval format pattern depends on the - preferences, see <code>TmfTimePreferences</code>. To change the - default time pattern, modify the preferences and call - <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html#updateDefaultFormats()"><code>updateDefaultFormats()</code></a></i></div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pattern</code> - the new default interval pattern</dd></dl>
-</li>
-</ul>
-<a name="getDefaulIntervalFormat()">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>getDefaulIntervalFormat</h4>
-<pre>public static <a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp">TmfTimestampFormat</a> getDefaulIntervalFormat()</pre>
-<dl><dt><span class="strong">Returns:</span></dt><dd>the default interval format pattern</dd></dl>
-</li>
-</ul>
-<a name="applyPattern(java.lang.String)">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>applyPattern</h4>
-<pre>public void applyPattern(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> pattern)</pre>
-<dl>
-<dt><strong>Overrides:</strong></dt>
-<dd><code><a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#applyPattern(java.lang.String)" title="class or interface in java.text">applyPattern</a></code> in class <code><a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text">SimpleDateFormat</a></code></dd>
-</dl>
-</li>
-</ul>
-<a name="toPattern()">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>toPattern</h4>
-<pre>public <a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> toPattern()</pre>
-<dl>
-<dt><strong>Overrides:</strong></dt>
-<dd><code><a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true#toPattern()" title="class or interface in java.text">toPattern</a></code> in class <code><a href="http://download.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html?is-external=true" title="class or interface in java.text">SimpleDateFormat</a></code></dd>
-</dl>
-</li>
-</ul>
-<a name="format(long)">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>format</h4>
-<pre>public <a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> format(long value)</pre>
-<div class="block">Format the timestamp according to its pattern.</div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - the timestamp value to format (in ns)</dd>
-<dt><span class="strong">Returns:</span></dt><dd>the formatted timestamp</dd></dl>
-</li>
-</ul>
-<a name="parseValue(java.lang.String, long)">
-<!-- -->
-</a>
-<ul class="blockList">
-<li class="blockList">
-<h4>parseValue</h4>
-<pre>public long parseValue(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> source,
- long ref)
- throws <a href="http://download.oracle.com/javase/7/docs/api/java/text/ParseException.html?is-external=true" title="class or interface in java.text">ParseException</a></pre>
-<div class="block">Parse a string according to the format pattern</div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>source</code> - the source string</dd><dd><code>ref</code> - the reference (base) time (in ns)</dd>
-<dt><span class="strong">Returns:</span></dt><dd>the parsed value (in ns)</dd>
-<dt><span class="strong">Throws:</span></dt>
-<dd><code><a href="http://download.oracle.com/javase/7/docs/api/java/text/ParseException.html?is-external=true" title="class or interface in java.text">ParseException</a></code> - if the string has an invalid format</dd></dl>
-</li>
-</ul>
-<a name="parseValue(java.lang.String)">
-<!-- -->
-</a>
-<ul class="blockListLast">
-<li class="blockList">
-<h4>parseValue</h4>
-<pre>public long parseValue(<a href="http://download.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> source)
- throws <a href="http://download.oracle.com/javase/7/docs/api/java/text/ParseException.html?is-external=true" title="class or interface in java.text">ParseException</a></pre>
-<div class="block">Parse a string according to the format pattern</div>
-<dl><dt><span class="strong">Parameters:</span></dt><dd><code>source</code> - the source string</dd>
-<dt><span class="strong">Returns:</span></dt><dd>the parsed value (in ns)</dd>
-<dt><span class="strong">Throws:</span></dt>
-<dd><code><a href="http://download.oracle.com/javase/7/docs/api/java/text/ParseException.html?is-external=true" title="class or interface in java.text">ParseException</a></code> - if the string has an invalid format</dd></dl>
-</li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</div>
-</div>
-<!-- ========= END OF CLASS DATA ========= -->
-</body>
-</html>
diff --git a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/package-frame.html b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/package-frame.html deleted file mode 100644 index c53324780f..0000000000 --- a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/package-frame.html +++ /dev/null @@ -1,19 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<!-- NewPage -->
-<html lang="en">
-<head>
-<!-- Generated by javadoc (version 1.7.0_51) on Sat Feb 22 08:24:16 EST 2014 -->
-<title>org.eclipse.linuxtools.tmf.core.timestamp</title>
-<meta name="date" content="2014-02-22">
-<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
-</head>
-<body>
-<h1 class="bar"><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/package-summary.html" target="classFrame">org.eclipse.linuxtools.tmf.core.timestamp</a></h1>
-<div class="indexContainer">
-<h2 title="Classes">Classes</h2>
-<ul title="Classes">
-<li><a href="TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp" target="classFrame">TmfTimestampFormat</a></li>
-</ul>
-</div>
-</body>
-</html>
diff --git a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/package-summary.html b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/package-summary.html deleted file mode 100644 index 02ebc4cf5e..0000000000 --- a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/linuxtools/tmf/core/timestamp/package-summary.html +++ /dev/null @@ -1,46 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<!-- NewPage -->
-<html lang="en">
-<head>
-<!-- Generated by javadoc (version 1.7.0_51) on Sat Feb 22 08:24:16 EST 2014 -->
-<title>org.eclipse.linuxtools.tmf.core.timestamp</title>
-<meta name="date" content="2014-02-22">
-<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
-</head>
-<body>
-<script type="text/javascript"><!--
- if (location.href.indexOf('is-external=true') == -1) {
- parent.document.title="org.eclipse.linuxtools.tmf.core.timestamp";
- }
-//-->
-</script>
-<noscript>
-<div>JavaScript is disabled on your browser.</div>
-</noscript>
-<div class="header">
-<h1 title="Package" class="title">Package org.eclipse.linuxtools.tmf.core.timestamp</h1>
-</div>
-<div class="contentContainer">
-<ul class="blockList">
-<li class="blockList">
-<table class="packageSummary" border="0" cellpadding="3" cellspacing="0" summary="Class Summary table, listing classes, and an explanation">
-<caption><span>Class Summary</span><span class="tabEnd"> </span></caption>
-<tr>
-<th class="colFirst" scope="col">Class</th>
-<th class="colLast" scope="col">Description</th>
-</tr>
-<tbody>
-<tr class="altColor">
-<td class="colFirst"><a href="../../../../../../org/eclipse/linuxtools/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.linuxtools.tmf.core.timestamp">TmfTimestampFormat</a></td>
-<td class="colLast">
-<div class="block">A formatting and parsing facility that can handle timestamps that span the - epoch with a precision down to the nanosecond.</div>
-</td>
-</tr>
-</tbody>
-</table>
-</li>
-</ul>
-</div>
-</body>
-</html>
diff --git a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html new file mode 100644 index 0000000000..89ad08d083 --- /dev/null +++ b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html @@ -0,0 +1,800 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<!-- NewPage --> +<html lang="en"> +<head> +<!-- Generated by javadoc (version 1.7.0_75) on Tue Feb 03 15:53:40 EST 2015 --> +<meta http-equiv="Content-Type" content="text/html" charset="iso-8859-1"> +<title>TmfTimestampFormat (Trace Compass API Specification)</title> +<meta name="date" content="2015-02-03"> +<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<script type="text/javascript"><!-- + if (location.href.indexOf('is-external=true') == -1) { + parent.document.title="TmfTimestampFormat (Trace Compass API Specification)"; + } +//--> +</script> +<noscript> +<div>JavaScript is disabled on your browser.</div> +</noscript> +<!-- ========= START OF TOP NAVBAR ======= --> +<div class="topNav"><a name="navbar_top"> +<!-- --> +</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow"> +<!-- --> +</a> +<ul class="navList" title="Navigation"> +<li><a href="../../../../../../overview-summary.html">Overview</a></li> +<li><a href="package-summary.html">Package</a></li> +<li class="navBarCell1Rev">Class</li> +<li><a href="class-use/TmfTimestampFormat.html">Use</a></li> +<li><a href="package-tree.html">Tree</a></li> +<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li> +<li><a href="../../../../../../index-files/index-1.html">Index</a></li> +<li><a href="../../../../../../help-doc.html">Help</a></li> +</ul> +<div class="aboutLanguage"><em><strong>Eclipse Trace Compass</strong></em></div> +</div> +<div class="subNav"> +<ul class="navList"> +<li><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampDelta.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp"><span class="strong">Prev Class</span></a></li> +<li>Next Class</li> +</ul> +<ul class="navList"> +<li><a href="../../../../../../index.html?org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" target="_top">Frames</a></li> +<li><a href="TmfTimestampFormat.html" target="_top">No Frames</a></li> +</ul> +<ul class="navList" id="allclasses_navbar_top"> +<li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li> +</ul> +<div> +<script type="text/javascript"><!-- + allClassesLink = document.getElementById("allclasses_navbar_top"); + if(window==top) { + allClassesLink.style.display = "block"; + } + else { + allClassesLink.style.display = "none"; + } + //--> +</script> +</div> +<div> +<ul class="subNavList"> +<li>Summary: </li> +<li><a href="#nested_classes_inherited_from_class_java.text.DateFormat">Nested</a> | </li> +<li><a href="#field_summary">Field</a> | </li> +<li><a href="#constructor_summary">Constr</a> | </li> +<li><a href="#method_summary">Method</a></li> +</ul> +<ul class="subNavList"> +<li>Detail: </li> +<li><a href="#field_detail">Field</a> | </li> +<li><a href="#constructor_detail">Constr</a> | </li> +<li><a href="#method_detail">Method</a></li> +</ul> +</div> +<a name="skip-navbar_top"> +<!-- --> +</a></div> +<!-- ========= END OF TOP NAVBAR ========= --> +<!-- ======== START OF CLASS DATA ======== --> +<div class="header"> +<div class="subTitle">org.eclipse.tracecompass.tmf.core.timestamp</div> +<h2 title="Class TmfTimestampFormat" class="title">Class TmfTimestampFormat</h2> +</div> +<div class="contentContainer"> +<ul class="inheritance"> +<li>java.lang.Object</li> +<li> +<ul class="inheritance"> +<li>java.text.Format</li> +<li> +<ul class="inheritance"> +<li>java.text.DateFormat</li> +<li> +<ul class="inheritance"> +<li>java.text.SimpleDateFormat</li> +<li> +<ul class="inheritance"> +<li>org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestampFormat</li> +</ul> +</li> +</ul> +</li> +</ul> +</li> +</ul> +</li> +</ul> +<div class="description"> +<ul class="blockList"> +<li class="blockList"> +<dl> +<dt>All Implemented Interfaces:</dt> +<dd>java.io.Serializable, java.lang.Cloneable</dd> +</dl> +<hr> +<br> +<pre>public class <span class="strong">TmfTimestampFormat</span> +extends java.text.SimpleDateFormat</pre> +<div class="block">A formatting and parsing facility that can handle timestamps that span the + epoch with a precision down to the nanosecond. It can be understood as an + extension of SimpleDateFormat that supports seconds since the epoch (Jan 1, + 1970, 00:00:00 GMT), additional sub-second patterns and optional delimiters. + <p> + The timestamp representation is broken down into a number of optional + components that can be assembled into a fairly simple way. + + <h4>Date and Time Patterns</h4> + All date and time pattern letters defined in <code>SimpleDateFormat</code> are + supported with the following exceptions: + <blockquote> + <table border=0 cellspacing=3 cellpadding=0 > + <tr bgcolor="#ccccff"> + <th align=left>Format + <th align=left>Description + <th align=left>Value Range + <th align=left>Example + <tr bgcolor="#eeeeff"> + <td><code>T</code> + <td>The seconds since the epoch + <td><code>0-9223372036</code> + <td><code>1332170682</code> + <tr> + <td><code>S</code> + <td>Millisecond + <td><code>N/A</code> + <td><code>Not supported</code> + <tr bgcolor="#eeeeff"> + <td><code>W</code> + <td>Week in month + <td><code>N/A</code> + <td><code>Not supported</code> + </table> + </blockquote> + <p> + <strong>Note:</strong> When parsing, if "T" is used, no other Date and Time + pattern letter will be interpreted and the entire pre-delimiter input string + will be parsed as a number. Also, "T" should be used for time intervals. + <p> + <strong>Note:</strong> The decimal separator between the Date and Time + pattern and the Sub-Seconds pattern is mandatory (if there is a fractional + part) and must be one of the sub-second delimiters. Date and Time pattern + letters are not interpreted after the decimal separator. + <p> + <h4>Sub-Seconds Patterns</h4> + <blockquote> + <table border=0 cellspacing=3 cellpadding=0 > + <tr bgcolor="#ccccff"> + <th align=left>Format + <th align=left>Description + <th align=left>Value Range + <th align=left>Example + <tr> + <td><code>S</code> + <td>Fraction of second + <td><code>0-999999999</code> + <td><code>123456789</code> + <tr bgcolor="#eeeeff"> + <td><code>C</code> + <td>Microseconds in ms + <td><code>0-999</code> + <td><code>456</code> + <tr> + <td><code>N</code> + <td>Nanoseconds in µs + <td><code>0-999</code> + <td><code>789</code> + </table> + </blockquote> + <strong>Note:</strong> The fraction of second pattern can be split, in which + case parsing and formatting continues at the next digit. Digits beyond the + total number of pattern letters are ignored when parsing and truncated when + formatting. + <p> + <strong>Note:</strong> When parsing, "S", "C" and "N" are interchangeable + and are all handled as fraction of second ("S"). The use of "C" and "N" is + discouraged but is supported for backward compatibility. + <p> + + The recognized sub-second delimiters are: + <ul> + <li>Space ("<code> </code>") + <li>Period ("<code>.</code>") + <li>Comma ("<code>,</code>") + <li>Dash ("<code>-</code>") + <li>Underline ("<code>_</code>") + <li>Colon ("<code>:</code>") + <li>Semicolon ("<code>;</code>") + <li>Slash ("<code>/</code>") + <li>Single-quote ("<code>''</code>") + <li>Double-quote ("<code>"</code>") + </ul> + <p> + <strong>Note:</strong> When parsing, sub-second delimiters are optional if + unquoted. However, an extra delimiter or any other unexpected character in + the input string ends the parsing of digits. All other quoted or unquoted + characters in the sub-second pattern are matched against the input string. + + <h4>Examples</h4> + The following examples show how timestamp patterns are interpreted in + the U.S. locale. The given timestamp is 1332170682539677389L, the number + of nanoseconds since 1970/01/01. + + <blockquote> + <table border=0 cellspacing=3 cellpadding=0> + <tr bgcolor="#ccccff"> + <th align=left>Date and Time Pattern + <th align=left>Result + <tr> + <td><code>"yyyy-MM-dd HH:mm:ss.SSS.SSS.SSS"</code> + <td><code>2012-03-19 11:24:42.539.677.389</code> + <tr bgcolor="#eeeeff"> + <td><code>"yyyy-MM-dd HH:mm:ss.SSS.SSS"</code> + <td><code>2012-03-19 11:24:42.539.677</code> + <tr> + <td><code>"yyyy-D HH:mm:ss.SSS.SSS"</code> + <td><code>2012-79 11:24:42.539.677</code> + <tr bgcolor="#eeeeff"> + <td><code>"ss,SSSS"</code> + <td><code>42,5397</code> + <tr> + <td><code>"T.SSS SSS SSS"</code> + <td><code>1332170682.539 677 389</code> + <tr bgcolor="#eeeeff"> + <td><code>"T"</code> + <td><code>1332170682</code> + </table> + </blockquote> + <p></div> +<dl><dt><span class="strong">Since:</span></dt> + <dd>2.0</dd> +<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../serialized-form.html#org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestampFormat">Serialized Form</a></dd></dl> +</li> +</ul> +</div> +<div class="summary"> +<ul class="blockList"> +<li class="blockList"> +<!-- ======== NESTED CLASS SUMMARY ======== --> +<ul class="blockList"> +<li class="blockList"><a name="nested_class_summary"> +<!-- --> +</a> +<h3>Nested Class Summary</h3> +<ul class="blockList"> +<li class="blockList"><a name="nested_classes_inherited_from_class_java.text.DateFormat"> +<!-- --> +</a> +<h3>Nested classes/interfaces inherited from class java.text.DateFormat</h3> +<code>java.text.DateFormat.Field</code></li> +</ul> +</li> +</ul> +<!-- =========== FIELD SUMMARY =========== --> +<ul class="blockList"> +<li class="blockList"><a name="field_summary"> +<!-- --> +</a> +<h3>Field Summary</h3> +<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation"> +<caption><span>Fields</span><span class="tabEnd"> </span></caption> +<tr> +<th class="colFirst" scope="col">Modifier and Type</th> +<th class="colLast" scope="col">Field and Description</th> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>static java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#DEFAULT_INTERVAL_PATTERN">DEFAULT_INTERVAL_PATTERN</a></strong></code> +<div class="block">The default interval pattern</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><code>static java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#DEFAULT_TIME_PATTERN">DEFAULT_TIME_PATTERN</a></strong></code> +<div class="block">The default timestamp pattern</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>protected java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#fCloseBracket">fCloseBracket</a></strong></code> +<div class="block">The closing bracket symbol</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><code>protected java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#fDelimiterChars">fDelimiterChars</a></strong></code> +<div class="block">The optional sub-second delimiter characters.</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>protected java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#fOpenBracket">fOpenBracket</a></strong></code> +<div class="block">The open bracket symbol</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><code>protected java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#fSubSecPatternChars">fSubSecPatternChars</a></strong></code> +<div class="block">The sub-second pattern letters.</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>protected java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#fSupplPatternLetters">fSupplPatternLetters</a></strong></code> +<div class="block">The supplementary pattern letters.</div> +</td> +</tr> +</table> +<ul class="blockList"> +<li class="blockList"><a name="fields_inherited_from_class_java.text.DateFormat"> +<!-- --> +</a> +<h3>Fields inherited from class java.text.DateFormat</h3> +<code>AM_PM_FIELD, calendar, DATE_FIELD, DAY_OF_WEEK_FIELD, DAY_OF_WEEK_IN_MONTH_FIELD, DAY_OF_YEAR_FIELD, DEFAULT, ERA_FIELD, FULL, HOUR_OF_DAY0_FIELD, HOUR_OF_DAY1_FIELD, HOUR0_FIELD, HOUR1_FIELD, LONG, MEDIUM, MILLISECOND_FIELD, MINUTE_FIELD, MONTH_FIELD, numberFormat, SECOND_FIELD, SHORT, TIMEZONE_FIELD, WEEK_OF_MONTH_FIELD, WEEK_OF_YEAR_FIELD, YEAR_FIELD</code></li> +</ul> +</li> +</ul> +<!-- ======== CONSTRUCTOR SUMMARY ======== --> +<ul class="blockList"> +<li class="blockList"><a name="constructor_summary"> +<!-- --> +</a> +<h3>Constructor Summary</h3> +<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> +<caption><span>Constructors</span><span class="tabEnd"> </span></caption> +<tr> +<th class="colOne" scope="col">Constructor and Description</th> +</tr> +<tr class="altColor"> +<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat()">TmfTimestampFormat</a></strong>()</code> +<div class="block">The default constructor (uses the default pattern)</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat(java.lang.String)">TmfTimestampFormat</a></strong>(java.lang.String pattern)</code> +<div class="block">The normal constructor</div> +</td> +</tr> +<tr class="altColor"> +<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat(java.lang.String,%20java.util.TimeZone)">TmfTimestampFormat</a></strong>(java.lang.String pattern, + java.util.TimeZone timeZone)</code> +<div class="block">The full constructor</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat(java.lang.String,%20java.util.TimeZone,%20java.util.Locale)">TmfTimestampFormat</a></strong>(java.lang.String pattern, + java.util.TimeZone timeZone, + java.util.Locale locale)</code> +<div class="block">The fuller constructor</div> +</td> +</tr> +<tr class="altColor"> +<td class="colOne"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#TmfTimestampFormat(org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestampFormat)">TmfTimestampFormat</a></strong>(<a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampFormat</a> other)</code> +<div class="block">The copy constructor</div> +</td> +</tr> +</table> +</li> +</ul> +<!-- ========== METHOD SUMMARY =========== --> +<ul class="blockList"> +<li class="blockList"><a name="method_summary"> +<!-- --> +</a> +<h3>Method Summary</h3> +<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> +<caption><span>Methods</span><span class="tabEnd"> </span></caption> +<tr> +<th class="colFirst" scope="col">Modifier and Type</th> +<th class="colLast" scope="col">Method and Description</th> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>void</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#applyPattern(java.lang.String)">applyPattern</a></strong>(java.lang.String pattern)</code> </td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><code>java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#format(long)">format</a></strong>(long value)</code> +<div class="block">Format the timestamp according to its pattern.</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>static <a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampFormat</a></code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#getDefaulIntervalFormat()">getDefaulIntervalFormat</a></strong>()</code> </td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><code>static <a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampFormat</a></code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#getDefaulTimeFormat()">getDefaulTimeFormat</a></strong>()</code> </td> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>long</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#parseValue(java.lang.String)">parseValue</a></strong>(java.lang.String source)</code> +<div class="block">Parse a string according to the format pattern</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><code>long</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#parseValue(java.lang.String,%20long)">parseValue</a></strong>(java.lang.String source, + long ref)</code> +<div class="block">Parse a string according to the format pattern</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><code>java.lang.String</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#toPattern()">toPattern</a></strong>()</code> </td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><code>static void</code></td> +<td class="colLast"><code><strong><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html#updateDefaultFormats()">updateDefaultFormats</a></strong>()</code> </td> +</tr> +</table> +<ul class="blockList"> +<li class="blockList"><a name="methods_inherited_from_class_java.text.SimpleDateFormat"> +<!-- --> +</a> +<h3>Methods inherited from class java.text.SimpleDateFormat</h3> +<code>applyLocalizedPattern, clone, equals, format, formatToCharacterIterator, get2DigitYearStart, getDateFormatSymbols, hashCode, parse, set2DigitYearStart, setDateFormatSymbols, toLocalizedPattern</code></li> +</ul> +<ul class="blockList"> +<li class="blockList"><a name="methods_inherited_from_class_java.text.DateFormat"> +<!-- --> +</a> +<h3>Methods inherited from class java.text.DateFormat</h3> +<code>format, format, getAvailableLocales, getCalendar, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getNumberFormat, getTimeInstance, getTimeInstance, getTimeInstance, getTimeZone, isLenient, parse, parseObject, setCalendar, setLenient, setNumberFormat, setTimeZone</code></li> +</ul> +<ul class="blockList"> +<li class="blockList"><a name="methods_inherited_from_class_java.text.Format"> +<!-- --> +</a> +<h3>Methods inherited from class java.text.Format</h3> +<code>format, parseObject</code></li> +</ul> +<ul class="blockList"> +<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object"> +<!-- --> +</a> +<h3>Methods inherited from class java.lang.Object</h3> +<code>finalize, getClass, notify, notifyAll, toString, wait, wait, wait</code></li> +</ul> +</li> +</ul> +</li> +</ul> +</div> +<div class="details"> +<ul class="blockList"> +<li class="blockList"> +<!-- ============ FIELD DETAIL =========== --> +<ul class="blockList"> +<li class="blockList"><a name="field_detail"> +<!-- --> +</a> +<h3>Field Detail</h3> +<a name="DEFAULT_TIME_PATTERN"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>DEFAULT_TIME_PATTERN</h4> +<pre>public static final java.lang.String DEFAULT_TIME_PATTERN</pre> +<div class="block">The default timestamp pattern</div> +<dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestampFormat.DEFAULT_TIME_PATTERN">Constant Field Values</a></dd></dl> +</li> +</ul> +<a name="DEFAULT_INTERVAL_PATTERN"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>DEFAULT_INTERVAL_PATTERN</h4> +<pre>public static final java.lang.String DEFAULT_INTERVAL_PATTERN</pre> +<div class="block">The default interval pattern</div> +<dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestampFormat.DEFAULT_INTERVAL_PATTERN">Constant Field Values</a></dd></dl> +</li> +</ul> +<a name="fSupplPatternLetters"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>fSupplPatternLetters</h4> +<pre>protected java.lang.String fSupplPatternLetters</pre> +<div class="block">The supplementary pattern letters. Can be redefined by sub-classes + to either override existing letters or augment the letter set. + If so, the format() method must provide the (re-)implementation of the + pattern.</div> +</li> +</ul> +<a name="fSubSecPatternChars"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>fSubSecPatternChars</h4> +<pre>protected java.lang.String fSubSecPatternChars</pre> +<div class="block">The sub-second pattern letters.</div> +<dl><dt><span class="strong">Since:</span></dt> + <dd>3.0</dd></dl> +</li> +</ul> +<a name="fDelimiterChars"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>fDelimiterChars</h4> +<pre>protected java.lang.String fDelimiterChars</pre> +<div class="block">The optional sub-second delimiter characters.</div> +<dl><dt><span class="strong">Since:</span></dt> + <dd>3.0</dd></dl> +</li> +</ul> +<a name="fOpenBracket"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>fOpenBracket</h4> +<pre>protected java.lang.String fOpenBracket</pre> +<div class="block">The open bracket symbol</div> +</li> +</ul> +<a name="fCloseBracket"> +<!-- --> +</a> +<ul class="blockListLast"> +<li class="blockList"> +<h4>fCloseBracket</h4> +<pre>protected java.lang.String fCloseBracket</pre> +<div class="block">The closing bracket symbol</div> +</li> +</ul> +</li> +</ul> +<!-- ========= CONSTRUCTOR DETAIL ======== --> +<ul class="blockList"> +<li class="blockList"><a name="constructor_detail"> +<!-- --> +</a> +<h3>Constructor Detail</h3> +<a name="TmfTimestampFormat()"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>TmfTimestampFormat</h4> +<pre>public TmfTimestampFormat()</pre> +<div class="block">The default constructor (uses the default pattern)</div> +</li> +</ul> +<a name="TmfTimestampFormat(java.lang.String)"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>TmfTimestampFormat</h4> +<pre>public TmfTimestampFormat(java.lang.String pattern)</pre> +<div class="block">The normal constructor</div> +<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pattern</code> - the format pattern</dd></dl> +</li> +</ul> +<a name="TmfTimestampFormat(java.lang.String, java.util.TimeZone)"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>TmfTimestampFormat</h4> +<pre>public TmfTimestampFormat(java.lang.String pattern, + java.util.TimeZone timeZone)</pre> +<div class="block">The full constructor</div> +<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pattern</code> - the format pattern</dd><dd><code>timeZone</code> - the time zone</dd><dt><span class="strong">Since:</span></dt> + <dd>2.1</dd></dl> +</li> +</ul> +<a name="TmfTimestampFormat(java.lang.String, java.util.TimeZone, java.util.Locale)"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>TmfTimestampFormat</h4> +<pre>public TmfTimestampFormat(java.lang.String pattern, + java.util.TimeZone timeZone, + java.util.Locale locale)</pre> +<div class="block">The fuller constructor</div> +<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pattern</code> - the format pattern</dd><dd><code>timeZone</code> - the time zone</dd><dd><code>locale</code> - the locale</dd><dt><span class="strong">Since:</span></dt> + <dd>3.2</dd></dl> +</li> +</ul> +<a name="TmfTimestampFormat(org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestampFormat)"> +<!-- --> +</a> +<ul class="blockListLast"> +<li class="blockList"> +<h4>TmfTimestampFormat</h4> +<pre>public TmfTimestampFormat(<a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampFormat</a> other)</pre> +<div class="block">The copy constructor</div> +<dl><dt><span class="strong">Parameters:</span></dt><dd><code>other</code> - the other format pattern</dd></dl> +</li> +</ul> +</li> +</ul> +<!-- ============ METHOD DETAIL ========== --> +<ul class="blockList"> +<li class="blockList"><a name="method_detail"> +<!-- --> +</a> +<h3>Method Detail</h3> +<a name="updateDefaultFormats()"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>updateDefaultFormats</h4> +<pre>public static void updateDefaultFormats()</pre> +<dl><dt><span class="strong">Since:</span></dt> + <dd>2.1</dd></dl> +</li> +</ul> +<a name="getDefaulTimeFormat()"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>getDefaulTimeFormat</h4> +<pre>public static <a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampFormat</a> getDefaulTimeFormat()</pre> +<dl><dt><span class="strong">Returns:</span></dt><dd>the default time format pattern</dd></dl> +</li> +</ul> +<a name="getDefaulIntervalFormat()"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>getDefaulIntervalFormat</h4> +<pre>public static <a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampFormat</a> getDefaulIntervalFormat()</pre> +<dl><dt><span class="strong">Returns:</span></dt><dd>the default interval format pattern</dd></dl> +</li> +</ul> +<a name="applyPattern(java.lang.String)"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>applyPattern</h4> +<pre>public void applyPattern(java.lang.String pattern)</pre> +<dl> +<dt><strong>Overrides:</strong></dt> +<dd><code>applyPattern</code> in class <code>java.text.SimpleDateFormat</code></dd> +</dl> +</li> +</ul> +<a name="toPattern()"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>toPattern</h4> +<pre>public java.lang.String toPattern()</pre> +<dl> +<dt><strong>Overrides:</strong></dt> +<dd><code>toPattern</code> in class <code>java.text.SimpleDateFormat</code></dd> +</dl> +</li> +</ul> +<a name="format(long)"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>format</h4> +<pre>public java.lang.String format(long value)</pre> +<div class="block">Format the timestamp according to its pattern.</div> +<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - the timestamp value to format (in ns)</dd> +<dt><span class="strong">Returns:</span></dt><dd>the formatted timestamp</dd></dl> +</li> +</ul> +<a name="parseValue(java.lang.String, long)"> +<!-- --> +</a> +<ul class="blockList"> +<li class="blockList"> +<h4>parseValue</h4> +<pre>public long parseValue(java.lang.String source, + long ref) + throws java.text.ParseException</pre> +<div class="block">Parse a string according to the format pattern</div> +<dl><dt><span class="strong">Parameters:</span></dt><dd><code>source</code> - the source string</dd><dd><code>ref</code> - the reference (base) time (in ns)</dd> +<dt><span class="strong">Returns:</span></dt><dd>the parsed value (in ns)</dd> +<dt><span class="strong">Throws:</span></dt> +<dd><code>java.text.ParseException</code> - if the string has an invalid format</dd></dl> +</li> +</ul> +<a name="parseValue(java.lang.String)"> +<!-- --> +</a> +<ul class="blockListLast"> +<li class="blockList"> +<h4>parseValue</h4> +<pre>public long parseValue(java.lang.String source) + throws java.text.ParseException</pre> +<div class="block">Parse a string according to the format pattern</div> +<dl><dt><span class="strong">Parameters:</span></dt><dd><code>source</code> - the source string</dd> +<dt><span class="strong">Returns:</span></dt><dd>the parsed value (in ns)</dd> +<dt><span class="strong">Throws:</span></dt> +<dd><code>java.text.ParseException</code> - if the string has an invalid format</dd></dl> +</li> +</ul> +</li> +</ul> +</li> +</ul> +</div> +</div> +<!-- ========= END OF CLASS DATA ========= --> +<!-- ======= START OF BOTTOM NAVBAR ====== --> +<div class="bottomNav"><a name="navbar_bottom"> +<!-- --> +</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> +<!-- --> +</a> +<ul class="navList" title="Navigation"> +<li><a href="../../../../../../overview-summary.html">Overview</a></li> +<li><a href="package-summary.html">Package</a></li> +<li class="navBarCell1Rev">Class</li> +<li><a href="class-use/TmfTimestampFormat.html">Use</a></li> +<li><a href="package-tree.html">Tree</a></li> +<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li> +<li><a href="../../../../../../index-files/index-1.html">Index</a></li> +<li><a href="../../../../../../help-doc.html">Help</a></li> +</ul> +<div class="aboutLanguage"><em><strong>Eclipse Trace Compass</strong></em></div> +</div> +<div class="subNav"> +<ul class="navList"> +<li><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampDelta.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp"><span class="strong">Prev Class</span></a></li> +<li>Next Class</li> +</ul> +<ul class="navList"> +<li><a href="../../../../../../index.html?org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" target="_top">Frames</a></li> +<li><a href="TmfTimestampFormat.html" target="_top">No Frames</a></li> +</ul> +<ul class="navList" id="allclasses_navbar_bottom"> +<li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li> +</ul> +<div> +<script type="text/javascript"><!-- + allClassesLink = document.getElementById("allclasses_navbar_bottom"); + if(window==top) { + allClassesLink.style.display = "block"; + } + else { + allClassesLink.style.display = "none"; + } + //--> +</script> +</div> +<div> +<ul class="subNavList"> +<li>Summary: </li> +<li><a href="#nested_classes_inherited_from_class_java.text.DateFormat">Nested</a> | </li> +<li><a href="#field_summary">Field</a> | </li> +<li><a href="#constructor_summary">Constr</a> | </li> +<li><a href="#method_summary">Method</a></li> +</ul> +<ul class="subNavList"> +<li>Detail: </li> +<li><a href="#field_detail">Field</a> | </li> +<li><a href="#constructor_detail">Constr</a> | </li> +<li><a href="#method_detail">Method</a></li> +</ul> +</div> +<a name="skip-navbar_bottom"> +<!-- --> +</a></div> +<!-- ======== END OF BOTTOM NAVBAR ======= --> +<p class="legalCopy"><small>Copyright (c) Ericsson and others 2015. All Rights Reserved.</small></p> +</body> +</html> diff --git a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/package-frame.html b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/package-frame.html new file mode 100644 index 0000000000..8331c59f11 --- /dev/null +++ b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/package-frame.html @@ -0,0 +1,31 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<!-- NewPage --> +<html lang="en"> +<head> +<!-- Generated by javadoc (version 1.7.0_75) on Tue Feb 03 15:53:43 EST 2015 --> +<meta http-equiv="Content-Type" content="text/html" charset="iso-8859-1"> +<title>org.eclipse.tracecompass.tmf.core.timestamp (Trace Compass API Specification)</title> +<meta name="date" content="2015-02-03"> +<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<h1 class="bar"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/package-summary.html" target="classFrame">org.eclipse.tracecompass.tmf.core.timestamp</a></h1> +<div class="indexContainer"> +<h2 title="Interfaces">Interfaces</h2> +<ul title="Interfaces"> +<li><a href="ITmfTimePreferencesConstants.html" title="interface in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame"><i>ITmfTimePreferencesConstants</i></a></li> +<li><a href="ITmfTimestamp.html" title="interface in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame"><i>ITmfTimestamp</i></a></li> +</ul> +<h2 title="Classes">Classes</h2> +<ul title="Classes"> +<li><a href="TmfNanoTimestamp.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame">TmfNanoTimestamp</a></li> +<li><a href="TmfSimpleTimestamp.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame">TmfSimpleTimestamp</a></li> +<li><a href="TmfTimePreferences.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame">TmfTimePreferences</a></li> +<li><a href="TmfTimeRange.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame">TmfTimeRange</a></li> +<li><a href="TmfTimestamp.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame">TmfTimestamp</a></li> +<li><a href="TmfTimestampDelta.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame">TmfTimestampDelta</a></li> +<li><a href="TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp" target="classFrame">TmfTimestampFormat</a></li> +</ul> +</div> +</body> +</html> diff --git a/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/package-summary.html b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/package-summary.html new file mode 100644 index 0000000000..702abdc184 --- /dev/null +++ b/doc/org.eclipse.tracecompass.doc.user/reference/api/org/eclipse/tracecompass/tmf/core/timestamp/package-summary.html @@ -0,0 +1,197 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<!-- NewPage --> +<html lang="en"> +<head> +<!-- Generated by javadoc (version 1.7.0_75) on Tue Feb 03 15:53:43 EST 2015 --> +<meta http-equiv="Content-Type" content="text/html" charset="iso-8859-1"> +<title>org.eclipse.tracecompass.tmf.core.timestamp (Trace Compass API Specification)</title> +<meta name="date" content="2015-02-03"> +<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style"> +</head> +<body> +<script type="text/javascript"><!-- + if (location.href.indexOf('is-external=true') == -1) { + parent.document.title="org.eclipse.tracecompass.tmf.core.timestamp (Trace Compass API Specification)"; + } +//--> +</script> +<noscript> +<div>JavaScript is disabled on your browser.</div> +</noscript> +<!-- ========= START OF TOP NAVBAR ======= --> +<div class="topNav"><a name="navbar_top"> +<!-- --> +</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow"> +<!-- --> +</a> +<ul class="navList" title="Navigation"> +<li><a href="../../../../../../overview-summary.html">Overview</a></li> +<li class="navBarCell1Rev">Package</li> +<li>Class</li> +<li><a href="package-use.html">Use</a></li> +<li><a href="package-tree.html">Tree</a></li> +<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li> +<li><a href="../../../../../../index-files/index-1.html">Index</a></li> +<li><a href="../../../../../../help-doc.html">Help</a></li> +</ul> +<div class="aboutLanguage"><em><strong>Eclipse Trace Compass</strong></em></div> +</div> +<div class="subNav"> +<ul class="navList"> +<li><a href="../../../../../../org/eclipse/tracecompass/tmf/core/synchronization/package-summary.html">Prev Package</a></li> +<li><a href="../../../../../../org/eclipse/tracecompass/tmf/core/trace/package-summary.html">Next Package</a></li> +</ul> +<ul class="navList"> +<li><a href="../../../../../../index.html?org/eclipse/tracecompass/tmf/core/timestamp/package-summary.html" target="_top">Frames</a></li> +<li><a href="package-summary.html" target="_top">No Frames</a></li> +</ul> +<ul class="navList" id="allclasses_navbar_top"> +<li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li> +</ul> +<div> +<script type="text/javascript"><!-- + allClassesLink = document.getElementById("allclasses_navbar_top"); + if(window==top) { + allClassesLink.style.display = "block"; + } + else { + allClassesLink.style.display = "none"; + } + //--> +</script> +</div> +<a name="skip-navbar_top"> +<!-- --> +</a></div> +<!-- ========= END OF TOP NAVBAR ========= --> +<div class="header"> +<h1 title="Package" class="title">Package org.eclipse.tracecompass.tmf.core.timestamp</h1> +</div> +<div class="contentContainer"> +<ul class="blockList"> +<li class="blockList"> +<table class="packageSummary" border="0" cellpadding="3" cellspacing="0" summary="Interface Summary table, listing interfaces, and an explanation"> +<caption><span>Interface Summary</span><span class="tabEnd"> </span></caption> +<tr> +<th class="colFirst" scope="col">Interface</th> +<th class="colLast" scope="col">Description</th> +</tr> +<tbody> +<tr class="altColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/ITmfTimePreferencesConstants.html" title="interface in org.eclipse.tracecompass.tmf.core.timestamp">ITmfTimePreferencesConstants</a></td> +<td class="colLast"> </td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/ITmfTimestamp.html" title="interface in org.eclipse.tracecompass.tmf.core.timestamp">ITmfTimestamp</a></td> +<td class="colLast"> +<div class="block">The fundamental time reference in the TMF.</div> +</td> +</tr> +</tbody> +</table> +</li> +<li class="blockList"> +<table class="packageSummary" border="0" cellpadding="3" cellspacing="0" summary="Class Summary table, listing classes, and an explanation"> +<caption><span>Class Summary</span><span class="tabEnd"> </span></caption> +<tr> +<th class="colFirst" scope="col">Class</th> +<th class="colLast" scope="col">Description</th> +</tr> +<tbody> +<tr class="altColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfNanoTimestamp.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfNanoTimestamp</a></td> +<td class="colLast"> +<div class="block">A simplified timestamp where scale is nanoseconds and precision is set to 0.</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfSimpleTimestamp.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfSimpleTimestamp</a></td> +<td class="colLast"> +<div class="block">A simplified timestamp where scale and precision are set to 0.</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimePreferences.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimePreferences</a></td> +<td class="colLast"> +<div class="block">TMF Time format preferences</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimeRange.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimeRange</a></td> +<td class="colLast"> +<div class="block">A utility class to define and manage time ranges.</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestamp.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestamp</a></td> +<td class="colLast"> +<div class="block">A generic timestamp implementation.</div> +</td> +</tr> +<tr class="rowColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampDelta.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampDelta</a></td> +<td class="colLast"> +<div class="block">A generic timestamp implementation for delta between timestamps.</div> +</td> +</tr> +<tr class="altColor"> +<td class="colFirst"><a href="../../../../../../org/eclipse/tracecompass/tmf/core/timestamp/TmfTimestampFormat.html" title="class in org.eclipse.tracecompass.tmf.core.timestamp">TmfTimestampFormat</a></td> +<td class="colLast"> +<div class="block">A formatting and parsing facility that can handle timestamps that span the + epoch with a precision down to the nanosecond.</div> +</td> +</tr> +</tbody> +</table> +</li> +</ul> +</div> +<!-- ======= START OF BOTTOM NAVBAR ====== --> +<div class="bottomNav"><a name="navbar_bottom"> +<!-- --> +</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> +<!-- --> +</a> +<ul class="navList" title="Navigation"> +<li><a href="../../../../../../overview-summary.html">Overview</a></li> +<li class="navBarCell1Rev">Package</li> +<li>Class</li> +<li><a href="package-use.html">Use</a></li> +<li><a href="package-tree.html">Tree</a></li> +<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li> +<li><a href="../../../../../../index-files/index-1.html">Index</a></li> +<li><a href="../../../../../../help-doc.html">Help</a></li> +</ul> +<div class="aboutLanguage"><em><strong>Eclipse Trace Compass</strong></em></div> +</div> +<div class="subNav"> +<ul class="navList"> +<li><a href="../../../../../../org/eclipse/tracecompass/tmf/core/synchronization/package-summary.html">Prev Package</a></li> +<li><a href="../../../../../../org/eclipse/tracecompass/tmf/core/trace/package-summary.html">Next Package</a></li> +</ul> +<ul class="navList"> +<li><a href="../../../../../../index.html?org/eclipse/tracecompass/tmf/core/timestamp/package-summary.html" target="_top">Frames</a></li> +<li><a href="package-summary.html" target="_top">No Frames</a></li> +</ul> +<ul class="navList" id="allclasses_navbar_bottom"> +<li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li> +</ul> +<div> +<script type="text/javascript"><!-- + allClassesLink = document.getElementById("allclasses_navbar_bottom"); + if(window==top) { + allClassesLink.style.display = "block"; + } + else { + allClassesLink.style.display = "none"; + } + //--> +</script> +</div> +<a name="skip-navbar_bottom"> +<!-- --> +</a></div> +<!-- ======== END OF BOTTOM NAVBAR ======= --> +<p class="legalCopy"><small>Copyright (c) Ericsson and others 2015. All Rights Reserved.</small></p> +</body> +</html> diff --git a/doc/org.eclipse.tracecompass.gdbtrace.doc.user/doc/User-Guide.mediawiki b/doc/org.eclipse.tracecompass.gdbtrace.doc.user/doc/User-Guide.mediawiki index 546af80bc8..93abfa01bb 100644 --- a/doc/org.eclipse.tracecompass.gdbtrace.doc.user/doc/User-Guide.mediawiki +++ b/doc/org.eclipse.tracecompass.gdbtrace.doc.user/doc/User-Guide.mediawiki @@ -9,7 +9,7 @@ The GDB Tracepoint Analysis feature is an extension to the Tracing and Monitorin = Getting Started = -The feature can be installed from the Eclipse update site by selecting '''Linux Tools''' > '''GDB Tracepoint Analysis'''. +The feature can be installed from the Eclipse update site by selecting '''Performance, Profiling and Tracing Tools''' > '''Trace Compass GDB Tracepoint Analysis'''. The feature requires GDB version 7.2 or later to be installed on the local host. The executable program 'gdb' must be found in the path. @@ -34,7 +34,7 @@ Collecting the C/C++ tracepoint data is outside the scope of this feature. It ca = Importing Tracepoint Data = -Some information in this section is redundant with the LTTng User Guide. For further details, see the LTTng User Guide entry in the [[#References | References]] section. +Some information in this section is redundant with the Trace Compass User Guide. For further details, see the Trace Compass User Guides entry in the [[#References | References]] section. == Creating a Tracing Project == @@ -48,7 +48,7 @@ Alternatively, the trace can be drag & dropped to the '''Traces''' folder from a == Selecting the GDB Trace Type == -Right-click the imported trace in the '''Traces''' folder and choose '''Select Trace Type...''' > '''GDB''' > '''GDB Trace''' from the context menu. This step can be omitted if the trace type was selected at import. +Right-click the imported trace in the '''Traces''' folder and choose '''Select Trace Type...''' > '''GDB''' > '''GDB Trace''' from the context menu. This step can be omitted if the trace type was selected or detected at import. The trace will be updated with the GDB icon [[Image:images/gdb_icon16.png]]. @@ -86,9 +86,6 @@ The trace can also be navigated from the '''Trace Control''' view by clicking th = References = -* [http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng2/User_Guide LTTng User Guide] +* [http://www.eclipse.org/tracecompass Trace Compass project] +* [https://wiki.eclipse.org/index.php/Trace_Compass#User_Guides Trace Compass User Guides] * [http://wiki.eclipse.org/CDT/User/FAQ#How_can_I_trace_my_application_using_C.2FC.2B.2B_Tracepoints.3F CDT FAQ - How can I trace my application using C/C++ Tracepoints?] - -= 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/GDB_Tracepoint_Analysis/User_Guide http://wiki.eclipse.org/Linux_Tools_Project/GDB_Tracepoint_Analysis/User_Guide] diff --git a/doc/org.eclipse.tracecompass.tmf.pcap.doc.user/doc/User-Guide.mediawiki b/doc/org.eclipse.tracecompass.tmf.pcap.doc.user/doc/User-Guide.mediawiki index da19dd00c5..79d0faeed9 100644 --- a/doc/org.eclipse.tracecompass.tmf.pcap.doc.user/doc/User-Guide.mediawiki +++ b/doc/org.eclipse.tracecompass.tmf.pcap.doc.user/doc/User-Guide.mediawiki @@ -1,11 +1,11 @@ -= Pcap Support Within TMF = += Pcap Support Within Trace Compass = -TMF now supports the reading of libpcap files for network tracing. Those files contains packets that were seen on a network, have a .pcap or .cap extension and can be captured with tools like Wireshark/Tshark/Tcpdump. To open a libpcap trace, simply import it just like any other trace type and TMF will recognize the format. Open the imported trace to see the packets that were captured. For more information about generic features of TMF see the [http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng2/User_Guide User Guide]. +Trace Compass now supports the reading of libpcap files for network tracing. Those files contains packets that were seen on a network, have a .pcap or .cap extension and can be captured with tools like Wireshark/Tshark/Tcpdump. To open a libpcap trace, simply import it just like any other trace type and Trace Compass will recognize the format. Open the imported trace to see the packets that were captured. For more information about generic features of Trace Compass see the [https://wiki.eclipse.org/index.php/Trace_Compass#User_Guides User Guides]. == Supported Protocols == -Currently, the Pcap integration in TMF can only recognize four protocols: Ethernet, Internet Protocol Version 4, TCP and UDP. In the future, more protocols will be added and supported. If you want to contribute, please see the “Adding a protocol” section in the [http://wiki.eclipse.org/Linux_Tools_Project/TMF/User_Guide TMF Developer Guide]. +Currently, the Pcap integration in Trace Compass can only recognize four protocols: Ethernet, Internet Protocol Version 4, TCP and UDP. In the future, more protocols will be added and supported. If you want to contribute, please see the “Adding a protocol” section in the [https://wiki.eclipse.org/index.php/Trace_Compass#User_Guides TMF Developer Guide]. == Network Tracing Perspective == @@ -47,7 +47,4 @@ Most of the time, you want to analyze the conversation between two endpoints (a == References == - -* [http://wiki.eclipse.org/index.php/Linux_Tools_Project/LTTng2/User_Guide LTTng User Guide] -* [http://wiki.eclipse.org/Linux_Tools_Project/TMF/User_Guide TMF Developer Guide] - +* [https://wiki.eclipse.org/index.php/Trace_Compass#User_Guides Trace Compass User Guides] |