Developer Reference for Intel® oneAPI Math Kernel Library for C
mkl_set_num_threads
Specifies the number of OpenMP* threads to use.
Syntax
voidmkl_set_num_threads ( intnt ) ;
Include Files
mkl.h
Input Parameters
Name |
Type |
Description |
|---|---|---|
nt |
int |
nt > 0 - The number of threads suggested by the user. nt ≤ 0 - Invalid value, which is ignored. |
Description
This function enables you to specify how many OpenMP threads Intel® oneAPI Math Kernel Library (oneMKL) should use for internal parallel regions. If this number is not set (default), Intel® oneMKL functions use the default number of threads for the OpenMP run-time library. The specified number of threads applies:
To all Intel® oneMKL functions except the functions from the domains where the number of threads is set with mkl_domain_set_num_threads
To all execution threads except the threads where the number of threads is set with mkl_set_num_threads_local
The number specified is a hint, and Intel® oneMKL may actually use a smaller number.
#include "mkl.h"
...
mkl_set_num_threads(4);
my_compute_using_mkl(); // Intel MKL uses up to 4 OpenMP threads