39 lines
955 B
ReStructuredText
39 lines
955 B
ReStructuredText
.. _OPAL_PCI_GET_PRESENCE_STATE:
|
|
|
|
OPAL_PCI_GET_PRESENCE_STATE
|
|
===========================
|
|
|
|
.. code-block: c
|
|
|
|
#define OPAL_PCI_GET_PRESENCE_STATE 119
|
|
|
|
int64_t opal_pci_get_presence_state(uint64_t id, uint64_t data);
|
|
|
|
Get PCI slot presence state
|
|
|
|
Parameters
|
|
----------
|
|
|
|
``uint64_t id``
|
|
PCI slot ID
|
|
|
|
``uint64_t data``
|
|
memory buffer pointer for presence state
|
|
|
|
Calling
|
|
-------
|
|
|
|
Retrieve PCI slot's presence state. The detected presence means there are
|
|
adapters inserted to the PCI slot. Otherwise, the PCI slot is regarded as
|
|
an empty one. The typical use is to ensure there are adapters existing
|
|
before probing the PCI slot in PCI hot add path. The retrieved presence
|
|
state is stored in buffer pointed by @data.
|
|
|
|
Return Codes
|
|
------------
|
|
:ref:`OPAL_SUCCESS`
|
|
PCI slot's presence state is retrieved successfully
|
|
:ref:`OPAL_PARAMETER`
|
|
The indicated PCI slot isn't found
|
|
:ref:`OPAL_UNSUPPORTED`
|
|
Presence retrieval not supported on the PCI slot
|