Trace2 Sample Application

Description

Trace2 is similar to Trace1, except instead of logging the function entry points for all MPI functions, it creates a log for only one function out of a set of MPITrace options. It is a two-tiered filtering system. For example, Trace2 can be configured to only return the mpiMotionMemoryGet(...) functions when filtering for MPITraceMEMORY_GET.

By default, Trace2 filters for the mpiMotionStart(...) function when the MPITraceFUNCTION_ENTRY option is selected. However, it can be configured to filter for any specific function, when another Trace option is selected (see MPITrace). If you change the Trace option, you must also specify the desired function that is to be logged to the circular file.

The log also includes a time stamp of when it was written to the circular file.

A circular file is similar in concept to a circular buffer; it allows trace data to be continually written without taking up too much disk space. To convert the circular files to normal “flat” files, please refer to the CircFileRead sample application.

See MPITrace for trace options.

Source Files

trace2.c | CircFile.c | CircFile.h

Download Now
Last Updated: 21Feb2005

See Also

MPI Documentation
Trace Module

Sample Applications