src/tbb/INSTALL.md

In RcppCore/RcppParallel: Parallel Programming Tools for 'Rcpp'

Installation 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. |

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 of Installation

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/oneapi-src/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/oneapi-src/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

RcppCore/RcppParallel documentation built on June 10, 2025, 5:54 a.m.