Intel® Trace Analyzer and Collector User and Reference Guide

ID 767272
Date 3/31/2023
Document Table of Contents

STF Components

A structured tracefile consists of a number of files, which can be interpreted as one conceptual data set. See the approximate structure in the figure below. Depending on the organization of actual files, the following component files will be written:

  • Index file <trace>.stf

  • Record declaration file <trace>.stf.dcl

  • Statistics file <trace>.stf.sts

  • Message file <trace>.stf.msg

  • Collective operation file <trace>.stf.cop

  • Process file(s) <trace>.stf.*.<index> (where * is one of the symbols, f,i,s,c,r, or x)

  • For the above three kinds of files, one anchor file each with the extension .anc

<trace> is the tracefile name, which is determined automatically or set in the LOGFILE-NAME configuration option.

STF Components

Additionally, five data files may be created for the given trace. These files are Summary Data files. They have common name <trace>.stf.sum.<suffix> (where suffix is one of fnc, cop, msg, cnt, or rep) and formally are not a part of the trace. You can use these files as additional input for Intel® Trace Analyzer. For details of Summary Data usage, see Intel® Trace Analyzer User and Reference Guide.

The records for routine entry/exit and counters are contained in the process files. The anchor files are used by Intel® Trace Analyzer to fast-forward within the record files; they can be deleted, but that may result in slower operation of Intel® Trace Analyzer.

Make sure that you use different names for traces from different runs; otherwise you will experience difficulties in identifying which process files belong to an index file, and which ones are left over from a previous run. To catch all component files, use the stftool with the --remove option to delete a STF file, or put the files into single-file STF format for transmission or archival with the stftool --convert option.

The number of actual process files will depend on the setting of the STF-USE-HW-STRUCTURE and STF-PROCS-PER-FILE configuration options described below.

See Also

stftool Utility