Merge branch 'master' into python_bindings

Author: shubskmr

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

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)

PRODUCT_GUID.txt

@@ -1,2 +1,2 @@
-1.27.0
-ed00a7db-f557-48c2-9f90-c1f97b56ad91
+1.28.0
+152a1567-448a-42b3-9cdd-83c1bdc21421

README.md

@@ -84,6 +84,33 @@ validation layer is enabled. Following variables need to be set to enable API lo
 By default logs will be written to the log file, as described above. To print the logs
 to stderr instead, `ZEL_LOADER_LOG_CONSOLE=1` needs to be set.
 
+The API logging output format includes both function entry and exit information, showing parameter names on entry and parameter values with the result code on exit. Each log entry is timestamped and includes the logger name and log level. Example output:
+
+```
+[2026-01-14 09:01:38.951] [ze_loader] [trace] zeContextCreate(hDriver, desc, phContext)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeContextCreate(hDriver=0x5b261fa70588, desc={stype=0x7ffdd20fe1e0, flags=0}, phContext=0x7ffdd20fe148)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] zeCommandListCreateImmediate(hContext, hDevice, altdesc, phCommandList)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeCommandListCreateImmediate(hContext=0x5b261fa74228, hDevice=0x5b261fa708b8, altdesc={stype=0x7ffdd20fe240, ordinal=0, index=0, flags=0, mode=0x7ffdd20fe25c, priority=0x7ffdd20fe260}, phCommandList=0x7ffdd20fe150)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] zeEventPoolCreate(hContext, desc, numDevices, phDevicesLocal, phEventPool)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeEventPoolCreate(hContext=0x5b261fa74228, desc={stype=0x7ffdd20fe200, flags=1, count=1}, numDevices=1, phDevices=0x7ffdd20fe138, phEventPool=0x7ffdd20fe160)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] zeEventCreate(hEventPool, desc, phEvent)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeEventCreate(hEventPool=0x5b261fa19c18, desc={stype=0x7ffdd20fe220, index=0, signal=4, wait=4}, phEvent=0x7ffdd20fe158)
+[2026-01-14 09:01:38.951] [ze_loader] [trace] zeCommandListAppendSignalEvent(hCommandList, hEvent)
+[2026-01-14 09:01:38.952] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeCommandListAppendSignalEvent(hCommandList=0x5b261fa743c8, hEvent=0x5b261c69e5d8)
+[2026-01-14 09:01:38.952] [ze_loader] [trace] zeEventHostSynchronize(hEvent, timeout)
+[2026-01-14 09:01:38.954] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeEventHostSynchronize(hEvent=0x5b261c69e5d8, timeout=18446744073709551615)
+[2026-01-14 09:01:38.954] [ze_loader] [trace] zeContextDestroy(hContext)
+[2026-01-14 09:01:38.954] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeContextDestroy(hContext=0x5b261fa74228)
+[2026-01-14 09:01:38.954] [ze_loader] [trace] zeCommandListDestroy(hCommandList)
+[2026-01-14 09:01:38.955] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeCommandListDestroy(hCommandList=0x5b261fa743c8)
+[2026-01-14 09:01:38.955] [ze_loader] [trace] zeEventDestroy(hEvent)
+[2026-01-14 09:01:38.955] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeEventDestroy(hEvent=0x5b261c69e5d8)
+[2026-01-14 09:01:38.955] [ze_loader] [trace] zeEventPoolDestroy(hEventPool)
+[2026-01-14 09:01:38.955] [ze_loader] [trace] SUCCESS (ZE_RESULT_SUCCESS) in zeEventPoolDestroy(hEventPool=0x5b261fa19c18)
+```
+
+
+
 # Driver/Device Sorting
 
 As of v1.20.3 of the Loader, Drivers and Devices reported to the user are sorted to enable the first device to be the best available device.

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

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`

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

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

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

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