[UR] Add descriptive error codes from L0

unified-runtime/include/unified-runtime/ur_api.h

@@ -961,6 +961,19 @@ typedef enum ur_result_t {
   UR_RESULT_ERROR_INVALID_SPEC_ID = 70,
   /// A graph object is not valid.
   UR_RESULT_ERROR_INVALID_GRAPH = 71,
+  /// An operation is not supported during graph capture.
+  UR_RESULT_ERROR_GRAPH_CAPTURE_UNSUPPORTED = 72,
+  /// An operation failed and invalidated the graph capture session.
+  UR_RESULT_ERROR_GRAPH_CAPTURE_INVALIDATED = 73,
+  /// An operation failed because it would merge two graph capture sessions.
+  UR_RESULT_ERROR_GRAPH_CAPTURE_MERGE_ATTEMPT = 74,
+  /// The command list is not in graph capture mode.
+  UR_RESULT_ERROR_COMMAND_LIST_NOT_CAPTURING = 75,
+  /// The graph contains unjoined forks.
+  UR_RESULT_ERROR_GRAPH_UNJOINED_FORKS = 76,
+  /// An operation failed because it uses a graph-internal counter-based
+  /// event outside of the graph.
+  UR_RESULT_ERROR_GRAPH_INTERNAL_EVENT = 77,
   /// Invalid Command-Buffer
   UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_EXP = 0x1000,
   /// Sync point is not valid for the command-buffer

unified-runtime/include/unified-runtime/ur_print.hpp

@@ -2206,6 +2206,24 @@ inline std::ostream &operator<<(std::ostream &os, enum ur_result_t value) {
   case UR_RESULT_ERROR_INVALID_GRAPH:
     os << "UR_RESULT_ERROR_INVALID_GRAPH";
     break;
+  case UR_RESULT_ERROR_GRAPH_CAPTURE_UNSUPPORTED:
+    os << "UR_RESULT_ERROR_GRAPH_CAPTURE_UNSUPPORTED";
+    break;
+  case UR_RESULT_ERROR_GRAPH_CAPTURE_INVALIDATED:
+    os << "UR_RESULT_ERROR_GRAPH_CAPTURE_INVALIDATED";
+    break;
+  case UR_RESULT_ERROR_GRAPH_CAPTURE_MERGE_ATTEMPT:
+    os << "UR_RESULT_ERROR_GRAPH_CAPTURE_MERGE_ATTEMPT";
+    break;
+  case UR_RESULT_ERROR_COMMAND_LIST_NOT_CAPTURING:
+    os << "UR_RESULT_ERROR_COMMAND_LIST_NOT_CAPTURING";
+    break;
+  case UR_RESULT_ERROR_GRAPH_UNJOINED_FORKS:
+    os << "UR_RESULT_ERROR_GRAPH_UNJOINED_FORKS";
+    break;
+  case UR_RESULT_ERROR_GRAPH_INTERNAL_EVENT:
+    os << "UR_RESULT_ERROR_GRAPH_INTERNAL_EVENT";
+    break;
   case UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_EXP:
     os << "UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_EXP";
     break;

unified-runtime/scripts/core/common.yml

@@ -285,6 +285,19 @@ etors:
       desc: "A specialization constant identifier is not valid."
     - name: ERROR_INVALID_GRAPH
       desc: "A graph object is not valid."
+    - name: ERROR_GRAPH_CAPTURE_UNSUPPORTED
+      desc: "An operation is not supported during graph capture."
+    - name: ERROR_GRAPH_CAPTURE_INVALIDATED
+      desc: "An operation failed and invalidated the graph capture session."
+    - name: ERROR_GRAPH_CAPTURE_MERGE_ATTEMPT
+      desc: "An operation failed because it would merge two graph capture sessions."
+    - name: ERROR_COMMAND_LIST_NOT_CAPTURING
+      desc: "The command list is not in graph capture mode."
+    - name: ERROR_GRAPH_UNJOINED_FORKS
+      desc: "The graph contains unjoined forks."
+    - name: ERROR_GRAPH_INTERNAL_EVENT
+      desc: "An operation failed because it uses a graph-internal counter-based
+             event outside of the graph."
     - name: ERROR_UNKNOWN
       value: "0x7ffffffe"
       desc: "Unknown or internal error"

unified-runtime/source/adapters/level_zero/common.cpp

@@ -62,6 +62,20 @@ ur_result_t ze2urResult(ze_result_t ZeResult) {
     return UR_RESULT_ERROR_UNSUPPORTED_FEATURE;
   case ZE_RESULT_ERROR_MODULE_LINK_FAILURE:
     return UR_RESULT_ERROR_PROGRAM_LINK_FAILURE;
+  case ZE_RESULT_ERROR_INVALID_GRAPH:
+    return UR_RESULT_ERROR_INVALID_GRAPH;
+  case ZE_RESULT_ERROR_GRAPH_CAPTURE_UNSUPPORTED:
+    return UR_RESULT_ERROR_GRAPH_CAPTURE_UNSUPPORTED;
+  case ZE_RESULT_ERROR_GRAPH_CAPTURE_INVALIDATED:
+    return UR_RESULT_ERROR_GRAPH_CAPTURE_INVALIDATED;
+  case ZE_RESULT_ERROR_GRAPH_CAPTURE_MERGE_ATTEMPT:
+    return UR_RESULT_ERROR_GRAPH_CAPTURE_MERGE_ATTEMPT;
+  case ZE_RESULT_ERROR_COMMAND_LIST_NOT_CAPTURING:
+    return UR_RESULT_ERROR_COMMAND_LIST_NOT_CAPTURING;
+  case ZE_RESULT_ERROR_GRAPH_UNJOINED_FORKS:
+    return UR_RESULT_ERROR_GRAPH_UNJOINED_FORKS;
+  case ZE_RESULT_ERROR_GRAPH_INTERNAL_EVENT:
+    return UR_RESULT_ERROR_GRAPH_INTERNAL_EVENT;
   default:
     return UR_RESULT_ERROR_UNKNOWN;
   }