1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
# Portable Computing Language (PoCL)
PoCL is a conformant implementation (for [CPU](https://www.khronos.org/conformance/adopters/conformant-products/opencl#submission_450)
and [Level Zero GPU](https://www.khronos.org/conformance/adopters/conformant-products/opencl#submission_453) targets)
of the OpenCL 3.0 standard which can be easily adapted for new targets.
[Official web page](http://portablecl.org)
[Full documentation](http://portablecl.org/docs/html/)
[](https://www.bestpractices.dev/projects/9499)
[](https://scan.coverity.com/projects/pocl-pocl)
## Building
This section contains instructions for building PoCL in its default
configuration and a subset of driver backends. You can find the full build
instructions including a list of available options
in the [install guide](http://portablecl.org/docs/html/install.html).
### Requirements
In order to build PoCL, you need the following support libraries and
tools:
* Latest released version of LLVM & Clang
* development files for LLVM & Clang + their transitive dependencies
(e.g. `libclang-dev`, `libclang-cpp-dev`, `libllvm-dev`, `zlib1g-dev`,
`libtinfo-dev`...)
* CMake 3.15 or newer
* GNU make or ninja
* Optional: pkg-config
* Optional: hwloc v1.0 or newer (e.g. `libhwloc-dev`)
* Optional (but enabled by default): python3 (for support of LLVM bitcode with SPIR target)
* Optional: llvm-spirv (version-compatible with LLVM) and spirv-tools
(required for SPIR-V support in CPU / CUDA; Vulkan driver supports SPIR-V through clspv)
For more details, consult the [install guide](http://portablecl.org/docs/html/install.html).
Building PoCL follows the usual CMake build steps. Note however, that PoCL
can be used from the build directory (without installing it system-wide).
## Supported environments
### CI status:
### Support Matrix legend:
:large_blue_diamond: Achieved status of OpenCL conformant implementation
:large_orange_diamond: Tested in CI extensively, including OpenCL-CTS tests
:green_circle: : Tested in CI
:yellow_circle: : Should work, but is untested
:x: : Unsupported
### Linux
| CPU device | LLVM 17 | LLVM 18 | LLVM 19 | LLVM 20 | LLVM 21 |
|:------------|:--------------:|:---------------:|:----------------:|:---------------:|:---------------:|
| [x86-64](https://github.com/pocl/pocl/actions/workflows/build_linux_gh.yml) | :green_circle: | :green_circle: :large_blue_diamond: | :green_circle: | :large_orange_diamond: | :large_orange_diamond: |
| [ARM64](https://github.com/pocl/pocl/actions/workflows/build_arm64.yml) | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: | :green_circle: |
| i686 | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: |
| ARM32 | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: |
| RISC-V | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: |
| PowerPC | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: |
| GPU device | LLVM 17 | LLVM 18 | LLVM 19 | LLVM 20 | LLVM 21 |
|:------------|:--------------:|:---------------:|:----------------:|:---------------:|:---------------:|
| [CUDA SM5.0](https://github.com/pocl/pocl/actions/workflows/build_cuda.yml) | :yellow_circle: | :green_circle: | :yellow_circle: | :green_circle: | :x: |
| CUDA SM other than 5.0 | :yellow_circle: | :yellow_circle: | :yellow_circle: | :yellow_circle: | :x: |
| [Level Zero](https://github.com/pocl/pocl/actions/workflows/build_level0.yml) | :yellow_circle: | :yellow_circle: | :green_circle: | :green_circle: | :large_orange_diamond: |
| [Vulkan](https://github.com/pocl/pocl/actions/workflows/build_openasip_vulkan.yml) | :green_circle: | :x: | :x: | :x: | :x: |
Note: CUDA with LLVM 21 is broken due to a bug in Clang (https://github.com/llvm/llvm-project/issues/154772).
| Special device | LLVM 17 | LLVM 18 | LLVM 19 | LLVM 20 | LLVM 21 |
|:---------------|:-------------:|:---------------:|:----------------:|:---------------:|:---------------:|
| [OpenASIP](https://github.com/pocl/pocl/actions/workflows/build_openasip_vulkan.yml) | :green_circle: | :x: | :x: | :x: | :x: |
| [Remote](https://github.com/pocl/pocl/actions/workflows/build_remote.yml) | :green_circle: | :green_circle: | :green_circle: | :green_circle: | :yellow_circle: |
### Mac OS X
| CPU device | LLVM 17 | LLVM 18 | LLVM 19 | LLVM 20 | LLVM 21 |
|:------------|:--------------:|:---------------:|:----------------:|:---------------:|:----------------:|
| [Apple Silicon](https://github.com/pocl/pocl/actions/workflows/build_macos.yml) | :yellow_circle: | :green_circle: | :green_circle: | :yellow_circle: | :yellow_circle: |
| [Intel CPU](https://github.com/pocl/pocl/actions/workflows/build_macos.yml) | :yellow_circle: | :yellow_circle: | :x: | :x: | :x: |
### Windows
| CPU device | LLVM 18 | LLVM 19 | LLVM 20 | LLVM 21 |
|:------------|:--------------:|:---------------:|:---------------:|:---------------:|
| [MinGW](https://github.com/pocl/pocl/actions/workflows/build_mingw.yml) / x86-64 | :yellow_circle: | :green_circle: | :yellow_circle: | :yellow_circle: |
| [MSVC](https://github.com/pocl/pocl/actions/workflows/build_msvc.yml) / x86-64 | :yellow_circle: | :green_circle: | :green_circle: | :yellow_circle: |
## Binary packages
### Linux distros
PoCL with CPU device support can be found on many linux distribution managers.
See [](https://repology.org/project/pocl/versions)
### PoCL with CUDA driver
PoCL with CUDA driver support for Linux `x86_64`, `aarch64` and `ppc64le`
can be found on conda-forge distribution and can be installed with
wget "https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-$(uname)-$(uname -m).sh"
bash Mambaforge-$(uname)-$(uname -m).sh # install mambaforge
To install pocl with cuda driver
mamba install pocl-cuda
To install all drivers
mamba install pocl
### macOS
#### Homebrew
PoCL with CPU driver support Intel and Apple Silicon chips can be
found on homebrew and can be installed with
brew install pocl
Note that this installs an ICD loader from KhronoGroup and the builtin
OpenCL implementation will be invisible when your application is linked
to this loader.
#### Conda
PoCL with CPU driver support Intel and Apple Silicon chips
can be found on conda-forge distribution and can be installed with
curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-$(uname)-$(uname -m).sh"
bash Mambaforge-$(uname)-$(uname -m).sh
To install the CPU driver
mamba install pocl
Note that this installs an ICD loader from KhronosGroup and the builtin
OpenCL implementation will be invisible when your application is linked
to this loader. To make both pocl and the builtin OpenCL implementaiton
visible, do
mamba install pocl ocl_icd_wrapper_apple
## License
PoCL is distributed under the terms of the MIT license. Contributions are expected
to be made with the same terms.
|
