prepare the 0.3 release
[lttngtop.git] / README
CommitLineData
c263c4eb 1LTTngTop
54645d5c
JD
2Julien Desfossez <jdesfossez@efficios.com>
3June 2015
1fc22eb4
JD
4
5Lttngtop is an ncurses interface for reading and browsing traces recorded by
6the LTTng tracer and displaying various statistics.
661ad2e0 7As of now, the cpu usage, per file/process I/O bandwidth and perf counters are
54645d5c
JD
8displayed. This release is the first one that handles live sessions as well as
9offline sessions.
1fc22eb4
JD
10
11USAGE
12-----
13
2f6b0043
JD
14The manpage located in the doc folder of this source tree documents the usage
15of LTTngTop.
1fc22eb4
JD
16
17BUILDING
18--------
19
20 ./bootstrap (skip if using tarball)
21 ./configure
22 make
23 make install
24
25DEPENDENCIES
26------------
27
2ee217af 28To compile Babeltrace and lttngtop, you need:
1fc22eb4
JD
29
30 gcc 3.2 or better
31 libc6 development librairies
32 (Debian : libc6, libc6-dev)
33 (Fedora : glibc, glibc)
34 glib 2.22 or better development libraries
35 (Debian : libglib2.0-0, libglib2.0-dev)
36 (Fedora : glib2, glib2-devel)
1fc22eb4
JD
37 libpopt >= 1.13 development libraries
38 (Debian : libpopt-dev)
39 (Fedora : popt)
40 ncurses development libraries
41 (Debian : libncurses5-dev)
54645d5c 42 babeltrace = 1.2.3 development library
1fc22eb4 43
2ee217af
JD
44To use the local live tracing feature, you need:
45 lttng-tools >= 2.4
46 lttng-modules >= 2.4
54645d5c 47 babeltrace = 1.2.4
2ee217af 48
1fc22eb4
JD
49For developers using the git tree:
50
51This source tree is based on the autotools suite from GNU to simplify
52portability. Here are some things you should have on your system in order to
53compile the git repository tree :
54
55- GNU autotools (automake >=1.10, autoconf >=2.50, autoheader >=2.50)
56 (make sure your system wide "automake" points to a recent version!)
57- GNU Libtool >=2.2
58 (for more information, go to http://www.gnu.org/software/autoconf/)
1fc22eb4
JD
59
60If you get the tree from the repository, you will need to use the "bootstrap"
61script in the root of the tree. It calls all the GNU tools needed to prepare the
62tree configuration.
This page took 0.036072 seconds and 4 git commands to generate.