From b4b596393e715f06df578cd8b91b273b91f5248c Mon Sep 17 00:00:00 2001 From: Stewart Smith Date: Fri, 31 May 2019 16:13:07 +1000 Subject: doc: Add skeleton OPAL_PCI_EEH_FREEZE_STATUS docs Fixes: https://github.com/open-power/skiboot/issues/99 Signed-off-by: Stewart Smith --- doc/opal-api/opal-pci-eeh-freeze-status-23.rst | 50 ++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 doc/opal-api/opal-pci-eeh-freeze-status-23.rst diff --git a/doc/opal-api/opal-pci-eeh-freeze-status-23.rst b/doc/opal-api/opal-pci-eeh-freeze-status-23.rst new file mode 100644 index 0000000..035dc14 --- /dev/null +++ b/doc/opal-api/opal-pci-eeh-freeze-status-23.rst @@ -0,0 +1,50 @@ +.. _OPAL_PCI_EEH_FREEZE_STATUS: + +OPAL_PCI_EEH_FREEZE_STATUS +========================== + +.. code-block:: c + + #define OPAL_PCI_EEH_FREEZE_STATUS 23 + + enum OpalFreezeState { + OPAL_EEH_STOPPED_NOT_FROZEN = 0, + OPAL_EEH_STOPPED_MMIO_FREEZE = 1, + OPAL_EEH_STOPPED_DMA_FREEZE = 2, + OPAL_EEH_STOPPED_MMIO_DMA_FREEZE = 3, + OPAL_EEH_STOPPED_RESET = 4, + OPAL_EEH_STOPPED_TEMP_UNAVAIL = 5, + OPAL_EEH_STOPPED_PERM_UNAVAIL = 6 + }; + + enum OpalPciStatusToken { + OPAL_EEH_NO_ERROR = 0, + OPAL_EEH_IOC_ERROR = 1, + OPAL_EEH_PHB_ERROR = 2, + OPAL_EEH_PE_ERROR = 3, + OPAL_EEH_PE_MMIO_ERROR = 4, + OPAL_EEH_PE_DMA_ERROR = 5 + }; + + int64_t opal_pci_eeh_freeze_status(uint64_t phb_id, uint64_t pe_number, + uint8_t *freeze_state, + uint16_t *pci_error_type, + uint64_t *phb_status); + +.. note:: The ``phb_status`` parameter is deprecated as + of :ref:`skiboot-6.3-rc1`. Linux only ever passed in NULL, + and this was safe. Supplying a pointer was previously *unsafe*. + Always pass NULL. + + +Returns +------- + +:ref:`OPAL_PARAMETER` + Invalid address or PHB. +:ref:`OPAL_UNSUPPORTED` + PHB does not support this operation. +:ref:`OPAL_HARDWARE` + Hardware prohibited getting status, OPAL maybe marked it as broken. +:ref:`OPAL_SUCCESS` + Retreived status. -- cgit v1.1