Add symbol to do general host interface tests (#115)

* libfaasm: add faasm_hsot_interface_test

* func: add demo func to throw exception from handler

* gh: bump version for new libfaasm

* nit: run clang format

Author: csegarragonz

.env

@@ -1,3 +1,3 @@
-SYSROOT_VERSION=0.2.5
-SYSROOT_CLI_IMAGE=faasm.azurecr.io/cpp-sysroot:0.2.5
+SYSROOT_VERSION=0.2.6
+SYSROOT_CLI_IMAGE=faasm.azurecr.io/cpp-sysroot:0.2.6
 COMPOSE_PROJECT_NAME=cpp-dev

.github/workflows/tests.yml

@@ -19,7 +19,7 @@ jobs:
     if: github.event.pull_request.draft == false
     runs-on: ubuntu-latest
     container:
-      image: faasm.azurecr.io/cpp-sysroot:0.2.5
+      image: faasm.azurecr.io/cpp-sysroot:0.2.6
       credentials:
         username: ${{ secrets.ACR_SERVICE_PRINCIPAL_ID }}
         password: ${{ secrets.ACR_SERVICE_PRINCIPAL_PASSWORD }}

VERSION

@@ -1 +1 @@
-0.2.5
+0.2.6

func/demo/CMakeLists.txt

@@ -28,6 +28,7 @@ demo_func(cpp_example cpp_example.cpp)
 #demo_func(curl_net curl_net.cpp)
 demo_func(dummy dummy.cpp)
 demo_func(echo echo.cpp)
+demo_func(exception exception.cpp)
 demo_func(exit exit.cpp)
 demo_func(fcntl fcntl.cpp)
 demo_func(fibonacci fibonacci.cpp)

func/demo/exception.cpp

@@ -0,0 +1,14 @@
+extern "C"
+{
+#include "faasm/host_interface.h"
+#include "faasm/host_interface_test.h"
+}
+
+#include <stdlib.h>
+
+// This function tests that exceptions can be propagated from host interface
+// calls to the Faasm runtime
+int main(int argc, char* argv[])
+{
+    __faasm_host_interface_test(HostInterfaceTest::ExceptionPropagationTest);
+}

libfaasm/CMakeLists.txt

@@ -8,6 +8,7 @@ set(CMAKE_CXX_STANDARD 17)
 set(PUBLIC_HEADERS
         faasm/core.h
         faasm/host_interface.h
+        faasm/host_interface_test.h
         faasm/array.h
         faasm/compare.h
         faasm/faasm.h

libfaasm/faasm.imports

@@ -42,3 +42,5 @@ __faasm_sm_critical_local_end
 # Migration
 __faasm_migrate_point
 
+# Test
+__faasm_host_interface_test

libfaasm/faasm/host_interface.h

@@ -157,4 +157,7 @@ void __faasm_sm_critical_local_end();
 
 HOST_IFACE_FUNC
 void __faasm_migrate_point(FaasmMigrateEntryPoint f, int arg);
+
+HOST_IFACE_FUNC
+void __faasm_host_interface_test(int testNum);
 #endif

libfaasm/faasm/host_interface_test.h

@@ -0,0 +1,14 @@
+#pragma once
+
+/* We use one host interface call, `__faasm_host_interface_test` to test
+ * different behaviours of host interface calls like, for example, throwing
+ * an exception and testing that it propagates correctly through the WASM
+ * runtime all the way to Faasm. With this enum we indicate the test number.
+ * Note that this header file needs to be duplicated in Faasm in:
+ * faasm/include/wasm/host_interface_test.h
+ */
+enum HostInterfaceTest
+{
+    NoTest = 0,
+    ExceptionPropagationTest = 1,
+};