aboutsummaryrefslogtreecommitdiffstats
path: root/roms/skiboot/doc/opal-api/opal-sync-host-reboot-87.rst
diff options
context:
space:
mode:
Diffstat (limited to 'roms/skiboot/doc/opal-api/opal-sync-host-reboot-87.rst')
-rw-r--r--roms/skiboot/doc/opal-api/opal-sync-host-reboot-87.rst25
1 files changed, 25 insertions, 0 deletions
diff --git a/roms/skiboot/doc/opal-api/opal-sync-host-reboot-87.rst b/roms/skiboot/doc/opal-api/opal-sync-host-reboot-87.rst
new file mode 100644
index 000000000..bc5605d31
--- /dev/null
+++ b/roms/skiboot/doc/opal-api/opal-sync-host-reboot-87.rst
@@ -0,0 +1,25 @@
+.. _OPAL_SYNC_HOST_REBOOT:
+
+OPAL_SYNC_HOST_REBOOT
+=====================
+
+.. code-block:: c
+
+ #define OPAL_SYNC_HOST_REBOOT 87
+
+ static int64_t opal_sync_host_reboot(void);
+
+This OPAL call halts asynchronous operations in preparation for something
+like kexec. It will halt DMA as well notification of some events (such
+as a new error log being available for retreival).
+
+It's meant to be called in a loop until :ref:`OPAL_SUCCESS` is returned.
+
+Returns
+-------
+:ref:`OPAL_SUCCESS`
+ Success!
+:ref:`OPAL_BUSY_EVENT`
+ not yet complete, call opal_sync_host_reboot() again, possibly with a short delay.
+:ref:`OPAL_BUSY`
+ Call opal_poll_events() and then retry opal_sync_host_reboot