instrumentation/events/README

   1 * Workflow for updating patches from newer kernel:
   2
   3 Pull the new headers from mainline kernel to lttng-modules/.
   4 Update those headers to fix the lttng-modules instrumentation style.
   5
   6
   7 * Workflow to add new Tracepoint instrumentation to newer kernel,
   8   and add support for it into LTTng:
   9
  10 a) instrument the kernel with new trace events headers. If you want that
  11    instrumentation distributed, you will have to push those changes into
  12    the upstream Linux kernel first,
  13 b) copy those headers into lttng-modules/ directory,
  14 c) look at a diff from other headers between mainline kernel version and
  15    lttng-modules/, and use that as a recipe to alter the new
  16    lttng-modules/ headers.
  17 d) create a new file in probes/ for the new trace event header you added,
  18 e) add it to probes/Makefile,
  19 f) build, make modules_install,
  20 g) don't forget to load that new module too.
  21
  22 Currently, LTTng policy is to only accept headers derived from trace
  23 event headers accepted into the Linux kernel upstream for tracepoints
  24 related to upstream kernel instrumentation.