Intel® Math Kernel Library 2019 Developer Reference - C
Enables Intel MKL to dynamically change the number of OpenMP* threads.
void mkl_set_dynamic (int flag);
Name |
Type |
Description |
---|---|---|
flag |
int |
flag = 0 - Requests disabling dynamic adjustment of the number of threads. flag≠ 0 - Requests enabling dynamic adjustment of the number of threads. |
This function indicates whether Intel MKL can dynamically change the number of OpenMP threads or should avoid doing this. The setting applies to all Intel MKL functions on all execution threads. This function takes precedence over the MKL_DYNAMIC environment variable.
Dynamic adjustment of the number of threads is enabled by default. Specifically, Intel MKL may use fewer threads in parallel regions than the number returned by the mkl_get_max_threads function. Disabling dynamic adjustment of the number of threads does not ensure that Intel MKL actually uses the specified number of threads, although the library attempts to use that number.
If you call Intel MKL from within an OpenMP parallel region and want to create internal parallel regions, either disable dynamic adjustment of the number of threads or set the thread-local number of threads (see mkl_set_num_threads_local for how to do it).
#include "mkl.h" … mkl_set_num_threads( 8 ); #pragma omp parallel { my_compute_with_mkl(); // Intel MKL uses 1 thread, being called from OpenMP parallel region mkl_set_dynamic( 0 ); // disable adjustment of the number of threads my_compute_with_mkl(); // Intel MKL uses 8 threads }