Skip to contentSkip to conversation

New tracef() feature in LTTng-UST

DISCUSSION Hollis Blanchard 1 participant 1 message Mar 17, 2014 1 message not in the archive

lore
Share & tools
lore
#1 lore raw
In reply to a message not in the archive
Quoted 25 lines · Mathieu Desnoyers

Hi everyone,

I pushed a new features in LTTng-UST that I'm sure everyone will like.

USAGE WITH TRACEF

The simplest way to add instrumentation to your code is by far the tracef() API. To you it, in a nutshell:

1) #include <lttng/tracef.h>

2) /* in your code, use like a printf */ tracef("my message, this integer %d", 1234);

3) Link your program against liblttng-ust.so.

4) Enable the UST event "lttng_ust_tracef:event" when tracing with the following sequence of commands from lttng-tools:

lttng create; lttng enable-event -u "lttng_ust_tracef:event"; lttng start [... run your program ...]
lttng stop; lttng view

That's it!

Quoted 7 lines

If you want to have more flexibility and control on the event names, payload typing, etc, you can continue reading on and use the trace‐ points below. "tracef()" is there for quick and dirty ad hoc instrumen‐ tation, whereas tracepoint.h is meant for thorough instrumentation of a code base to be integrated with an upstream project.

Feedback is welcome!

I haven't seen vocal support for this yet, so let me just say this is a *very* welcome addition. Today, one of the first questions we get from our customers is "how do I create new tracepoints in my code?", and unfortunately that's almost always a very painful discussion. Having this API available would be a big help.

Hollis Blanchard
Product Owner, Sourcery CodeBench <http://go.mentor.com/codebench> and Sourcery Analyzer <http://go.mentor.com/sourceryanalyzer>
Mentor Graphics Embedded Software Division

_______________________________________________
lttng-dev mailing list
[email protected]
http://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev