← Back to branch summary

~pmdj/ubuntu/trusty/qemu/2.9+applesmc+fadtv3

« back to all changes in this revision

Viewing changes to roms/skiboot/doc/opal-api/opal-pci-set-mve-33.txt

  • Committer: Phil Dennis-Jordan
  • Date: 2017-07-21 08:03:43 UTC
  • mfrom: (1.1.1)
  • Revision ID: phil@philjordan.eu-20170721080343-2yr2vdj7713czahv
New upstream release 2.9.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
roms/skiboot/doc/opal-api/opal-pci-set-mve-33.txt
 
1
OPAL_PCI_SET_MVE
 
2
----------------
 
3
 
 
4
#define OPAL_PCI_SET_MVE                        33
 
5
 
 
6
static int64_t opal_pci_set_mve(uint64_t phb_id, uint32_t mve_number,
 
7
                                uint32_t pe_number)
 
8
 
 
9
WARNING: following documentation is from old sources, and is possibly
 
10
not representative of OPALv3 as implemented by skiboot. This should be
 
11
used as a starting point for full documentation.
 
12
 
 
13
The host calls this function to bind a PE to an MSI Validation Table Entry
 
14
(MVE) in the PHB. The MVE compares the MSI requester (RID) to a PE RID,
 
15
including within the XIVE, to validate that the requester is authorized to
 
16
signal an interrupt to the associated DMA address for a message value that
 
17
selects a particular XIVE.
 
18
 
 
19
    The phb_id parameter is the value from the PHB node ibm,opal-phbid
 
20
    property.
 
21
 
 
22
    The mve_number is the index, from 0 to ibm,opal,ibm-num-msi-ports minus1
 
23
 
 
24
    the pe_number is the index of a PE, from 0 to ibm,opal-num-pes minus 1.
 
25
 
 
26
    This call maps an MVE to a PE and PE RID domain. OPAL uses the PELT to
 
27
    determine the PE domain. OPAL treats this call as a NOP for IODA2 PHBs
 
28
    and returns a status of OPAL_SUCCESS.
 
29
 
 
30
 
 
31
Return value:
 
32
 
 
33
        if (!phb)
 
34
                return OPAL_PARAMETER;
 
35
        if (!phb->ops->set_mve)
 
36
                return OPAL_UNSUPPORTED;