X-Git-Url: https://git.liburcu.org/?a=blobdiff_plain;f=README.md;h=0bcf0d377c93eeb7dd76bb7ac0cb1f91162f73fd;hb=55d52d490c1396ac26cbf08641fedb3d8859abfd;hp=4a39fa54b57f5c7b167a3ba116adf9bbec645760;hpb=27caca78522727c29c777d3697d007a2fe9724c6;p=lttng-trace.git diff --git a/README.md b/README.md index 4a39fa5..0bcf0d3 100644 --- a/README.md +++ b/README.md @@ -3,4 +3,52 @@ LTTng trace - Trace command execution and its sub-processes by Mathieu Desnoyers -TODO + +Building +-------- + +### Prerequisites + +This source tree is based on the Autotools suite from GNU to simplify +portability. Here are some things you should have on your system in order to +compile the Git repository tree: + + - [GNU Autotools](http://www.gnu.org/software/autoconf/) + (**Automake >= 1.12**, **Autoconf >= 2.69**, + **Autoheader >= 2.69**; + make sure your system-wide `automake` points to a recent version!) + +### Building steps + +If you get the tree from the Git repository, you will need to run + + ./bootstrap + +in its root. It calls all the GNU tools needed to prepare the tree +configuration. + +To build and install, do: + + ./configure + make + sudo make install + +### Usage + +Make sure lttng-tools, lttng-ust, and lttng-modules are installed on +your system. Make sure your user is part of the `tracing` group. + +As root, launch the LTTng session daemon: + + lttng-sessiond -d + +As user, run: + + lttng-trace COMMAND + +Where COMMAND is the command you want to trace. Follow the instructions +on standard error. + +For detailed help, run: + + lttng-trace --help