traceparser()
QNX SDP8.0C Library ReferenceAPIDeveloper
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:
Safety: | |
---|---|
Cancellation point | No |
Signal handler | No |
Thread | No |
Page updated: