Intel® Math Kernel Library 2018 Developer Reference - C
For the Automatic Offload mode, returns the status of the latest call to an Intel MKL function.
int mkl_mic_get_status (void);
This function returns the status of the latest call to an Intel MKL function done in the Automatic Offload (AO) mode. The sign of the returned value characterizes the status of the AO computations at a high level:
= 0 - The computations completed successfully using AO
> 0 - The computations were done without using AO
< 0 - The computations were not completed at all
In an AO call to an Intel MKL function, offloading computations as expected may not be possible for various reasons, such as:
Lack of available memory or computation cores on an Intel Xeon Phi coprocessor
Incorrect environment settings (which result in a failure to locate or load a coprocessor driver or libraries)
Communication error during data transfer to or from a coprocessor (for example, a remote process dies unexpectedly)
Other unexpected error
The status returned helps you to find out the reason of offload failure.
Because the status is a thread-local value, to be able to check the status of an Intel MKL AO function, the following sequence of function calls in the same thread is required:
mkl_mic_clear_status
Intel MKL function
mkl_mic_get_status
Name |
Type |
Description |
---|---|---|
status |
int |
The thread-local value of the status:
|
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 |