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

Recording Hardware Performance Information (Linux* OS)

On Linux* OS Intel® Trace Collector can sample hardware counters with the Performance Application Programming Interface (PAPI). Because PAPI might not be available on a system, support for it is provided as an additional layer on top of the normal Intel® Trace Collector.
This layer is implemented in the
VT_sample.c
source file. It is a sample file that traces counters available through PAPI High level API.
To record hardware counters, do the following:
  1. Adjust the
    VT_sample.c
    sample with the necessary counters
  2. Rebuild the
    libVTsample.so
    file:
    1. Copy the contents of
      <isntall-dir>/slib
      directory into your working directory.
    2. Edit the provided
      Makefile
      to match the local setup.
    3. Build the file using the
      make
      command.
  3. Set the
    LD_LIBRARY_PATH
    environment variable as follows:
    $ export LD_LIBRARY_PATH=<path_to_libVTsample>:<path_to_PAPI>
  4. Add
    libVTsample.so
    to the link line in front of the Intel® Trace Collector library. The link line will look as follows:
    $ mpiicc ctest.c -L$VT_SLIB_DIR -L. -L$PAPI_ROOT -lVTsample -lVT -lpapi $VT_ADD_LIBS -o ctest
To view the counters in Intel® Trace Analyzer, use
Counter Timeline
.

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