X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=README;h=e6a0d4a043d85611117b90440af27e757137c29b;hb=6b40862968f9211983918d0e99cbe3656a0dd600;hp=48ac65727aec9d6056ed2f4e4c38b75c8b1c7461;hpb=98541fcfb395ad8bc7f1dc347694b3ce5527c4c7;p=lttng-modules.git diff --git a/README b/README index 48ac6572..e6a0d4a0 100644 --- a/README +++ b/README @@ -8,28 +8,34 @@ need for additional patches. Other features: - Produces CTF (Common Trace Format) natively, (http://www.efficios.com/ctf) -- Function tracer, perf counters and kprobes support, +- Tracepoints, Function tracer, CPU Performance Monitoring Unit (PMU) + counters and kprobes support, - Integrated interface for both kernel and userspace tracing, - Have the ability to attach "context" information to events in the - trace (e.g. any perf counter, pid, ppid, tid, comm name, etc). So - basically, all the perf "required fields" like "preempt count" and - "bkl count" are all optional, specified on a per-tracing-session basis - (except for timestamp and event id, which are mandatory). + trace (e.g. any PMU counter, pid, ppid, tid, comm name, etc). + All the extra information fields to be collected with events are + optional, specified on a per-tracing-session basis (except for + timestamp and event id, which are mandatory). To build and install, you will need to have your kernel headers available (or access to your full kernel source tree), and use: -make -make install +% make +# make modules_install If you need to specify the target directory to the kernel you want to build against, use: -KERNELDIR=path_to_kernel_dir make -KERNELDIR=path_to_kernel_dir make install +% KERNELDIR=path_to_kernel_dir make +# KERNELDIR=path_to_kernel_dir make modules_install -Use lttng-tools to control the tracer. LTTng tools should automatically load the -kernel modules when needed. +Use lttng-tools to control the tracer. LTTng tools should automatically load +the kernel modules when needed. Use Babeltrace to print traces as a +human-readable text log. These tools are available at the following URL: +http://lttng.org/lttng2.0 + +Please note that the LTTng-UST 2.0 (user-space tracing counterpart of LTTng 2.0) +is still in active development and not released yet. So far, it has been tested on vanilla kernels 2.6.38 and 2.6.39 (on x86 at the moment). It should work fine with newer kernels and other architectures, but