Skip to content

Commit 2581123

Browse files
guoyejunEwanC
andauthored
[SYCL-Graph][Doc] Graph nodes cannot depend on events from outside the graph (#11736)
Co-authored-by: Ewan Crawford <[email protected]>
1 parent 7911773 commit 2581123

File tree

1 file changed

+18
-10
lines changed

1 file changed

+18
-10
lines changed

sycl/doc/extensions/experimental/sycl_ext_oneapi_graph.asciidoc

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1108,20 +1108,28 @@ they do in non-recording mode.
11081108

11091109
==== Event Limitations
11101110

1111-
Events returned from queue submissions when a queue is in the recording state
1112-
may only be used as parameters to `handler::depends_on()` or as dependent
1113-
events for queue shortcuts like `queue::parallel_for()` for submissions which
1114-
are being recorded to the same modifiable `command_graph`.
1111+
For queue submissions that are being recorded to a modifiable `command_graph`,
1112+
the only events that can be used as parameters to `handler::depends_on()`, or
1113+
as dependent events for queue shortcuts like `queue::parallel_for()`, are events
1114+
that have been returned from queue submissions recorded to the same modifiable
1115+
`command_graph`.
1116+
1117+
Other limitations on the events returned from a submission to a queue in the
1118+
recording state are:
11151119

11161120
- Calling `event::get_info<info::event::command_execution_status>()` or
1117-
`event::get_profiling_info()` on an event returned from a queue submission
1118-
recorded to a graph will throw synchronously with error code `invalid`.
1121+
`event::get_profiling_info()` will throw synchronously with error code `invalid`.
1122+
1123+
- A host-side wait on the event will throw synchronously with error
1124+
code `invalid`.
1125+
1126+
- Using the event outside of the recording scope will throw synchronously with error code
1127+
`invalid`.
11191128

1120-
- Waiting on an event returned from a queue submission recorded to a graph
1121-
will throw synchronously with error code `invalid`.
1129+
==== Queue Limitations
11221130

1123-
- Waiting on a queue in the recording state is an error and will throw
1124-
synchronously with error code `invalid`.
1131+
A host-side wait on a queue in the recording state is an error and will
1132+
throw synchronously with error code `invalid`.
11251133

11261134
==== Buffer Limitations
11271135

0 commit comments

Comments
 (0)