[SYCL][DOC] Propose "get_kernel_info" extension #14472
Conversation
Add a proposed extension to query a kernel's information descriptor without creating a kernel bundle.
Also improve the wording for constraints.
| don't think we want to mandate an error check at runtime. | ||
| In retrospect, I think this is the right behavior for the core SYCL spec also, | ||
| and we should consider changing the specified behavior. | ||
| Thoughts? |
There was a problem hiding this comment.
Which exceptions are these, specifically?
There was a problem hiding this comment.
For example:
Preconditions: [...] The device
devmust be one of the devices contained byctxt. The kernelKernelNamemust be compatible with the devicedevas defined byis_compatible.
In the existing SYCL 2020 spec, these error conditions mandate an exception:
An
exceptionwith theerrc::invaliderror code if any of the devices indevsis not one of devices contained by the contextctxtor is not a descendent device of some device inctxt.An
exceptionwith theerrc::invaliderror code if the kernel is not compatible with devicedev(as defined byis_compatible())
| However, this seems different from a _Constraint_, which is expected to result | ||
| in a compile-time error. | ||
| For now, I just listed it as a _Precondition_, so there is no formal | ||
| requirement for an implementation to diagnose this error. |
There was a problem hiding this comment.
Seems like the specification currently uses precondition for template argument requirements, so I think precondition is fine.
There was a problem hiding this comment.
Seems like the specification currently uses
preconditionfor template argument requirements
In the current SYCL 2020 specification, you mean? Yes, this is a bug in the specification, and it's my fault. I wrote that part of the specification before I understood the difference between Preconditions and Constraints. Those should be Constraints. It's on my list of things to clean up.
In the calls to `get_kernel_info` allow the device to be a descendent device of the provided context.
Add a proposed extension to query a kernel's information descriptor without creating a kernel bundle.