tau2vtf(1) [debian man page]

TAU2VTF(1)							       Tools								TAU2VTF(1)

NAME

       tau2vtf - convert TAU tracefiles to vampir tracefiles

SYNOPSIS

       tau2vtf [-nomessage] [-v] [[-a] [-fa]] {tau_tracefile} {tau_eventfile} {vtf_tracefile}

DESCRIPTION

       This program is generated when TAU is configured with the -vtf=<vtf_dir> option.

       The tau2vtf trace converter takes a single tau_tracefile (*.trc) and tau_eventfile (*.edf) and produces a corresponding vtf_tracefile
       (*.vtf). The input files and output file must be specified in that order. Multi-file TAU traces must be merged before conversion.

       The default output file format is VTF3 binary. If the output filename is given as the .vpt.gz type, rather than .vpt, the output file will
       be gzipped. There are two additional output format options. The command line argument '-a' produces the vtf file output in ASCII VTF3
       format. The command line argument '-fa' produces the vtf file output in the FAST ASCII VTF3 format. Note that these arguments are mutually
       exclusive.

OPTIONS

       -nomessage Suppresses printing of message information in the trace.

       -v Verbose mode sends trace event descriptions to the standard output as they are converted.

       -a Print the vtf file output in the human-readable VTF3 ASCII format

       -fa Print the vtf file in the simplified human-readable FAST ASCII VTF3 format

EXAMPLES

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

       tau2vtf merged.trc tau.edf app.vpt

       The following will convert merged.trc and tau.edf to a gzipped FAST ASCII vampir tracefile app.vpt.gz, with message events omitted:

       tau2vtf merged.trc tau.edf app.vpt.gz -nomessage -fa

SEE ALSO

       vtf2profile(1), tau2profile(1), tau_merge(1), tau_convert(1)

								    12/22/2005								TAU2VTF(1)

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)