X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=instrumentation%2Fevents%2FREADME;h=fc3cd6e256f34cc0cfbb954dd642ada9804af2e4;hb=ecd86863f274c6661a2393cbcb02593f66144c7f;hp=dad2cbbd9de888a4db8119dd9f804a75291ce7da;hpb=ae3dd5f081c58c263e6a70f46546c3b12b3213af;p=lttng-modules.git diff --git a/instrumentation/events/README b/instrumentation/events/README index dad2cbbd..fc3cd6e2 100644 --- a/instrumentation/events/README +++ b/instrumentation/events/README @@ -1,7 +1,24 @@ -The workflow for updating patches from newer kernel: +* Workflow for updating patches from newer kernel: -Diff mainline/ and lttng-module/ directories. +Pull the new headers from mainline kernel to lttng-modules/. +Update those headers to fix the lttng-modules instrumentation style. -Pull the new headers from mainline kernel to mainline/. -Copy them into lttng-modules. -Apply diff. Fix conflicts. + +* 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.