README

   1 This directory contains the source code for the LTTng integration plugins for
   2 Eclipse, which includes the generic Tracing and Monitoring Framework (TMF).
   3
   4 The plugins are categorized as follows:
   5 org.eclipse.linuxtools.ctf.*          Common Trace Format (CTF) reader library
   6 org.eclipse.linuxtools.gdbtrace.*     Support for reading and viewing GDB traces
   7 org.eclipse.linuxtools.lttng2.*       LTTng 2.x integration
   8 org.eclipse.linuxtools.tmf.*          Tracing and Monitoring Framework
   9 org.eclipse.linuxtools.tracing.rcp.*  Code specific to the RCP version
  10
  11 See the plugins.svg file for a diagram showing the dependencies between the
  12 different plugins.
  13
  14
  15 To set up the environment to build TMF from within Eclipse, see this wiki page:
  16 http://wiki.eclipse.org/Linux_Tools_Project/LTTng_Eclipse_Plug-in_Development_Environment_Setup
  17
  18
  19
  20
  21 To build the plugins manually using Maven, you first need to build the Linux Tools target definition
  22  (starting from the root of the source tree):
  23 $ cd releng/org.eclipse.linuxtools.target
  24 $ mvn clean install
  25 Then you can build the LTTng plugins:
  26 $ cd ../../lttng
  27 $ mvn clean install
  28
  29 As long as you don't clear the Maven reactor cache (in ~/.m2), you should not
  30 need to rebuild the target definition.
  31
  32
  33 The default command will compile and run the unit tests. Running the tests can
  34 take some time, to skip them you can append "-Dmaven.test.skip=true" to the
  35 'mvn' command:
  36 $ mvn clean install -Dmaven.test.skip=true
  37
  38 The RCP is not built by default, to build it you need to add "-PtracingRcp" to
  39 the 'mvn' command:
  40 $ mvn clean install -PtracingRcp -Dmaven.test.skip=true
  41
  42 This will build the RCP for all supported architectures. The resulting archives
  43 will be placed in lttng/org.eclipse.linuxtools.tracing.rcp.product/target/products
  44