@@ -486,10 +486,10 @@ class depends_on {
486
486
}
487
487
----
488
488
489
- ==== Depends-On-All-Leaves Property
489
+ ==== Depends-On-All-Leaves Property
490
490
The API for explicitly adding nodes to a `command_graph` includes a
491
- `property_list` parameter. This extension defines the `depends_on_all_leaves`
492
- property to be passed here. `depends_on_all_leaves` provides a shortcut for
491
+ `property_list` parameter. This extension defines the `depends_on_all_leaves`
492
+ property to be passed here. `depends_on_all_leaves` provides a shortcut for
493
493
adding all the current leaves of a graph as dependencies.
494
494
[source,c++]
495
495
----
@@ -757,11 +757,11 @@ print_graph(std::string path, bool verbose = false) const;
757
757
----
758
758
759
759
|Synchronous operation that writes a DOT formatted description of the graph to the
760
- provided path. By default, this includes the graph topology, node types, node id,
761
- and kernel names.
762
- Verbose can be set to true to write more detailed information about each node type
760
+ provided path. By default, this includes the graph topology, node types, node id,
761
+ and kernel names.
762
+ Verbose can be set to true to write more detailed information about each node type
763
763
such as kernel arguments, copy source, and destination addresses.
764
- At the moment DOT format is the only supported format. The name of hte output file
764
+ At the moment DOT format is the only supported format. The name of the output file
765
765
must therefore match this extension, i.e. "<filename>.dot".
766
766
767
767
Parameters:
@@ -772,7 +772,7 @@ or memory access where applicable.
772
772
773
773
Exceptions:
774
774
775
- * Throws synchronously with error code `invalid` if the path is invalid or
775
+ * Throws synchronously with error code `invalid` if the path is invalid or
776
776
the file extension is not supported or if the write operation failed.
777
777
778
778
|===
@@ -1220,11 +1220,12 @@ passed an invalid event.
1220
1220
1221
1221
The new handler methods, and queue shortcuts, defined by
1222
1222
link:../supported/sycl_ext_oneapi_enqueue_barrier.asciidoc[sycl_ext_oneapi_enqueue_barrier]
1223
- cannot be used in graph nodes. A synchronous exception will be thrown with
1224
- error code `invalid` if a user tries to add them to a graph.
1225
-
1226
- Removing this restriction is something we may look at for future revisions of
1227
- `sycl_ext_oneapi_graph`.
1223
+ can only be used in graph nodes created using the Record & Replay API, as
1224
+ barriers rely on events to enforce dependencies. A synchronous exception will be
1225
+ thrown with error code `invalid` if a user tries to add them to a graph using
1226
+ the Explicit API. Empty nodes created with the `node::depends_on_all_leaves`
1227
+ property can be used instead of barriers when a user is building a graph with
1228
+ the explicit API.
1228
1229
1229
1230
==== sycl_ext_oneapi_memcpy2d
1230
1231
@@ -1793,12 +1794,14 @@ if used in application code.
1793
1794
. Using `handler::memset` in a graph node.
1794
1795
. Using `handler::prefetch` in a graph node.
1795
1796
. Using `handler::memadvise` in a graph node.
1796
- . Using specialization constants in a graph node.
1797
1797
. Using reductions in a graph node.
1798
1798
. Using sycl streams in a graph node.
1799
- . Using a kernel bundle in a graph node.
1800
1799
. Profiling an event returned from graph submission with
1801
1800
`event::get_profiling_info()`.
1801
+ . Level Zero immediate command-lists are not supported, and
1802
+ `sycl::ext::intel::property::queue::no_immediate_command_list`
1803
+ should be set on construction to any queues an executable
1804
+ graph is submitted to.
1802
1805
1803
1806
== Revision History
1804
1807
0 commit comments