| OPAL_PCI_GET_PHB_DIAG_DATA2 |
| =========================== |
| |
| Get PCI diagnostic data from a given PHB |
| |
| Parameters |
| ---------- |
| ``uint64_t phb_id`` |
| the ID of the PHB you want to retrieve data from |
| |
| ``void *diag_buffer`` |
| an allocated buffer to store diag data in |
| |
| ``uint64_t diag_buffer_len`` |
| size in bytes of the diag buffer |
| |
| Calling |
| ------- |
| |
| Retrieve the PHB's diagnostic data. The diagnostic data is stored in the |
| buffer pointed by @diag_buffer. Different PHB versions will store different |
| diagnostics, defined in include/opal-api.h as ``struct OpalIo<PHBVer>ErrorData``. |
| |
| ``OPAL_PCI_GET_PHB_DIAG_DATA`` is deprecated and ``OPAL_PCI_GET_PHB_DIAG_DATA2`` should be used instead. |
| |
| Return Codes |
| ------------ |
| OPAL_SUCCESS |
| Diagnostic data has been retrieved and stored successfully |
| |
| OPAL_PARAMETER |
| The given buffer is too small to store the diagnostic data |
| |
| OPAL_HARDWARE |
| The PHB is in a broken state and its data cannot be retreived |
| |
| OPAL_UNSUPPORTED |
| Diagnostic data is not implemented for this PHB type |