diff options
Diffstat (limited to 'roms/skiboot/doc/opal-api/opal-int-eoi-124.rst')
| -rw-r--r-- | roms/skiboot/doc/opal-api/opal-int-eoi-124.rst | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/roms/skiboot/doc/opal-api/opal-int-eoi-124.rst b/roms/skiboot/doc/opal-api/opal-int-eoi-124.rst new file mode 100644 index 000000000..c7d991c88 --- /dev/null +++ b/roms/skiboot/doc/opal-api/opal-int-eoi-124.rst @@ -0,0 +1,24 @@ +.. _OPAL_INT_EOI: + +OPAL_INT_EOI +============ + +.. code-block:: c + + #define OPAL_INT_EOI 124 + + static int64_t opal_int_eoi(uint32_t xirr); + +Modelled on the ``H_EOI`` PAPR call. + +This can return a positive value, which means more interrupts +are queued for that CPU/priority and must be fetched as the XIVE is not +guaranteed to assert the CPU external interrupt line again until the +pending queue for the current priority has been emptied. + +For P9 and above systems where host doesn't know about interrupt controller. +An OS can instead make OPAL calls for XICS emulation. + +For an OS to use this OPAL call, an ``ibm,opal-intc`` compatible device must +exist in the device tree (see :ref:`xive-device-tree`). If OPAL does not create +such a device, the host OS MUST NOT use this call. |