TAU_CONVERT(1) Tools TAU_CONVERT(1)NAME
tau_convert - convert TAU tracefiles into various alternative trace formats
SYNOPSIS
tau_convert [[-alog] [-SSDF] [-dump] [-paraver [-t]] [-pv]
[-vampir [ -longsymbolbugfix ] [ -compact ] [[ -user ] [ -class ] [ -all ]] [ -nocomm ]]] [outputtrc] {inputtrc} {edffile}
DESCRIPTION
tau_convert is generated when TAU is configured with the -TRACE option.
This program requires specification of a TAU tracefile and eventfile. It will convert the given TAU traces to the ASCII-based trace format
specified in the first argument. The conversion type specification may be followed by additional options specific to the conversion type.
It defaults to the single threaded vampir format if no other format is specified. tau_convert also accepts specification of an output file
as the last argument. If none is given it prints the converted data to the standard out.
OPTIONS -alog convert TAU tracefile into the alog format (This format is deprecated. The SLOG2 format is recommended.)
-SDDF convert TAU tracefile into the SDDF format
-dump convert TAU tracefile into multi-column human readable text
-paraver convert TAU tracefile into paraver format
-t indicate conversion of multi threaded TAU trace into paraver format
-pv convert single threaded TAU tracefile into vampir format (all -vampir options apply) (default)
-vampir convert multi threaded TAU tracefile into vampir format
-longsymbolbugfix make the first characters of long, similar identifier strings unique to avoid a bug in vampir
-compact abbreviate individual event entries
-all compact all entries (default)
-user compact user entries only
-class compact class entries only
-nocomm disregard communication events
[outputtrc] specify the name of the output tracefile to be produced
EXAMPLES
To print the contents of a TAU tracefile to the screen:
tau_convert -dump app.trc tau.edf
To convert a merged, threaded TAU tracefile to paraver format:
tau_convert -paraver -t app.trc tau.edf app.pv
SEE ALSO tau_merge(1), tau2vtf(1), tau2profile(1), tau2slog2(1)
12/22/2005 TAU_CONVERT(1)
Check Out this Related Man Page
TAU_MERGE(1) Tools TAU_MERGE(1)NAME
tau_merge - combine multiple node and or thread TAU tracefiles into a merged tracefile
SYNOPSIS
tau_merge [-a] [-r] [-n] [-e eventfile_list] [-m output_eventfile] {tracefile_list} [{output_tracefile} { - }]
DESCRIPTION
tau_merge is generated when TAU is configured with the -TRACE option.
This tool assembles a set of tau trace and event files from multiple multiple nodes or threads across a program's execution into a single
unified trace file. Many TAU trace file tools operate on merged trace files.
Minimally, tau_merge must be invoked with a list of unmerged trace files followed by the desired name of the merged trace file or the -
flag to send the output to the standard out. Typically the list can be designated by giving the shared name of the trace files to be merged
followed by desired range of thread or node designators in brackets or the wild card character '*' to encompass variable thread and node
designations in the filename (trace.A.B.C.trc where A, B and C are the node, context and thread numbers respectively). For example
tautrace.*.trc would represent all tracefiles in a given directory while tautrace.[0-5].0.0.trc would represent the tracefiles of nodes 0
through 5 with context 0 and thread 0.
tau_merge will generate the specified merged trace file and an event definition file, tau.edf by default.
The event definition file can be given an alternative name by using the '-m' flag followed by the desired filename. A list of event
definition files to be merged can be designated explicitly by using the '-e' flag followed by a list of unmerged .edf files, specified in
the same manner as the trace file list.
If computational resources are insufficient to merge all trace and event files simultaneously the process may be undertaken hierarchically.
Corresponding subsets of the tracefiles and eventfiles may be merged in sequence to produce a smaller set of files that can then be to
merged into a singular fully merged tracefile and eventfile. E.g. for a 100 node trace, trace sets 1-10, 11-20, ..., 91-100 could be merged
into traces 1a, 2a, ..., 10a. Then 1a-10a could be merged to create a fully merged tracefile.
OPTIONS -e eventfile_list explicitly define the eventfiles to be merged
-m output_eventfile explicitly name the merged eventfile to be created
- send the merged tracefile to the standard out
-a adjust earliest timestamp time to zero
-r do not reassemble long events
-n do not block waiting for new events. By default tau_merge will block and wait for new events to be appended if a tracefile is
incomplete. This command allows offline merging of (potentially) incomplete tracefiles.
EXAMPLES
To merge all TAU tracefiles into app.trc and produce a merged tau.edf eventfile:
tau_merge *.trc app.trc
To merge all eventfiles 0-255 into ev0_255merged.edf and TAU tracefiles for nodes 0-255 into the standard out:
tau_merge -e events.[0-255].edf -m ev0_255merged.edf
tautrace.[0-255].*.trc -
To merge eventfiles 0, 5 and seven info ev057.edf and tau tracefiles for nodes 0, 5 and 7 with context and thread 0 into app.trc:
tau_merge -e events.0.edf events.5.edf events.7.edf -m ev057.edf
tautrace.0.0.0.trc tautrace.5.0.0.trc tautrace.7.0.0.trc app.trc
SEE ALSO
tau_convert
tau2profile
tau2vtf
tau2elg
tau2slog2
12/22/2005 TAU_MERGE(1)