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
|
# Portable Computing Language (PoCL)
PoCL is being developed towards an efficient implementation of the OpenCL
standard which can be easily adapted for new targets.
[Official web page](http://portablecl.org)
[Full documentation](http://portablecl.org/docs/html/)
## 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 [user 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.9 or newer
* GNU make or ninja
* pkg-config
* pthread (should be installed by default)
* hwloc v1.0 or newer (e.g. `libhwloc-dev`) - optional
* python3 (for support of LLVM bitcode with SPIR target; optional
but enabled by default)
* llvm-spirv (version-compatible with LLVM) and spirv-tools
(optional; required for SPIR-V support in CPU / CUDA; Vulkan driver
supports SPIR-V through clspv)
On Ubuntu or Debian based distros you can install the relevant packages with
```bash
export LLVM_VERSION=<major LLVM version>
apt install -y python3-dev libpython3-dev build-essential ocl-icd-libopencl1 \
cmake git pkg-config libclang-${LLVM_VERSION}-dev clang-${LLVM_VERSION} \
llvm-${LLVM_VERSION} make ninja-build ocl-icd-libopencl1 ocl-icd-dev \
ocl-icd-opencl-dev libhwloc-dev zlib1g zlib1g-dev clinfo dialog apt-utils \
libxml2-dev libclang-cpp${LLVM_VERSION}-dev libclang-cpp${LLVM_VERSION} \
llvm-${LLVM_VERSION}-dev
```
If your distro does not package the version of LLVM you wish to build against
you might want to set up the
[upstream LLVM package repository](https://apt.llvm.org/).
### Configure & Build
Building PoCL follows the usual CMake workflow, i.e.:
```bash
cd <directory-with-pocl-sources>
mkdir build
cd build
cmake ..
make
# and optionally
make install
```
### Supported LLVM Versions
PoCL aims to support **the latest LLVM version** at the time of PoCL release, **plus the previous** LLVM version. All older LLVM versions are supported on a
"best effort" basis; there might not be build bots continuously testing the code
base nor anyone fixing their possible breakage.
### OpenCL 3.0 support
If you want PoCL built with ICD and OpenCL 3.0 support at platform level,
you will need sufficiently new ocl-icd (2.3.x). For Ubuntu, it can be installed'
from this PPA: https://launchpad.net/~ocl-icd/+archive/ubuntu/ppa
Additionally, if you want the CPU device to report as 3.0 OpenCL
you will need LLVM 14 or newer.
### GPU support on different architectures
PoCL can be used to provide OpenCL driver on several architectures where the hardware manufacturer does not ship them
like Nvidia Tegra (ARM) or IBM Power servers. On PPC64le servers, there are specific instructions to handle the build
of PoCL in [README.PPC64le](./README.PPC64le).
See also [PoCL with CUDA driver](#pocl-with-cuda-driver) section for prebuilt
binaries.
### Windows
Windows support has been unmaintained for a long time and building on Windows
may or may not work. There are old instructions for building with Visual Studio
in [README.Windows](./README.Windows) but with the builtin CMake support of more
recent Visual Studio versions (2019+) it might be enough to install the
dependencies (e.g. with `winget`) and simply open the main `CMakeLists.txt` file
in Visual Studio and let it work its magic.
Contributions for improving compatibility with Windows and more detailed and up
to date build steps are welcome!
### Notes
Building on ARM platforms is possible but lacks a maintainer and there are
[some gotchas](./README.ARM).
If you are a distro maintainer, check [README.packaging](./README.packaging) for
recommendations on build settings for packaged builds.
## 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 KhronoGroup 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.
|
