| 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 |