README

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