Skip to content

Commit 748c8e2

Browse files
authored
[SYCL][Docs] Updates to experimental status spec (#284)
* Add `sycl_ext_oneapi_bindless_images` as an unsupported extension. See intel#10609 * Fix host-tasks link, as we now have two sections with this heading. * Add Maxime as contributor to revision 2. * Minor formatting.
1 parent ff54561 commit 748c8e2

File tree

1 file changed

+19
-6
lines changed

1 file changed

+19
-6
lines changed

sycl/doc/extensions/experimental/sycl_ext_oneapi_graph.asciidoc

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1032,7 +1032,7 @@ modifiable graph will perform this action, useful in RAII pattern usage.
10321032
:host-task: https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#subsec:interfaces.hosttasks
10331033

10341034
It is not yet supported to have a host task inside a `command_graph`.
1035-
Support will be added subsequently as detailed in the <<host-tasks, host tasks>>
1035+
Support will be added subsequently as detailed in the <<future-host-tasks, host tasks>>
10361036
part from the <<future-direction, future direction>> section of this specification.
10371037

10381038
=== Queue Behavior In Recording Mode
@@ -1201,6 +1201,16 @@ code `invalid` if a user tries to add them to a graph.
12011201
Removing this restriction is something we may look at for future revisions of
12021202
`sycl_ext_oneapi_graph`.
12031203

1204+
=== sycl_ext_oneapi_bindless_images
1205+
1206+
The new handler methods, and queue shortcuts, defined by
1207+
link:../experimental/sycl_ext_oneapi_bindless_images.asciidoc[sycl_ext_oneapi_bindless_images]
1208+
cannot be used in graph nodes. A synchronous exception will be thrown with error
1209+
code `invalid` if a user tries to add them to a graph
1210+
1211+
Removing this restriction is something we may look at for future revisions of
1212+
`sycl_ext_oneapi_graph`.
1213+
12041214
== Examples
12051215

12061216
[NOTE]
@@ -1502,7 +1512,7 @@ associated with a buffer that was created using a host data pointer will
15021512
outlive any executable graphs created from a modifiable graph which uses
15031513
that buffer.
15041514

1505-
=== Host Tasks [[host-tasks]]
1515+
=== Host Tasks [[future-host-tasks]]
15061516

15071517
A {host-task}[host task] is a native C++ callable, scheduled according to SYCL
15081518
dependency rules. It is valid to record a host task as part of graph, though it
@@ -1666,13 +1676,15 @@ The following features are not yet supported:
16661676
. Using `handler::fill` in a graph node implemented for USM only.
16671677
. Using `handler::memset` in a graph node.
16681678
. Using `handler::prefetch` in a graph node.
1669-
. Using handler::memadvise in a graph node.
1679+
. Using `handler::memadvise` in a graph node.
16701680
. Using specialization constants in a graph node.
16711681
. Using reductions in a graph node.
16721682
. Using sycl streams in a graph node.
16731683
. Thread safety of new methods.
1674-
. Profiling an event returned from graph submission with `event::get_profiling_info()`.
1675-
. Subgraph can only be added as a node to any parent graph once, and will not correctly execute by itself after being added as a sub-graph.
1684+
. Profiling an event returned from graph submission with
1685+
`event::get_profiling_info()`.
1686+
. A sub-graph can only be added as a node to any parent graph once, and will not
1687+
correctly execute by itself after being added as a sub-graph.
16761688

16771689
== Revision History
16781690

@@ -1684,7 +1696,8 @@ The following features are not yet supported:
16841696

16851697
|1|2023-03-23|Pablo Reble, Ewan Crawford, Ben Tracy, Julian Miller
16861698
|Initial public working draft
1687-
|2|2023-08-01|Pablo Reble, Ewan Crawford, Ben Tracy, Julian Miller
1699+
|2|2023-08-01|Pablo Reble, Ewan Crawford, Ben Tracy, Julian Miller,
1700+
Maxime France-Pillois
16881701
|Promote status to experimental
16891702

16901703
|========================================

0 commit comments

Comments
 (0)