projects / lttng-trace.git / blame
| 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/) | |
| a6235500 MJ |
17 | (**Automake >= 1.12**, **Autoconf >= 2.69**, |
| 18 | **Autoheader >= 2.69**; | |
| 93f41cd5 MD |
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 |