Initial stubs for the error handling overhaul.

Author: Diptorup Deb

dpctl-capi/include/dpctl_error_handler_type.h

@@ -32,4 +32,14 @@
  * @param    err_code       Error code extracted from an SYCL asynchronous
  * error.
  */
-typedef void error_handler_callback(int err_code);
+typedef void error_handler_callback(int err_code) __attribute__((
+    deprecated("the function does not allow passing in an error string, use "
+               "'error_handler_callback_fn' instead!!!")));
+
+/*!
+ * @brief Type signature required for an error handler callback function.
+ *
+ * @param    err_code       My Param doc
+ * @param    err_msg        My Param doc
+ */
+typedef void (*error_handler_callback_fn)(int err_code, const char *err_msg);

dpctl-capi/include/dpctl_exec_state.h

@@ -0,0 +1,65 @@
+//===- dpctl_exec_state.h - C API for service functions          -*-C++-*- ===//
+//
+//                      Data Parallel Control (dpctl)
+//
+// Copyright 2020-2021 Intel Corporation
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//===----------------------------------------------------------------------===//
+///
+/// \file
+/// The file declares a struct to store dpctl's error handler and other
+/// execution state configurations.
+///
+//===----------------------------------------------------------------------===//
+
+#pragma once
+
+#include "Support/DllExport.h"
+#include "Support/ExternC.h"
+#include "Support/MemOwnershipAttrs.h"
+#include "dpctl_error_handler_type.h"
+
+DPCTL_C_EXTERN_C_BEGIN
+
+/*!
+ * @brief
+ *
+ */
+typedef struct DpctlExecutionState *DpctlExecState;
+
+/*!
+ * @brief
+ *
+ * @param    handler        My Param doc
+ * @return   {return}       My Param doc
+ */
+__dpctl_give DpctlExecState
+dpctl_exec_state_create(const error_handler_callback_fn handler);
+
+/*!
+ * @brief
+ *
+ * @return   {return}       My Param doc
+ */
+__dpctl_give DpctlExecState dpctl_exec_state_create_default();
+
+/*!
+ * @brief
+ *
+ * @param    DpctlExecState My Param doc
+ */
+void dpctl_exec_state_delete(__dpctl_take DpctlExecState state);
+
+DPCTL_C_EXTERN_C_END

dpctl-capi/include/dpctl_service.h

@@ -19,7 +19,7 @@
 //===----------------------------------------------------------------------===//
 ///
 /// \file
-/// This header defines dpctl service functions.
+/// This header declares dpctl service functions.
 ///
 //===----------------------------------------------------------------------===//
 

dpctl-capi/source/dpctl_exec_state.cpp

@@ -0,0 +1,106 @@
+//===- dpctl_exec_state.cpp - Implements C API for sycl::context         ---==//
+//
+//                      Data Parallel Control (dpctl)
+//
+// Copyright 2020-2021 Intel Corporation
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//===----------------------------------------------------------------------===//
+///
+/// \file
+/// This file implements the data types and functions declared in
+/// dpctl_exec_state.h.
+///
+//===----------------------------------------------------------------------===//
+
+#include "dpctl_exec_state.h"
+#include "Support/CBindingWrapping.h"
+#include <iostream>
+
+namespace
+{
+
+/*!
+ * @brief
+ *
+ * @param    err_code       My Param doc
+ * @param    err_msg        My Param doc
+ */
+void default_handler(int err_code, const char *err_msg)
+{
+    std::cerr << "DPCTL-ERROR (" << err_code << ") " << err_msg;
+}
+
+/*!
+ * @brief
+ *
+ */
+class ExecutionState
+{
+    const error_handler_callback_fn handler_;
+
+public:
+    ExecutionState() : handler_(default_handler){};
+    ExecutionState(const error_handler_callback_fn handler) : handler_(handler)
+    {
+    }
+};
+
+DEFINE_SIMPLE_CONVERSION_FUNCTIONS(ExecutionState, DpctlExecState);
+
+} // namespace
+
+/*!
+ * @brief
+ *
+ * @param    handler        My Param doc
+ * @return   {return}       My Param doc
+ */
+__dpctl_give DpctlExecState
+dpctl_exec_state_create(const error_handler_callback_fn handler)
+{
+    try {
+        ExecutionState *state = new ExecutionState(handler);
+        return wrap(state);
+    } catch (std::bad_alloc const &ba) {
+        std::cerr << ba.what() << '\n';
+        std::terminate();
+    }
+}
+
+/*!
+ * @brief
+ *
+ * @return   {return}       My Param doc
+ */
+__dpctl_give DpctlExecState dpctl_exec_state_create_default()
+{
+    try {
+        ExecutionState *state = new ExecutionState();
+        return wrap(state);
+    } catch (std::bad_alloc const &ba) {
+        std::cerr << ba.what() << '\n';
+        std::terminate();
+    }
+}
+
+/*!
+ * @brief
+ *
+ * @param    DpctlExecState My Param doc
+ */
+void dpctl_exec_state_delete(__dpctl_take DpctlExecState state)
+{
+    delete unwrap(state);
+}