[llvm] WIP: [Offload] Add testing for Offload program and kernel related entry points (PR #127803)

[Callum Fare via llvm-commits]

================
@@ -0,0 +1,76 @@
+//===-- Kernel.td - Kernel definitions for Offload ---------*- tablegen -*-===//
+//
+// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+//===----------------------------------------------------------------------===//
+//
+// This file contains Offload API definitions related to the kernel handle
+//
+//===----------------------------------------------------------------------===//
+
+def : Function {
+    let name = "olCreateKernel";
+    let desc = "Create a kernel from the function identified by `KernelName` in the given program";
+    let details = [
+        "The created kernel has an initial reference count of 1."
+    ];
+    let params = [
+        Param<"ol_program_handle_t", "Program", "handle of the program", PARAM_IN>,
+        Param<"const char*", "KernelName", "name of the kernel entry point in the program", PARAM_IN>,
+        Param<"ol_kernel_handle_t*", "Kernel", "output pointer for the created kernel", PARAM_OUT>
+    ];
+    let returns = [];
+}
+
+def : Function {
+    let name = "olRetainKernel";
----------------
callumfare wrote:

This is a consequence of the ability to set individual (or all) kernel arguments on a kernel object. With that, the kernel becomes the global address + whatever argument state the user has set, which necessitates tracking this state.

If we go the direction of passing arguments at the time of a kernel launch then we can drop all this.

https://github.com/llvm/llvm-project/pull/127803