ltt/branches/poly/README

   1
   2 This package contains the trace reading library and trace viewing tools for
   3 the new Linux Trace Toolkit trace format. The associated kernel files to
   4 generate the new traces are not yet included. In the meantime, a converter
   5 from the old trace format to the new is provided. For more detailed information
   6 see doc/developer/index.html
   7
   8 * Compiling
   9
  10 Some development libraries are needed for compiling :
  11
  12 gtk 2 development libraries (libgtk2.0, libgtk2.0-dev)
  13 glib 2 development libraries (libglib2.0-0, libglib2.0-dev)
  14 libpopt development libraries (libpopt0, libpopt-dev)
  15 libpango development libraries (libpango1.0, libpango1.0-dev)
  16
  17 To compile the source tree from a tarball, simply follow these steps :
  18
  19 - run ./configure
  20 - make
  21 - make install
  22
  23 After running ./configure, you can also go in specific subdirectories and
  24 use make, make install.
  25
  26
  27 * Source Tree Structure
  28
  29 This is a sample of the suggested tree for Linux Trace Toolkit.
  30
  31 ltt: new trace format reading library (and converter).
  32 README: This file.
  33 debian: debian config files (currently empty).
  34 doc:    Documentation.
  35 doc/user:      User related documentation.
  36 doc/developer: Developer related documentation.
  37 kernel: Linux Trace Toolkit kernel code (currently empty).
  38 lttd:   Linux Trace Toolkit daemon (currently empty).
  39 lttv:   Linux Trace Toolkit trace analysis tool and viewer.
  40 lttv/modules:  Linux Trace Toolkit analysis tool and viewer plugin modules.
  41 specs:  RPM config files (currently empty).
  42
  43 * The rest of the tools
  44
  45 You must use the lastest versions of patches for the Linux Kernel. That includes
  46 relayfs and ltt patches, available on the ltt-dev mailing list at
  47 http://www.listserv.shafik.org/pipermail/ltt-dev/. You will find there the
  48 lastest version of the trace daemon that must be used to create the traces. (in
  49 the TraceToolkit package)
  50
  51 Once your traces are created, you must use the convert tool to create a trace in
  52 the proper format from them.
  53
  54 * For Developers
  55
  56 This source tree is based on the autotools suite from GNU to simplify
  57 portability. Here are some things you should have on your system in order to
  58 compile the subversion repository tree :
  59
  60
  61 GNU autotools (automake-1,7, autoconf2.50, autoheader2.50)
  62 (make sure your system wide "automake" points to version 1.7!)
  63 GNU Libtool
  64 (for more information, go to http://www.gnu.org/software/autoconf/)
  65
  66 If you get the tree from the repository, you will need to use the autogen.sh
  67 script. It calls all the GNU tools needed to prepare the tree configuration.
  68
  69
  70
  71 Mathieu Desnoyers