Intel® oneAPI Math Kernel Library Developer Reference - C
Enables dispatching for new Intel® architectures or restricts the set of Intel® instruction sets available for dispatching.
int mkl_enable_instructions (int isa);
Name |
Type |
Description |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
isa |
int |
The latest Intel® instruction-set architecture (ISA) for Intel® oneAPI Math Kernel Library to dispatch.
|
Intel® oneAPI Math Kernel Library does run-time processor dispatching to identify appropriate internal code paths to traverse for Intel® oneAPI Math Kernel Library functions called by the application. Themkl_enable_instructions function controls the behavior of the dispatcher to do either of the following:
Enable dispatching for new Intel architectures.
Intel® oneAPI Math Kernel Library does not dispatch instruction sets that do not have silicon available at time of the product launch. Callmkl_enable_instructions to enable dispatching the code path for such an ISA in a simulator environment or on hardware that supports this ISA.
Restrict the set of Intel instruction sets available for dispatching.
Call mkl_enable_instructions to restrict dispatching to code paths for earlier ISA. For example, if the hardware supports Intel AVX, a call to mkl_enable_instructions with the MKL_ENABLE_SSE4_2 parameter forces the dispatcher to use the Intel SSE4-2 code path.
If the system does not support the instruction set specified by the isa parameter or if the system is based on a non-Intel architecture, mkl_enable_instructions does nothing and returns zero.
Settings specified by the mkl_enable_instructions function set an upper limit to settings specified by the mkl_cbwr_set function.
You can use the MKL_ENABLE_INSTRUCTIONS environment variable instead of calling mkl_enable_instructions (for more details, see theIntel® oneAPI Math Kernel Library Developer Guide); however, the settings specified by the function take precedence over the settings specified by the environment variable.
Name |
Type |
Description |
---|---|---|
irc |
int |
Function completion status: 1 - Intel® oneAPI Math Kernel Library dispatches the code path for the specified ISA by default. 0 - The request is rejected. Usually this occurs if mkl_enable_instructions was called:
|
Optimization Notice |
---|
Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice. Notice revision #20110804 |