Developer Guide

  • 2021.2
  • 06/11/2021
  • Public
Contents

Build Libraries from Sources

The Intel® TCC Tools host package contains source files for the measurement library and cache allocation library. You can use the sources to build the libraries for environments that are not directly supported by Intel® TCC Tools.

Dependencies

The measurement library requires the development headers of the Instrumentation and Tracing Technology API (ITT API) for compilation and has no runtime dependencies. To configure your host system for building the measurement library, follow the instructions in Host System Setup.
The cache allocation library has no additional build dependencies. During runtime, it expects the
tcc_buffer
driver to be loaded and other components of the software stack to be configured to provide cache allocation capabilities. The cache allocation library communicates with the
tcc_buffer
driver through a set of ioctl calls; other components of the stack affect cache allocation indirectly. Enabling other components of the stack for cache allocation is outside the scope of this document.

Library Sources Location

Sources are available in
${TCC_ROOT}/sources
after installing the Intel® TCC Tools host package and setting the environment configuration. Feel free to explore and check the implementation.

Build Steps

Use the following steps to build the libraries:
  1. Make sure you have completed the steps in Host System Setup.
  2. Create a build directory:
    cd ${TCC_ROOT}/sources mkdir build && cd build
  3. Run cmake:
    cmake -DCMAKE_INSTALL_PREFIX=./install ../
  4. Build the libraries:
    make && make install
After the build finishes, the install directory will contain
include
,
lib64
, and
share
directories.

Using the Libraries

To use the produced libraries, copy the
include
and
lib64
directories to the proper directories on your target system.
Check that
/usr/share/tcc_tools/config
exists or copy
install/share/tcc_tools/config
into
/usr/share/tcc_tools/config
on the target system. Alternatively, you can use the TCC_CONFIG_PATH environment variable to specify the path to the config file:
export TCC_CONFIG_PATH=<path_to_your_config>

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.