Compiler: Expected error code for unsupported clCreateProgramWithSource

[bananAshkar]

In our OpenCL implementation we do not support online compilation APIs, including: clCreateProgramWithSource
Instead, the API is stubbed and returns: CL_INVALID_OPERATION
According to the OpenCL specification (section 5.8.1 Creating Program Objects),
clCreateProgramWithSource:

Must return specific error codes for invalid inputs or resource failures:
CL_INVALID_CONTEXT
CL_INVALID_VALUE
CL_OUT_OF_RESOURCES
CL_OUT_OF_HOST_MEMORY

However:

The specification does not explicitly define behavior when the API itself is not supported by the implementation.
There is no mention of CL_INVALID_OPERATION in this context.

compiler/test_build_helpers.cpp:486 invokes this API and expects standard behavior. This creates a mismatch between the specification, which does not define behavior for unsupported APIs, and the conformance suite, which implicitly requires support for this functionality.

[bashbaug]

I think this is more of a spec issue than a CTS issue.

Could you please confirm what your implementation that does not support online compilation is returning for the following queries?

• CL_DEVICE_COMPILER_AVAILABLE: this probably returns CL_FALSE?
• CL_DEVICE_OPENCL_C_VERSION: this probably returns an empty string?
• CL_DEVICE_IL_VERSION: this probably returns an empty string, too?

The current error behavior for CL_DEVICE_COMPILER_AVAILABLE is a bit different than I'd expect:

• There is no error behavior tied to this query for clCreateProgramWithSource or clCreateProgramWithIL.
• There is error behavior tied to this query for clBuildProgram, clCompileProgram, and clSetProgramSpecializationConstant (???), and these APIs can return CL_COMPILER_NOT_AVAILABLE.

Should it be valid to create a program from source or IL when a compiler is unavailable for all of the devices in the context? According to the letter of the spec, this is not an error, though this also does not seem particularly useful.

[bananAshkar]

In our implementation, CL_DEVICE_COMPILER_AVAILABLE returns CL_FALSE, CL_DEVICE_IL_VERSION returns an empty string, and clCreateProgramWithSource is not supported and returns CL_INVALID_OPERATION. CL_DEVICE_OPENCL_C_VERSION is currently reported as OpenCL C 3.0, although online compilation is not supported. Our main question is whether the spec intends clCreateProgramWithSource to remain valid as a program-object creation step even when no compiler is available, with failure deferred to clBuildProgram, or whether rejecting it up front is also allowed.