• 2019 Update 3
  • 03/07/2019
  • Public Content
  • Download as PDF
Contents

Synopsis
xstftool
<STF file>
[stftool options]
Valid options are those that work together with
stftool --dump
, the most important ones being:
  • --request
    : extract a subset of the data
  • --matched-vtf
    : put information about complex events like messages and collective operations into one line
Description
The
xstftool
is a simple wrapper around the
stftool
and the
expandvtlog.pl
Perl* script which tells the
stftool
to dump a given Structured Trace Format (STF) file in ASCII format and uses the script as a filter to make the output more readable.
It is intended to be used for doing custom analysis of trace data with scripts that parse the output to extract information not provided by the existing tools, or for situations where a few shell commands provide the desired information more quickly than a graphical analysis tool.
Output
The output has the format of the ASCII Vampir* Trace Format (VTF), but entities like function names are not represented by integer numbers that cannot be understood without remembering their definitions, but rather inserted into each record. The CPU numbers that encode process and thread ranks resp. groups are also expanded.
Examples
The following examples compare the output of
stftool --dump
with the expanded output of
xstftool
:
  • definition of a group
DEFGROUP 2147942402 "All_Processes" NMEMBS 2 2147483649 2147483650 DEFGROUP All_Processes NMEMBS 2 "Process_0" "Process_2"
  • a counter sample on thread 2 of the first process
8629175798 SAMP CPU 131074 DEF 6 UINT 8 3897889661 8629175798 SAMP CPU 2:1 DEF "PERF_DATA:PAPI_TOT_INS" UINT 8 3897889661

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804