KhronosGroup / KhronosGroup/OpenCL-Docs

clSetKernelArg arg_value for pointers to the local address space error condition

Open
#1,497 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

needs-new-opencl-minor-version
Dominant language
Python
Stars
421
Forks
132
Avg merge
5d 13h
Merged PRs (30d)
11

Description

The current description of clSetKernelArg says:

If the argument is declared with the local qualifier, the arg_value entry must be NULL.

However, there is no documented error condition if arg_value is not equal to NULL.

Should this be CL_INVALID_VALUE (see: https://github.com/KhronosGroup/OpenCL-Docs/pull/1493#discussion_r2536317144) or something else?

Since this is another new error condition, it may need to be added as part of an extension or a new minor OpenCL version.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the clSetKernelArg section of the linked OpenCL 3.0 API specification and review the referenced OpenCL-Docs pull request discussion. Determine the appropriate error condition for a non-NULL arg_value with a local argument, including whether it belongs in an extension or a minor version. Done means the specification change and versioning path are clearly agreed.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.