35 lines
1 KiB
ReStructuredText
35 lines
1 KiB
ReStructuredText
|
.. _OPAL_PCI_GET_HUB_DIAG_DATA:
|
||
|
|
|
||
|
|
OPAL_PCI_GET_HUB_DIAG_DATA
|
||
|
|
==========================
|
||
|
|
|
||
|
|
.. code-block:: c
|
||
|
|
|
||
|
|
#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 :ref:`OPAL_PCI_NEXT_ERROR` error type is `OPAL_EEH_IOC_ERROR` and severity
|
||
|
|
is `OPAL_EEH_SEV_INF`, then the OS should call :ref:`OPAL_PCI_GET_HUB_DIAG_DATA`
|
||
|
|
to retreive diagnostic data to log appropriately.
|
||
|
|
|
||
|
|
Returns
|
||
|
|
-------
|
||
|
|
:ref:`OPAL_SUCCESS`
|
||
|
|
Diagnostic data copied successfully
|
||
|
|
:ref:`OPAL_PARAMETER`
|
||
|
|
Invalid address, invalid hub ID, or insufficient space in buffer for
|
||
|
|
diagnostic data.
|
||
|
|
:ref:`OPAL_UNSUPPORTED`
|
||
|
|
hub doesn't support retreiving diagnostic data.
|
||
|
|
:ref:`OPAL_CLOSED`
|
||
|
|
No pending error.
|
||
|
|
:ref:`OPAL_INTERNAL_ERROR`
|
||
|
|
Something went wrong.
|