Data interpretation (e.g. traceprinter)

To aid in processing the binary trace event data, we provide the libtraceparser library. The API functions let you set up a series of functions that are called when complete buffer slots of event data have been received/read from the raw binary event stream.

We also provide a linear trace event printer (traceprinter) that outputs all of the trace events ordered linearly by their timestamp as they're emitted by the kernel. This utility uses the libtraceparser library. You can also modify the traceprinter source as a basis for your own custom parser or use the API to create an interface to do the following offline or in real time:

• perform analysis
• display results
• debug applications
• create a self-monitoring system
• show events ordered by process or by thread
• show thread states and transitions
• show currently running threads

The traceparser library provides an API for parsing and interpreting the trace events that are stored in the event file. The library simplifies the parsing and interpretation process by letting you easily:

• set up callback functions and associations for each event
• retrieve header and system information from the trace event file
• debug and control the parsing process

For more information, see the Interpreting Trace Data chapter in this guide, as well as the entry for traceprinter in the Utilities Reference.