Intel® C++ Compiler 16.0 User and Reference Guide
This topic only applies to Intel® 64 and IA-32 architectures targeting Intel® Graphics Technology.
The gfx_sys_check tool is not supported on OS X*.
Before running a heterogeneous application that offloads computations to the Intel® Graphics Technology cores, launch the gfx_sys_check tool to verify that your system is set up correctly.
If all conditions meet the requirements for starting an offload, the tool will offload a small kernel and report the status of the offload.
If an offload cannot be performed, the tool will diagnose possible issues and report them.
The tool checks for the following system characteristics:
| Check | Description |
|---|---|
|
CPU |
Executes the cpuid machine instruction and prints the result. The tool does not identify the model/family of the CPU. |
|
OS version |
On Windows, the supported versions are Windows Vista, Windows 7, and later (dwMajorVersion >= 6). On Linux OS, versions are not checked. |
|
Display driver |
Initializes a display driver and prints all available driver identifications. |
|
Native test |
Launches a simple heterogeneous program to test the entire runtime software stack. If the program is executed successfully, the gfx_sys_check tool prints the result. |
|
MDF library version |
MDF is a separately provided library that is required for performing an offload. The tool checks the minimum MDF requirement specified by MDF option. If this option was not entered, version 3 is assumed as minimum. |
To start the check process, invoke the tool with the following command:
gfx_sys_check [options]
On Linux* OS, options are preceded by a hyphen ( - ); on Windows* OS, options are preceded by a slash ( / ).
There are five options you can specify when invoking the gfx_sys_check tool:
| Option | Description |
|---|---|
|
h |
Prints help and exits. |
|
v |
Verbose mode. Instructs the tool to perform the same checks as in the regular mode, but give more information in the resulting printout. |
|
o <filename> |
Redirects all output to the specified file. |
|
MDF <version> |
Specifies the version of MDF. If the version of MDF installed on your computer is lower than specified, the tool will report an error. The default value for this option is 3, so all MDF versions below 3.0.0.0 are not supported. Enter the <version> in a four-digit dot-separated format: A[.B[.C[.D]]], for example 3.0.0.1017. You can also specify a single number, for example 4, which would mean version 4.0.0.0. |
|
ic <install-dir> |
Not yet implemented. |
The gfx_sys_check tool returns the following exit codes:
| Code | Description |
|---|---|
| 0 | Success |
| 1 | Invalid command line option |
| 2 | Unsupported OS version |
| 3 | Unexpected exception caught |
| 4 | Display driver initialization failed |
| 5 | Native test execution or verification failed |
| 6 | Unsupported MDF version |