Name

trace2profile — convert TAU tracefiles to TAU profile files

Synopsis

tau2vprofile [ -d directory ] [ -s snapshot_interval ] { tau_tracefile } { tau_eventfile }

Description

This program is generated when TAU is configured with the -TRACE option.

The trace2profile converter takes a single tau_tracefile (*.trc) and tau_eventfile (*.edf) and produces a corresponding series of profile files. The input files must be specified in that order, with optinal parameters coming afterward. Multi-file TAU traces must be merged before conversion.

Options

-d Output profile files to the specified 'directory' rather than the current directory.

-s Output a profile snapshot showing the state of the profile data accumulated from the trace every 'snapshot_interval' time units. The snapshot profiles are placed sequentially in directories labled 'snapshot_n' where 'n' is an integer ranging from 0 to to the total number of snapshots -1.

Examples

The program must be run with the tau trace and tau event files specified in the command line in that order. Any additional arguments follow. The following will produce a profile file array, from the TAU trace and event files merged.trc and tau.edf trace file:

trace2profile merged.trc tau.edf
      

The following will convert merged.trc and tau.edf to a series of profiles one directory higher. It will also produce a profile snapshot every 250,000 time units:

trace2profile merged.trc tau.edf -d ./.. -s 250000