OpenCL

Open Computing Language (OpenCL) is Article description::a framework for writing programs that execute across heterogeneous computing platforms (CPUs, GPUs, DSPs, FPGAs, ASICs, etc.).

Overview
The point of this article is to deal with Gentoo implementation and quirks so the overview will be short. For a better overview of the theoretical aspects, see the OpenCL wikipedia article.

OpenCL presents itself as a library with a simple interface:


 * Standardized API headers (eg. ) for C and C++.
 * The OpenCL library (eg. ).

The standard is made to provide many OpenCL platforms on one system, and each platform can see various devices. Each device has a certain compute characteristics (number of compute units, optimal vector size, memory limits, ...).

The OpenCL standard allows to load OpenCL kernels which are pieces of C99-like code that is JIT-compiled by the OpenCL implementations (most of them rely on to work), and execute these kernels on the target hardware. Functions are provided to compile the kernels, load them, transfer data back and forth from the target devices, etc.

Hardware vendors can benefit from this standard by implementing the OpenCL primitives for their hardware.

Installing an OpenCL implementation means adding a library implementing the OpenCL API, and a reference to the library path in the ICD (Installable Client Driver) database, as a file in.

There is an ICD loader which can be provided by a generic loader or one of the implementations. For most uses of OpenCL one of these must be selected using.

The OpenCL host and device API calls, the memory hierarchy are standard, but it doesn't mean that code which is portable to different implementations will be efficient on all of them. Often, code has to be tested on one implementation to eliminate issues. See the and  sections.

Implementations on Linux
Here are upstream projects that provide an implementation of OpenCL.


 * pocl is an OpenSource, LLVM-based OpenCL implementation for the CPU which is not necessarily the fastest, but is educational
 * mesa has a WIP implementation which works on some GPU devices.
 * AMD provides its AMD APP SDK which contains an OpenCL library.
 * NVIDIA provides its CUDA toolkit which contains an OpenCL library.
 * Intel, on Linux, has an implementation for CPU devices, and another for GPU devices ("Beignet").

The implementations will be developed in further subsections.

ICD
The package provides a layer of indirection to enable different OpenCL implementations, and also provides the OpenCL.pc pkg-config descriptor.

Mesa (clover)
As of mid-2023, installing with the   USE flag provides an OpenCL 1.1 installation that works on Evergreen through Sea Islands AMD GPU families (Vega and later GPU families like Navi are not supported). See the section below for newer GPUs. For a full list of features see the GalliumCompute Matrix.

Since media-libs/mesa-20.3 it supports OpenCL 1.2.

Intel - CPU
The Intel CPU SDK is provided by the which is in portage.

Intel Graphics Compute Runtime
Beginning with the Broadwell processor series, Graphics Compute Runtime for OpenCL is provided by.

Install it manually as the note suggests (64-bit only):

AMD
The newest OpenCL implementation from AMD is ROCm, Radeon Open Compute, which supports GFX8 and newer GPU chips (Fiji, Polaris, Vega). The GFX7 chips are enabled, but not officially supported. For older chips, use either the Mesa clover (above), or amdgpu-pro-opencl (below) implementations. The ROCm source is available on GitHub, at RadeonOpenCompute/ROCm. ROCm is in Gentoo; install. For an error-free operation, it may be necessary to recompile with the   USE flag, and to keep the default   USE flag for.

For ROCm to work properly with the AMDGPU drivers, the following kernel options must be set:

There also exists -package which provides closed source OpenCL libraries from Ubuntu AMDGPU-PRO driver package. These libraries are normally used with the closed source drivers, but this package helps users to try if they can use them with open source  drivers.

nVidia
The driver is provided by the package which is in the main ebuild repository.

Displaying info about OpenCL
Information about the system's OpenCL capabilities can be viewed using the package.

Implementation validation
An implementation (especially the experimental ones) can be checked by running test suites such as:


 * piglit: Open Source OpenGL/OpenCL test suite. Check GalliumCompute for simple piglit tests

Implementation tuning
The main vendors will provide some form of advanced documentation to use their hardware to the maximum:


 * nVidia: For developers targeting nVidia hardware, nVidia provides a Best Practices Guide.
 * AMD: For developers targeting AMD hardware, AMD provides an Optimization Guide.

Some characteristics are not straightforward to find. Benchmarks are one mode of discovery.

LLVM DLL hell
LLVM is starting to become a central library, and it is used by most of the implementations. If the user/implementer is not careful, linkage issues can occur (symbol collisions, constructors getting called multiple times and not handled, etc.). This is something that can be noticed with many implementations also.