Renamed dpctl_sycl_program_interface to dpctl_sycl_kernel_bundle_interface

Author: oleksandr-pavlyk

dpctl/_backend.pxd

@@ -302,7 +302,7 @@ cdef extern from "syclinterface/dpctl_sycl_context_interface.h":
     cdef void DPCTLContext_Delete(DPCTLSyclContextRef CtxRef)
 
 
-cdef extern from "syclinterface/dpctl_sycl_program_interface.h":
+cdef extern from "syclinterface/dpctl_sycl_kernel_bundle_interface.h":
     cdef DPCTLSyclKernelBundleRef DPCTLKernelBundle_CreateFromSpirv(
         const DPCTLSyclContextRef Ctx,
         const DPCTLSyclDeviceRef Dev,

dpctl/program/_program.pxd

@@ -44,7 +44,7 @@ cdef class SyclProgram:
     ''' Wraps a sycl::kernel_bundle<sycl::bundle_state::executable> object created from
         using SYCL interoperability layer for OpenCL and Level-Zero backends.
 
-        SyclProgram exposes the C API from dpctl_sycl_program_interface.h. A
+        SyclProgram exposes the C API from dpctl_sycl_kernel_bundle_interface.h. A
         SyclProgram can be created from either a source string or a SPIR-V
         binary file.
     '''

dpctl/program/_program.pyx

@@ -97,12 +97,13 @@ cdef class SyclKernel:
 
 
 cdef class SyclProgram:
-    """ Wraps a ``sycl::program`` object created from an OpenCL interoperability
-        program.
+    """ Wraps a ``sycl::kernel_bundle<sycl::bundle_state::executable>`` object
+    created using SYCL interoperability layer with underlying backends. Only the
+    OpenCL and Level-Zero backends are currently supported.
 
-        SyclProgram exposes the C API from ``dpctl_sycl_program_interface.h``. A
-        SyclProgram can be created from either a source string or a SPIR-V
-        binary file.
+    SyclProgram exposes the C API from ``dpctl_sycl_kernel_bundle_interface.h``.
+    A SyclProgram can be created from either a source string or a SPIR-V
+    binary file.
     """
 
     @staticmethod

libsyclinterface/include/dpctl_sycl_program_interface.h renamed to libsyclinterface/include/dpctl_sycl_kernel_bundle_interface.h

@@ -1,4 +1,5 @@
-//===- dpctl_sycl_program_interface.h - C API for sycl::program  -*-C++-*- ===//
+//===- dpctl_sycl_kernel_bundle_interface.h - C API for
+//     sycl::kernel_bundle<sycl::bundle_state::executable>      -*-C++-*- ===//
 //
 //                      Data Parallel Control (dpctl)
 //
@@ -84,7 +85,7 @@ __dpctl_give DPCTLSyclKernelBundleRef DPCTLKernelBundle_CreateFromOCLSource(
  * @brief Returns the SyclKernel with given name from the program, if not found
  * then return NULL.
  *
- * @param    PRef           Opaque pointer to a sycl::program
+ * @param    KBRef          Opaque pointer to a sycl::kernel_bundle
  * @param    KernelName     Name of kernel
  * @return   A SyclKernel reference if the kernel exists, else NULL
  * @ingroup KernelBundleInterface
@@ -98,7 +99,7 @@ DPCTLKernelBundle_GetKernel(__dpctl_keep DPCTLSyclKernelBundleRef KBRef,
  * @brief Return True if a SyclKernel with given name exists in the program, if
  * not found then returns False.
  *
- * @param    PRef           Opaque pointer to a sycl::program
+ * @param    KBRef          Opaque pointer to a sycl::kernel_bundle
  * @param    KernelName     Name of kernel
  * @return   True if the kernel exists, else False
  * @ingroup KernelBundleInterface

libsyclinterface/source/dpctl_sycl_program_interface.cpp renamed to libsyclinterface/source/dpctl_sycl_kernel_bundle_interface.cpp

@@ -1,5 +1,5 @@
-//===- dpctl_sycl_program_interface.cpp - Implements C API for
-// sycl::kernel_bundle<sycl::bundle_state::executable> =//
+//===- dpctl_sycl_kernel_bundle_interface.cpp - Implements C API for
+//    sycl::kernel_bundle<sycl::bundle_state::executable>  ---------------===//
 //
 //                      Data Parallel Control (dpctl)
 //
@@ -21,11 +21,11 @@
 ///
 /// \file
 /// This file implements the functions declared in
-/// dpctl_sycl_program_interface.h.
+/// dpctl_sycl_kernel_bundle_interface.h.
 ///
 //===----------------------------------------------------------------------===//
 
-#include "dpctl_sycl_program_interface.h"
+#include "dpctl_sycl_kernel_bundle_interface.h"
 #include "Config/dpctl_config.h"
 #include "Support/CBindingWrapping.h"
 #include "dpctl_dynamic_lib_helper.h"

libsyclinterface/tests/test_sycl_kernel_interface.cpp

@@ -1,4 +1,4 @@
-//===-- test_sycl_program_interface.cpp - Test cases for kernel interface ===//
+//===-- test_sycl_kernel_interface.cpp - Test cases for kernel interface  ===//
 //
 //                      Data Parallel Control (dpctl)
 //
@@ -27,8 +27,8 @@
 #include "dpctl_sycl_context_interface.h"
 #include "dpctl_sycl_device_interface.h"
 #include "dpctl_sycl_device_selector_interface.h"
+#include "dpctl_sycl_kernel_bundle_interface.h"
 #include "dpctl_sycl_kernel_interface.h"
-#include "dpctl_sycl_program_interface.h"
 #include "dpctl_sycl_queue_interface.h"
 #include "dpctl_sycl_queue_manager.h"
 #include "dpctl_utils.h"

libsyclinterface/tests/test_sycl_program_interface.cpp

@@ -1,4 +1,5 @@
-//===-- test_sycl_program_interface.cpp - Test cases for module interface -===//
+//===- test_sycl_kernel_bundle_interface.cpp -
+//                                      Test cases for module interface -===//
 //
 //                      Data Parallel Control (dpctl)
 //
@@ -29,8 +30,8 @@
 #include "dpctl_sycl_device_interface.h"
 #include "dpctl_sycl_device_manager.h"
 #include "dpctl_sycl_device_selector_interface.h"
+#include "dpctl_sycl_kernel_bundle_interface.h"
 #include "dpctl_sycl_kernel_interface.h"
-#include "dpctl_sycl_program_interface.h"
 #include "dpctl_sycl_queue_interface.h"
 #include "dpctl_sycl_queue_manager.h"
 #include <CL/sycl.hpp>

libsyclinterface/tests/test_sycl_queue_submit.cpp

@@ -28,8 +28,8 @@
 #include "dpctl_sycl_device_interface.h"
 #include "dpctl_sycl_device_selector_interface.h"
 #include "dpctl_sycl_event_interface.h"
+#include "dpctl_sycl_kernel_bundle_interface.h"
 #include "dpctl_sycl_kernel_interface.h"
-#include "dpctl_sycl_program_interface.h"
 #include "dpctl_sycl_queue_interface.h"
 #include "dpctl_sycl_usm_interface.h"
 #include <CL/sycl.hpp>