Commit | Line | Data |
---|---|---|
27caca78 MD |
1 | LTTng trace - Trace command execution and its sub-processes |
2 | ===================================================================== | |
3 | ||
4 | by Mathieu Desnoyers | |
5 | ||
93f41cd5 MD |
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.10**, **Autoconf >= 2.50**, | |
18 | **Autoheader >= 2.50**; | |
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 |