OPAL_PCI_GET_HUB_DIAG_DATA

#define OPAL_PCI_GET_HUB_DIAG_DATA           50

int64_t opal_pci_get_hub_diag_data(uint64_t hub_id, void *diag_buffer, uint64_t diag_buffer_len);

Fetch diagnostic data for an IO hub. This was only implemented for hardware specific to POWER7 systems, something that was only ever available internally to IBM for development purposes.

It is currently not used.

If OPAL_PCI_NEXT_ERROR error type is OPAL_EEH_IOC_ERROR and severity is OPAL_EEH_SEV_INF, then the OS should call OPAL_PCI_GET_HUB_DIAG_DATA to retreive diagnostic data to log appropriately.

Returns

OPAL_SUCCESS

Diagnostic data copied successfully

OPAL_PARAMETER

Invalid address, invalid hub ID, or insufficient space in buffer for diagnostic data.

OPAL_UNSUPPORTED

hub doesn’t support retreiving diagnostic data.

OPAL_CLOSED

No pending error.

OPAL_INTERNAL_ERROR

Something went wrong.