aboutsummaryrefslogtreecommitdiff
path: root/doc/opal-api/opal-sync-host-reboot-87.rst
blob: bc5605d31f3080de9cdf6c9b9fff861e42d8b42b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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