Latest development can be found at:
- * Gitweb : http://git.lttng.org/lttng-tools.git/
- * Git : git://git.lttng.org/lttng-tools.git
+ * Gitweb : http://git.lttng.org/lttng-tools.git/
+ * Git : git://git.lttng.org/lttng-tools.git
-PREREQUISITES:
+REQUIREMENTS:
- - libuuid
- Universally unique id library - headers and static libraries libuuid
- generates and parses 128-bit universally unique ids (UUIDs). See RFC
- 4122 for more information.
+ - liburcu
+ Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
- * Debian/Ubuntu package: uuid-dev
+ -> Tested with liburcu >= v0.6.6
- - liburcu
- Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
-
- -> Tested with liburcu >= v0.5.4
+ * Debian/Ubuntu package: liburcu-dev
+ * Git : git://git.lttng.org/userspace-rcu.git
+ * Website: http://lttng.org/urcu
- * Debian/Ubuntu package: liburcu-dev
- * Git : git://lttng.org/userspace-rcu.git
- * Website: http://lttng.org/urcu
+ - libpopt >= 1.13
+ Library for parsing command line parameters
- - libustctl
- LTTng user-space tracer control library
+ * Debian/Ubuntu package: libpopt-dev
- Needed for interaction with that tracer.
+For developers using the git tree:
- - liblttctl
- LTTng kernel tracer control library
+This source tree is based on the autotools suite from GNU to simplify
+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)
+ (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/)
+
+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.
- Needed for interaction with that tracer.
INSTALLATION INSTRUCTIONS:
- - Download, compile and install liburcu, libuuid, libustctl and liblttctl
- - In this package's tree, run ./configure.
- - Run make.
- - Run make install.
- - Run ldconfig.
+ - Download, compile and install the prerequisites.
+ Then:
+ $ ./configure
+ $ make
+ $ sudo make install
+ $ sudo ldconfig
If compiling from the git repository, run ./bootstrap before running
the configure script, to generate it.
+USAGE:
+
+Please see doc/quickstart.txt to help you start tracing. You can also use the
+-h/--help command on 'lttng' and all other commands offered in this tool (Ex:
+lttng enable-event -h).
+
PACKAGE CONTENTS:
- This package contains the following elements:
+ This package contains the following elements:
+
+ - liblttngctl
+ The LTTng tracing control library.
+
+ - liblttng-sessiond-comm
+ The lttng-sessiond communication library. In order to talk with lttng-sessiond,
+ this library must be used.
+
+ - libkernelctl
+ Kernel tracer control and ioctl definitions.
- - liblttngctl
- The LTTng trace control library.
+ - liblttng-consumer
+ Library for Kernel and (optionally) UST trace consumer.
- - liblttsessiondcomm
- The ltt-sessiond communication library. In order to talk with ltt-sessiond,
- thi library must be used.
+ - lttng-consumerd
+ The consumer daemon which uses liblttng-consumer.
- - ltt-sessiond
- The LTTng session daemon binary.
+ - lttng-sessiond
+ The LTTng session daemon binary.
- - lttng
- The LTTng tracer command line control tool.
+ - lttng
+ The LTTng tracer command line control tool.
- - include
- The liblttngctl API header file.
+ - include (lttng.h --> installed in $(includedir)/lttng/lttng.h)
+ The liblttngctl API header file.
- - tests
- Various test programs.
+ - tests
+ Various test programs.
projects / lttng-tools.git / blobdiff