Intel® C++ Compiler 16.0 User and Reference Guide
This topic only applies to Intel® Many Integrated Core Architecture (Intel® MIC Architecture).
Use the functions described in this section to determine:
the number of coprocessors in a system
the coprocessor on which a program is running
Use the header file offload.h to define the interfaces for these functions and their usage. Include it with #include offload.h.
In a system with multiple coprocessors, you need to specify the target-number argument when using the offload pragma to reliably use data persistence. When you use alloc_if or free_if to implement data persistence on the coprocessor, but do not specify target-number, the compiler runtime randomly chooses a coprocessor, so the chosen coprocessor could be one on which the data is not available.
To determine the number of coprocessors in the system, use the function int _Offload_number_of_devices().
The function returns an integer equal to the number of coprocessors installed and working in the system. If none are installed and working, the return value is 0.
To determine the coprocessor that is executing the program, use the function int _Offload_get_device_number().
The function returns an integer equal to the number of the coprocessor executing the program, where 0 is the first card. If the program is executing on the CPU, the return value is -1.
To determine if a section of offloaded code has completed running on a given coprocessor, you can use the API _Offload_signaled().
The syntax for this API is:
extern int _Offload_signaled(int target_number, void *signal);