traceparser()

Process trace data

Synopsis:

#include <sys/traceparser.h>

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:

traceparser_init() to initialize the parser
traceparser_cs(), traceparser_cs_range(), or both to set up callbacks
traceparser_debug() to set the debugging mode (optional)

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