Merge pull request #593 from w3f/rfc-abort-handler

[PoC/WIP] Abort Handler Host API

ab_host-api/_part.adoc

@@ -21,3 +21,5 @@ include::misc.adoc[]
 include::allocator.adoc[]
 
 include::logging.adoc[]
+
+include::panic_handler.adoc[]

ab_host-api/logging.adoc

@@ -34,5 +34,5 @@ Arguments::
 * `target`: a pointer-size (<<defn-runtime-pointer-size>>) to the
 string which contains the path, module or location from where the log was
 executed.
-* `message`: a pointer-size (<<defn-runtime-pointer-size>>) to the log
-message.
+* `message`: a pointer-size (<<defn-runtime-pointer-size>>) to the UTF-8 encoded
+log message.

ab_host-api/panic_handler.adoc

@@ -0,0 +1,18 @@
+=== Abort Handler
+
+Interface for aborting the execution of the runtime.
+
+==== `ext_panic_handler_abort_on_panic`
+Aborts the execution of the runtime with a given message. Note that the message
+will be only displayed if the host is enabled to display those types of
+messages, which is implementation specific.
+
+===== Version 1 - Prototype
+----
+(func $ext_panic_handler_abort_on_panic_version_1
+	(param $message i64))
+----
+
+Arguments::
+* `message`: a pointer-size (<<defn-runtime-pointer-size>>) to the UTF-8 encoded
+message.