<html>
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p><br>
</p>
<br>
<div class="moz-cite-prefix">On Thursday 11 August 2016 02:32 PM,
Nageswara R Sastry wrote:<br>
</div>
<blockquote
cite="mid:1470906172-1829-1-git-send-email-rnsastry@linux.vnet.ibm.com"
type="cite">
<pre wrap="">Documentation for OPAL_GET_XIVE_SOURCE 38
Changes from V1 to V2
moved xive_number to xive_num
Changes from V2 to V3
handled compilation warning
Changes from V3 to V4
removed function and define statements</pre>
</blockquote>
<br>
Looks good.<br>
Reviewed-by: Mukesh Ojha <a class="moz-txt-link-rfc2396E"
href="mailto:hegdevasant@linux.vnet.ibm.com"><mukesh02@linux.vnet.ibm.com></a><br>
<br>
But you have to put changelog after ---.<br>
E.g<br>
<br>
<br>
<blockquote
cite="mid:1470906172-1829-1-git-send-email-rnsastry@linux.vnet.ibm.com"
type="cite">
<pre wrap="">
Signed-off-by: Nageswara R Sastry <a class="moz-txt-link-rfc2396E" href="mailto:rnsastry@linux.vnet.ibm.com"><rnsastry@linux.vnet.ibm.com></a>
---</pre>
</blockquote>
<br>
<pre wrap="">Changes from V1 to V2
moved xive_number to xive_num
Changes from V2 to V3
handled compilation warning
Changes from V3 to V4
removed function and define statements</pre>
<br>
Thanks,<br>
Mukesh<br>
<blockquote
cite="mid:1470906172-1829-1-git-send-email-rnsastry@linux.vnet.ibm.com"
type="cite">
<pre wrap="">
doc/opal-api/opal-get-xive-source-38.rst | 32 ++++++++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
create mode 100644 doc/opal-api/opal-get-xive-source-38.rst
diff --git a/doc/opal-api/opal-get-xive-source-38.rst b/doc/opal-api/opal-get-xive-source-38.rst
new file mode 100644
index 0000000..2989c80
--- /dev/null
+++ b/doc/opal-api/opal-get-xive-source-38.rst
@@ -0,0 +1,32 @@
+OPAL_GET_XIVE_SOURCE
+====================
+::
+
+ This function validates the given ``xive_num`` and sets the
+ ``interrupt_source_number``. Then returns the proper return code.
+
+Parameters
+----------
+
+``phb_id``
+ The ``phb_id`` parameter is the value from the PHB node ``ibm,opal-phbid``
+ property.
+
+``xive_num``
+ The ``xive_num`` is the index of an XIVE that corresponds to a particular
+ interrupt.
+
+``interrupt_source_number``
+ The ``interrupt_source_number`` is a value formed by the combination of the
+ device tree MSI property base BUID and ``xive_num``
+
+Return Codes
+------------
+``OPAL_PARAMETER``
+ The indicated ``phb_id`` not found
+
+``OPAL_UNSUPPORTED``
+ Presence retrieval not supported on the ``phb_id``
+
+``OPAL_SUCCESS``
+ Indicates Success!
</pre>
</blockquote>
<br>
</body>
</html>