README.md

   1 LTTng trace - Trace command execution and its sub-processes
   2 =====================================================================
   3
   4 by Mathieu Desnoyers
   5
   6
   7 Building
   8 --------
   9
  10 ### Prerequisites
  11
  12 This source tree is based on the Autotools suite from GNU to simplify
  13 portability. Here are some things you should have on your system in order to
  14 compile the Git repository tree:
  15
  16   - [GNU Autotools](http://www.gnu.org/software/autoconf/)
  17     (**Automake >= 1.12**, **Autoconf >= 2.69**,
  18     **Autoheader >= 2.69**;
  19     make sure your system-wide `automake` points to a recent version!)
  20
  21 ### Building steps
  22
  23 If you get the tree from the Git repository, you will need to run
  24
  25     ./bootstrap
  26
  27 in its root. It calls all the GNU tools needed to prepare the tree
  28 configuration.
  29
  30 To build and install, do:
  31
  32     ./configure
  33     make
  34     sudo make install
  35
  36 ### Usage
  37
  38 Make sure lttng-tools, lttng-ust, and lttng-modules are installed on
  39 your system. Make sure your user is part of the `tracing` group.
  40
  41 As root, launch the LTTng session daemon:
  42
  43     lttng-sessiond -d
  44
  45 As user, run:
  46
  47     lttng-trace COMMAND
  48
  49 Where COMMAND is the command you want to trace. Follow the instructions
  50 on standard error.
  51
  52 For detailed help, run:
  53
  54     lttng-trace --help