1 files changed, 35 insertions, 0 deletions
diff --git a/roms/skiboot/doc/opal-api/opal-check-async-completion-86.rst b/roms/skiboot/doc/opal-api/opal-check-async-completion-86.rst
new file mode 100644
index 000000000..1744c6928
--- /dev/null
+++ b/roms/skiboot/doc/opal-api/opal-check-async-completion-86.rst
@@ -0,0 +1,35 @@
+.. _OPAL_CHECK_ASYNC_COMPLETION:
+
+OPAL_CHECK_ASYNC_COMPLETION
+===========================
+
+:ref:`OPAL_CHECK_ASYNC_COMPLETION` checks if an async OPAL pending message was
+completed. (see :ref:`opal-messages`).
+
+.. code-block:: c
+
+   #define OPAL_CHECK_ASYNC_COMPLETION		86
+
+   int64_t opal_check_completion(uint64_t *buffer, uint64_t size, uint64_t token);
+
+Parameters:
+
+buffer
+  buffer to copy message into
+size
+  sizeof buffer to copy message into
+token
+  async message token
+
+Currently unused by Linux, but it is used by FreeBSD.
+
+
+Return values
+-------------
+
+:ref:`OPAL_PARAMETER`
+  buffer parameter is an invalid pointer (NULL or > top of RAM).
+:ref:`OPAL_SUCCESS`
+  message successfully copied to buffer.
+:ref:`OPAL_BUSY`
+  message is still pending and should be re-checked later.