oneapi-src · nrspruit · Feb 3, 2026 · Feb 3, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,13 @@
 # Level zero loader changelog
+## v1.28.0
+* feature: Update to support L0 Spec v1.15.31
+* Loader Driver Interaction conformance tests for Sysman Exp and Ext APIs (#418)
+* Loader Driver Interaction conformance tests for Sysman Modules (#411)
+* Ensure explicit multidriver teardown during context destroy (#416)
+* fix memory leaks in loader (#417)
+* Update Tracing Layer Documentation for the expanded support (#414)
+* Expand Loader API Documentation to be more detailed (#410)
+* Added tests for Loader Driver interaction conformance for Sysman Modules (#409)
 ## v1.27.0
 * feature: Update to support L0 Spec v1.15.26
 * fix: fix Driver Search Paths for all Linux Distros

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -13,7 +13,7 @@ if(MSVC AND (MSVC_VERSION LESS 1900))
 endif()
 
 # This project follows semantic versioning (https://semver.org/)
-project(level-zero VERSION 1.27.0)
+project(level-zero VERSION 1.28.0)
 include(GNUInstallDirs)
 
 find_package(Git)

diff --git a/PRODUCT_GUID.txt b/PRODUCT_GUID.txt
@@ -1,2 +1,2 @@
-1.27.0
-ed00a7db-f557-48c2-9f90-c1f97b56ad91
+1.28.0
+152a1567-448a-42b3-9cdd-83c1bdc21421
diff --git a/include/ze.py b/include/ze.py
@@ -4,7 +4,7 @@
  SPDX-License-Identifier: MIT
 
  @file ze.py
- @version v1.15-r1.15.26
+ @version v1.15-r1.15.31
 
  """
 import platform
@@ -1040,10 +1040,11 @@ class ze_command_queue_flags_v(IntEnum):
                                                                             ## the next to define an in-order list, and application is allowed to
                                                                             ## pass signal and wait events
                                                                             ## to each appended command to implement more complex dependency graphs.
-    COPY_OFFLOAD_HINT = ZE_BIT(2)                                           ## Try to offload copy operations to different engines. Applicable only
-                                                                            ## for compute queues.
-                                                                            ## This is only a hint. Driver may ignore it per append call, based on
-                                                                            ## platform capabilities or internal heuristics.
+    COPY_OFFLOAD_HINT = ZE_BIT(2)                                           ## To be used only when creating immediate command lists and only for
+                                                                            ## compute queues.
+                                                                            ## Try to offload copy operations to different engines. This is only a hint.
+                                                                            ## Driver may ignore it per append call, based on platform capabilities
+                                                                            ## or internal heuristics.
 
 class ze_command_queue_flags_t(c_int):
     def __str__(self):
@@ -1124,6 +1125,10 @@ class ze_command_list_flags_v(IntEnum):
                                                                             ## more complex dependency graphs. Cannot be combined with ::ZE_COMMAND_LIST_FLAG_RELAXED_ORDERING.
     EXP_CLONEABLE = ZE_BIT(4)                                               ## this command list may be cloned using ::zeCommandListCreateCloneExp
                                                                             ## after ::zeCommandListClose.
+    COPY_OFFLOAD_HINT = ZE_BIT(5)                                           ## Try to offload copy operations to different engines. Applicable only
+                                                                            ## for compute queues.
+                                                                            ## This is only a hint. Driver may ignore it per append call, based on
+                                                                            ## platform capabilities or internal heuristics.
 
 class ze_command_list_flags_t(c_int):
     def __str__(self):
@@ -2048,21 +2053,21 @@ def __str__(self):
 ##     - Implementation must support ::ZE_MODULE_PROGRAM_EXP_NAME extension
 ##     - Modules support import and export linkage for functions and global
 ##       variables.
-##     - SPIR-V import and export linkage types are used. See SPIR-V
-##       specification for linkage details.
 ##     - pInputModules, pBuildFlags, and pConstants from ::ze_module_desc_t is
 ##       ignored.
 ##     - Format in ::ze_module_desc_t needs to be set to
-##       ::ZE_MODULE_FORMAT_IL_SPIRV.
+##       ::ZE_MODULE_FORMAT_IL_SPIRV or ::ZE_MODULE_FORMAT_NATIVE.
+##     - All modules in the list must be of the same format and match the
+##       format specified in ::ze_module_desc_t.
 class ze_module_program_exp_desc_t(Structure):
     _fields_ = [
         ("stype", ze_structure_type_t),                                 ## [in] type of this structure
         ("pNext", c_void_p),                                            ## [in][optional] must be null or a pointer to an extension-specific
                                                                         ## structure (i.e. contains stype and pNext).
         ("count", c_ulong),                                             ## [in] Count of input modules
-        ("inputSizes", POINTER(c_size_t)),                              ## [in][range(0, count)] sizes of each input IL module in pInputModules.
-        ("pInputModules", POINTER(c_ubyte*)),                           ## [in][range(0, count)] pointer to an array of IL (e.g. SPIR-V modules).
-                                                                        ## Valid only for SPIR-V input.
+        ("inputSizes", POINTER(c_size_t)),                              ## [in][range(0, count)] sizes of each input module in pInputModules.
+        ("pInputModules", POINTER(c_ubyte*)),                           ## [in][range(0, count)] pointer to an array of binary modules in format
+                                                                        ## specified as part of ::ze_module_desc_t.
         ("pBuildFlags", POINTER(c_char_p)),                             ## [in][optional][range(0, count)] array of strings containing build
                                                                         ## flags. See pBuildFlags in ::ze_module_desc_t.
         ("pConstants", POINTER(ze_module_constants_t*))                 ## [in][optional][range(0, count)] pointer to array of specialization

diff --git a/include/ze_api.h b/include/ze_api.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file ze_api.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZE_API_H
@@ -3042,10 +3042,11 @@ typedef enum _ze_command_queue_flag_t
                                                                             ///< the next to define an in-order list, and application is allowed to
                                                                             ///< pass signal and wait events
                                                                             ///< to each appended command to implement more complex dependency graphs.
-    ZE_COMMAND_QUEUE_FLAG_COPY_OFFLOAD_HINT = ZE_BIT(2),                    ///< Try to offload copy operations to different engines. Applicable only
-                                                                            ///< for compute queues.
-                                                                            ///< This is only a hint. Driver may ignore it per append call, based on
-                                                                            ///< platform capabilities or internal heuristics.
+    ZE_COMMAND_QUEUE_FLAG_COPY_OFFLOAD_HINT = ZE_BIT(2),                    ///< To be used only when creating immediate command lists and only for
+                                                                            ///< compute queues.
+                                                                            ///< Try to offload copy operations to different engines. This is only a hint.
+                                                                            ///< Driver may ignore it per append call, based on platform capabilities
+                                                                            ///< or internal heuristics.
     ZE_COMMAND_QUEUE_FLAG_FORCE_UINT32 = 0x7fffffff ///< Value marking end of ZE_COMMAND_QUEUE_FLAG_* ENUMs
 
 } ze_command_queue_flag_t;
@@ -3376,6 +3377,10 @@ typedef enum _ze_command_list_flag_t
                                                                             ///< more complex dependency graphs. Cannot be combined with ::ZE_COMMAND_LIST_FLAG_RELAXED_ORDERING.
     ZE_COMMAND_LIST_FLAG_EXP_CLONEABLE = ZE_BIT(4),                         ///< this command list may be cloned using ::zeCommandListCreateCloneExp
                                                                             ///< after ::zeCommandListClose.
+    ZE_COMMAND_LIST_FLAG_COPY_OFFLOAD_HINT = ZE_BIT(5),                     ///< Try to offload copy operations to different engines. Applicable only
+                                                                            ///< for compute queues.
+                                                                            ///< This is only a hint. Driver may ignore it per append call, based on
+                                                                            ///< platform capabilities or internal heuristics.
     ZE_COMMAND_LIST_FLAG_FORCE_UINT32 = 0x7fffffff ///< Value marking end of ZE_COMMAND_LIST_FLAG_* ENUMs
 
 } ze_command_list_flag_t;
@@ -3429,7 +3434,7 @@ typedef struct _ze_command_list_desc_t
 ///         + `nullptr == desc`
 ///         + `nullptr == phCommandList`
 ///     - ::ZE_RESULT_ERROR_INVALID_ENUMERATION
-///         + `0x1f < desc->flags`
+///         + `0x3f < desc->flags`
 ///     - ::ZE_RESULT_ERROR_UNSUPPORTED_ENUMERATION
 ZE_APIEXPORT ze_result_t ZE_APICALL
 zeCommandListCreate(
@@ -4103,6 +4108,7 @@ zeCommandListAppendMemoryCopy(
 ///         + `nullptr == ptr`
 ///         + `nullptr == pattern`
 ///     - ::ZE_RESULT_ERROR_INVALID_SYNCHRONIZATION_OBJECT
+///     - ::ZE_RESULT_ERROR_UNSUPPORTED_ALIGNMENT
 ///     - ::ZE_RESULT_ERROR_INVALID_SIZE
 ///         + `(nullptr == phWaitEvents) && (0 < numWaitEvents)`
 ZE_APIEXPORT ze_result_t ZE_APICALL
@@ -8632,21 +8638,21 @@ typedef enum _ze_module_program_exp_version_t
 ///     - Implementation must support ::ZE_MODULE_PROGRAM_EXP_NAME extension
 ///     - Modules support import and export linkage for functions and global
 ///       variables.
-///     - SPIR-V import and export linkage types are used. See SPIR-V
-///       specification for linkage details.
 ///     - pInputModules, pBuildFlags, and pConstants from ::ze_module_desc_t is
 ///       ignored.
 ///     - Format in ::ze_module_desc_t needs to be set to
-///       ::ZE_MODULE_FORMAT_IL_SPIRV.
+///       ::ZE_MODULE_FORMAT_IL_SPIRV or ::ZE_MODULE_FORMAT_NATIVE.
+///     - All modules in the list must be of the same format and match the
+///       format specified in ::ze_module_desc_t.
 typedef struct _ze_module_program_exp_desc_t
 {
     ze_structure_type_t stype;                                              ///< [in] type of this structure
     const void* pNext;                                                      ///< [in][optional] must be null or a pointer to an extension-specific
                                                                             ///< structure (i.e. contains stype and pNext).
     uint32_t count;                                                         ///< [in] Count of input modules
-    const size_t* inputSizes;                                               ///< [in][range(0, count)] sizes of each input IL module in pInputModules.
-    const uint8_t** pInputModules;                                          ///< [in][range(0, count)] pointer to an array of IL (e.g. SPIR-V modules).
-                                                                            ///< Valid only for SPIR-V input.
+    const size_t* inputSizes;                                               ///< [in][range(0, count)] sizes of each input module in pInputModules.
+    const uint8_t** pInputModules;                                          ///< [in][range(0, count)] pointer to an array of binary modules in format
+                                                                            ///< specified as part of ::ze_module_desc_t.
     const char** pBuildFlags;                                               ///< [in][optional][range(0, count)] array of strings containing build
                                                                             ///< flags. See pBuildFlags in ::ze_module_desc_t.
     const ze_module_constants_t** pConstants;                               ///< [in][optional][range(0, count)] pointer to array of specialization
@@ -9976,9 +9982,10 @@ ZE_APIEXPORT ze_result_t ZE_APICALL
 zeCommandListAppendSignalExternalSemaphoreExt(
     ze_command_list_handle_t hCommandList,                                  ///< [in] The command list handle.
     uint32_t numSemaphores,                                                 ///< [in] The number of external semaphores.
-    ze_external_semaphore_ext_handle_t* phSemaphores,                       ///< [in][range(0, numSemaphores)] The vector of external semaphore handles
-                                                                            ///< to be appended into command list.
-    ze_external_semaphore_signal_params_ext_t* signalParams,                ///< [in] Signal parameters.
+    ze_external_semaphore_ext_handle_t* phSemaphores,                       ///< [in][range(0, numSemaphores)] The array of pointers to external
+                                                                            ///< semaphore handles to be appended into command list.
+    ze_external_semaphore_signal_params_ext_t* signalParams,                ///< [in][range(0, numSemaphores)] The array of pointers to external
+                                                                            ///< semaphore signal parameters.
     ze_event_handle_t hSignalEvent,                                         ///< [in][optional] handle of the event to signal on completion
     uint32_t numWaitEvents,                                                 ///< [in][optional] number of events to wait on before launching; must be 0
                                                                             ///< if `nullptr == phWaitEvents`
@@ -10025,9 +10032,10 @@ ZE_APIEXPORT ze_result_t ZE_APICALL
 zeCommandListAppendWaitExternalSemaphoreExt(
     ze_command_list_handle_t hCommandList,                                  ///< [in] The command list handle.
     uint32_t numSemaphores,                                                 ///< [in] The number of external semaphores.
-    ze_external_semaphore_ext_handle_t* phSemaphores,                       ///< [in] [range(0,numSemaphores)] The vector of external semaphore handles
-                                                                            ///< to append into command list.
-    ze_external_semaphore_wait_params_ext_t* waitParams,                    ///< [in] Wait parameters.
+    ze_external_semaphore_ext_handle_t* phSemaphores,                       ///< [in][range(0,numSemaphores)] The array of pointers to external
+                                                                            ///< semaphore handles to append into command list.
+    ze_external_semaphore_wait_params_ext_t* waitParams,                    ///< [in][range(0,numSemaphores)] The array of pointers to external
+                                                                            ///< semaphore wait parameters.
     ze_event_handle_t hSignalEvent,                                         ///< [in][optional] handle of the event to signal on completion
     uint32_t numWaitEvents,                                                 ///< [in][optional] number of events to wait on before launching; must be 0
                                                                             ///< if `nullptr == phWaitEvents`

diff --git a/include/ze_ddi.h b/include/ze_ddi.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file ze_ddi.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZE_DDI_H

diff --git a/include/ze_ddi_common.h b/include/ze_ddi_common.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file ze_ddi_common.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZE_DDI_COMMON_H

diff --git a/include/zer.py b/include/zer.py
@@ -4,7 +4,7 @@
  SPDX-License-Identifier: MIT
 
  @file zer.py
- @version v1.15-r1.15.26
+ @version v1.15-r1.15.31
 
  """
 import platform

diff --git a/include/zer_api.h b/include/zer_api.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file zer_api.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZER_API_H

diff --git a/include/zer_ddi.h b/include/zer_ddi.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file zer_ddi.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZER_DDI_H

diff --git a/include/zes.py b/include/zes.py
@@ -4,7 +4,7 @@
  SPDX-License-Identifier: MIT
 
  @file zes.py
- @version v1.15-r1.15.26
+ @version v1.15-r1.15.31
 
  """
 import platform

diff --git a/include/zes_api.h b/include/zes_api.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file zes_api.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZES_API_H

diff --git a/include/zes_ddi.h b/include/zes_ddi.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file zes_ddi.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZES_DDI_H

diff --git a/include/zet.py b/include/zet.py
@@ -4,7 +4,7 @@
  SPDX-License-Identifier: MIT
 
  @file zet.py
- @version v1.15-r1.15.26
+ @version v1.15-r1.15.31
 
  """
 import platform

diff --git a/include/zet_api.h b/include/zet_api.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file zet_api.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZET_API_H

diff --git a/include/zet_ddi.h b/include/zet_ddi.h
@@ -5,7 +5,7 @@
  * SPDX-License-Identifier: MIT
  *
  * @file zet_ddi.h
- * @version v1.15-r1.15.26
+ * @version v1.15-r1.15.31
  *
  */
 #ifndef _ZET_DDI_H