Intel® Advisor User Guide

ID 766448
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Define the TBBROOT Environment Variable

With Intel® Advisor samples, to build the Intel® oneAPI Threading Building Blocks (oneTBB) project (_tbb), you need to define the TBBROOT environment variable.

To define this environment variable:

On Linux* OS:

  1. Open a command line window.

  2. Use the export command to set the TBBROOT environment variable, type: export TBBROOT=<tbb-install-dir>. If you used the default path during installation, the <tbb-install-dir> is inside:

    • For root users:

      /opt/intel/
    • For non-root users:

      $HOME/intel/

    For example, if you installed the Intel® oneAPI Threading Building Blocks as a part of Intel® oneAPI Base Toolkit, the <tbb-install-dir> may be /opt/intel/oneapi/tbb/<version>.

  3. To always set this variable on the current system, add this definition to your .login or similar shell initialization file.

On Windows* OS:

  1. Open the control panel and access: Control Panel > System and Security > System > Advanced system settings > Environment Variables....

  2. Locate any existing definition of the TBBROOT user or system environment variable. If present, verify that it value is correct if you encountered build errors and either click Cancel or OK as needed to exit the dialog box.

  3. If it is not present, under System variables or User variables, click New.

  4. Specify the Variable name as: TBBROOT.

  5. Specify the Variable value as the path of the installed Intel® oneAPI Base Toolkit files, including the \tbb directory.

    If you installed the product as part of a Intel® oneAPI Base Toolkit and used the default path, files are installed below: C:\Program Files (x86)\Intel\oneAPI\, for example C:\Program Files (x86)\Intel\oneAPI\tbb\<version>.

  6. Click OK several times.

  7. For the change to take effect:

    • If using Microsoft Visual Studio*: close and reopen Visual Studio.

    • If using command window: close and reopen your command window.

    In some cases, you may need to log off and log on for this change to take effect.

  8. If needed, you can test the definition by opening a command window and typing set TBBROOT.

You have defined the TBBROOT environment variable.