linux/ltt/lttng-2.11.0/instrumentation/events
Nobody c98ea5e20a Bundle lttng-modules-2.11.7 2022-08-11 22:26:54 +03:00
..
lttng-module Bundle lttng-modules-2.11.7 2022-08-11 22:26:54 +03:00
README Bundle lttng-modules-2.11.7 2022-08-11 22:26:54 +03:00

README

* Workflow for updating patches from newer kernel:

Pull the new headers from mainline kernel to lttng-modules/.
Update those headers to fix the lttng-modules instrumentation style.


* Workflow to add new Tracepoint instrumentation to newer kernel,
  and add support for it into LTTng:

a) instrument the kernel with new trace events headers. If you want that
   instrumentation distributed, you will have to push those changes into
   the upstream Linux kernel first,
b) copy those headers into lttng-modules/ directory,
c) look at a diff from other headers between mainline kernel version and 
   lttng-modules/, and use that as a recipe to alter the new
   lttng-modules/ headers.
d) create a new file in probes/ for the new trace event header you added,
e) add it to probes/Makefile,
f) build, make modules_install,
g) don't forget to load that new module too.

Currently, LTTng policy is to only accept headers derived from trace
event headers accepted into the Linux kernel upstream for tracepoints
related to upstream kernel instrumentation.