LTTng Trace Control
----------------
-Please visit http://lttng.org for more information.
+Please visit https://lttng.org for more information. The current maintainer is
+David Goulet <dgoulet@efficios.com>.
Latest development can be found at:
- * Gitweb : http://git.lttng.org/lttng-tools.git/
+ * Gitweb : https://git.lttng.org/?p=lttng-tools.git;a=summary
* Git : git://git.lttng.org/lttng-tools.git
REQUIREMENTS:
- - Linux kernel >= 2.6.27
- pipe2(), epoll_create1() and SOCK_CLOEXEC are needed to run the session
- daemon. There were introduce in the Linux 2.6.27
+ - Linux kernel >= 2.6.27
+ For epoll() support, at least this version is needed. However, poll() is
+ also supported by running "./configure --disable-epoll". Using that, the
+ kernel version can probably be older but we can't provide any guarantee.
+ Please let us know if you are able to go lower without any problems.
- liburcu
Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
- -> Tested with liburcu >= v0.6.6
+ -> Tested with liburcu 0.7.x stable.
* Debian/Ubuntu package: liburcu-dev
* Git : git://git.lttng.org/userspace-rcu.git
- * Website: http://lttng.org/urcu
+ * Website: https://lttng.org/urcu
- libpopt >= 1.13
Library for parsing command line parameters
* Debian/Ubuntu package: libpopt-dev
+ - libuuid
+ Universally unique id library
+
+ * Debian/Ubuntu package: uuid-dev
+
+ - Babeltrace (optional)
+ Trace viewer. Enable the use of "lttng view" command
+
+ * Debian/Ubuntu package: babeltrace
+
+ - libxml2 >= 2.7.6
+ XML document parsing library.
+
+ * Debian/Ubuntu package: libxml2-dev
+
+ - Perl (optional)
+ Needed for make check and tests.
+
+ - Python >= 3.0 (optional)
+ Needed for make check and tests.
+
+ * Debian/Ubuntu package: python3
+
- SWIG >= 2.0 (optional)
- Needed for Python bindings
+ Needed for Python bindings (--enable-python-bindings).
* Debian/Ubuntu package: swig2.0
- python-dev (optional)
Python headers
- * Debian/Ubuntu package: python-dev
+ * Debian/Ubuntu package: python3-dev
- For kernel tracing: modprobe
- - bash
- Needed for running "make check".
+ - bash
+ Needed for running "make check".
For developers using the git tree:
- GNU autotools (automake >=1.10, autoconf >=2.50, autoheader >=2.50)
(make sure your system wide "automake" points to a recent version!)
- GNU Libtool >=2.2
- (for more information, go to http://www.gnu.org/software/autoconf/)
-- GNU Gold >= 2.22
- (Before this version we hit a known bug documented at:
- http://sourceware.org/bugzilla/show_bug.cgi?id=11317)
+ (for more information, go to https://www.gnu.org/software/autoconf/)
- flex >= 2.5.35
- bison >= 2.4
+If you use GNU gold, which is NOT mandatory, make sure you have this version:
+- GNU gold >= 2.22
+(Before this version we hit a known bug documented at:
+ http://sourceware.org/bugzilla/show_bug.cgi?id=11317)
+Be advise that with GNU gold, you'll might have to specify -L/usr/local/lib in
+LDFLAGS.
+
If you get the tree from the repository, you will need to use the "bootstrap"
-script in the root of the tree. It calls all the GNU tools needed to prepare the
-tree configuration.
+script in the root of the tree. It calls all the GNU tools needed to prepare
+the tree configuration.
INSTALLATION INSTRUCTIONS:
- Download, compile and install the prerequisites.
Then:
+ $ ./boostrap
$ ./configure
$ make
$ sudo make install
the configure script, to generate it.
If you want Python bindings, run ./configure --enable-python-bindings.
+ Please note that some distributions will need the following
+ environment variables set before running configure:
+
+ export PYTHON="python3"
+ export PYTHON_CONFIG="/usr/bin/python3-config"
USAGE:
This package contains the following elements:
- - liblttng-ctl
+ - liblttng-ctl (public API)
The LTTng tracing control library.
- libsessiond-comm (internal)
- The lttng-sessiond communication library. In order to talk with
- lttng-sessiond, this library must be used.
+ The lttng-sessiond communication library. In order to talk with
+ lttng-sessiond, this library must be used.
- libkernel-ctl (internal)
Kernel tracer control and ioctl definitions.
- libconsumer (internal)
Library for Kernel and (optionally) UST trace consumer.
- - libkernel-consumer (internal)
- Library for Kernel consumer control
+ - libkernel-consumer (internal)
+ Library for Kernel consumer control
+
+ - libust-consumer (internal)
+ Library for UST consumer control
- - libust-consumer (internal)
- Library for UST consumer control
+ - libhashtable (internal)
+ Library wrapper over URCU hashtables.
- - libhashtable (internal)
- Library wrapper over URCU hashtables.
+ - libcommon (internal)
+ Contains multiple useful function call used by the whole tree.
- - libcommon (internal)
- Contains multiple useful function call used by the whole tree.
+ - libcompat (internal)
+ Compatibility library mostly for FreeBSD and Linux.
- - libcompat (internal)
- Compatibility library mostly for FreeBSD and Linux.
-
- - librelayd (internal)
- Library for all relayd interactions over the network.
+ - librelayd (internal)
+ Library for all relayd interactions over the network.
- - lttng-relayd
- The relay daemon used for network streaming
+ - lttng-relayd
+ The relay daemon used for network streaming
- lttng-consumerd
The consumer daemon which uses libconsumer.
- lttng
The LTTng tracer command line control tool.
- - include (lttng.h --> installed in $(includedir)/lttng/lttng.h)
+ - include (installed in $(includedir)/lttng/)
The liblttngctl API header file.
- tests
Various test programs.
- - doc
- Various documentations and quickstart guide.
+ - doc
+ Various documentations and quickstart guide.
- - extras
- Contains extra data such as bash completion file.
+ - extras
+ Contains extra data such as bash completion file.
+ Note: the presence of xmllint is required for bash-completion.
+ Python bindings for liblttng-ctl are also available there.
projects / lttng-tools.git / blobdiff