README

   1 LTTNG USERSPACE TRACER
   2
   3 Dependencies:
   4
   5 - liburcu
   6   Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
   7   http://ltt.polymtl.ca/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary
   8
   9 - libkcompat
  10   Linux kernel userspace compatibility library.
  11   http://git.dorsal.polymtl.ca
  12
  13 Installation instruction:
  14
  15 - Download, compile and install liburcu and libkcompat.
  16 - In this package's tree, run ./configure.
  17 - Run make.
  18 - Run make install.
  19 - Run ldconfig.
  20 - See the manual in the doc/ directory for usage instructions.
  21
  22 Package contents:
  23
  24 - libust
  25   The actual userspace tracing library that must be linked to the
  26   instrumented programs.
  27
  28 - ustctl
  29   A program to control the tracing of userspace applications. It can list
  30   markers, start the tracing, stop the tracing, enable/disable markers, etc.
  31
  32 - ustd
  33   The daemon that collects trace data and writes it to the disk.
  34
  35 - Documentation
  36
  37 - hello
  38   An example application that uses the userspace tracer.
  39
  40 - libmallocwrap
  41   An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
  42   in any program without need to recompile it.
  43
  44 - libinterfork
  45   A library that is LD_PRELOAD'ed, and that hijacks calls to several system
  46   calls in order to trace across these calls.