vtf2profile(1) [debian man page]

VTF2PROFILE(1)							       Tools							    VTF2PROFILE(1)

NAME

       vtf2profile - Generate a TAU profile set from a vampir trace file

SYNOPSIS

       vtf2profile [-p profile] [-i interval_start interval_end] [-c] [-h] {-f tracefile}

DESCRIPTION

       vtf2profile is created when TAU is configured with the -vtf=<vtf_dir> option. This tool converts a VTF trace file (*.vpt) to a tau profile
       set (profile.A.B.C where A, B and C are the node, context and thread numbers respectively).

       The vtf file to be read is specified in the command line by the -f flag followed by the file's location. The VTF tracefile specified may be
       in gzipped form, eg app.vpt.gz. -p is similarly used to specify the relative path to the directory where the profile files should be
       stored. If no output directory is specified the current directory will be used. A contiguous interval within the vtf file may be selected
       for conversion by using the -i flag followed by two integers, representing the timestamp of the start and end of the desired interval
       respectively. The entire vtf file is converted if no interval is given.

OPTIONS

       -f tracefile -Specify the Vampir tracefile to be converted.

       -p profile -Specify the location where the profile file(s) should be written.

       -i interval_start interval_end -Limit the profile produced to the specified interval within the vampir trace file.

       -c -Opens a command line interface for the program.

       -h -Displays a help message.

EXAMPLES

       To convert a vampir tracefile, trace.vpt, to an equivalent TAU profile, use the following:

       vtf2profile -f trace.vpt

       To produce a TAU profile in the ./profiles directory representing only the events from the start of the tracefile to timestamp 6000, use:

       vtf2profile -f trace.vpt -p ./profiles -i 0 6000

SEE ALSO

       tau2vtf(1), tau2profile(1)

								    12/22/2005							    VTF2PROFILE(1)

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)