4 This source tree contains the source code for the Trace Compass plugins for
7 The plugins are categorized as follows:
9 analysis/ | Generic extensions to the base framework
10 btf/ | Best Trace Format (BTF) integration
11 common/ | Generic utilities that can be used by other plugins
12 ctf/ | Common Trace Format (CTF) reader library
13 doc/ | Documentation and code examples
14 gdbtrace/ | Support for reading and viewing GDB traces
15 lttng/ | LTTng integration
16 pcap/ | libpcap integration
17 rcp/ | Code specific to the RCP version
18 releng/ | Releng-related plugins
19 statesystem/ | State System library
22 See the `components.svg` file for a diagram showing the dependencies between the
26 Setting up the development environment
27 --------------------------------------
29 To set up the environment to build Trace Compass from within Eclipse, see this
31 <http://wiki.eclipse.org/Trace_Compass/Development_Environment_Setup>
37 To build the plugins manually using Maven, simply run the following command from
38 the top-level directory:
42 The default command will compile and run the unit tests. Running the tests can
43 take some time, to skip them you can append `-Dmaven.test.skip=true` to the
46 mvn clean install -Dmaven.test.skip=true
48 The RCP is not built by default, to build it you need to add `-Pbuild-rcp` to
51 mvn clean install -Pbuild-rcp -Dmaven.test.skip=true
53 This will build the RCP for all supported architectures. The resulting archives
54 will be placed in `rcp/org.eclipse.tracecompass.rcp.product/target/products`.
56 These commands will also build the p2 update site, which will be placed in
57 `releng/org.eclipse.tracecompass.releng-site/target/repository`.
60 Maven profiles and properties
61 -----------------------------
63 The following Maven profiles, and their corresponding properties, are defined in
64 the build system. You can set them by using `-P[profile name]` and
65 `-D[property name]=[value]` in `mvn` commands.
69 Re-compiles the CTF grammar files. This should be enabled if you modify the
70 `.g` files in the `ctf.parser` plugin.
74 Builds the RCP archives. Refer to the previous section for details.
78 Mainly for use on build servers. Copies the generated RCP archives, as well as
79 the RCP-specific update site, to the paths specified by
80 `-DrcpDestination=/absolute/path/to/destination` and
81 `-DrcpSiteDestination=/absolute/path/to/destination`, respectively.
82 Must be used with `-Pbuild-rcp`!
84 * `-Pdeploy-update-site`
86 Mainly for use on build servers. Copies the standard update site (for the
87 Eclipse plugin installation) to the destination specified by
88 `-DsiteDestination=/absolute/path/to/destination`.
90 * `-Psign-update-site`
92 Mainly for use on build servers. Signs all the generated update sites using
93 the Eclipse signing server.
97 Mainly for use on build servers. Copies the generated HTML documentation to
98 the destination specified by `-DdocDestination=/absolute/path/to/destination`.
99 Some directories may need to already exist at the destination (or Maven will
100 throw related errors).