fix: filename history needs a rework in the next release
[lttngtop.git] / README
1 LTTngTop
2 Julien Desfossez <julien.desfossez@efficios.com>
3 April 2012
4
5 Lttngtop is an ncurses interface for reading and browsing traces recorded by
6 the LTTng tracer and displaying various statistics.
7 As of now, the cpu usage, per file/process I/O bandwidth and perf counters are
8 displayed. This version currently only supports offline traces, but a live
9 version is in alpha and will be available for testing soon.
10
11 USAGE
12 -----
13
14 The manpage located in the doc folder of this source tree documents the usage
15 of LTTngTop.
16
17 BUILDING
18 --------
19
20 ./bootstrap (skip if using tarball)
21 ./configure
22 make
23 make install
24
25 DEPENDENCIES
26 ------------
27
28 To compile Babeltrace and lttngtop, you need:
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)
37 libpopt >= 1.13 development libraries
38 (Debian : libpopt-dev)
39 (Fedora : popt)
40 ncurses development libraries
41 (Debian : libncurses5-dev)
42 babeltrace >= 1.2.0 development library
43
44 To use the local live tracing feature, you need:
45 lttng-tools >= 2.4
46 lttng-modules >= 2.4
47 babeltrace >= 1.2.0
48
49 For developers using the git tree:
50
51 This source tree is based on the autotools suite from GNU to simplify
52 portability. Here are some things you should have on your system in order to
53 compile 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/)
59
60 If you get the tree from the repository, you will need to use the "bootstrap"
61 script in the root of the tree. It calls all the GNU tools needed to prepare the
62 tree configuration.
This page took 0.030788 seconds and 4 git commands to generate.