-------------
LTTng-UST depends on [liburcu](http://liburcu.org/) v0.7.2 at build and
-run times.
+run times. It also optionally depends on libnuma.
Building
portability. Here are some things you should have on your system in order to
compile the Git repository tree:
- - GNU Autotools (Automake >= 1.10, Autoconf >= 2.50, Autoheader >= 2.50;
+ - [GNU Autotools](http://www.gnu.org/software/autoconf/)
+ (**Automake >= 1.10**, **Autoconf >= 2.50**,
+ **Autoheader >= 2.50**;
make sure your system-wide `automake` points to a recent version!)
- - [GNU Libtool](http://www.gnu.org/software/autoconf/) >= 2.2
- - Perl (optional: needed for `make check` and tests)
+ - **[GNU Libtool](https://www.gnu.org/software/libtool/) >= 2.2**
-Optional packages to build LTTng-tools man pages:
+
+### Optional dependencies
+
+Optional packages to build LTTng-ust man pages:
- **[AsciiDoc](http://www.methods.co.nz/asciidoc/) >= 8.4.5**
(previous versions may work, but were not tested)
In this case, you only need AsciiDoc and xmlto if you indend to modify
the AsciiDoc man page sources.
+Needed for `make check` and tests:
+
+ - **[Perl](https://www.perl.org/)**
+
+
+### Building steps
+
If you get the tree from the Git repository, you will need to run
./bootstrap
It _has_ to be preloaded in order to hijack calls. In contrast,
`liblttng-ust` may be linked at build time.
- `liblttng-ust-java`: a simple library that uses JNI to allow tracing
- in Java programs.
- - `liblttng-ust-jul`: a package that includes a JNI library and a JAR
- library to provide an LTTng-UST logging back-end for Java application
- using Java Util Logging.
+ in Java programs. (Configure with `--enable-jni-interface`).
+ - `liblttng-ust-java-agent`: a package that includes a JNI library and a
+ JAR library to provide an LTTng-UST logging back-end for Java
+ applications using Java Util Logging or Log4j. (Configure with
+ `--enable-java-agent-jul` or `--enable-java-agent-log4j` or
+ `--enable-java-agent-all`).
- `liblttng-ust-libc-wrapper`: an example library that can be
preloaded to instrument some calls to libc (currently `malloc()` and
`free()`) and to POSIX threads (mutexes currently instrumented) in
any program without need to recompile it.
+ - `liblttng-ust-python-agent`: a library used by python-lttngust to allow
+ tracing in Python applications. (Configure with `--enable-python-agent`)
- `libringbuffer`: the ring buffer implementation used within LTTng-UST.
+ - `python-lttngust`: a package to provide an LTTng-UST logging back-end
+ for Python applications using the standard logging framework.
- `snprintf`: an asynchronous signal-safe version of `snprintf()`.
- `tests`: various test programs.
- `tools`: home of `lttng-gen-tp`.