README

   1 LTTngTop
   2 Julien Desfossez <jdesfossez@efficios.com>
   3 June 2015
   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 release is the first one that handles live sessions as well as
   9 offline sessions.
  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.4 development library
  43           (Debian : libbabeltrace-dev, libbabeltrace-ctf-dev)
  44
  45 To use the local live tracing feature, you need:
  46         lttng-tools >= 2.4
  47         lttng-modules >= 2.4
  48         babeltrace = 1.2.4
  49
  50 For developers using the git tree:
  51
  52 This source tree is based on the autotools suite from GNU to simplify
  53 portability. Here are some things you should have on your system in order to
  54 compile the git repository tree :
  55
  56 - GNU autotools (automake >=1.10, autoconf >=2.50, autoheader >=2.50)
  57   (make sure your system wide "automake" points to a recent version!)
  58 - GNU Libtool >=2.2
  59   (for more information, go to http://www.gnu.org/software/autoconf/)
  60
  61 If you get the tree from the repository, you will need to use the "bootstrap"
  62 script in the root of the tree. It calls all the GNU tools needed to prepare the
  63 tree configuration.