Skip to content

INSTALL.md

Latest commit

 

History

History
144 lines (107 loc) · 5.96 KB

INSTALL.md

File metadata and controls

144 lines (107 loc) · 5.96 KB

Install

Install from Release Packages

To install oneTBB from the release packages, use the following commands:

tar -xvf oneapi-tbb-xxx.xx.x-*.tgz
source env/vars.sh

Install from Sources

Prerequisites

  • Make sure you have installed CMake version 3.1 (or newer) on your system. oneTBB uses CMake build configuration.
  • Configure and build oneTBB. To work with build configurations, see Build System Description.

Configure oneTBB

At the command prompt, type:

cmake <options> <repo_root>

You may want to use some additional options for configuration:

Option Purpose Description
-G <generator> Specify project generator For more information, run cmake –help.
-DCMAKE_BUILD_TYPE=Debug Specify for Debug build Not applicable for multi-configuration generators such as Visual Studio generator.
-DTBB_VERIFY_DEPENDENCY_SIGNATURE=ON|OFF Controls signature verification of dynamic dependencies loaded during runtime If set to ON, only the signed dynamic dependencies are loaded. This is the recommended behavior. By default, the value is unspecified. Therefore, the warning is printed. To suppress the warning, set the value explicitly.

Build oneTBB

To build the system, run:

cmake --build . <options>

Some useful build options:

  • --target <target> - specific target, "all" is default.
  • --config <Release|Debug> - build configuration, applicable only for multi-config generators such as Visual Studio generator.

Install and Pack oneTBB

NOTE

Be careful about installing prefix. It defaults to /usr/local on UNIX* and c:/Program Files/${PROJECT_NAME} on Windows* OS. You can define custom CMAKE_INSTALL_PREFIX during configuration:

cmake -DCMAKE_INSTALL_PREFIX=/my/install/prefix ..

Installation can also be done using:

cmake --install <project-binary-dir>

Special --install target can alternatively be used for installation, e.g. make install.

You can use the install components for partial installation.

The following install components are supported:

  • runtime - oneTBB runtime package (core shared libraries and .dll files on Windows* OS).
  • devel - oneTBB development package (header files, CMake integration files, library symbolic links, and .lib files on Windows* OS).
  • tbb4py - oneTBB Module for Python.

If you want to install specific components after configuration and build, run:

cmake -DCOMPONENT=<component> [-DBUILD_TYPE=<build-type>] -P cmake_install.cmake

Simple packaging using CPack is supported. The following commands allow you to create a simple portable package that includes header files, libraries, and integration files for CMake:

cmake <options> ..
cpack

Installation from vcpkg

You can download and install oneTBB using the vcpkg dependency manager:

  git clone https://github.com/Microsoft/vcpkg.git
  cd vcpkg
  ./bootstrap-vcpkg.sh #.\bootstrap-vcpkg.bat(for Windows)
  ./vcpkg integrate install
  ./vcpkg install tbb

The oneTBB port in vcpkg is kept up to date by Microsoft* team members and community contributors. If the version is out of date, create an issue or pull request on the vcpkg repository.

Example

Single-Configuration Generators

The following example demonstrates how to install oneTBB for single-configuration generators (e.g. GNU Make, Ninja, etc.).

# Do our experiments in /tmp
cd /tmp
# Clone oneTBB repository
git clone https://github.com/uxlfoundation/oneTBB.git
cd oneTBB
# Create binary directory for out-of-source build
mkdir build && cd build
# Configure: customize CMAKE_INSTALL_PREFIX and disable TBB_TEST to avoid tests build
cmake -DCMAKE_INSTALL_PREFIX=/tmp/my_installed_onetbb -DTBB_TEST=OFF ..
# Build
cmake --build .
# Install
cmake --install .
# Well done! Your installed oneTBB is in /tmp/my_installed_onetbb

Multi-Configuration Generators

The following example demonstrates how to install oneTBB for multi-configuration generators such as Visual Studio*.

Choose the configuration during the build and install steps:

REM Do our experiments in %TMP%
cd %TMP%
REM Clone oneTBB repository
git clone https://github.com/uxlfoundation/oneTBB.git
cd oneTBB
REM Create binary directory for out-of-source build
mkdir build && cd build
REM Configure: customize CMAKE_INSTALL_PREFIX and disable TBB_TEST to avoid tests build
cmake -DCMAKE_INSTALL_PREFIX=%TMP%\my_installed_onetbb -DTBB_TEST=OFF ..
REM Build "release with debug information" configuration 
cmake --build . --config relwithdebinfo
REM Install "release with debug information" configuration 
cmake --install . --config relwithdebinfo
REM Well done! Your installed oneTBB is in %TMP%\my_installed_onetbb