traceparser_init()

Initialize the traceparser state information

Synopsis:

#include <sys/traceparser.h>

struct traceparser_state * traceparser_init (
   struct traceparser_state * stateptr );

Arguments:

stateptr
NULL or a pointer to a state-information structure obtained from a previous call to traceparser_init().

Library:

libtraceparser

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

Description:

The traceparser_init() function initializes the state of the traceparser library and returns a pointer to an initialized state structure. You'll use this function if you're creating your own utility for parsing trace data (as an alternative to traceprinter).

The traceparser_state structure is an opaque structure for use by the other traceparser functions.

Returns:

A pointer to a valid initialized state structure, or NULL if an error occurred (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(), traceparser_cs(), traceparser_cs_range(), traceparser_debug(), traceparser_destroy(), traceparser_get_info()

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