ceph/src/tracing/README.md

   1 Installation
   2 ============
   3
   4 The LTTng libraries that ship with Ubuntu 12.04 have been very buggy, and the
   5 generated header files using `lttng-gen-tp` have needed to be fixed just to
   6 compile in the Ceph tree. The packages available in Ubuntu 14.04 seem to work
   7 alright, and for older versions please install LTTng from the LTTng PPA.
   8
   9     https://launchpad.net/~lttng/+archive/ppa
  10
  11 Then install as normal
  12
  13     apt-get install lttng-tools liblttng-ust-dev
  14
  15 Add/Update Provider
  16 ===================
  17
  18 ## Create tracepoint definition file
  19
  20 Add tracepoint definitions for the provider into a `.tp` file. Documentation
  21 on defining a tracepoint can be found in `man lttng-ust`. By convention files
  22 are named according to the logical sub-system they correspond to (e.g.
  23 `mutex.tp`, `pg.tp`). And add a C source file to be compiled into the tracepoint
  24 provider shared object, in which `TRACEPOINT_DEFINE` should be defined. See
  25 [LTTng document](http://lttng.org/docs/#doc-dynamic-linking) for details.
  26 Place the `.tp` and the `.c` files into the `src/tracing` directory
  27 and modify the CMake file `src/tracing/CMakeLists.txt` accordingly.
  28
  29