KhronosGroup / KhronosGroup/OpenCL-Docs

Clarifying spec behavior for CL_DEVICE_TYPE_ALL

Open
#1,400 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
420
Forks
131
Avg merge
5d 13h
Merged PRs (30d)
11

Description

Would like to confirm that this interpretation of the spec is accurate.

For a platform with multiple devices including a device of type CL_DEVICE_TYPE_CUSTOM, the only API expected to work are:
- clGetDeviceIDs when invoked with CL_DEVICE_TYPE_ALL will return all devices including the custom device
- clCreateContextFromType when invoked with CL_DEVICE_TYPE_ALL will create a context that includes all of these devices
- For a context thus created, clGetContextInfo will work as defined in the spec, including returning all included devices when param_name is CL_CONTEXT_DEVICES

Calling any other API on a multi-device context that includes a custom device will result in undefined/implementation defined behavior.

Contributor guide

Open the contributing guide

Research direction

Review the OpenCL specification sections for clGetDeviceIDs, clCreateContextFromType, and clGetContextInfo, focusing on CL_DEVICE_TYPE_ALL and contexts containing CL_DEVICE_TYPE_CUSTOM. The work is complete when the specification explicitly confirms or corrects the interpretation described in the issue.

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.