Skip to content

[SYCL][Doc] Clarify launch of kernels with L0 #20069

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: sycl
Choose a base branch
from
Open

[SYCL][Doc] Clarify launch of kernels with L0 #20069

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 22 additions & 1 deletion sycl/doc/extensions/proposed/sycl_ext_oneapi_free_function_kernels.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ https://github.com/intel/llvm/issues

== Dependencies

This extension is written against the SYCL 2020 revision 8 specification.
This extension is written against the SYCL 2020 revision 10 specification.
All references below to the "core SYCL specification" or to section numbers in
the SYCL specification refer to that revision.

Expand Down Expand Up @@ -941,6 +941,27 @@ bytes) of the device local memory that is represented by the
The pointer passed to `zeKernelSetArgumentValue` or `clSetKernelArg` must be
NULL in this case.

Some kernel features are disallowed when submitting a kernel using Level Zero or
OpenCL.
Other features require the kernel to be invoked in some special way.
These features are detailed below:

* When a kernel's static call tree contains a call to
`get_work_group_scratch_memory` from
link:../experimental/sycl_ext_oneapi_work_group_scratch_memory.asciidoc[
sycl_ext_oneapi_work_group_scratch_memory], the kernel has an additional
"hidden" argument whose value must be set when the kernel is invoked.
This argument appears after all other kernel arguments.
The value corresponds to the `work_group_scratch_size` launch property, which
specifies the size of the dynamic device local memory that is available via
`get_work_group_scratch_memory`.
The kernel argument's size specifies the size (in bytes) of the dynamic device
local memory.
The kernel argument's pointer must be NULL.

* Kernels must not use specialization constants as defined in section 4.9.5
"Specialization constants" of the core SYCL specification.


== Implementation notes

Expand Down