tau_merge - Online in the Cloud

PROGRAM:

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

Use tau_merge online using onworks.net services