Skip to content

Commit 12cea7f

Browse files
authored
[SYCL][Fusion] Document unsupported features (#11705)
Document SYCL features currently not supported by kernel fusion in the implementation documentation. --------- Signed-off-by: Lukas Sommer <[email protected]>
1 parent 59161fb commit 12cea7f

File tree

2 files changed

+11
-8
lines changed

2 files changed

+11
-8
lines changed

sycl/doc/design/KernelFusionJIT.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,7 @@
22

33
## Context
44

5-
To support the [user driven kernel fusion extension](https://github.com/intel/llvm/pull/7098) (a presentation can be found [here](https://github.com/oneapi-src/oneAPI-tab/blob/main/tab-dpcpp-onedpl/presentations/oneAPI-TAB-20220727-Kernel-Fusion.pdf)).
6-
Currently, only targets able to consume SPIR-V are supported.
5+
To support the [user driven kernel fusion extension](https://github.com/intel/llvm/pull/7098) (a presentation can be found [here](https://github.com/oneapi-src/oneAPI-tab/blob/main/language/presentations/oneAPI-TAB-20220727-Kernel-Fusion.pdf)).
76

87
The basic workflow is shown in the diagram below
98

@@ -284,3 +283,13 @@ flag during static compilation.
284283
During the fusion process at runtime, the JIT will load the LLVM IR and
285284
finalize the fused kernel to the final target. More information is available
286285
[here](./CompilerAndRuntimeDesign.md#kernel-fusion-support).
286+
287+
### Unsupported SYCL constructs
288+
289+
The following SYCL API constructs are currently not officially supported for
290+
kernel fusion and should be considered untested/unsupported:
291+
292+
- Reductions
293+
- `sycl::stream`
294+
- Specialization constants and `sycl::kernel_handler`
295+
- Images (`sycl::unsampled_image` and `sycl::sampled_image`)

sycl/doc/extensions/experimental/sycl_ext_codeplay_kernel_fusion.asciidoc

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -73,12 +73,6 @@ on an API for kernel fusion in SYCL to inform a future extension proposal
7373
addressing the mentioned problems.
7474
====
7575

76-
[NOTE]
77-
====
78-
This extension is currently being implemented in {dpcpp} only for kernels in
79-
SPIRV format.
80-
====
81-
8276
== Overview
8377

8478
Every kernel launch in SYCL carries an overhead due to memory traffic and device

0 commit comments

Comments
 (0)