Skip to content

Commit e45df2e

Browse files
author
Ewan Crawford
committed
Address editorial PR feedback
1 parent b61190b commit e45df2e

2 files changed

Lines changed: 11 additions & 15 deletions

File tree

api/cl_khr_command_buffer.asciidoc

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33

44
include::{generated}/meta/{refprefix}cl_khr_command_buffer.txt[]
55

6-
// *Revision*::
7-
// 0.9.7
86
// *Extension and Version Dependencies*::
97
// This extension requires OpenCL 1.2 or later.
108
// Buffering of SVM commands requires OpenCL 2.0 or later.
@@ -132,11 +130,6 @@ command-buffer. However, simultaneous use may result in command-buffers having
132130
a larger overhead to implement, so the capability is optional to enable
133131
optimizations when this usage isn't required by a user.
134132

135-
Instead the goal for the base level of functionality provided by the extension
136-
is to support pipelined workflows. Where a command-buffer is repeatedly
137-
enqueued, with each enqueue expressing dependencies on any previous submissions,
138-
without the enqueue calls blocking in user code.
139-
140133
=== Interactions With Other Extensions
141134

142135
The introduction of the command-buffer abstraction enables functionality

api/opencl_runtime_layer.asciidoc

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14618,14 +14618,14 @@ on one or more command-queues without any application code interaction.
1461814618
Grouping the operations together allows efficient enqueuing of repetitive
1461914619
operations, as well as enabling driver optimizations.
1462014620

14621-
Upon creation a command-buffer is defined as being in the <<recording,
14622-
Recording>> state, in order for the command-buffer to be enqueued
14623-
it must first be finalized using {clFinalizeCommandBufferKHR} after which no
14624-
further commands can be recorded. A command-buffer is submitted for execution
14625-
on command-queues with a call to {clEnqueueCommandBufferKHR}. It is
14626-
always valid to call {clEnqueueCommandBufferKHR} with a command-buffer that
14627-
has previously been enqueued, provided the call doesn't violate the definition
14628-
of <<simultaneous-use, simultaneous use>>.
14621+
Upon creation a command-buffer is in the <<recording, Recording>> state. In
14622+
order for the command-buffer to be enqueued it must first be finalized using
14623+
{clFinalizeCommandBufferKHR}, after which no further commands can be recorded.
14624+
A command-buffer is enqueued for execution on command-queues with a call to
14625+
{clEnqueueCommandBufferKHR}. It is always valid to call
14626+
{clEnqueueCommandBufferKHR} with a command-buffer that has previously been
14627+
enqueued, provided the call doesn't violate the definition of
14628+
<<simultaneous-use, simultaneous use>>.
1462914629

1463014630
Command-buffers are created using an ordered list of command-queues that
1463114631
commands are recorded to and execute on by default. All these queue objects
@@ -14702,13 +14702,16 @@ Simultaneous Use:: When a command-buffer is submitted for
1470214702
execution without a prerequisite on all the previous submissions of the same
1470314703
command-buffer which are not in the {CL_COMPLETE} state.
1470414704

14705+
[NOTE]
14706+
====
1470514707
An example of simultaneous use would be two submissions of the same
1470614708
command-buffer to a single out-of-order queue, without any events or barriers
1470714709
used to express a dependency between the two enqueue calls. Using a single
1470814710
in-order queue, events, or barriers to express dependencies between submissions
1470914711
of the same command-buffer would each be ways to avoid simultaneous use and are
1471014712
valid usage of command-buffers created without the
1471114713
{CL_COMMAND_BUFFER_SIMULTANEOUS_USE_KHR} flag.
14714+
====
1471214715

1471314716
ifdef::cl_khr_command_buffer_multi_device[]
1471414717
=== Command-Buffers and Multiple Devices

0 commit comments

Comments
 (0)