.. _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