Skip to content

Commit a9acb70

Browse files
authored
[NFC][SYCL][Doc] Fix dependencies installation documentation (#3088)
- Fix TBB links to point to Gold Release binaries; - Align with Gold release by fixing directory structure and directory/archive naming scheme; - Mention possibility to build TBB RT from sources in GetStartedGuide.md That change also fixes issue #3077.
1 parent 697c018 commit a9acb70

File tree

2 files changed

+26
-20
lines changed

2 files changed

+26
-20
lines changed

buildbot/dependency.conf

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,15 @@ ocl_gpu_rt_ver=21.02.18820
1010
# https://downloadmirror.intel.com/30066/a08/igfx_win10_100.9030.zip
1111
ocl_gpu_rt_ver_win=27.20.100.9030
1212
intel_sycl_ver=build
13-
# https://github.com/oneapi-src/oneTBB/releases/download/v2021.1-beta10/oneapi-tbb-2021.1-beta10-lin.tgz
14-
tbb_ver=2021.1.053
15-
# Binaries can be built from sources following instructions under:
13+
14+
# TBB binaries can be built from sources following instructions under
1615
# https://github.com/oneapi-src/oneTBB/blob/master/cmake/README.md
16+
# or downloaded using links below:
17+
# https://github.com/oneapi-src/oneTBB/releases/download/v2021.1.1/oneapi-tbb-2021.1.1-lin.tgz
18+
tbb_ver=2021.1.053
19+
# https://github.com/oneapi-src/oneTBB/releases/download/v2021.1.1/oneapi-tbb-2021.1.1-win.zip
1720
tbb_ver_win=2021.1.049
21+
1822
# https://github.com/intel/llvm/releases/download/2020-WW45/fpgaemu-2020.11.11.0.04_rel.tar.gz
1923
ocl_fpga_emu_ver=2020.11.11.0.04
2024
# https://github.com/intel/llvm/releases/download/2020-WW45/win-fpgaemu-2020.11.11.0.04_rel.zip

sycl/doc/GetStartedGuide.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -207,35 +207,37 @@ run the following commands
207207
/etc/OpenCL/vendors/intel_expcpu.icd
208208
```
209209

210-
3) Extract TBB libraries. For example, for the archive tbb-<tbb_version>-lin.tgz
210+
3) Extract or build TBB libraries using links in
211+
[the dependency configuration file](../../buildbot/dependency.conf). For example,
212+
for the archive oneapi-tbb-<tbb_version>-lin.tgz:
211213

212214
```bash
213-
mkdir -p /opt/intel/tbb_<tbb_version>
214-
cd /opt/intel/tbb_<tbb_version>
215-
tar -zxvf tbb*lin.tgz
215+
mkdir -p /opt/intel
216+
cd /opt/intel
217+
tar -zxvf oneapi-tbb*lin.tgz
216218
```
217219

218220
4) Copy files from or create symbolic links to TBB libraries in OpenCL RT
219221
folder:
220222

221223
```bash
222224
# OpenCL FPGA emulation RT
223-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbb.so
225+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbb.so
224226
/opt/intel/oclfpgaemu_<fpga_version>/x64
225-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbbmalloc.so
227+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbbmalloc.so
226228
/opt/intel/oclfpgaemu_<fpga_version>/x64
227-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbb.so.12
229+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbb.so.12
228230
/opt/intel/oclfpgaemu_<fpga_version>/x64
229-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbbmalloc.so.2
231+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbbmalloc.so.2
230232
/opt/intel/oclfpgaemu_<fpga_version>/x64
231233
# OpenCL CPU RT
232-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbb.so
234+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbb.so
233235
/opt/intel/oclcpuexp_<cpu_version>/x64
234-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbbmalloc.so
236+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbbmalloc.so
235237
/opt/intel/oclcpuexp_<cpu_version>/x64
236-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbb.so.12
238+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbb.so.12
237239
/opt/intel/oclcpuexp_<cpu_version>/x64
238-
ln -s /opt/intel/tbb_<tbb_version>/tbb/lib/intel64/gcc4.8/libtbbmalloc.so.2
240+
ln -s /opt/intel/oneapi-tbb-<tbb_version>/lib/intel64/gcc4.8/libtbbmalloc.so.2
239241
/opt/intel/oclcpuexp_<cpu_version>/x64
240242
```
241243

@@ -262,9 +264,9 @@ not working properly.
262264
[the dependency configuration file](../../buildbot/dependency.conf). For
263265
example, to `c:\oclcpu_rt_<cpu_version>`.
264266

265-
3) Extract the archive with TBB runtime using links in
266-
[the dependency configuration file](../../buildbot/dependency.conf). For
267-
example, to `c:\tbb_<tbb_version>`.
267+
3) Extract the archive with TBB runtime or build it from sources using links
268+
in [the dependency configuration file](../../buildbot/dependency.conf). For
269+
example, to `c:\oneapi-tbb-<tbb_version>`.
268270

269271
4) Run `Command Prompt` as `Administrator`. To do that click `Start` button,
270272
type `Command Prompt`, click the Right mouse button on it, then click
@@ -278,10 +280,10 @@ command:
278280
```bash
279281
# Install OpenCL FPGA emulation RT
280282
# Answer N to clean previous OCL_ICD_FILENAMES configuration
281-
c:\oclfpga_rt_<fpga_version>\install.bat c:\tbb_<tbb_version>\tbb\bin\intel64\vc14
283+
c:\oclfpga_rt_<fpga_version>\install.bat c:\oneapi-tbb-<tbb_version>\redist\intel64\vc14
282284
# Install OpenCL CPU RT
283285
# Answer Y to setup CPU RT side-bi-side with FPGA RT
284-
c:\oclcpu_rt_<cpu_version>\install.bat c:\tbb_<tbb_version>\tbb\bin\intel64\vc14
286+
c:\oclcpu_rt_<cpu_version>\install.bat c:\oneapi-tbb-<tbb_version>\redist\intel64\vc14
285287
```
286288
287289
### Obtain prerequisites for ahead of time (AOT) compilation

0 commit comments

Comments
 (0)