[UR] Add device-wide synchronization extension (#20378)

This commit adds the ability to synchronize with all operations
currently enqueued or executing on a given device.

---------

Signed-off-by: Larsen, Steffen <[email protected]>

Author: steffenlarsen

unified-runtime/include/ur_api.h

@@ -0,0 +1,64 @@
+<%
+    OneApi=tags['$OneApi']
+    x=tags['$x']
+    X=x.upper()
+%>
+
+.. _experimental-device-wait:
+
+================================================================================
+Device Wait
+================================================================================
+
+.. warning::
+
+    Experimental features:
+
+    *   May be replaced, updated, or removed at any time.
+    *   Do not require maintaining API/ABI stability of their own additions over
+        time.
+    *   Do not require conformance testing of their own additions.
+
+
+
+Motivation
+--------------------------------------------------------------------------------
+
+This extension adds the ability to do device-wide synchronization, instead of at
+queue or event level.
+
+API
+--------------------------------------------------------------------------------
+
+Enums
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* ${x}_device_info_t
+    * ${X}_DEVICE_INFO_DEVICE_WAIT_SUPPORT_EXP
+
+Functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ${x}DeviceWaitExp
+
+Changelog
+--------------------------------------------------------------------------------
+
++-----------+---------------------------------------------+
+| Revision  | Changes                                     |
++===========+=============================================+
+| 1.0       | Initial Draft                               |
++-----------+---------------------------------------------+
+
+Support
+--------------------------------------------------------------------------------
+
+Adapters which support this experimental feature *must* return ``true`` when
+queried for ${X}_DEVICE_INFO_DEVICE_WAIT_SUPPORT_EXP via
+${x}DeviceGetInfo. Conversely, before using any of the functionality defined
+in this experimental feature the user *must* use the device query to determine
+if the adapter supports this feature.
+
+Contributors
+--------------------------------------------------------------------------------
+
+* Steffen Larsen `[email protected] <[email protected]>`_

unified-runtime/include/ur_api_funcs.def

@@ -0,0 +1,38 @@
+#
+# Copyright (C) 2023 Intel Corporation
+#
+# Part of the Unified-Runtime Project, under the Apache License v2.0 with LLVM Exceptions.
+# See LICENSE.TXT
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+#
+# See YaML.md for syntax definition
+#
+--- #--------------------------------------------------------------------------
+type: header
+desc: "Intel $OneApi Unified Runtime Experimental APIs for device-wide synchronization"
+ordinal: "99"
+--- #--------------------------------------------------------------------------
+type: enum
+extend: true
+typed_etors: true
+desc: "Extension enums for $x_device_info_t to support device-wide synchronization."
+name: $x_device_info_t
+etors:
+    - name: DEVICE_WAIT_SUPPORT_EXP
+      value: "0x6002"
+      desc: "[$x_bool_t] Returns true if the device supports the device-wide synchronization experimental feature."
+--- #--------------------------------------------------------------------------
+type: function
+desc: "Synchronizes with all queues on the device."
+class: $xDevice
+name: WaitExp
+decl: static
+ordinal: "1"
+params:
+    - type: $x_device_handle_t
+      name: hDevice
+      desc: "[in] handle of the device instance."
+returns:
+    - $X_RESULT_ERROR_INVALID_DEVICE
+    - $X_RESULT_ERROR_INVALID_NULL_HANDLE:
+      - "`hDevice == nullptr`"

unified-runtime/include/ur_ddi.h

@@ -682,7 +682,10 @@ etors:
 - name: IPC_CLOSE_MEM_HANDLE_EXP
   desc: Enumerator for $xIPCCloseMemHandleExp
   value: '292'
-max_id: '292'
+- name: DEVICE_WAIT_EXP
+  desc: Enumerator for $xDeviceWaitExp
+  value: '293'
+max_id: '293'
 ---
 type: enum
 desc: Defines structure types