summaryrefslogtreecommitdiffstats
path: root/doc/opal-api/opal-pci-set-p2p-157.rst
blob: c34630cc8ef06597b439e20b7682824c7f00979a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
OPAL_PCI_SET_P2P
================
::

   #define OPAL_PCI_SET_P2P			157

   int64_t opal_pci_set_p2p(uint64_t phbid_init, uint64_t phbid_target,
				uint64_t desc, uint16_t pe_number)

   /* PCI p2p descriptor */
   #define OPAL_PCI_P2P_ENABLE		0x1
   #define OPAL_PCI_P2P_LOAD		0x2
   #define OPAL_PCI_P2P_STORE		0x4

The host calls this function to enable PCI peer-to-peer on the PHBs.

Parameters
----------
::

   uint64_t phbid_init
   uint64_t phbid_target
   uint64_t desc
   uint16_t pe_number


``phbid_init``
  is the value from the PHB node ibm,opal-phbid property for the device initiating the p2p operation

``phbid_target``
  is the value from the PHB node ibm,opal-phbid property for the device targeted by the p2p operation

``desc``
  tells whether the p2p operation is a store (OPAL_PCI_P2P_STORE) or load (OPAL_PCI_P2P_LOAD). Can be both.
  OPAL_PCI_P2P_ENABLE enables/disables the setting

``pe_number``
  PE number for the initiating device

Return Values
-------------

``OPAL_SUCCESS``
  Configuration was successful

``OPAL_PARAMETER``
  Invalid PHB or mode parameter

``OPAL_UNSUPPORTED``
  Not supported by hardware
OpenPOWER on IntegriCloud