Parallel Libtrace HOWTO: Examples

Looking for some worked examples of parallel libtrace code?

Currently, three libtrace tools have been ported to use the parallel API: traceanon, tracertstats and tracestats. Look for the source to these programs in the tools/ directory.

You can also find some parallel code examples in the examples/parallel/ directory.

There is a reasonably complete skeleton of a parallel libtrace program inside the examples/skeleton directory called parallel.c. It provides empty functions for most of the supported callbacks, a signal handler for SIGINT that will call trace_pstop and a main function that will do most of the necessary setup and configuration for you. It's a good starting point if you want to write your own parallel libtrace program.

In terms of documentation, libtrace_parallel.h should be considered the definitive reference (aside from this HOWTO). All functions, data types and special definitions should be covered in there.

Finally, if none of that really helps, you can email [email protected] and someone will do their best to point you in the right direction.