traceparser()

Process trace data

Synopsis:

#include <sys/traceparser.h>

extern int traceparser ( 
   struct traceparser_state * stateptr,
   void * userdata,
   const char * filename );

Arguments:

stateptr
A pointer to the parser's state information, obtained by calling traceparser_init().
userdata
A pointer to arbitrary user data to pass to any event-processing callback that doesn't have its own user data.
filename
The name of the trace file that you want to parse. You can create this file by using tracelogger, TraceEvent(), or some combination of the two.

Library:

libtraceparser

Use the -l traceparser option to qcc to link against this library.

Description:

The traceparser() function starts the parsing of the trace data in filename. You'll use this function if you're creating your own utility for parsing trace data (as an alternative to traceprinter).

Before calling this function, you must have called:

When you've finished parsing the data, call traceparser_destroy() to destroy the parser.

Returns:

0
Success.
-1
Failure; errno is set. See also traceparser_get_info() for further details.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread No

See also:

TraceEvent(), traceparser_cs(), traceparser_cs_range(), traceparser_debug(), traceparser_destroy(), traceparser_get_info(), traceparser_init()

tracelogger, traceprinter in the Utilities Reference

System Analysis Toolkit User's Guide

Analyzing Your System with Kernel Tracing chapter of the Integrated Development Environment User's Guide