Skip to content

Conversation

@Bensuo
Copy link
Contributor

@Bensuo Bensuo commented Jun 9, 2023

  • Adds a specification document for the command-buffer experimental feature
  • Adds a new section to the documentation nagivation for experimental features
  • Define UR_COMMAND_BUFFER_EXTENSION_STRING_EXP which represents the string returned by a device info extension query if command-buffers are supported.

Note:
I've duplicated the experimental features warning across the new pages but I'm not sure if this is desirable or not, and if it is, if there is a way to specify this once and include it in multiple places.

Closes #583

@kbenzie kbenzie added the experimental Experimental feature additions/changes/specification label Jun 9, 2023
Copy link
Contributor

@EwanC EwanC left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me for giving a high level summary for the feature.

@Bensuo Bensuo requested a review from kbenzie June 12, 2023 09:37
@Bensuo Bensuo force-pushed the ben/command-buffer-spec branch from 33d41a6 to 4866580 Compare June 12, 2023 18:47
@kbenzie
Copy link
Contributor

kbenzie commented Jun 13, 2023

Note:
I've duplicated the experimental features warning across the new pages but I'm not sure if this is desirable or not, and if it is, if there is a way to specify this once and include it in multiple places.

This is great! I will ensure this gets added to the template when we implement that in #600.

Copy link
Contributor

@veselypeta veselypeta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Bensuo Bensuo force-pushed the ben/command-buffer-spec branch from 4866580 to b717cec Compare June 13, 2023 16:10
- Add macro for extension string return from device query for command-buffers
- Add Experimental Features section to docs navigation
- Improve command-buffer extension specification
@kbenzie kbenzie force-pushed the ben/command-buffer-spec branch from 798d5af to e45d49e Compare June 14, 2023 09:46
@kbenzie kbenzie merged commit c7b48b4 into oneapi-src:main Jun 14, 2023
// sync-point
${x}CommandBufferAppendKernelLaunchExp(hCommandBuffer, hKernel, workDim, pGlobalWorkOffset, pGlobalWorkSize, pLocalWorkSize, 1, &syncPoint, nullptr);

Enqueueing Command-Buffers

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Bensuo @kbenzie : dont know if Enqueue is the correct verb here. should this be submit?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To join the dots, it was the DPC++ PR implementing the entry-point for L0 which raised this discussion intel/llvm#9992 (comment)

FYI that both Benie and Ben are on holiday this week.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think, in the context of UR which is heavily based on OpenCL, enqueue feels like the appropriate verb to me since it aligns with all of the other entry points which enqueue commands to a queue object.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

experimental Experimental feature additions/changes/specification

Projects

None yet

Development

Successfully merging this pull request may close these issues.

RST specification for command-buffer experimental feature

5 participants