systemsoftware
/
Linux-Architecture-Reference
30
1
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

File cleanup. Table cleanup. Minor edits.

Browse Source 
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
pull/2/head
Jeff Scheel 4 years ago
parent c250b41348
commit 51a1657033
66 changed files with 1898 additions and 1666 deletions
Show Stats Download Patch File Download Diff File

2
LoPAR/app_bibliography.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

7
LoPAR/app_capi_error_handling.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -16,7 +16,10 @@


--> -->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="app_coherent_platform_facility_error_handling_recovery"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="app_coherent_platform_facility_error_handling_recovery">
<title>Coherent Platform Facility Error Handling and Recovery</title> <title>Coherent Platform Facility Error Handling and Recovery</title>


<para>During the course of operation, a coherent platform function can encounter errors. <para>During the course of operation, a coherent platform function can encounter errors.

20
LoPAR/app_cmo_def.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -39,14 +39,14 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569382_93865"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569382_93865">
<title>CMO Terms</title> <title>CMO Terms</title>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="50*" /> <colspec colname="c1" colwidth="30*" align="center" />
<colspec colname="c2" colwidth="50*" /> <colspec colname="c2" colwidth="70*" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Term</para> <para>Term</para>
</entry> </entry>
<entry> <entry align="center">
<para>Definition</para> <para>Definition</para>
</entry> </entry>
</row> </row>
@ -107,11 +107,11 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569382_70763"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569382_70763">
<title>CMO Characteristics</title> <title>CMO Characteristics</title>
<tgroup cols="4"> <tgroup cols="4">
<colspec colname="c1" colwidth="25*" /> <colspec colname="c1" colwidth="25*" align="center" />
<colspec colname="c2" colwidth="25*" /> <colspec colname="c2" colwidth="25*" align="center" />
<colspec colname="c3" colwidth="25*" /> <colspec colname="c3" colwidth="25*" align="center" />
<colspec colname="c4" colwidth="25*" /> <colspec colname="c4" colwidth="25*" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Characteristics</para> <para>Characteristics</para>
@ -122,7 +122,7 @@
<entry> <entry>
<para>Values</para> <para>Values</para>
</entry> </entry>
<entry> <entry align="center">
<para>Notes</para> <para>Notes</para>
</entry> </entry>
</row> </row>

221
LoPAR/app_eeh_handling.xml
Unescape Escape View File

@ -1,116 +1,133 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569381_46906" xml:id="dbdoclet.50569381_46906"
version="5.0" version="5.0"
xml:lang="en"> xml:lang="en">


<title>EEH Error Processing</title> <title>EEH Error Processing</title>


<para>This appendix describes the architectural intent for EEH error processing. <para>This appendix describes the architectural intent for EEH error processing.
This appendix does not attempt to illustrate all possible scenarios, and other This appendix does not attempt to illustrate all possible scenarios, and other
implementations are possible.</para> implementations are possible.</para>


<section xml:id="dbdoclet.50569381_11923"> <section xml:id="dbdoclet.50569381_11923">
<title>General Scenarios</title> <title>General Scenarios</title>
<para>In general, the device driver recovery consists of issuing an <para>In general, the device driver recovery consists of issuing an
<emphasis>ibm,read-slot-reset-state2</emphasis> call prior to doing any recovery <emphasis>ibm,read-slot-reset-state2</emphasis> call prior to doing any recovery
to determine if (1) the IOA is in the MMIO Stopped and DMA Stopped state (that is, to determine if (1) the IOA is in the MMIO Stopped and DMA Stopped state (that is,
that an error has occurred which has put it into this state), and (2) whether or that an error has occurred which has put it into this state), and (2) whether or
not the PE has been reset by the platform in the process of entering the MMIO not the PE has been reset by the platform in the process of entering the MMIO
Stopped and DMA Stopped state, and then doing one of the following:</para> Stopped and DMA Stopped state, and then doing one of the following:</para>


<orderedlist> <orderedlist>
<listitem> <listitem>
<para>Simplest approach: </para> <para>Simplest approach: </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Reset the PE</para> <para>Reset the PE</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Reconfigure the PE</para> <para>Reconfigure the PE</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>


<listitem xml:id="dbdoclet.50569381_39262"> <listitem xml:id="dbdoclet.50569381_39262">
<para>Most general approach (detailed more in <xref linkend="dbdoclet.50569381_38095"/>): </para> <para>Most general approach (detailed more in <xref linkend="dbdoclet.50569381_38095"/>): </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Release the PE for <emphasis>Load</emphasis> /<emphasis>Store</emphasis></para> <para>Release the PE for <emphasis>Load</emphasis> /<emphasis>Store</emphasis></para>
</listitem> </listitem>

<listitem> <listitem>
<para>Issue <emphasis>Load</emphasis> /<emphasis> Store</emphasis> instructions t <para>Issue <emphasis>Load</emphasis> /<emphasis> Store</emphasis> instructions t
o get any desired state information from the IOA</para> o get any desired state information from the IOA</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Call the <emphasis>ibm,slot-error-detail</emphasis> RTAS call to get the <para>Call the <emphasis>ibm,slot-error-detail</emphasis> RTAS call to get the
platform error information</para> platform error information</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Log the error information</para> <para>Log the error information</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Reset the PE</para> <para>Reset the PE</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Reconfigure the PE</para> <para>Reconfigure the PE</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>


<listitem> <listitem>
<para>Most robust (no reset unless necessary): </para> <para>Most robust (no reset unless necessary): </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Release the PE for <emphasis>Load</emphasis> /<emphasis>Store</emphasis></para> <para>Release the PE for <emphasis>Load</emphasis> /<emphasis>Store</emphasis></para>
</listitem> </listitem>

<listitem> <listitem>
<para>Issue <emphasis> Load</emphasis> /<emphasis> Store</emphasis> instructions <para>Issue <emphasis> Load</emphasis> /<emphasis> Store</emphasis> instructions
to get any desired state information from the IOA</para> to get any desired state information from the IOA</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Call the <emphasis> ibm,slot-error-detail</emphasis> RTAS call to get the <para>Call the <emphasis> ibm,slot-error-detail</emphasis> RTAS call to get the
platform error information</para> platform error information</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Log the error information</para> <para>Log the error information</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Device driver does IOA cleanup</para> <para>Device driver does IOA cleanup</para>
</listitem> </listitem>

<listitem> <listitem>
<para>Release the PE for DMA and restart operations (no reset) </para> <para>Release the PE for DMA and restart operations (no reset) </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
</orderedlist> </orderedlist>


<para>In any scenario, after several retries of a recoverable operation, the OS <para>In any scenario, after several retries of a recoverable operation, the OS
may determine that further recovery efforts should cease. In such a case, may determine that further recovery efforts should cease. In such a case,
calling <emphasis>ibm,slot-error-detail</emphasis> with <emphasis>Function</emphasis> 2 calling <emphasis>ibm,slot-error-detail</emphasis> with <emphasis>Function</emphasis> 2
(Permanent Error), in addition to returning error information, marks that the PE is (Permanent Error), in addition to returning error information, marks that the PE is
no longer accessible due to previous errors.</para> no longer accessible due to previous errors.</para>
</section> </section>


<section xml:id="dbdoclet.50569381_38095"> <section xml:id="dbdoclet.50569381_38095">
<title>More Detail on the Most General Approach</title> <title>More Detail on the Most General Approach</title>
<para>The following gives a more detailed look at scenario #<xref linkend="dbdoclet.50569381_39262"/> <para>The following gives a more detailed look at scenario #<xref linkend="dbdoclet.50569381_39262"/>
in <xref linkend="dbdoclet.50569381_11923"/>. This will be broken up into two groups of operations: in <xref linkend="dbdoclet.50569381_11923"/>. This will be broken up into two groups of operations:
error logging and error recovery.</para> error logging and error recovery.</para>
<para>These scenarios assume that:</para> <para>These scenarios assume that:</para>


<orderedlist> <orderedlist>
<listitem> <listitem>
<para>The <emphasis> ibm,configure-pe</emphasis> RTAS call is implemented.</para> <para>The <emphasis> ibm,configure-pe</emphasis> RTAS call is implemented.</para>
</listitem> </listitem>
@ -118,18 +135,18 @@ xml:lang="en">
<listitem> <listitem>
<para>The attempts at recovery stop when Max_Retries_Exceeded is true.</para> <para>The attempts at recovery stop when Max_Retries_Exceeded is true.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>


<section> <section>
<title>Error Logging</title> <title>Error Logging</title>


<orderedlist> <orderedlist>
<listitem> <listitem>
<para>If the device driver is going to capture internal IOA-specific information <para>If the device driver is going to capture internal IOA-specific information
as a part of the error logging process or if the IOA controlled by the device driver as a part of the error logging process or if the IOA controlled by the device driver
requires a longer wait after reset than the normal PCI specified minimum wait time, requires a longer wait after reset than the normal PCI specified minimum wait time,
then the device driver determines whether its IOA has been reset as a result of entering then the device driver determines whether its IOA has been reset as a result of entering
EEH Stopped State, by looking at the <emphasis>PE Recovery Info</emphasis> output of EEH Stopped State, by looking at the <emphasis>PE Recovery Info</emphasis> output of
the <emphasis>ibm,read-slot-reset-state2</emphasis> RTAS call.</para> the <emphasis>ibm,read-slot-reset-state2</emphasis> RTAS call.</para>
</listitem> </listitem>


@ -138,106 +155,106 @@ xml:lang="en">
</listitem> </listitem>


<listitem> <listitem>
<para>If the IOA requires longer wait after reset times than the specified minimum, <para>If the IOA requires longer wait after reset times than the specified minimum,
and the PE was reset (see step #1) as a result of the EEH event, then wait the and the PE was reset (see step #1) as a result of the EEH event, then wait the
additional necessary time before continuing.</para> additional necessary time before continuing.</para>
</listitem> </listitem>


<listitem xml:id="dbdoclet.50569381_59303"> <listitem xml:id="dbdoclet.50569381_59303">
<para>The OS or device driver <para>The OS or device driver
enables PE MMIOs by calling the <emphasis>ibm,set-eeh-option</emphasis> RTAS call enables PE MMIOs by calling the <emphasis>ibm,set-eeh-option</emphasis> RTAS call
with <emphasis>Function</emphasis> 2. </para> with <emphasis>Function</emphasis> 2. </para>
</listitem> </listitem>


<listitem> <listitem>
<para>The OS or device driver calls the <emphasis>ibm,configure-pe</emphasis> RTAS call. </para> <para>The OS or device driver calls the <emphasis>ibm,configure-pe</emphasis> RTAS call. </para>
<orderedlist numeration="loweralpha"> <orderedlist numeration="loweralpha">
<listitem> <listitem>
<para>If the PCI fabric does not need configuring (the PE was not reset previous to the <para>If the PCI fabric does not need configuring (the PE was not reset previous to the
call or was reset but was previously configured with <emphasis>ibm,configure-pe</emphasis> ), call or was reset but was previously configured with <emphasis>ibm,configure-pe</emphasis> ),
then the call returns without doing anything, otherwise it attempts to configure then the call returns without doing anything, otherwise it attempts to configure
the fabric up to but not including the endpoint IOA configuration registers.</para> the fabric up to but not including the endpoint IOA configuration registers.</para>
</listitem> </listitem>


<listitem> <listitem>
<para>If an EEH event occurs as a result of probing during the <para>If an EEH event occurs as a result of probing during the
<emphasis>ibm,configure-pe</emphasis> RTAS call that results in a <emphasis>ibm,configure-pe</emphasis> RTAS call that results in a
reset of the PE, the PE will be returned in the PE state of 2. Software reset of the PE, the PE will be returned in the PE state of 2. Software
does not necessarily need to check this on return from the call. The case does not necessarily need to check this on return from the call. The case
where this occurs is expected to be rare, and probably signals a non-transient error. where this occurs is expected to be rare, and probably signals a non-transient error.
In this case the software can continue on with the recovery phase of the EEH processing, In this case the software can continue on with the recovery phase of the EEH processing,
and will eventually hit the same EEH event on further processing.</para> and will eventually hit the same EEH event on further processing.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</listitem> </listitem>


<listitem xml:id="dbdoclet.50569381_74560"> <listitem xml:id="dbdoclet.50569381_74560">
<para>If the PE was <para>If the PE was
reset (see step #1) as a result of the EEH event, then if the device driver is reset (see step #1) as a result of the EEH event, then if the device driver is
going to gather IOA-specific information for logging, it needs to finish the going to gather IOA-specific information for logging, it needs to finish the
configuration of the IOA PCI configuration registers, by restoring the PCI configuration of the IOA PCI configuration registers, by restoring the PCI
configuration space registers of the IOA(s) in the PE (for example, BARs, configuration space registers of the IOA(s) in the PE (for example, BARs,
Memory Space Enable, etc.). </para> Memory Space Enable, etc.). </para>
</listitem> </listitem>


<listitem xml:id="dbdoclet.50569381_29191"> <listitem xml:id="dbdoclet.50569381_29191">
<para>If desired, the <para>If desired, the
device driver gathers IOA-specific information via MMIOs, by doing MMIOs to its IOA.</para> device driver gathers IOA-specific information via MMIOs, by doing MMIOs to its IOA.</para>
</listitem> </listitem>


<listitem> <listitem>
<para>The OS or device driver calls <emphasis>ibm,slot-error-detail</emphasis> . <para>The OS or device driver calls <emphasis>ibm,slot-error-detail</emphasis> .
Any data captured in step #<xref linkend="dbdoclet.50569381_29191"/> is passed in the Any data captured in step #<xref linkend="dbdoclet.50569381_29191"/> is passed in the
call. Note that maximum amount of data will be captured in some cases only when the call. Note that maximum amount of data will be captured in some cases only when the
<emphasis>ibm,slot-error-detail</emphasis> call is made with PE not in the MMIO Stopped <emphasis>ibm,slot-error-detail</emphasis> call is made with PE not in the MMIO Stopped
State (as it should be in step #<xref linkend="dbdoclet.50569381_59303"/>). </para> State (as it should be in step #<xref linkend="dbdoclet.50569381_59303"/>). </para>
<orderedlist numeration="loweralpha"> <orderedlist numeration="loweralpha">
<listitem> <listitem>
<para>If Max_Retries_Exceeded is true, then call <emphasis>ibm,slot-error-detail</emphasis> <para>If Max_Retries_Exceeded is true, then call <emphasis>ibm,slot-error-detail</emphasis>
with <emphasis> Function</emphasis> 2 (Permanent Error).</para> with <emphasis> Function</emphasis> 2 (Permanent Error).</para>
</listitem> </listitem>


<listitem> <listitem>
<para>If Max_Retries_Exceeded is not true, then call <emphasis>ibm,slot-error-detail</emphasis> <para>If Max_Retries_Exceeded is not true, then call <emphasis>ibm,slot-error-detail</emphasis>
with <emphasis>Function</emphasis> 1(Temporary Error).</para> with <emphasis>Function</emphasis> 1(Temporary Error).</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</listitem> </listitem>


<listitem> <listitem>
<para>The <emphasis>ibm,slot-error-detail</emphasis> RTAS call captures whatever <para>The <emphasis>ibm,slot-error-detail</emphasis> RTAS call captures whatever
PCI config space registers it can between the configuration address passed in the call PCI config space registers it can between the configuration address passed in the call
and the system (PHB), and including at the configuration address and at the PHB, and and the system (PHB), and including at the configuration address and at the PHB, and
returns them along with the device specific data in an error log in the return information returns them along with the device specific data in an error log in the return information
from the call. This call may encounter another EEH event, in which case it returns what from the call. This call may encounter another EEH event, in which case it returns what
information it can in the call, with a <emphasis>Status</emphasis> of 0 (Success).</para> information it can in the call, with a <emphasis>Status</emphasis> of 0 (Success).</para>
</listitem> </listitem>


<listitem> <listitem>
<para>The OS or device driver logs the log entry returned from the <para>The OS or device driver logs the log entry returned from the
<emphasis>ibm,slot-error-detail</emphasis> RTAS call.</para> <emphasis>ibm,slot-error-detail</emphasis> RTAS call.</para>
</listitem> </listitem>


<listitem> <listitem>
<para>If Max_Retries_Exceeded is not true, then the next step is PE Recovery, <para>If Max_Retries_Exceeded is not true, then the next step is PE Recovery,
otherwise stop and mark the IOA(s) in the PE as unusable.</para> otherwise stop and mark the IOA(s) in the PE as unusable.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</section> </section>


<section> <section>
<title>PE Recovery</title> <title>PE Recovery</title>


<orderedlist> <orderedlist>
<listitem> <listitem>
<para>OS or device driver does a PE reset sequence. Note that this step is <para>OS or device driver does a PE reset sequence. Note that this step is
required even if the PE was reset as a result of the initial EEH event, because required even if the PE was reset as a result of the initial EEH event, because
the error logging steps (for example, the <emphasis>ibm,configure-pe</emphasis> the error logging steps (for example, the <emphasis>ibm,configure-pe</emphasis>
or <emphasis> ibm,slot-error-detail</emphasis> calls) could have encountered or <emphasis> ibm,slot-error-detail</emphasis> calls) could have encountered
another EEH event. </para> another EEH event. </para>
<orderedlist numeration="loweralpha"> <orderedlist numeration="loweralpha">
<listitem> <listitem>
<para>The device driver or OS calls <emphasis>ibm,set-slot-reset</emphasis> with <para>The device driver or OS calls <emphasis>ibm,set-slot-reset</emphasis> with
<emphasis>Function</emphasis> 1 or 3 to activate the reset.</para> <emphasis>Function</emphasis> 1 or 3 to activate the reset.</para>
</listitem> </listitem>


@ -246,26 +263,26 @@ xml:lang="en">
</listitem> </listitem>


<listitem> <listitem>
<para>The device driver or OS calls <emphasis>ibm,set-slot-reset</emphasis> with <para>The device driver or OS calls <emphasis>ibm,set-slot-reset</emphasis> with
<emphasis>Function</emphasis> 0 to deactivate the reset.</para> <emphasis>Function</emphasis> 0 to deactivate the reset.</para>
</listitem> </listitem>


<listitem> <listitem>
<para>The minimum reset inactive to first configuration cycles is waited. <para>The minimum reset inactive to first configuration cycles is waited.
If the IOA requires more than the standard PCI specified time, then wait that If the IOA requires more than the standard PCI specified time, then wait that
longer time, instead.</para> longer time, instead.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</listitem> </listitem>


<listitem> <listitem>
<para>The OS or device driver calls <emphasis>ibm,configure-pe.</emphasis> <para>The OS or device driver calls <emphasis>ibm,configure-pe.</emphasis>
<note><para>If an EEH event occurs as a result of probing <note><para>If an EEH event occurs as a result of probing
during the <emphasis>ibm,configure-pe</emphasis> RTAS call that results in a reset during the <emphasis>ibm,configure-pe</emphasis> RTAS call that results in a reset
of the PE, the PE will be returned in the PE state of 2. Software does not necessarily of the PE, the PE will be returned in the PE state of 2. Software does not necessarily
need to check this on return from the call. The case where this occurs is expected to need to check this on return from the call. The case where this occurs is expected to
be rare, and probably signals a non-transient error. In this case the software can be rare, and probably signals a non-transient error. In this case the software can
continue on with the recovery phase of the EEH processing, and will eventually hit continue on with the recovery phase of the EEH processing, and will eventually hit
the same EEH event on further processing.</para></note> the same EEH event on further processing.</para></note>
</para> </para>
</listitem> </listitem>
@ -277,7 +294,7 @@ xml:lang="en">
<listitem> <listitem>
<para>The device driver initializes the IOA for operations.</para> <para>The device driver initializes the IOA for operations.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>


</section> </section>
</section> </section>

9
LoPAR/app_fault_v_errorlog.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -16,7 +16,10 @@


--> -->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdoclet.50569385_36278"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569385_36278">
<title> <title>
When to use: Fault vs. Error Log Indicators (Lightpath Mode)</title> When to use: Fault vs. Error Log Indicators (Lightpath Mode)</title>
<para>This appendix gives <para>This appendix gives
@ -113,7 +116,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>All</para> <para>All</para>

90
LoPAR/app_firmware_dump.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -72,11 +72,11 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>Register Save Area Format</title> <title>Register Save Area Format</title>
<tgroup cols="5"> <tgroup cols="5">
<colspec colname="c1" colwidth="20*" /> <colspec colname="c1" colwidth="15*" align="center" />
<colspec colname="c2" colwidth="20*" /> <colspec colname="c2" colwidth="15*" align="center" />
<colspec colname="c3" colwidth="20*" /> <colspec colname="c3" colwidth="23*" align="center" />
<colspec colname="c4" colwidth="20*" /> <colspec colname="c4" colwidth="23*" />
<colspec colname="c5" colwidth="20*" /> <colspec colname="c5" colwidth="23*" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -94,19 +94,19 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Value</emphasis> <emphasis role="bold">Value</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle">
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -301,11 +301,11 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>RegEntry Format</title> <title>RegEntry Format</title>
<tgroup cols="5"> <tgroup cols="5">
<colspec colname="c1" colwidth="20*" /> <colspec colname="c1" colwidth="15*" align="center" />
<colspec colname="c2" colwidth="20*" /> <colspec colname="c2" colwidth="15*" align="center" />
<colspec colname="c3" colwidth="20*" /> <colspec colname="c3" colwidth="23*" align="center" />
<colspec colname="c4" colwidth="20*" /> <colspec colname="c4" colwidth="23*" align="center" />
<colspec colname="c5" colwidth="20*" /> <colspec colname="c5" colwidth="23*" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -328,14 +328,14 @@
<emphasis role="bold">Value</emphasis> <emphasis role="bold">Value</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x0</para> <para>0x0</para>
@ -377,10 +377,10 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>CPUSTRT and CPUEND have the following format</title> <title>CPUSTRT and CPUEND have the following format</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="50*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="25*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="25*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>8 Byte Identifier</para> <para>8 Byte Identifier</para>
@ -399,9 +399,9 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>8-Byte RegEntries</title> <title>8-Byte RegEntries</title>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="50*" /> <colspec colname="c1" colwidth="50*" align="center" />
<colspec colname="c2" colwidth="50*" /> <colspec colname="c2" colwidth="50*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>8 Byte Identifier</para> <para>8 Byte Identifier</para>
@ -417,10 +417,10 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>4-Byte RegEntries</title> <title>4-Byte RegEntries</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="50*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="25*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="25*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>8 Byte Identifier</para> <para>8 Byte Identifier</para>
@ -440,8 +440,8 @@
<title>Identifiers Supported in Version 0x0 of the <title>Identifiers Supported in Version 0x0 of the
Table</title> Table</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="25*" /> <colspec colname="c1" colwidth="25*" align="center" />
<colspec colname="c2" colwidth="25*" /> <colspec colname="c2" colwidth="25*" align="center" />
<colspec colname="c3" colwidth="50*" /> <colspec colname="c3" colwidth="50*" />
<thead> <thead>
<row> <row>
@ -455,14 +455,14 @@
<emphasis role="bold">Identifier (ASCII)</emphasis> <emphasis role="bold">Identifier (ASCII)</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x4350555354525400</para> <para>0x4350555354525400</para>
@ -6004,11 +6004,11 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>HPT Entry Save Area Format</title> <title>HPT Entry Save Area Format</title>
<tgroup cols="5"> <tgroup cols="5">
<colspec colname="c1" colwidth="20*" /> <colspec colname="c1" colwidth="15*" align="center" />
<colspec colname="c2" colwidth="20*" /> <colspec colname="c2" colwidth="15*" align="center" />
<colspec colname="c3" colwidth="20*" /> <colspec colname="c3" colwidth="23*" align="center" />
<colspec colname="c4" colwidth="20*" /> <colspec colname="c4" colwidth="23*" align="center" />
<colspec colname="c5" colwidth="20*" /> <colspec colname="c5" colwidth="23*" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -6031,14 +6031,14 @@
<emphasis role="bold">Value</emphasis> <emphasis role="bold">Value</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -6184,11 +6184,11 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>HPT Entry Format</title> <title>HPT Entry Format</title>
<tgroup cols="5"> <tgroup cols="5">
<colspec colname="c1" colwidth="20*" /> <colspec colname="c1" colwidth="15*" align="center" />
<colspec colname="c2" colwidth="20*" /> <colspec colname="c2" colwidth="15*" align="center" />
<colspec colname="c3" colwidth="20*" /> <colspec colname="c3" colwidth="23*" align="center" />
<colspec colname="c4" colwidth="20*" /> <colspec colname="c4" colwidth="23*" align="center" />
<colspec colname="c5" colwidth="20*" /> <colspec colname="c5" colwidth="23*" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -6211,14 +6211,14 @@
<emphasis role="bold">Value</emphasis> <emphasis role="bold">Value</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x0</para> <para>0x0</para>

10
LoPAR/app_glossary.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -16,10 +16,10 @@


--> -->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" version="5.0"
xml:id="dbdoclet.50569388_37308"> xml:id="dbdoclet.50569388_37308">
<?dbhtml stop-chunking?> <?dbhtml stop-chunking?>
<title>Glossary</title> <title>Glossary</title>
<para>This glossary contains an alphabetical list of terms, phrases, and abbreviations used in this document. </para> <para>This glossary contains an alphabetical list of terms, phrases, and abbreviations used in this document. </para>

22
LoPAR/app_pa_processor_binding.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -592,7 +592,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>phys.lo cell:</para> <para>phys.lo cell:</para>
@ -810,7 +810,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>2.04</para> <para>2.04</para>
@ -1135,7 +1135,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -1456,7 +1456,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="7"> <entry morerows="7">
<para>0</para> <para>0</para>
@ -2181,7 +2181,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="3"> <entry morerows="3">
<para>0</para> <para>0</para>
@ -2328,7 +2328,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="1"> <entry morerows="1">
<para>0</para> <para>0</para>
@ -2440,7 +2440,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="1"> <entry morerows="1">
<para>0</para> <para>0</para>
@ -2554,7 +2554,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -3103,7 +3103,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>&#160;</para> <para>&#160;</para>
@ -3522,7 +3522,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>msr</para> <para>msr</para>

38
LoPAR/app_papr_binding.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -287,7 +287,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Installation Media:</para> <para>Installation Media:</para>
@ -991,7 +991,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1</para> <para>1</para>
@ -1625,7 +1625,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>C5</para> <para>C5</para>
@ -1757,7 +1757,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Version</para> <para>Version</para>
@ -2018,7 +2018,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -2155,7 +2155,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>ethernet_mac</para> <para>ethernet_mac</para>
@ -2544,7 +2544,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="18"> <entry morerows="18">
<para>Base</para> <para>Base</para>
@ -4804,7 +4804,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="7"> <entry morerows="7">
<para>0</para> <para>0</para>
@ -5860,7 +5860,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>storage-system-io</para> <para>storage-system-io</para>
@ -6062,7 +6062,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -6335,7 +6335,7 @@
<colspec colname="c1" colwidth="20*" align="center" /> <colspec colname="c1" colwidth="20*" align="center" />
<colspec colname="c2" colwidth="20*" align="center" /> <colspec colname="c2" colwidth="20*" align="center" />
<colspec colname="c3" colwidth="60*" /> <colspec colname="c3" colwidth="60*" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Name</para> <para>Name</para>
@ -8329,7 +8329,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para> <para>
@ -10320,7 +10320,7 @@ where:
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>100</para> <para>100</para>
@ -10408,7 +10408,7 @@ where:
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="3" valign="middle"> <entry morerows="3" valign="middle">
<para>&#160;</para> <para>&#160;</para>
@ -10753,7 +10753,7 @@ where:
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Version</para> <para>Version</para>
@ -10832,7 +10832,7 @@ where:
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Block_type</para> <para>Block_type</para>
@ -10891,7 +10891,7 @@ where:
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Block_type</para> <para>Block_type</para>
@ -10981,7 +10981,7 @@ where:
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Block_type</para> <para>Block_type</para>

22
LoPAR/app_platform_hcalls.xml
Unescape Escape View File

@ -1,5 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdoclet.50569383_58396"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569383_58396">
<title>Platform Dependent hcall()s</title> <title>Platform Dependent hcall()s</title>


<para>This appendix defines the set of hypervisor calls (hcall()s) that are <para>This appendix defines the set of hypervisor calls (hcall()s) that are

24
LoPAR/app_splar.xml
Unescape Escape View File

@ -1,8 +1,28 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569367_15730">
<title>SPLPAR Characteristics Definitions</title> <title>SPLPAR Characteristics Definitions</title>
<section> <section>
<title xml:id="dbdoclet.50569367_15730">SPLPAR Characteristics Definitions</title> <title>SPLPAR Characteristics Definitions</title>


<para>This appendix defines the string that is returned by the <para>This appendix defines the string that is returned by the
ibm,get-system-parameter RTAS call when the parameter token value of 20 ibm,get-system-parameter RTAS call when the parameter token value of 20

24
LoPAR/app_virtual_nic.xml
Unescape Escape View File

@ -1,6 +1,26 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> xmlns:xl="http://www.w3.org/1999/xlink"
<title xml:id="dbdoclet.50569384_75285">A Protocol for VNIC Communications</title> version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569384_75285">
<title>A Protocol for VNIC Communications</title>


<section> <section>
<title>Introduction</title> <title>Introduction</title>

22
LoPAR/app_virtual_scsi.xml
Unescape Escape View File

@ -1,5 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdoclet.50569379_75285"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569379_75285">
<title>A Protocol for VSCSI Communications</title> <title>A Protocol for VSCSI Communications</title>


<section> <section>

7
LoPAR/app_virtual_tpm.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -16,7 +16,10 @@


--> -->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="ch_virtual_trusted_platform_module"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="ch_virtual_trusted_platform_module">
<title>Virtual Trusted Platform Module (VTPM)</title> <title>Virtual Trusted Platform Module (VTPM)</title>


<section> <section>

38
LoPAR/app_virtual_tty.xml
Unescape Escape View File

@ -1,5 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdoclet.50569375_64200"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569375_64200">
<title>A Protocol for a Virtual TTY Interface</title> <title>A Protocol for a Virtual TTY Interface</title>


<section> <section>
@ -78,7 +98,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x0</para> <para>0x0</para>
@ -166,7 +186,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x0</para> <para>0x0</para>
@ -266,7 +286,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x6</para> <para>0x6</para>
@ -421,7 +441,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x6</para> <para>0x6</para>
@ -472,7 +492,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>TSCD</para> <para>TSCD</para>
@ -553,7 +573,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x0</para> <para>0x0</para>
@ -664,7 +684,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x0</para> <para>0x0</para>
@ -833,7 +853,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0xFF</para> <para>0xFF</para>

45
LoPAR/app_vmc_comm.xml
Unescape Escape View File

@ -1,5 +1,24 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<appendix xmlns="http://docbook.org/ns/docbook" <appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en">
<title>A Protocol for VMC Communications</title> <title>A Protocol for VMC Communications</title>


<section> <section>
@ -72,7 +91,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c1" colwidth="15*" align="center" /> <colspec colname="c1" colwidth="15*" align="center" />
<colspec colname="c2" colwidth="15*" align="center" /> <colspec colname="c2" colwidth="15*" align="center" />
<colspec colname="c3" colwidth="70*" align="center" /> <colspec colname="c3" colwidth="70*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -123,7 +142,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c7" colwidth="11*" align="center" /> <colspec colname="c7" colwidth="11*" align="center" />
<colspec colname="c8" colwidth="11*" align="center" /> <colspec colname="c8" colwidth="11*" align="center" />
<colspec colname="c9" colwidth="11*" align="center" /> <colspec colname="c9" colwidth="11*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -240,7 +259,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c7" colwidth="11*" align="center" /> <colspec colname="c7" colwidth="11*" align="center" />
<colspec colname="c8" colwidth="11*" align="center" /> <colspec colname="c8" colwidth="11*" align="center" />
<colspec colname="c9" colwidth="11*" align="center" /> <colspec colname="c9" colwidth="11*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -402,7 +421,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c6" colwidth="12*" align="center" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" align="center" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" align="center" /> <colspec colname="c8" colwidth="12*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -492,7 +511,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c6" colwidth="12*" align="center" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" align="center" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" align="center" /> <colspec colname="c8" colwidth="12*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -570,7 +589,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c6" colwidth="12*" align="center" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" align="center" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" align="center" /> <colspec colname="c8" colwidth="12*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -646,7 +665,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c6" colwidth="12*" align="center" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" align="center" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" align="center" /> <colspec colname="c8" colwidth="12*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -723,7 +742,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c7" colwidth="11*" align="center" /> <colspec colname="c7" colwidth="11*" align="center" />
<colspec colname="c8" colwidth="11*" align="center" /> <colspec colname="c8" colwidth="11*" align="center" />
<colspec colname="c9" colwidth="11*" align="center" /> <colspec colname="c9" colwidth="11*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -834,7 +853,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c6" colwidth="12*" align="center" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" align="center" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" align="center" /> <colspec colname="c8" colwidth="12*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -914,7 +933,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c6" colwidth="12*" align="center" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" align="center" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" align="center" /> <colspec colname="c8" colwidth="12*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -1022,7 +1041,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c6" colwidth="12*" align="center" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" align="center" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" align="center" /> <colspec colname="c8" colwidth="12*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>
@ -1102,7 +1121,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<colspec colname="c7" colwidth="11*" align="center" /> <colspec colname="c7" colwidth="11*" align="center" />
<colspec colname="c8" colwidth="11*" align="center" /> <colspec colname="c8" colwidth="11*" align="center" />
<colspec colname="c9" colwidth="11*" align="center" /> <colspec colname="c9" colwidth="11*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1 B</para> <para>1 B</para>

2
LoPAR/bk_main.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

13
LoPAR/ch_LoPAPR_preface.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -15,11 +15,12 @@
limitations under the License. limitations under the License.


--> -->
<preface xmlns="http://docbook.org/ns/docbook" <preface xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" version="5.0"
xml:id="ch_PAPR_preface"> xml:id="ch_PAPR_preface">

<title>About This Document</title> <title>About This Document</title>
<?dbhtml stop-chunking?> <?dbhtml stop-chunking?>



23
LoPAR/ch_address_map.xml
Unescape Escape View File

@ -1,6 +1,25 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook" <chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdoclet.50569328_Address-Map"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569328_Address-Map">
<title>Address Map</title> <title>Address Map</title>


<para>The address map of an LoPAR platform is made up of several distinct <para>The address map of an LoPAR platform is made up of several distinct

17
LoPAR/ch_dynamic_reconfig.xml
Unescape Escape View File

@ -1,3 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook" <chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0" version="5.0"

30
LoPAR/ch_interrupt_controller.xml
Unescape Escape View File

@ -1,9 +1,25 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569331_37856"
version="5.0" Licensed under the Apache License, Version 2.0 (the "License");
xml:lang="en"> you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569331_37856"
version="5.0"
xml:lang="en">
<title>Interrupt Controller</title> <title>Interrupt Controller</title>


<para>This chapter specifies the requirements for the LoPAR interrupt <para>This chapter specifies the requirements for the LoPAR interrupt
@ -306,7 +322,7 @@ xml:lang="en">
particular, these calls assign additional MSI resources to an IOA function (as particular, these calls assign additional MSI resources to an IOA function (as
defined by its PCI configuration address: <emphasis>PHB_Unit_ID_Hi, defined by its PCI configuration address: <emphasis>PHB_Unit_ID_Hi,
PHB_Unit_ID_Low, and config_addr</emphasis>), when supported by the platform. PHB_Unit_ID_Low, and config_addr</emphasis>), when supported by the platform.
See <xref linkend="dbdoclet.50569332_61719"/> for more information on theses RTAS calls for See <xref linkend="dbdoclet.50569332_61719"/> for more information on theses RTAS calls for
MSI management.</para> MSI management.</para>
<para>This architecture will refer generically to the MSI and MSI-X <para>This architecture will refer generically to the MSI and MSI-X
capabilities as simply &#x201C;MSI,&#x201D; except where differentiation is capabilities as simply &#x201C;MSI,&#x201D; except where differentiation is

216
LoPAR/ch_introduction.xml
Unescape Escape View File

@ -1,130 +1,146 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569326_38341"
version="5.0" Licensed under the Apache License, Version 2.0 (the "License");
xml:lang="en"> you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569326_38341"
version="5.0"
xml:lang="en">
<title>Introduction</title> <title>Introduction</title>

<para>This architecture specification provides a comprehensive computer <para>This architecture specification provides a comprehensive computer
system platform-to-software interface definition, combined with minimum system system platform-to-software interface definition, combined with minimum system
requirements, that enables the development of and software porting to a range requirements, that enables the development of and software porting to a range
of compatible industry-standard computer systems from workstations through of compatible industry-standard computer systems from workstations through
servers. These systems are based on the requirements defined in servers. These systems are based on the requirements defined in
<xref linkend="dbdoclet.50569387_99718"/><footnote xml:id="pgfId-1000323"><para>The <xref linkend="dbdoclet.50569387_99718"/><footnote xml:id="pgfId-1000323"><para>The
term &#x201C;Processor Architecture&#x201D; (PA) is used throughout this term &#x201C;Processor Architecture&#x201D; (PA) is used throughout this
document to mean compliance with the requirements specified in document to mean compliance with the requirements specified in
<xref linkend="dbdoclet.50569387_99718"/>.</para></footnote>. The definition supports <xref linkend="dbdoclet.50569387_99718"/>.</para></footnote>. The definition supports
the development of both uniprocessor and multiprocessor system the development of both uniprocessor and multiprocessor system
implementations.</para> implementations.</para>
<para>A key attribute and benefit of this architecture is the ability of <para>A key attribute and benefit of this architecture is the ability of
platform developers to have degrees of freedom of implementation below the platform developers to have degrees of freedom of implementation below the
level of architected interfaces and therefore have the opportunity for adding level of architected interfaces and therefore have the opportunity for adding
unique value. This flexibility is achieved through architecture facilities unique value. This flexibility is achieved through architecture facilities
including: (1) device drivers; (2) Open Firmware (OF); (3) including: (1) device drivers; (2) Open Firmware (OF); (3)
Run-Time Abstraction Services (RTAS); Run-Time Abstraction Services (RTAS);
and (4) hardware abstraction layers. The role of items 1 and (4) hardware abstraction layers. The role of items 1
and 4 are described in separate operating system (OS) documentation. The role and 4 are described in separate operating system (OS) documentation. The role
that items 2 and 3 play in this architecture will be described in subsequent that items 2 and 3 play in this architecture will be described in subsequent
paragraphs and chapters.</para> paragraphs and chapters.</para>
<para>This architecture combines leading-edge technologies to create a <para>This architecture combines leading-edge technologies to create a
superior computing platform. By design, it supports a wide range of computing superior computing platform. By design, it supports a wide range of computing
needs including personal productivity, engineering design, data management, needs including personal productivity, engineering design, data management,
information analysis, education, desktop publishing, multimedia, entertainment, information analysis, education, desktop publishing, multimedia, entertainment,
and database, file, and application servers. This architecture effectively and database, file, and application servers. This architecture effectively
leverages industry-standard I/O through the PCI bus. Systems based on this leverages industry-standard I/O through the PCI bus. Systems based on this
architecture are expected to offer price/performance advantages and to address architecture are expected to offer price/performance advantages and to address
the expected growth in computing performance and functionality.</para> the expected growth in computing performance and functionality.</para>
<para><emphasis role="bold">Architecture Note:</emphasis> In modern platforms, designers may choose <para><emphasis role="bold">Architecture Note:</emphasis> In modern platforms, designers may choose
between various PCI topology standards. This architecture uses the term between various PCI topology standards. This architecture uses the term
&#x201C;PCI&#x201D; as a general term to describe the most recent versions of &#x201C;PCI&#x201D; as a general term to describe the most recent versions of
all forms of PCI standards including any approved Engineering Change Requests all forms of PCI standards including any approved Engineering Change Requests
(ECRs) against them. In cases where there are significant differences between (ECRs) against them. In cases where there are significant differences between
individual PCI standards, the following terminology is used to differentiate individual PCI standards, the following terminology is used to differentiate
between the PCI standards.</para> between the PCI standards.</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>The term &#x201C;conventional PCI&#x201D; refers to behavior or <para>The term &#x201C;conventional PCI&#x201D; refers to behavior or
features that conform to the most recent version of the features that conform to the most recent version of the
<xref linkend="dbdoclet.50569387_65468"/>, including any approved ECRs against it. <xref linkend="dbdoclet.50569387_65468"/>, including any approved ECRs against it.
</para> </para>
</listitem> </listitem>

<listitem> <listitem>
<para>The term &#x201C;PCI-X&#x201D; refers to behavior or features that <para>The term &#x201C;PCI-X&#x201D; refers to behavior or features that
conform to the most recent version of the conform to the most recent version of the
<xref linkend="dbdoclet.50569387_26550"/>, including any approved ECRs against it.</para> <xref linkend="dbdoclet.50569387_26550"/>, including any approved ECRs against it.</para>
</listitem> </listitem>

<listitem> <listitem>
<para>The term &#x201C;PCI Express&#x201D; refers to behavior or features <para>The term &#x201C;PCI Express&#x201D; refers to behavior or features
that conform to the most recent version of the that conform to the most recent version of the
<xref linkend="dbdoclet.50569387_66784"/> including any approved ECRs against it. In <xref linkend="dbdoclet.50569387_66784"/> including any approved ECRs against it. In
addition, the terms &#x201C;bus,&#x201D; &#x201C;bridge&#x201D; and &#x201C;PCI addition, the terms &#x201C;bus,&#x201D; &#x201C;bridge&#x201D; and &#x201C;PCI
Host Bridge (PHB)&#x201D; used in relation to &#x201C;PCI&#x201D; throughout Host Bridge (PHB)&#x201D; used in relation to &#x201C;PCI&#x201D; throughout
this architecture may refer to a PCI Express &#x201C;link,&#x201D; this architecture may refer to a PCI Express &#x201C;link,&#x201D;
&#x201C;switch,&#x201D; and &#x201C;root complex&#x201D; respectively.</para> &#x201C;switch,&#x201D; and &#x201C;root complex&#x201D; respectively.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>

<section> <section>
<title>Platform Topology</title> <title>Platform Topology</title>
<para>To the experienced computer designer and system manufacturer, much of <para>To the experienced computer designer and system manufacturer, much of
the content of this architecture will be familiar. A typical desktop topology the content of this architecture will be familiar. A typical desktop topology
is shown in <xref linkend="dbdoclet.50569326_34945"/>. This topology consists is shown in <xref linkend="dbdoclet.50569326_34945"/>. This topology consists
of a single PA processor, volatile System Memory, and a single Host Bridge of a single PA processor, volatile System Memory, and a single Host Bridge
providing a PCI Bus. The PCI Bus provides for connection of I/O adapters providing a PCI Bus. The PCI Bus provides for connection of I/O adapters
(IOAs). See <xref linkend="dbdoclet.50569388_37308"/> for the definition of an (IOAs). See <xref linkend="dbdoclet.50569388_37308"/> for the definition of an
IOA.</para> IOA.</para>
<para>A more complex general topology is shown in <para>A more complex general topology is shown in
<xref linkend="dbdoclet.50569326_34945"/>. All platforms consist of one or more PA <xref linkend="dbdoclet.50569326_34945"/>. All platforms consist of one or more PA
processors, a volatile System Memory separate from other subsystems, and a processors, a volatile System Memory separate from other subsystems, and a
number of IOAs, which may initiate transactions to System Memory. The number of IOAs, which may initiate transactions to System Memory. The
processors are linked over the primary processor bus/switch to each other, to processors are linked over the primary processor bus/switch to each other, to
the System Memory, and to one or more Host Bridges. In general, IOAs do not the System Memory, and to one or more Host Bridges. In general, IOAs do not
connect to the primary processor bus/switch. The Host Bridges connect to connect to the primary processor bus/switch. The Host Bridges connect to
secondary buses which have IOAs connected to them. In turn, one or more bus secondary buses which have IOAs connected to them. In turn, one or more bus
bridges may be employed to tertiary buses (and beyond) with additional IOAs bridges may be employed to tertiary buses (and beyond) with additional IOAs
connected to them. Typically, the bus speeds and throughput decrease and the connected to them. Typically, the bus speeds and throughput decrease and the
number of supportable loads increases as one progresses from the primary number of supportable loads increases as one progresses from the primary
processor bus to more remote buses. </para> processor bus to more remote buses. </para>
<para>There are variations on these topologies, which are likely to occur <para>There are variations on these topologies, which are likely to occur
and are therefore worth describing below. This architecture describes and are therefore worth describing below. This architecture describes
interfaces, not implementation. The logical software model must remain the interfaces, not implementation. The logical software model must remain the
same, even if the physical topology is different.</para> same, even if the physical topology is different.</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>In a smaller platform, the Host Bridge and/or the memory and/or an <para>In a smaller platform, the Host Bridge and/or the memory and/or an
IOA may be integrated into a single chip. In this case, the topology would not IOA may be integrated into a single chip. In this case, the topology would not
look like <xref linkend="dbdoclet.50569326_34945"/> from a chip point of view, look like <xref linkend="dbdoclet.50569326_34945"/> from a chip point of view,
but instead would be integrated onto the single chip.</para> but instead would be integrated onto the single chip.</para>
</listitem> </listitem>

<listitem> <listitem>
<para>In a larger platform, secondary buses may be implemented, with two <para>In a larger platform, secondary buses may be implemented, with two
or more Host Bridges, as two or more parallel expansion buses for performance or more Host Bridges, as two or more parallel expansion buses for performance
reasons. Similarly, tertiary buses may be two or more parallel expansion buses reasons. Similarly, tertiary buses may be two or more parallel expansion buses
off each secondary bus. This is indicated by the ellipses near the Host Bridge off each secondary bus. This is indicated by the ellipses near the Host Bridge
and the Bus Bridge.</para> and the Bus Bridge.</para>
</listitem> </listitem>

<listitem> <listitem>
<para>In a high performance platform, with multiple processors and <para>In a high performance platform, with multiple processors and
multiple memoriea switch may be employed to allow multiple parallel accesses multiple memoriea switch may be employed to allow multiple parallel accesses
by the processors to memory. The path through the switches would be decided by by the processors to memory. The path through the switches would be decided by
the addressing of ths, a switch may be employed to allow multiple parallel accesses the addressing of ths, a switch may be employed to allow multiple parallel accesses
by the processors to memory. The path through the switches would be decided by by the processors to memory. The path through the switches would be decided by
the addressing of the memory.</para> the addressing of the memory.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<para>Each of the following chapters provides information necessary to <para>Each of the following chapters provides information necessary to
successfully implement compliant systems. It is recommended that the reader successfully implement compliant systems. It is recommended that the reader
become thoroughly familiar with the contents of these chapters and their become thoroughly familiar with the contents of these chapters and their
references prior to beginning system or software development. It is anticipated references prior to beginning system or software development. It is anticipated
that standard chip sets will simplify the development of compliant that standard chip sets will simplify the development of compliant
implementations consistent with the topologies shown below and will be implementations consistent with the topologies shown below and will be
available from third-party industry sources.</para> available from third-party industry sources.</para>
<figure xml:id="dbdoclet.50569326_34945"> <figure xml:id="dbdoclet.50569326_34945">
<title>Typical Desktop Topology</title> <title>Typical Desktop Topology</title>
@ -140,9 +156,9 @@ xml:lang="en">
<imageobject role="fo"><imagedata contentdepth="100%" fileref="figures/PAPR-4.gif" format="GIF" scalefit="1" width="100%"/></imageobject> <imageobject role="fo"><imagedata contentdepth="100%" fileref="figures/PAPR-4.gif" format="GIF" scalefit="1" width="100%"/></imageobject>
</mediaobject> </mediaobject>
</figure> </figure>
<para><emphasis role="bold">Note:</emphasis> To enable the implementation of a large number of I/O adapters in a large <para><emphasis role="bold">Note:</emphasis> To enable the implementation of a large number of I/O adapters in a large
system, the Host Bridge may be split into two pieces -- a Hub and a Bridge -- system, the Host Bridge may be split into two pieces -- a Hub and a Bridge --
with the two connected by a cable, thus enabling the I/O adapters to be housed with the two connected by a cable, thus enabling the I/O adapters to be housed
at a distance from the main processor enclosure.</para> at a distance from the main processor enclosure.</para>
</section> </section>
</chapter> </chapter>

26
LoPAR/ch_io_devices.xml
Unescape Escape View File

@ -1,6 +1,24 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook" <chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en">
<title>I/O Devices</title> <title>I/O Devices</title>


<para>This chapter describes requirements for IOAs. It adds detail to areas <para>This chapter describes requirements for IOAs. It adds detail to areas
@ -299,7 +317,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="3"> <entry morerows="3">
<para> Command</para> <para> Command</para>
@ -583,7 +601,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Entire adapter assigned to OS, IOV not enabled</para> <para>Entire adapter assigned to OS, IOV not enabled</para>

28
LoPAR/ch_io_topology.xml
Unescape Escape View File

@ -1,9 +1,25 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569330_13240"
version="5.0" Licensed under the Apache License, Version 2.0 (the "License");
xml:lang="en"> you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569330_13240"
version="5.0"
xml:lang="en">
<title>I/O Bridges and Topologies</title> <title>I/O Bridges and Topologies</title>


<para>There will be at least one bridge in a platform which interfaces to the <para>There will be at least one bridge in a platform which interfaces to the

42
LoPAR/ch_lpar_option.xml
Unescape Escape View File

@ -1,5 +1,25 @@
<chapter xmlns="http://docbook.org/ns/docbook" <?xml version="1.0" encoding="UTF-8"?>
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdoclet.50569344_14591"> <!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569344_14591">
<title>Logical Partitioning Option</title> <title>Logical Partitioning Option</title>


<section> <section>
@ -8077,7 +8097,7 @@ hcall ( const int64 H_BLOCK_REMOVE, /* Function Code */
<entry><para role="font-size:6pt">7</para></entry> <entry><para role="font-size:6pt">7</para></entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry namest="c1" nameend="c8"> <entry namest="c1" nameend="c8">
<para role="font-size:6pt">Control</para> <para role="font-size:6pt">Control</para>
@ -8117,7 +8137,7 @@ hcall ( const int64 H_BLOCK_REMOVE, /* Function Code */
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry><para>Type</para></entry> <entry><para>Type</para></entry>
<entry><para>&#160;</para></entry> <entry><para>&#160;</para></entry>
@ -23176,7 +23196,7 @@ hcall ( const H_STOP_COP_OP,
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="3"> <entry morerows="3">
<para>43:44</para> <para>43:44</para>
@ -23410,7 +23430,7 @@ hcall ( const uint64 H_MEMSTAT_CTRL, uint64 flags);]]></programlisting>
<entry><para>31</para></entry> <entry><para>31</para></entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry><para>0</para></entry> <entry><para>0</para></entry>
<entry><para>R</para></entry> <entry><para>R</para></entry>
@ -23477,7 +23497,7 @@ hcall ( const uint64 H_MEMSTAT_CTRL, uint64 flags);]]></programlisting>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -23569,7 +23589,7 @@ hcall ( const uint64 H_MEMSTAT_CTRL, uint64 flags);]]></programlisting>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -23644,7 +23664,7 @@ hcall ( const uint64 H_MEMSTAT_CTRL, uint64 flags);]]></programlisting>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -23954,7 +23974,7 @@ hcall ( const uint64 H_RETURN_PAGEINFO,
<entry><para>7</para></entry> <entry><para>7</para></entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry><para>0</para></entry> <entry><para>0</para></entry>
<entry namest="c2" nameend="c3"><para>Ar</para></entry> <entry namest="c2" nameend="c3"><para>Ar</para></entry>
@ -24140,7 +24160,7 @@ hcall ( const uint64 H_RETURN_PAGEINFO,
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>lpx</para> <para>lpx</para>

26
LoPAR/ch_nonvolatile_memory.xml
Unescape Escape View File

@ -1,8 +1,24 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569333_15433"
version="5.0" xml:lang="en"> Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569333_15433"
version="5.0" xml:lang="en">
<title>Non-Volatile Memory</title> <title>Non-Volatile Memory</title>


<para>This chapter describes the requirements relating to Non-Volatile <para>This chapter describes the requirements relating to Non-Volatile

2
LoPAR/ch_notifications.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

28
LoPAR/ch_numa.xml
Unescape Escape View File

@ -1,9 +1,25 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569346_35960"
version="5.0" Licensed under the Apache License, Version 2.0 (the "License");
xml:lang="en"> you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569346_35960"
version="5.0"
xml:lang="en">
<title>Non Uniform Memory Access (NUMA) Option</title> <title>Non Uniform Memory Access (NUMA) Option</title>


<section> <section>

24
LoPAR/ch_processors_memory.xml
Unescape Escape View File

@ -1,6 +1,24 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en">
<title>Processor and Memory</title> <title>Processor and Memory</title>


<para>The purpose of this chapter is to specify the processor and memory <para>The purpose of this chapter is to specify the processor and memory

28
LoPAR/ch_product_topology.xml
Unescape Escape View File

@ -1,9 +1,25 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569341_39268"
version="5.0" Licensed under the Apache License, Version 2.0 (the "License");
xml:lang="en"> you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569341_39268"
version="5.0"
xml:lang="en">
<title>Product Topology</title> <title>Product Topology</title>


<section xml:id="dbdoclet.50569341_34882"> <section xml:id="dbdoclet.50569341_34882">

2
LoPAR/ch_rtas.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

40
LoPAR/ch_service_indicators.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -799,9 +799,9 @@
<?dbhtml table-width="75%" ?> <?dbhtml table-width="75%" ?>
<?dbfo table-width="75%" ?> <?dbfo table-width="75%" ?>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="33*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="33*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="33*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -821,7 +821,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Number of FRUs</para> <para>Number of FRUs</para>
@ -3751,7 +3751,7 @@
<?dbhtml table-width="80%" ?> <?dbhtml table-width="80%" ?>
<?dbfo table-width="80%" ?> <?dbfo table-width="80%" ?>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="40*" /> <colspec colname="c1" colwidth="40*" align="center" />
<colspec colname="c2" colwidth="60*" /> <colspec colname="c2" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -3760,14 +3760,14 @@
<emphasis role="bold">Green Indicator State</emphasis> <emphasis role="bold">Green Indicator State</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Usage</emphasis> <emphasis role="bold">Usage</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Any not already covered in this table</para> <para>Any not already covered in this table</para>
@ -3833,7 +3833,7 @@
<?dbhtml table-width="80%" ?> <?dbhtml table-width="80%" ?>
<?dbfo table-width="80%" ?> <?dbfo table-width="80%" ?>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="40*" /> <colspec colname="c1" colwidth="40*" align="center" />
<colspec colname="c2" colwidth="60*" /> <colspec colname="c2" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -3842,14 +3842,14 @@
<emphasis role="bold">Green Indicator State</emphasis> <emphasis role="bold">Green Indicator State</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Usage</emphasis> <emphasis role="bold">Usage</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Any not already covered in this table</para> <para>Any not already covered in this table</para>
@ -3936,7 +3936,7 @@
<?dbhtml table-width="80%" ?> <?dbhtml table-width="80%" ?>
<?dbfo table-width="80%" ?> <?dbfo table-width="80%" ?>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="40*" /> <colspec colname="c1" colwidth="40*" align="center" />
<colspec colname="c2" colwidth="60*" /> <colspec colname="c2" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -3945,14 +3945,14 @@
<emphasis role="bold">Green Indicator State</emphasis> <emphasis role="bold">Green Indicator State</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Usage</emphasis> <emphasis role="bold">Usage</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Any not already covered in this table</para> <para>Any not already covered in this table</para>
@ -4025,7 +4025,7 @@
<?dbhtml table-width="80%" ?> <?dbhtml table-width="80%" ?>
<?dbfo table-width="80%" ?> <?dbfo table-width="80%" ?>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="40*" /> <colspec colname="c1" colwidth="40*" align="center" />
<colspec colname="c2" colwidth="60*" /> <colspec colname="c2" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -4034,14 +4034,14 @@
<emphasis role="bold">Green Indicator State</emphasis> <emphasis role="bold">Green Indicator State</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Usage</emphasis> <emphasis role="bold">Usage</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Any not already covered in this table</para> <para>Any not already covered in this table</para>
@ -4110,7 +4110,7 @@
<?dbhtml table-width="80%" ?> <?dbhtml table-width="80%" ?>
<?dbfo table-width="80%" ?> <?dbfo table-width="80%" ?>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="40*" /> <colspec colname="c1" colwidth="40*" align="center" />
<colspec colname="c2" colwidth="60*" /> <colspec colname="c2" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -4119,14 +4119,14 @@
<emphasis role="bold">Green Indicator State</emphasis> <emphasis role="bold">Green Indicator State</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Usage</emphasis> <emphasis role="bold">Usage</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Any not already covered in this table</para> <para>Any not already covered in this table</para>

28
LoPAR/ch_smp.xml
Unescape Escape View File

@ -1,9 +1,25 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569340_14972"
version="5.0" Licensed under the Apache License, Version 2.0 (the "License");
xml:lang="en"> you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569340_14972"
version="5.0"
xml:lang="en">
<title>The Symmetric Multiprocessor Option</title> <title>The Symmetric Multiprocessor Option</title>


<para>This architecture supports the implementation of symmetric <para>This architecture supports the implementation of symmetric

28
LoPAR/ch_system_reqs.xml
Unescape Escape View File

@ -1,9 +1,25 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="UTF-8"?>
<chapter xmlns="http://docbook.org/ns/docbook" <!--
xmlns:xl="http://www.w3.org/1999/xlink" Copyright (c) 2016, 2020 OpenPOWER Foundation
xml:id="dbdoclet.50569327_31987"
version="5.0" Licensed under the Apache License, Version 2.0 (the "License");
xml:lang="en"> you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:id="dbdoclet.50569327_31987"
version="5.0"
xml:lang="en">
<title>System Requirements</title> <title>System Requirements</title>


<para>This chapter gives an operational overview of LoPAR systems and <para>This chapter gives an operational overview of LoPAR systems and

24
LoPAR/ch_virtual_io.xml
Unescape Escape View File

@ -1,5 +1,25 @@
<chapter xmlns="http://docbook.org/ns/docbook" <?xml version="1.0" encoding="UTF-8"?>
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdoclet.50569348_71217"> <!--
Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569348_71217">
<title>Virtualized Input/Output</title> <title>Virtualized Input/Output</title>
<para>Virtualized I/O is an optional feature of platforms that have <para>Virtualized I/O is an optional feature of platforms that have
hypervisor support. Virtual I/O (VIO) provides to a given partition the hypervisor support. Virtual I/O (VIO) provides to a given partition the

22
LoPAR/pom.xml
Unescape Escape View File

@ -1,7 +1,23 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" <!--
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Copyright (c) 2016, 2020 OpenPOWER Foundation
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

-->
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent> <parent>


<groupId>org.openpowerfoundation.docs</groupId> <groupId>org.openpowerfoundation.docs</groupId>

54
LoPAR/sec_LoPAPR_audience.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
@ -13,36 +13,36 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.

--> -->
<section xmlns="http://docbook.org/ns/docbook" <section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" version="5.0"
xml:id="section_PAPR_audience"> xml:id="section_PAPR_audience">
<?dbhtml stop-chunking?> <?dbhtml stop-chunking?>

<title> Audience for This Document</title> <title> Audience for This Document</title>

<para>This document defines the platform and system requirements for designing <para>This document defines the platform and system requirements for designing
LoPAR platforms. This document is the primary source of information that a platform, LoPAR platforms. This document is the primary source of information that a platform,
OS, or hardware component developer would need to create compatible products. OS, or hardware component developer would need to create compatible products.
Additional requirements are defined by the industry standards referenced in this Additional requirements are defined by the industry standards referenced in this
document.</para> document.</para>

<para>This document describes the platform to OS interface which must be provided <para>This document describes the platform to OS interface which must be provided
in these platforms. Platform designers must assemble components and firmware which in these platforms. Platform designers must assemble components and firmware which
match this interface. Also, the document defines minimum system configuration match this interface. Also, the document defines minimum system configuration
requirements. Platform designers must meet or exceed these minimums to build a requirements. Platform designers must meet or exceed these minimums to build a
standard platform. </para> standard platform. </para>

<para>This document must be used by those designing compatible software including <para>This document must be used by those designing compatible software including
the OS, boot software, or firmware. If a function is supported, software developers the OS, boot software, or firmware. If a function is supported, software developers
must provide support for the interfaces described in this document. This software must provide support for the interfaces described in this document. This software
must provide the mandatory functions and capabilities as described in the requirements must provide the mandatory functions and capabilities as described in the requirements
in this document. However, this document does not limit this software from going beyond in this document. However, this document does not limit this software from going beyond
the specification through software tailored to specific hardware. For example, the OS the specification through software tailored to specific hardware. For example, the OS
must implement the interface to the required abstracted interfaces to hardware, but the must implement the interface to the required abstracted interfaces to hardware, but the
OS may also implement fast paths to specific hardware that it recognizes.</para> OS may also implement fast paths to specific hardware that it recognizes.</para>

</section> </section>

123
LoPAR/sec_LoPAPR_conventions.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
@ -13,77 +13,80 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.

--> -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" <section xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="section_PAPR_conventions"> xmlns:xi="http://www.w3.org/2001/XInclude"
<?dbhtml stop-chunking?> xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" xml:id="section_PAPR_conventions">

<?dbhtml stop-chunking?>

<title> Document-specific Conventions</title> <title> Document-specific Conventions</title>

<simplesect> <simplesect>
<title> Requirement Enumeration</title> <title> Requirement Enumeration</title>
<para>Within the body of this document requirements are clearly defined by separate <para>Within the body of this document requirements are clearly defined by separate
paragraphs beginning with a bold text sequence number. A list of all these are paragraphs beginning with a bold text sequence number. A list of all these are
available as a separate document. These requirements may point to other standards available as a separate document. These requirements may point to other standards
documents, or figures or tables which conveniently show the requirement. The documents, or figures or tables which conveniently show the requirement. The
referenced material becomes part of the requirements in this document. Users of this referenced material becomes part of the requirements in this document. Users of this
document must comply with these requirements to build a standard platform. Other document must comply with these requirements to build a standard platform. Other
material in this document is supportive description of these requirements, architecture material in this document is supportive description of these requirements, architecture
notes, or implementation notes. Architecture or implementation notes are flagged with notes, or implementation notes. Architecture or implementation notes are flagged with
a descriptive phrase&#8212;for example, &#8220;Hardware Implementation Note&#8221;&#8212; a descriptive phrase&#8212;for example, &#8220;Hardware Implementation Note&#8221;&#8212;
and followed by indented paragraphs. The descriptive material and notes provide no and followed by indented paragraphs. The descriptive material and notes provide no
additional requirements and may be used for their information content.</para> additional requirements and may be used for their information content.</para>
</simplesect> </simplesect>

<simplesect> <simplesect>
<title> Big-Endian Numbering</title> <title> Big-Endian Numbering</title>
<para>Big-Endian numbering of bytes and bits is used in this document, unless <para>Big-Endian numbering of bytes and bits is used in this document, unless
indicated otherwise. Numbering of bits starts at 0 for the most significant bit and indicated otherwise. Numbering of bits starts at 0 for the most significant bit and
continues to the least significant bit, unless indicated otherwise. All data structures continues to the least significant bit, unless indicated otherwise. All data structures
used for communicating between the OS and the platform (for example, RTAS and hypervisor used for communicating between the OS and the platform (for example, RTAS and hypervisor
calls) will be in Big-Endian format, unless otherwise designated.</para> calls) will be in Big-Endian format, unless otherwise designated.</para>
</simplesect> </simplesect>

<simplesect> <simplesect>
<title> Hypertext Links</title> <title> Hypertext Links</title>
<para>This document makes use of hypertext links. Cross references, Table of Contents <para>This document makes use of hypertext links. Cross references, Table of Contents
entries, List of Tables entries, and List of Figures entries are all clickable hypertext entries, List of Tables entries, and List of Figures entries are all clickable hypertext
links, to make navigation of the document easier.</para> links, to make navigation of the document easier.</para>
</simplesect> </simplesect>

<simplesect> <simplesect>
<title> Specific Terms</title> <title> Specific Terms</title>
<para>In this document:</para> <para>In this document:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>The term &#8220;Processor Architecture&#8221; (PA) is used to mean compliance with <para>The term &#8220;Processor Architecture&#8221; (PA) is used to mean compliance with
the requirements specified in <citetitle><xref linkend="dbdoclet.50569387_99718"/></citetitle>.</para> the requirements specified in <citetitle><xref linkend="dbdoclet.50569387_99718"/></citetitle>.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>The term &#8220;processor&#8221; is used as a general term to mean &#8220;processor, <para>The term &#8220;processor&#8221; is used as a general term to mean &#8220;processor,
&#8221; or &#8220;processor core,&#8221; or &#8220;thread of a multi-threaded processor &#8221; or &#8220;processor core,&#8221; or &#8220;thread of a multi-threaded processor
design.&#8221; In any case where it makes a difference, the specific terminology for that design.&#8221; In any case where it makes a difference, the specific terminology for that
case is used.</para> case is used.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>The term &#8220;real&#8221; used in relationship with addresses is a generic term <para>The term &#8220;real&#8221; used in relationship with addresses is a generic term
that means &#8220;processor real address&#8221; when the platform is running in SMP (non-LPAR) that means &#8220;processor real address&#8221; when the platform is running in SMP (non-LPAR)
mode and partition &#8220;logical real address&#8221; when the platform is running in LPAR mode and partition &#8220;logical real address&#8221; when the platform is running in LPAR
mode.</para> mode.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>The term &#8220;PCI&#8221; is used as a general term to describe the most recent <para>The term &#8220;PCI&#8221; is used as a general term to describe the most recent
versions of all forms of PCI standards. In cases where there are significant differences versions of all forms of PCI standards. In cases where there are significant differences
between individual PCI standards, the following terminology is used to differentiate between between individual PCI standards, the following terminology is used to differentiate between
the PCI standards: conventional PCI, PCI-X, and PCI Express.</para> the PCI standards: conventional PCI, PCI-X, and PCI Express.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</simplesect> </simplesect>

<simplesect> <simplesect>
<title> Typographical Conventions</title> <title> Typographical Conventions</title>
<para>Typographical conventions used in this document are described in <para>Typographical conventions used in this document are described in
<xref linkend="dbdoclet.50569325_36717"/>.</para> <xref linkend="dbdoclet.50569325_36717"/>.</para>
<para><anchor xml:id="dbdoclet.50569325_12795" xreflabel=""/>&#160;</para> <para><anchor xml:id="dbdoclet.50569325_12795" xreflabel=""/>&#160;</para>
<table frame="all" pgwide="1" xml:id="dbdoclet.50569325_36717"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569325_36717">
@ -98,14 +101,14 @@
</thead><tbody> </thead><tbody>
<row> <row>
<entry><para> Rn-m-x.</para></entry> <entry><para> Rn-m-x.</para></entry>
<entry><para> A requirement number. The number &#8220;n&#8221; indicates a requirement <entry><para> A requirement number. The number &#8220;n&#8221; indicates a requirement
sequence number and is changed only when it is necessary change the sequence numbers sequence number and is changed only when it is necessary change the sequence numbers
of one or more requirements on an update. The number &#8220;m&#8221; is the section of one or more requirements on an update. The number &#8220;m&#8221; is the section
that the requirement appears in, and the number &#8220;x&#8221; is the number of the that the requirement appears in, and the number &#8220;x&#8221; is the number of the
requirement within that section. The sequence numbers are automatically generated and requirement within that section. The sequence numbers are automatically generated and
are restarted at the beginning of each new section. Sequence numbers for existing are restarted at the beginning of each new section. Sequence numbers for existing
requirements will not change unless it becomes necessary to insert a requirement between requirements will not change unless it becomes necessary to insert a requirement between
other requirements or to add a section that renumbers other sections (at which point, other requirements or to add a section that renumbers other sections (at which point,
the number &#8220;n&#8221; will be incremented for the next publication of the document).</para></entry> the number &#8220;n&#8221; will be incremented for the next publication of the document).</para></entry>
</row> </row>
<row> <row>
@ -116,8 +119,8 @@
</row> </row>
<row> <row>
<entry><para> <emphasis role="bold"><literal> Courier Bold</literal></emphasis></para></entry> <entry><para> <emphasis role="bold"><literal> Courier Bold</literal></emphasis></para></entry>
<entry><para> Indicates OF properties, methods, configuration variables, node names <entry><para> Indicates OF properties, methods, configuration variables, node names
and encode functions (for example, <emphasis> encode-int</emphasis> and <emphasis> and encode functions (for example, <emphasis> encode-int</emphasis> and <emphasis>
encode-string</emphasis> ). In addition, OF properties are enclosed in quotes.</para> encode-string</emphasis> ). In addition, OF properties are enclosed in quotes.</para>
<para>Indicates NVRAM partition names</para></entry> <para>Indicates NVRAM partition names</para></entry>
</row> </row>
@ -139,44 +142,44 @@
</row> </row>
<row> <row>
<entry><para> 0xF... FFF100</para></entry> <entry><para> 0xF... FFF100</para></entry>
<entry><para> This hexadecimal notation represents a replication of the hexadecimal <entry><para> This hexadecimal notation represents a replication of the hexadecimal
character to the right of the ellipsis to fill out the field width. For example, the character to the right of the ellipsis to fill out the field width. For example, the
address 0xF... FFF100 would be 0xFFFFF100 on a processor with a 32-bit address bus or address 0xF... FFF100 would be 0xFFFFF100 on a processor with a 32-bit address bus or
0xFFFFFFFFFFFFF100 on a processor with a 64-bit address bus.</para></entry> 0xFFFFFFFFFFFFF100 on a processor with a 64-bit address bus.</para></entry>
</row> </row>
<row> <row>
<entry><para> 0:9</para></entry> <entry><para> 0:9</para></entry>
<entry><para> Ranges of bits are specified by two numbers separated by a colon. The <entry><para> Ranges of bits are specified by two numbers separated by a colon. The
range includes the first number, all numbers in between, and the last number.</para></entry> range includes the first number, all numbers in between, and the last number.</para></entry>
</row> </row>
<row> <row>
<entry><para> 0xm-0xn</para></entry> <entry><para> 0xm-0xn</para></entry>
<entry><para> A range of addresses or values within the document is always inclusive, <entry><para> A range of addresses or values within the document is always inclusive,
from m up to and including n.</para></entry> from m up to and including n.</para></entry>
</row> </row>
<row> <row>
<entry><para> &lt;token&gt;</para></entry> <entry><para> &lt;token&gt;</para></entry>
<entry><para> This notation means the character or character string named within the <entry><para> This notation means the character or character string named within the
less than and greater than symbols is used in the place of the symbols and name. For less than and greater than symbols is used in the place of the symbols and name. For
instance, the property name <emphasis role="bold"> &#8220;ibm,sensor-</emphasis> <emphasis>&lt;token&gt;</emphasis> instance, the property name <emphasis role="bold"> &#8220;ibm,sensor-</emphasis> <emphasis>&lt;token&gt;</emphasis>
<emphasis role="bold">&#8221;</emphasis> indicates the set of properties <emphasis role="bold">&#8221;</emphasis> indicates the set of properties
<emphasis role="bold">&#8220;ibm,sensor-9000&#8221;</emphasis>, <emphasis role="bold">&#8220;ibm,sensor-9000&#8221;</emphasis>,
<emphasis role="bold">&#8220;ibm,sensor-9001&#8221;</emphasis> , . . .</para></entry> <emphasis role="bold">&#8220;ibm,sensor-9001&#8221;</emphasis> , . . .</para></entry>
</row> </row>
<row> <row>
<entry><para> Reserved For Compatibility</para></entry> <entry><para> Reserved For Compatibility</para></entry>
<entry><para> This notation is a placeholder used to reserve numbering (for example, <entry><para> This notation is a placeholder used to reserve numbering (for example,
chapter, section and requirement numbers) so that subsequent numbering remains consistent chapter, section and requirement numbers) so that subsequent numbering remains consistent
with document changes.</para></entry> with document changes.</para></entry>
</row> </row>
<row> <row>
<entry><para> NULL vs. null</para></entry> <entry><para> NULL vs. null</para></entry>
<entry><para> NULL designates an ASCII NULL string (0x00). The term &#8220;null&#8221; <entry><para> NULL designates an ASCII NULL string (0x00). The term &#8220;null&#8221;
indicates the empty set.</para></entry> indicates the empty set.</para></entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
</simplesect> </simplesect>

</section> </section>

69
LoPAR/sec_LoPAPR_goals.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
@ -13,73 +13,76 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.

--> -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" <section xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="section_PAPR_goals"> xmlns:xi="http://www.w3.org/2001/XInclude"
<?dbhtml stop-chunking?> xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" xml:id="section_PAPR_goals">

<?dbhtml stop-chunking?>

<title> Goals of This Specification</title> <title> Goals of This Specification</title>

<para>The specific goals of this specification are as follows:</para> <para>The specific goals of this specification are as follows:</para>

<itemizedlist> <itemizedlist>

<listitem> <listitem>
<para>To create a stable platform architecture to be used by platforms based on processors <para>To create a stable platform architecture to be used by platforms based on processors
defined by <xref linkend="dbdoclet.50569387_99718"/>. <emphasis>Processor</emphasis> defined by <xref linkend="dbdoclet.50569387_99718"/>. <emphasis>Processor</emphasis>
implementations based on this implementations based on this
architecture include IBM POWER8&#8482; processors and their successors. </para> architecture include IBM POWER8&#8482; processors and their successors. </para>
</listitem> </listitem>

<listitem> <listitem>
<para>To create an architecture which will allow platforms to operate with previous versions <para>To create an architecture which will allow platforms to operate with previous versions
of the OS (&#8220;n-1&#8221; capability). </para> of the OS (&#8220;n-1&#8221; capability). </para>
</listitem> </listitem>


<listitem> <listitem>
<para>To leverage existing and future industry-standard buses and interfaces.</para> <para>To leverage existing and future industry-standard buses and interfaces.</para>
</listitem> </listitem>

<listitem> <listitem>
<para>To provide a flexible address map. Another key attribute of this specification <para>To provide a flexible address map. Another key attribute of this specification
is the relocatability of devices and subsystems within the Processor Architecture (PA) is the relocatability of devices and subsystems within the Processor Architecture (PA)
address space. Subsystem address information, which defines where I/O Adapters (IOAs) address space. Subsystem address information, which defines where I/O Adapters (IOAs)
reside, is detected by the OF and passed to the OS in the device tree. This architecture reside, is detected by the OF and passed to the OS in the device tree. This architecture
accommodates the use of multiple identical buses and IOAs in the same platform without accommodates the use of multiple identical buses and IOAs in the same platform without
address conflicts.</para> address conflicts.</para>
</listitem> </listitem>


<listitem> <listitem>
<para>To build upon the OF boot environment defined in <para>To build upon the OF boot environment defined in
<xref linkend="dbdoclet.50569387_45524"/>.</para> <xref linkend="dbdoclet.50569387_45524"/>.</para>
</listitem> </listitem>

<listitem> <listitem>
<para>To provide an architecture which can evolve as technology changes. </para> <para>To provide an architecture which can evolve as technology changes. </para>
</listitem> </listitem>

<listitem> <listitem>
<para>To minimize the support cost for multiple OS versions through the definition of common <para>To minimize the support cost for multiple OS versions through the definition of common
platform abstraction techniques. Common and compatible approaches to the abstraction of platform abstraction techniques. Common and compatible approaches to the abstraction of
hardware will reduce the burden on hardware developers who produce differentiated machines.</para> hardware will reduce the burden on hardware developers who produce differentiated machines.</para>
</listitem> </listitem>


<listitem> <listitem>
<para>To architect a mechanism for error handling, error reporting, and fault isolation. This <para>To architect a mechanism for error handling, error reporting, and fault isolation. This
architecture provides for the implementation of more robust systems, if desired by the system architecture provides for the implementation of more robust systems, if desired by the system
developers.</para> developers.</para>
</listitem> </listitem>

<listitem> <listitem>
<para>To architect a mechanism for Dynamic Reconfiguration of the hardware.</para> <para>To architect a mechanism for Dynamic Reconfiguration of the hardware.</para>
</listitem> </listitem>

<listitem> <listitem>
<para>To provide an architecture which allows for the logical partitioning of system resources, <para>To provide an architecture which allows for the logical partitioning of system resources,
in order to execute multiple concurrent OS instances.</para> in order to execute multiple concurrent OS instances.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>


</section> </section>

36
LoPAR/sec_LoPAPR_reading.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
@ -13,26 +13,30 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.

--> -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" <section xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="section_PAPR_reading"> xmlns:xi="http://www.w3.org/2001/XInclude"
<?dbhtml stop-chunking?> xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="section_PAPR_reading">

<?dbhtml stop-chunking?>

<title> Suggested Reading</title> <title> Suggested Reading</title>

<para><xref linkend="dbdoclet.50569387_27251"/> provides a full list of references and ordering information <para><xref linkend="dbdoclet.50569387_27251"/> provides a full list of references and ordering information
for these references.</para> for these references.</para>


<para>This document assumes the reader has an understanding of computer architecture in general, <para>This document assumes the reader has an understanding of computer architecture in general,
the Processor Architecture, the various Peripheral Component Interconnect (PCI) specifications, the Processor Architecture, the various Peripheral Component Interconnect (PCI) specifications,
and OF. Some understanding of the current personal computer and workstation architectures is also and OF. Some understanding of the current personal computer and workstation architectures is also
useful. A list of suggested background reading includes:</para> useful. A list of suggested background reading includes:</para>

<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><citetitle><xref linkend="dbdoclet.50569387_99718"/></citetitle>. <para><citetitle><xref linkend="dbdoclet.50569387_99718"/></citetitle>.
Note that this specification is referred to as the &#8220;Processor Architecture,&#8221; or &#8220;PA,&#8221; Note that this specification is referred to as the &#8220;Processor Architecture,&#8221; or &#8220;PA,&#8221;
in the body of this document.</para> in the body of this document.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -48,5 +52,5 @@
<para><citetitle><xref linkend="dbdoclet.50569387_45524"/></citetitle> and relevant bindings</para> <para><citetitle><xref linkend="dbdoclet.50569387_45524"/></citetitle> and relevant bindings</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>

</section> </section>

68
LoPAR/sec_error_codes.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -147,14 +147,14 @@
<?dbhtml table-width="50%" ?> <?dbhtml table-width="50%" ?>
<?dbfo table-width="50%" ?> <?dbfo table-width="50%" ?>
<tgroup cols="8"> <tgroup cols="8">
<colspec colname="c1" colwidth="12*" /> <colspec colname="c1" colwidth="12*" align="center" />
<colspec colname="c2" colwidth="12*" /> <colspec colname="c2" colwidth="12*" align="center" />
<colspec colname="c3" colwidth="12*" /> <colspec colname="c3" colwidth="12*" align="center" />
<colspec colname="c4" colwidth="12*" /> <colspec colname="c4" colwidth="12*" align="center" />
<colspec colname="c5" colwidth="12*" /> <colspec colname="c5" colwidth="12*" align="center" />
<colspec colname="c6" colwidth="12*" /> <colspec colname="c6" colwidth="12*" align="center" />
<colspec colname="c7" colwidth="12*" /> <colspec colname="c7" colwidth="12*" align="center" />
<colspec colname="c8" colwidth="12*" /> <colspec colname="c8" colwidth="12*" align="center" />
<thead> <thead>
<row> <row>
<entry nameend="c5" namest="c1"> <entry nameend="c5" namest="c1">
@ -169,7 +169,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry nameend="c2" namest="c1"> <entry nameend="c2" namest="c1">
<para> <para>
@ -228,7 +228,7 @@
<?dbhtml table-width="80%" ?> <?dbhtml table-width="80%" ?>
<?dbfo table-width="80%" ?> <?dbfo table-width="80%" ?>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="15*" /> <colspec colname="c1" colwidth="15*" align="center" />
<colspec colname="c2" colwidth="85*" /> <colspec colname="c2" colwidth="85*" />
<thead> <thead>
<row> <row>
@ -237,14 +237,14 @@
<emphasis role="bold">Field</emphasis> <emphasis role="bold">Field</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>S1</para> <para>S1</para>
@ -349,8 +349,8 @@
<?dbhtml table-width="75%" ?> <?dbhtml table-width="75%" ?>
<?dbfo table-width="75%" ?> <?dbfo table-width="75%" ?>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="20*" /> <colspec colname="c1" colwidth="20*" align="center" />
<colspec colname="c2" colwidth="20*" /> <colspec colname="c2" colwidth="20*" align="center" />
<colspec colname="c3" colwidth="60*" /> <colspec colname="c3" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -365,19 +365,19 @@
<emphasis role="bold">PCI Sub-ClassS3-S4</emphasis> <emphasis role="bold">PCI Sub-ClassS3-S4</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="2"> <entry morerows="2">
<para>0</para> <para>0</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Devices that were built before the class code field was <para>Devices that were built before the class code field was
defined</para> defined</para>
</entry> </entry>
@ -403,7 +403,7 @@
<entry morerows="6"> <entry morerows="6">
<para>1</para> <para>1</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Mass storage controller.</para> <para>Mass storage controller.</para>
</entry> </entry>
</row> </row>
@ -461,7 +461,7 @@
<entry morerows="5"> <entry morerows="5">
<para>2</para> <para>2</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Network controller.</para> <para>Network controller.</para>
</entry> </entry>
</row> </row>
@ -509,7 +509,7 @@
<entry morerows="3"> <entry morerows="3">
<para>3</para> <para>3</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Display controller.</para> <para>Display controller.</para>
</entry> </entry>
</row> </row>
@ -541,7 +541,7 @@
<entry morerows="3"> <entry morerows="3">
<para>4</para> <para>4</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Multimedia device</para> <para>Multimedia device</para>
</entry> </entry>
</row> </row>
@ -573,7 +573,7 @@
<entry morerows="3"> <entry morerows="3">
<para>5</para> <para>5</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Memory controller.</para> <para>Memory controller.</para>
</entry> </entry>
</row> </row>
@ -605,7 +605,7 @@
<entry morerows="9"> <entry morerows="9">
<para>6</para> <para>6</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Bridge IOAs.</para> <para>Bridge IOAs.</para>
</entry> </entry>
</row> </row>
@ -685,7 +685,7 @@
<entry morerows="3"> <entry morerows="3">
<para>7</para> <para>7</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Simple communication controllers.</para> <para>Simple communication controllers.</para>
</entry> </entry>
</row> </row>
@ -717,7 +717,7 @@
<entry morerows="5"> <entry morerows="5">
<para>8</para> <para>8</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Generic system peripherals</para> <para>Generic system peripherals</para>
</entry> </entry>
</row> </row>
@ -765,7 +765,7 @@
<entry morerows="4"> <entry morerows="4">
<para>9</para> <para>9</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Input devices</para> <para>Input devices</para>
</entry> </entry>
</row> </row>
@ -805,7 +805,7 @@
<entry morerows="2"> <entry morerows="2">
<para>A</para> <para>A</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Docking stations</para> <para>Docking stations</para>
</entry> </entry>
</row> </row>
@ -829,7 +829,7 @@
<entry morerows="2"> <entry morerows="2">
<para>B</para> <para>B</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Processors</para> <para>Processors</para>
</entry> </entry>
</row> </row>
@ -853,7 +853,7 @@
<entry morerows="2"> <entry morerows="2">
<para>C</para> <para>C</para>
</entry> </entry>
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2" align="center">
<para>Serial bus controllers</para> <para>Serial bus controllers</para>
</entry> </entry>
</row> </row>
@ -883,8 +883,8 @@
<?dbhtml table-width="75%" ?> <?dbhtml table-width="75%" ?>
<?dbfo table-width="75%" ?> <?dbfo table-width="75%" ?>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="20*" /> <colspec colname="c1" colwidth="20*" align="center" />
<colspec colname="c2" colwidth="20*" /> <colspec colname="c2" colwidth="20*" align="center" />
<colspec colname="c3" colwidth="60*" /> <colspec colname="c3" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -898,14 +898,14 @@
<emphasis role="bold">Sub-ClassS3-S4</emphasis> <emphasis role="bold">Sub-ClassS3-S4</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="13"> <entry morerows="13">
<para>0</para> <para>0</para>

4
LoPAR/sec_error_introduction.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -34,7 +34,7 @@
via two RTAS functions, via two RTAS functions,
<emphasis>event-scan</emphasis> and <emphasis>event-scan</emphasis> and
<emphasis>check-exception</emphasis>, which are described further in <emphasis>check-exception</emphasis>, which are described further in
<xref linkend="dbdoclet.50569332_16852"/>. A further RTAS function, <xref linkend="dbdoclet.50569332_16852"/>. A further RTAS function,
<emphasis>rtas-last-error</emphasis>, is also provided to return <emphasis>rtas-last-error</emphasis>, is also provided to return
information about hardware failures detected specifically within an RTAS information about hardware failures detected specifically within an RTAS
call.</para> call.</para>

2
LoPAR/sec_pa_processor_binding_terms.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

2
LoPAR/sec_papr_binding_terms.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

884
LoPAR/sec_rtas_call_defn.xml
View File

File diff suppressed because it is too large Load Diff

23
LoPAR/sec_rtas_configure_kernel_dump.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -40,13 +40,12 @@
<xref linkend="dbdoclet.50569332_24141" />.</para> <xref linkend="dbdoclet.50569332_24141" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_24141"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_24141">
<title>Argument Call Buffer <title><emphasis>ibm,configure-kernel-dump</emphasis> Argument Call Buffer</title>
<emphasis>ibm,configure-kernel-dump</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Parameter Type</para> <para>Parameter Type</para>
@ -54,7 +53,7 @@
<entry> <entry>
<para>Name</para> <para>Name</para>
</entry> </entry>
<entry> <entry align="center">
<para>Values</para> <para>Values</para>
</entry> </entry>
</row> </row>
@ -174,9 +173,9 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_76933"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_76933">
<title>Kernel Assisted Dump Memory Structure</title> <title>Kernel Assisted Dump Memory Structure</title>
<tgroup cols="5"> <tgroup cols="5">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="1*" /> <colspec colname="c2" colwidth="1*" align="center" />
<colspec colname="c3" colwidth="1*" /> <colspec colname="c3" colwidth="1*" align="center" />
<colspec colname="c4" colwidth="2*" /> <colspec colname="c4" colwidth="2*" />
<colspec colname="c5" colwidth="2*" /> <colspec colname="c5" colwidth="2*" />
<thead> <thead>
@ -188,7 +187,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Offset</para> <para>Offset</para>
@ -196,7 +195,7 @@
<entry nameend="c3" namest="c2"> <entry nameend="c3" namest="c2">
<para>Number of Bytes</para> <para>Number of Bytes</para>
</entry> </entry>
<entry nameend="c5" namest="c4"> <entry nameend="c5" namest="c4" align="center">
<para>Value</para> <para>Value</para>
</entry> </entry>
</row> </row>

54
LoPAR/sec_rtas_dma_window.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -227,11 +227,10 @@
<xref linkend="dbdoclet.50569332_53901" />.</para> <xref linkend="dbdoclet.50569332_53901" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_53901"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_53901">
<title>Argument Call Buffer <title><emphasis>ibm,query-pe-dma-window</emphasis> Argument Call Buffer</title>
<emphasis>ibm,query-pe-dma-window</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -245,14 +244,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="5" valign="middle"> <entry morerows="5" valign="middle">
<para>In</para> <para>In</para>
@ -457,11 +456,10 @@
<xref linkend="dbdoclet.50569332_26269" />.</para> <xref linkend="dbdoclet.50569332_26269" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_26269"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_26269">
<title>Argument Call Buffer <title><emphasis>ibm,create-pe-dma-window</emphasis> Argument Call Buffer</title>
<emphasis>ibm,create-pe-dma-window</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -475,14 +473,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="7" valign="middle"> <entry morerows="7" valign="middle">
<para>In</para> <para>In</para>
@ -684,11 +682,10 @@
<xref linkend="dbdoclet.50569332_36074" />.</para> <xref linkend="dbdoclet.50569332_36074" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_36074"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_36074">
<title>Argument Call Buffer <title><emphasis>ibm,remove-pe-dma-window</emphasis> Argument Call Buffer</title>
<emphasis>ibm,remove-pe-dma-window</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -702,14 +699,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="3" valign="middle"> <entry morerows="3" valign="middle">
<para>In</para> <para>In</para>
@ -853,9 +850,9 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_25585"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_25585">
<title>DDW Option Extensions</title> <title>DDW Option Extensions</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="15*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="30*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="55*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -877,7 +874,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>2.7</para> <para>2.7</para>
@ -954,11 +951,10 @@
<xref linkend="dbdoclet.50569332_68052" />.</para> <xref linkend="dbdoclet.50569332_68052" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_68052"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_68052">
<title>Argument Call Buffer <title><emphasis>ibm,reset-pe-dma-windows</emphasis> Argument Call Buffer</title>
<emphasis>ibm,reset-pe-dma-windows</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -972,14 +968,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="5" valign="middle"> <entry morerows="5" valign="middle">
<para>In</para> <para>In</para>

124
LoPAR/sec_rtas_env_epow.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
@ -13,16 +13,16 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.

--> -->
<section xmlns="http://docbook.org/ns/docbook" <section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" version="5.0"
xml:id="dbdoclet.50569337_17513"> xml:id="dbdoclet.50569337_17513">

<title>Environmental and Power Warnings</title> <title>Environmental and Power Warnings</title>

<para>Environmental and Power Warnings (EPOW) is an option that provides <para>Environmental and Power Warnings (EPOW) is an option that provides
a means for the platform to inform the OS of these types of events. The a means for the platform to inform the OS of these types of events. The
intent is to enable the OS to provide basic information to the user about intent is to enable the OS to provide basic information to the user about
@ -32,86 +32,86 @@
the loss of power. Even on platforms that provide hardware protection of the loss of power. Even on platforms that provide hardware protection of
data during environmental events, EPOW notification allows discrimination data during environmental events, EPOW notification allows discrimination
between I/O errors caused by hardware failures versus EPOW events.</para> between I/O errors caused by hardware failures versus EPOW events.</para>

<para>These warnings include action codes that the platform can use to <para>These warnings include action codes that the platform can use to
influence the OS behavior when various hardware components fail. For influence the OS behavior when various hardware components fail. For
example, a fan failure where the system can continue to operate in the example, a fan failure where the system can continue to operate in the
safe cooling range may just generate an action code of WARN_COOLING, but safe cooling range may just generate an action code of WARN_COOLING, but
a fan failure where the system cannot operate in the safe cooling range a fan failure where the system cannot operate in the safe cooling range
may generate an action code of SYSTEM_HALT.</para> may generate an action code of SYSTEM_HALT.</para>

<para><emphasis role="bold">Implementation Note:</emphasis> Hardware cannot assume that the OS will <para><emphasis role="bold">Implementation Note:</emphasis> Hardware cannot assume that the OS will
process or take action on these warnings. These warnings are only process or take action on these warnings. These warnings are only
provided to the OS in order to allow the OS a chance to cleanly abort provided to the OS in order to allow the OS a chance to cleanly abort
operations in progress at the time of the warning. Hardware still assumes operations in progress at the time of the warning. Hardware still assumes
responsibility for preventing hardware damage due to environmental or responsibility for preventing hardware damage due to environmental or
power problems.</para> power problems.</para>

<para>An OS that wants to be EPOW-aware will look for the <para>An OS that wants to be EPOW-aware will look for the
<emphasis>epow-events</emphasis> node in the OF device tree, enable the <emphasis>epow-events</emphasis> node in the OF device tree, enable the
interrupts listed in its interrupts listed in its
<literal>&#8220;interrupts&#8221;</literal> property, and provide an <literal>&#8220;interrupts&#8221;</literal> property, and provide an
interrupt handler to call interrupt handler to call
<emphasis>check-exception</emphasis> when one of those interrupts are <emphasis>check-exception</emphasis> when one of those interrupts are
received.</para> received.</para>

<para>When an EPOW event occurs, whether reported by <para>When an EPOW event occurs, whether reported by
<emphasis>check-exception</emphasis> or <emphasis>check-exception</emphasis> or
<emphasis>event-scan</emphasis>, RTAS will directly pass back the EPOW <emphasis>event-scan</emphasis>, RTAS will directly pass back the EPOW
sensor value as part of the Extended Error Log format as described in sensor value as part of the Extended Error Log format as described in
<xref linkend="dbdoclet.50569337_39498"/>, assuming the extended log is <xref linkend="dbdoclet.50569337_39498"/>, assuming the extended log is
requested. Doing so avoids the need for the OS to make an extra RTAS call requested. Doing so avoids the need for the OS to make an extra RTAS call
to obtain the sensor value. For critical power problems, the to obtain the sensor value. For critical power problems, the
<emphasis>check-exception</emphasis> function is used to immediately <emphasis>check-exception</emphasis> function is used to immediately
report changes of state to the OS, while the report changes of state to the OS, while the
<emphasis>get-sensor-state</emphasis> function allows the OS to monitor <emphasis>get-sensor-state</emphasis> function allows the OS to monitor
the condition (for example, loss of AC power) to see if the problem the condition (for example, loss of AC power) to see if the problem
corrects itself.</para> corrects itself.</para>

<variablelist> <variablelist>

<varlistentry> <varlistentry>
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513" <term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513"
xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term>
<listitem> <listitem>
<para> If the platform supports Environmental and <para> If the platform supports Environmental and
Power Warnings by including a EPOW device tree entry, then the platform Power Warnings by including a EPOW device tree entry, then the platform
must support the EPOW sensor for the must support the EPOW sensor for the
<emphasis>get-sensor-state</emphasis> RTAS function.</para> <emphasis>get-sensor-state</emphasis> RTAS function.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry> <varlistentry>
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513" <term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513"
xrefstyle="select: labelnumber nopage"/>-2.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-2.</emphasis></term>
<listitem> <listitem>
<para> The EPOW sensor, if provided, must contain <para> The EPOW sensor, if provided, must contain
the EPOW action code (defined in the EPOW action code (defined in
<xref linkend="dbdoclet.50569337_45557"/>) in the least significant 4 <xref linkend="dbdoclet.50569337_45557"/>) in the least significant 4
bits. In cases where multiple EPOW actions are required, the action code bits. In cases where multiple EPOW actions are required, the action code
with the highest numerical value (where 0 is lowest and 7 is highest) with the highest numerical value (where 0 is lowest and 7 is highest)
must be presented to the OS. The platform may implement any subset of must be presented to the OS. The platform may implement any subset of
these action codes, but must operate as described in these action codes, but must operate as described in
<xref linkend="dbdoclet.50569337_45557"/> for those it does implement.</para> <xref linkend="dbdoclet.50569337_45557"/> for those it does implement.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry> <varlistentry>
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513" <term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513"
xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term>
<listitem> <listitem>
<para>To ensure adequate response time, <para>To ensure adequate response time,
platforms which implement the EPOW_MAIN_ENCLOSURE or EPOW_POWER_OFF platforms which implement the EPOW_MAIN_ENCLOSURE or EPOW_POWER_OFF
action codes must do so via interrupt and action codes must do so via interrupt and
<emphasis>check-exception</emphasis> notification, rather than by <emphasis>check-exception</emphasis> notification, rather than by
<emphasis>event-scan</emphasis> notification. <emphasis>event-scan</emphasis> notification.
<emphasis>(Except as modified by Requirement <emphasis>(Except as modified by Requirement
<xref linkend="dbdoclet.50569337_83439"/>)</emphasis></para> <xref linkend="dbdoclet.50569337_83439"/>)</emphasis></para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry xml:id="dbdoclet.50569337_83439"> <varlistentry xml:id="dbdoclet.50569337_83439">
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513" <term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513"
xrefstyle="select: labelnumber nopage"/>-4.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-4.</emphasis></term>
<listitem> <listitem>
<para>If the platform <para>If the platform
@ -120,54 +120,54 @@
to the EPOW event.</para> to the EPOW event.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry> <varlistentry>
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513" <term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513"
xrefstyle="select: labelnumber nopage"/>-5.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-5.</emphasis></term>
<listitem> <listitem>
<para>For interrupt-driven EPOW events, the <para>For interrupt-driven EPOW events, the
platform must ensure that an EPOW interrupt is not lost in the case where platform must ensure that an EPOW interrupt is not lost in the case where
a numerically higher-priority EPOW event occurs between the time when a numerically higher-priority EPOW event occurs between the time when
<emphasis>check-exception</emphasis> gathers the sensor value and when it <emphasis>check-exception</emphasis> gathers the sensor value and when it
resets the interrupt.</para> resets the interrupt.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry> <varlistentry>
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513" <term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569337_17513"
xrefstyle="select: labelnumber nopage"/>-6.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-6.</emphasis></term>
<listitem> <listitem>
<para>For SYSTEM_SHUTDOWN EPOW class 3, after a <para>For SYSTEM_SHUTDOWN EPOW class 3, after a
SYSTEM_SHUTDOWN EPOW commences and when the delay interval timer expires, SYSTEM_SHUTDOWN EPOW commences and when the delay interval timer expires,
if an if an
<emphasis role="bold"><literal>&#8220;ibm,recoverable-epow3&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,recoverable-epow3&#8221;</literal></emphasis>
encode-null encode-null
property in the property in the
<emphasis role="bold"><literal>/rtas</literal></emphasis> node is present, then the OS code that manages <emphasis role="bold"><literal>/rtas</literal></emphasis> node is present, then the OS code that manages
preserving storage must check the EPOW sensor state and the preserving storage must check the EPOW sensor state and the
<emphasis role="bold"><literal>&#8220;ibm,request-partition-shutdown&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,request-partition-shutdown&#8221;</literal></emphasis>
property if present. A normal boot must only occur when the EPOW sensor state property if present. A normal boot must only occur when the EPOW sensor state
indicates that the EPOW condition requiring a shutdown no longer exists indicates that the EPOW condition requiring a shutdown no longer exists
(EPOW 0) and the (EPOW 0) and the
<emphasis role="bold"><literal>&#8220;ibm,request-partition-shutdown&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,request-partition-shutdown&#8221;</literal></emphasis>
is not present. Otherwise, the code that manages preserving storage must take is not present. Otherwise, the code that manages preserving storage must take
the action as identified by the property.</para> the action as identified by the property.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

</variablelist> </variablelist>

<para><emphasis role="bold">Implementation Note:</emphasis> One way for hardware to prevent the loss of an <para><emphasis role="bold">Implementation Note:</emphasis> One way for hardware to prevent the loss of an
EPOW interrupt is by deferring the generation of a new EPOW interrupt EPOW interrupt is by deferring the generation of a new EPOW interrupt
until the existing EPOW interrupt is reset by a call to the RTAS until the existing EPOW interrupt is reset by a call to the RTAS
<emphasis>check-exception</emphasis> function. Another way is to ignore <emphasis>check-exception</emphasis> function. Another way is to ignore
resets to the interrupt until all EPOW events have been reported.</para> resets to the interrupt until all EPOW events have been reported.</para>

<table frame="all" pgwide="1" xml:id="dbdoclet.50569337_45557"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569337_45557">
<title>EPOW Action Codes</title> <title>EPOW Action Codes</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="30*" /> <colspec colname="c1" colwidth="30*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="60*" /> <colspec colname="c3" colwidth="60*" />
<thead> <thead>
<row> <row>
@ -181,14 +181,14 @@
<emphasis role="bold">Value</emphasis> <emphasis role="bold">Value</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description</emphasis> <emphasis role="bold">Description</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>EPOW_RESET/MESSAGE</para> <para>EPOW_RESET/MESSAGE</para>
@ -289,32 +289,32 @@
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>

<para><emphasis role="bold">Software Implementation Note:</emphasis> A recommended OS processing method <para><emphasis role="bold">Software Implementation Note:</emphasis> A recommended OS processing method
for an EPOW_MAIN_ENCLOSURE event is as follows:</para> for an EPOW_MAIN_ENCLOSURE event is as follows:</para>

<itemizedlist> <itemizedlist>
<listitem> <listitem>

<para>Prepare for shutdown, mask the EPOW interrupt, and wait for 50 <para>Prepare for shutdown, mask the EPOW interrupt, and wait for 50
milliseconds. Then call get-sensor-state to read the EPOW sensor.</para> milliseconds. Then call get-sensor-state to read the EPOW sensor.</para>


</listitem> </listitem>
<listitem> <listitem>

<para>If the EPOW action code is unchanged, wait an additional 50 <para>If the EPOW action code is unchanged, wait an additional 50
milliseconds.</para> milliseconds.</para>


</listitem> </listitem>
<listitem> <listitem>

<para>If the action code is EPOW_POWER_OFF, attempt to power off. <para>If the action code is EPOW_POWER_OFF, attempt to power off.
Otherwise, the power condition may have stabilized, so interrupts may be Otherwise, the power condition may have stabilized, so interrupts may be
enabled and normal operation resumed.</para> enabled and normal operation resumed.</para>


</listitem> </listitem>
</itemizedlist> </itemizedlist>

<para> <para>
<emphasis role="bold">Implementation Note:</emphasis> EPOW_RESET (EPOW action code 0) <emphasis role="bold">Implementation Note:</emphasis> EPOW_RESET (EPOW action code 0)
may be used to indicate that a previously reported EPOW condition is no may be used to indicate that a previously reported EPOW condition is no
@ -324,7 +324,7 @@
error log that specified the type of WARN_POWER EPOW generated would be error log that specified the type of WARN_POWER EPOW generated would be
set in the EPOW_RESET error log to indicate the specific EPOW event that set in the EPOW_RESET error log to indicate the specific EPOW event that
was reset.</para> was reset.</para>

<para>Systems that do not support an EPOW interrupt would generally be <para>Systems that do not support an EPOW interrupt would generally be
unable to support the EPOW action codes 5 and 7. In those cases, there unable to support the EPOW action codes 5 and 7. In those cases, there
could not be an EPOW event to indicate a loss of power. However, after could not be an EPOW event to indicate a loss of power. However, after
@ -332,5 +332,5 @@
the system had lost power previously and the power had been restored. The the system had lost power previously and the power had been restored. The
EPOW_RESET should only be used in this way if the system is unable to EPOW_RESET should only be used in this way if the system is unable to
generate an EPOW class 5 or class 7.</para> generate an EPOW class 5 or class 7.</para>

</section> </section>

410
LoPAR/sec_rtas_environment.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -308,9 +308,9 @@
<title>Use of <title>Use of
<emphasis role="bold"><literal>&#8220;used-by-rtas&#8221;</literal></emphasis></title> <emphasis role="bold"><literal>&#8220;used-by-rtas&#8221;</literal></emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="33*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="33*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="33*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -330,7 +330,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Only used by OS</para> <para>Only used by OS</para>
@ -663,8 +663,8 @@
<emphasis role="bold"><literal>instantiate-rtas-64</literal></emphasis> <emphasis role="bold"><literal>instantiate-rtas-64</literal></emphasis>
Argument Call Buffer</title> Argument Call Buffer</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -673,7 +673,7 @@
<emphasis role="bold">Parameter Type</emphasis> <emphasis role="bold">Parameter Type</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
@ -685,7 +685,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>In</para> <para>In</para>
@ -774,8 +774,8 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_20008"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_20008">
<title>RTAS Tokens for Functions</title> <title>RTAS Tokens for Functions</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="33*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="33*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="33*" />
<thead> <thead>
<row> <row>
@ -789,21 +789,19 @@
<emphasis role="bold">Required?</emphasis> <emphasis role="bold">Required?</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center" >
<para> <para>
<emphasis role="bold">Notes</emphasis> <emphasis role="bold">Notes</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;nvram-fetch&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;nvram-fetch&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_96529" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_96529" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -816,10 +814,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;nvram-store&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;nvram-store&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_57392" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_57392" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -832,10 +828,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;get-time-of-day&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;get-time-of-day&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_88127" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_88127" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -848,10 +842,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;set-time-of-day&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;set-time-of-day&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_35194" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_35194" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -864,10 +856,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;set-time-for-power-on&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;set-time-for-power-on&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_13743" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_13743" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -880,10 +870,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;event-scan&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;event-scan&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_24845" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_24845" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -896,10 +884,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;check-exception&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;check-exception&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_71287" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_71287" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -912,10 +898,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;rtas-last-error&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;rtas-last-error&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_71223" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_71223" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -928,10 +912,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,platform-dump&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,platform-dump&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_98203" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_98203" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -944,10 +926,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,read-pci-config&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,read-pci-config&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_59536" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_59536" />
</para> </para>
</entry> </entry>
<entry morerows="1"> <entry morerows="1">
@ -960,20 +940,16 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,write-pci-config&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,write-pci-config&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_54555" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_54555" />
</para> </para>
</entry> </entry>
</row> </row>
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;display-character&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;display-character&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_10053" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_10053" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -986,10 +962,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;set-indicator&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;set-indicator&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_32164" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_32164" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1003,10 +977,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;get-sensor-state&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;get-sensor-state&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_10754" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_10754" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1019,10 +991,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,set-system-parameter&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,set-system-parameter&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_31665" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_31665" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1035,10 +1005,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,get-system-parameter&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,get-system-parameter&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_62190" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_62190" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1051,10 +1019,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;set-power-level&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;set-power-level&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_45884" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_45884" />
</para> </para>
</entry> </entry>
<entry morerows="1"> <entry morerows="1">
@ -1068,10 +1034,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;get-power-level&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;get-power-level&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_67298" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_67298" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1081,10 +1045,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;power-off&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;power-off&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_79728" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_79728" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1098,10 +1060,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,power-off-ups&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,power-off-ups&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_50770" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_50770" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1115,10 +1075,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;system-reboot&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;system-reboot&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_50284" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_50284" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1131,10 +1089,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,update-flash-64-and-reboot&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,update-flash-64-and-reboot&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_77103" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_77103" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1147,10 +1103,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,manage-flash-image&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,manage-flash-image&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_81833" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_81833" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1163,10 +1117,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,validate-flash-image&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,validate-flash-image&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_40640" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_40640" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1179,10 +1131,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,activate-firmware&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,activate-firmware&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_28163" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_28163" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1195,10 +1145,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;stop-self&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;stop-self&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_68497" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_68497" />
</para> </para>
</entry> </entry>
<entry morerows="2"> <entry morerows="2">
@ -1211,10 +1159,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;start-cpu&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;start-cpu&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_39014" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_39014" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1224,10 +1170,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;query-cpu-stopped-state&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;query-cpu-stopped-state&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_81575" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_81575" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1237,10 +1181,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,os-term&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,os-term&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_42118" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_42118" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1253,10 +1195,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,exti2c&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,exti2c&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_19739" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_19739" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1269,10 +1209,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,get-xive&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,get-xive&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_48295" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_48295" />
</para> </para>
</entry> </entry>
<entry morerows="3"> <entry morerows="3">
@ -1285,10 +1223,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,set-xive&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,set-xive&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_13631" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_13631" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1298,10 +1234,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,int-off&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,int-off&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_95487" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_95487" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1311,10 +1245,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,int-on&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,int-on&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_61000" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_61000" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1324,10 +1256,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,configure-connector&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,configure-connector&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569342_39636" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569342_39636" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1341,10 +1271,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,set-eeh-option&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,set-eeh-option&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_27269" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_27269" />
</para> </para>
</entry> </entry>
<entry morerows="1"> <entry morerows="1">
@ -1357,10 +1285,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,set-slot-reset&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,set-slot-reset&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_86249" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_86249" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1387,10 +1313,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,read-slot-reset-state2&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,read-slot-reset-state2&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_87326" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_87326" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1403,10 +1327,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,get-config-addr-info2&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,get-config-addr-info2&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_68098" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_68098" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1419,10 +1341,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,slot-error-detail&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,slot-error-detail&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_43482" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_43482" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1435,10 +1355,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,open-errinjct&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,open-errinjct&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_22302" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_22302" />
</para> </para>
</entry> </entry>
<entry morerows="2"> <entry morerows="2">
@ -1451,10 +1369,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,errinjct&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,errinjct&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_22302" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_22302" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1464,10 +1380,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,close-errinjct&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,close-errinjct&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_22302" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_22302" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1477,10 +1391,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,nmi-register&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,nmi-register&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_12478" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_12478" />
</para> </para>
</entry> </entry>
<entry morerows="1"> <entry morerows="1">
@ -1493,10 +1405,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,nmi-interlock&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,nmi-interlock&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_12478" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_12478" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1506,10 +1416,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,configure-bridge&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,configure-bridge&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_65423" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_65423" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1522,10 +1430,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,configure-pe&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,configure-pe&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_45262" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_45262" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1538,10 +1444,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,get-indices&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,get-indices&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="sec_get_indices_rtas_call" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="sec_get_indices_rtas_call" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1555,10 +1459,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,get-vpd&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,get-vpd&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_72964" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_72964" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1571,10 +1473,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,manage-storage-preservation&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,manage-storage-preservation&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_28221" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_28221" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1587,10 +1487,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,get-dynamic-sensor-state&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,get-dynamic-sensor-state&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_61055" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_61055" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1604,10 +1502,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,set-dynamic-indicator&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,set-dynamic-indicator&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_30542" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_30542" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1621,10 +1517,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,change-msi&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,change-msi&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_16274" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_16274" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1638,10 +1532,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,suspend-me&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,suspend-me&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_45918" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_45918" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1654,10 +1546,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,update-nodes&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,update-nodes&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_84414" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_84414" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1670,10 +1560,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,update-properties&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,update-properties&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_40069" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_40069" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1686,10 +1574,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,configure-kernel-dump&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,configure-kernel-dump&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_67111" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_67111" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1703,10 +1589,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,query-pe-dma-window&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,query-pe-dma-window&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_99826" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_99826" />
</para> </para>
</entry> </entry>
<entry morerows="2"> <entry morerows="2">
@ -1719,10 +1603,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,create-pe-dma-window&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,create-pe-dma-window&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_49009" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_49009" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1732,10 +1614,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,remove-pe-dma-window&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,remove-pe-dma-window&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_60545" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_60545" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1745,10 +1625,8 @@
<row> <row>
<entry> <entry>
<para> <para>
<emphasis role="bold"><literal>&#8220;ibm,reset-pe-dma-windows&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,reset-pe-dma-windows&#8221;</literal></emphasis><?linebreak?>
</para> <xref linkend="dbdoclet.50569332_60545" xrefstyle="select: labelnumber pagenumber" />
<para>
<xref linkend="dbdoclet.50569332_60545" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1787,7 +1665,7 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_38140"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_38140">
<title>OF Device Tree Properties</title> <title>OF Device Tree Properties</title>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="50*" /> <colspec colname="c1" colwidth="50*" align="center" />
<colspec colname="c2" colwidth="50*" /> <colspec colname="c2" colwidth="50*" />
<thead> <thead>
<row> <row>
@ -1796,14 +1674,14 @@
<emphasis role="bold">name</emphasis> <emphasis role="bold">name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">value</emphasis> <emphasis role="bold">value</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para> <para>
@ -2189,7 +2067,7 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_22280"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_22280">
<title>RTAS Argument Call Buffer</title> <title>RTAS Argument Call Buffer</title>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="50*" /> <colspec colname="c1" colwidth="50*" align="center" />
<colspec colname="c2" colwidth="50*" /> <colspec colname="c2" colwidth="50*" />
<thead> <thead>
<row> <row>
@ -2198,14 +2076,14 @@
<emphasis role="bold">Cell Number</emphasis> <emphasis role="bold">Cell Number</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center" >
<para> <para>
<emphasis role="bold">Use</emphasis> <emphasis role="bold">Use</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>1</para> <para>1</para>
@ -2407,7 +2285,7 @@
<title>RTAS <title>RTAS
<emphasis>Status</emphasis> Word Values</title> <emphasis>Status</emphasis> Word Values</title>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="50*" /> <colspec colname="c1" colwidth="50*" align="center" />
<colspec colname="c2" colwidth="50*" /> <colspec colname="c2" colwidth="50*" />
<thead> <thead>
<row> <row>
@ -2416,7 +2294,7 @@
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold"> <emphasis role="bold">
<emphasis>Status</emphasis> Word Meanings</emphasis> <emphasis>Status</emphasis> Word Meanings</emphasis>
@ -2424,7 +2302,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>

10
LoPAR/sec_rtas_error_classes.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -49,9 +49,9 @@
<?dbhtml table-width="75%" ?> <?dbhtml table-width="75%" ?>
<?dbfo table-width="75%" ?> <?dbfo table-width="75%" ?>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="40*" /> <colspec colname="c1" colwidth="40*" align="center" />
<colspec colname="c2" colwidth="40*" /> <colspec colname="c2" colwidth="40*" align="center" />
<colspec colname="c3" colwidth="20*" /> <colspec colname="c3" colwidth="20*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -74,7 +74,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Internal Errors</para> <para>Internal Errors</para>

112
LoPAR/sec_rtas_error_indications.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
@ -13,21 +13,21 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.

--> -->
<section xmlns="http://docbook.org/ns/docbook" <section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" version="5.0"
xml:id="Internal_Error_Indications"> xml:id="Internal_Error_Indications">

<title>Internal Error Indications</title> <title>Internal Error Indications</title>

<para>Hardware may detect a variety of problems during operation, ranging <para>Hardware may detect a variety of problems during operation, ranging
from soft errors which have already been corrected by the time they are from soft errors which have already been corrected by the time they are
reported, to hard errors of such severity that the OS (and perhaps the reported, to hard errors of such severity that the OS (and perhaps the
hardware) cannot meaningfully continue operation. The mechanisms hardware) cannot meaningfully continue operation. The mechanisms
described in described in
<xref linkend="dbdoclet.50569337_66258"/> are used to report such errors to the <xref linkend="dbdoclet.50569337_66258"/> are used to report such errors to the
OS. This section describes the architectural sources of errors, and OS. This section describes the architectural sources of errors, and
describes a method that platforms can use to report the error. All OSs describes a method that platforms can use to report the error. All OSs
@ -36,7 +36,7 @@
may be introduced via RTAS, and the OS may not have to handle the error may be introduced via RTAS, and the OS may not have to handle the error
directly. More robust error detection, reporting, and correcting are at directly. More robust error detection, reporting, and correcting are at
the option of the hardware vendor.</para> the option of the hardware vendor.</para>

<para> <para>
<anchor xml:id="dbdoclet.50569337_marker-13885" xreflabel="" /> <anchor xml:id="dbdoclet.50569337_marker-13885" xreflabel="" />
<anchor xml:id="dbdoclet.50569337_marker-13886" xreflabel="" />The <anchor xml:id="dbdoclet.50569337_marker-13886" xreflabel="" />The
@ -51,12 +51,12 @@
handle such cases, a special hardware mechanism may be provided to gather handle such cases, a special hardware mechanism may be provided to gather
and store residual error data, to be analyzed when the system goes and store residual error data, to be analyzed when the system goes
through a subsequent successful reboot.</para> through a subsequent successful reboot.</para>

<para>Less critical internal errors may also be signaled to the OS <para>Less critical internal errors may also be signaled to the OS
through a platform-specific interrupt in the &#8220;Internal through a platform-specific interrupt in the &#8220;Internal
Errors&#8221; class, or by periodic polling with the Errors&#8221; class, or by periodic polling with the
<emphasis>event-scan</emphasis> RTAS function.</para> <emphasis>event-scan</emphasis> RTAS function.</para>

<para><emphasis role="bold">Architecture Note:</emphasis> The machine check interrupt will not be listed <para><emphasis role="bold">Architecture Note:</emphasis> The machine check interrupt will not be listed
in the OF node for the &#8220;Internal Errors&#8221; class, since it is a in the OF node for the &#8220;Internal Errors&#8221; class, since it is a
standard architectural mechanism. The machine check interrupt mechanism standard architectural mechanism. The machine check interrupt mechanism
@ -69,55 +69,55 @@
connection to the processor machine check interrupt pin, or via a system connection to the processor machine check interrupt pin, or via a system
bus error indicator (for example, Transfer Error Acknowledge - bus error indicator (for example, Transfer Error Acknowledge -
TEA).</para> TEA).</para>

<variablelist> <variablelist>

<varlistentry xml:id="dbdoclet.50569337_38528"> <varlistentry xml:id="dbdoclet.50569337_38528">
<term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications" <term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications"
xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term>
<listitem> <listitem>
<para>OSs must set <para>OSs must set
MSRME=1 prior to the occurrence of a machine check interrupt in order to MSRME=1 prior to the occurrence of a machine check interrupt in order to
enable machine check processing via the enable machine check processing via the
<emphasis>check-exception</emphasis> RTAS function.</para> <emphasis>check-exception</emphasis> RTAS function.</para>

<para> <para>
<emphasis role="bold">Architecture Note:</emphasis> Requirement <emphasis role="bold">Architecture Note:</emphasis> Requirement
<xref linkend="dbdoclet.50569337_38528"/> is not applicable when the FWNMI <xref linkend="dbdoclet.50569337_38528"/> is not applicable when the FWNMI
option is used.</para> option is used.</para>

</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry xml:id="dbdoclet.50569337_36603"> <varlistentry xml:id="dbdoclet.50569337_36603">
<term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications" <term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications"
xrefstyle="select: labelnumber nopage"/>-2.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-2.</emphasis></term>
<listitem> <listitem>
<para>For <para>For
hardware-detected errors, platforms must generate error indications as hardware-detected errors, platforms must generate error indications as
described in described in
<xref linkend="dbdoclet.50569337_30773"/>, unless the error can be handled <xref linkend="dbdoclet.50569337_30773"/>, unless the error can be handled
through a less severe platform-specific interrupt, or the nature of the through a less severe platform-specific interrupt, or the nature of the
error forces a checkstop condition.</para> error forces a checkstop condition.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry> <varlistentry>
<term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications" <term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications"
xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term>
<listitem> <listitem>
<para>Platforms which detect and report the <para>Platforms which detect and report the
errors described in errors described in
<xref linkend="dbdoclet.50569337_30773"/> must provide information to the OS <xref linkend="dbdoclet.50569337_30773"/> must provide information to the OS
via the RTAS via the RTAS
<emphasis>check-exception</emphasis> function, using the reporting format <emphasis>check-exception</emphasis> function, using the reporting format
described in described in
<xref linkend="dbdoclet.50569337_21249"/>.</para> <xref linkend="dbdoclet.50569337_21249"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry xml:id="dbdoclet.50569337_16228"> <varlistentry xml:id="dbdoclet.50569337_16228">
<term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications" <term><emphasis role="bold">R1-<xref linkend="Internal_Error_Indications"
xrefstyle="select: labelnumber nopage"/>-4.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-4.</emphasis></term>
<listitem> <listitem>
<para>To prevent error <para>To prevent error
@ -126,7 +126,7 @@
interrupt signaled via the external machine check interrupt pin.</para> interrupt signaled via the external machine check interrupt pin.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

</variablelist> </variablelist>


<para> <para>
@ -135,8 +135,8 @@


<orderedlist> <orderedlist>
<listitem> <listitem>

<para>The intent of Requirement <para>The intent of Requirement
<xref linkend="dbdoclet.50569337_36603"/> is to define standard error <xref linkend="dbdoclet.50569337_36603"/> is to define standard error
notification mechanisms for different hardware error types. For most notification mechanisms for different hardware error types. For most
hardware errors, the signaling mechanism is the machine check interrupt, hardware errors, the signaling mechanism is the machine check interrupt,
@ -156,15 +156,15 @@
summarize, platforms should not use platform-specific interrupts to summarize, platforms should not use platform-specific interrupts to
signal hardware errors unless there is a complete hardware/RTAS platform signal hardware errors unless there is a complete hardware/RTAS platform
solution for handling such errors.</para> solution for handling such errors.</para>

</listitem> </listitem>
<listitem> <listitem>


<para>The intent of Requirement <para>The intent of Requirement
<xref linkend="dbdoclet.50569337_16228"/> is that most hardware errors would be <xref linkend="dbdoclet.50569337_16228"/> is that most hardware errors would be
signaled simultaneously to all processors, so that processors could signaled simultaneously to all processors, so that processors could
synchronize the error handling process; that is, one processor would be synchronize the error handling process; that is, one processor would be
chosen to do the call to chosen to do the call to
<emphasis>check-exception</emphasis>, while the other processors remained <emphasis>check-exception</emphasis>, while the other processors remained
idle so that they would not interfere with RTAS while it gathered machine idle so that they would not interfere with RTAS while it gathered machine
check error data. While this is a straightforward wiring solution for check error data. While this is a straightforward wiring solution for
@ -178,13 +178,13 @@
such propagation should be avoided, and such errors should be signaled such propagation should be avoided, and such errors should be signaled
through the machine check interrupt pin to ensure proper error through the machine check interrupt pin to ensure proper error
handling.</para> handling.</para>

</listitem> </listitem>
</orderedlist> </orderedlist>

<section xml:id="dbdoclet.50569337_52952"> <section xml:id="dbdoclet.50569337_52952">
<title>Error Indication Mechanisms</title> <title>Error Indication Mechanisms</title>

<para> <para>
<xref linkend="dbdoclet.50569337_30773"/> describes the mechanisms by <xref linkend="dbdoclet.50569337_30773"/> describes the mechanisms by
which software will be notified of the occurrence of operational failures which software will be notified of the occurrence of operational failures
@ -198,12 +198,12 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569337_30773"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569337_30773">
<title>Error Indications for System Operations</title> <title>Error Indications for System Operations</title>
<tgroup cols="6"> <tgroup cols="6">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="20*" /> <colspec colname="c3" colwidth="20*" align="center" />
<colspec colname="c4" colwidth="20*" /> <colspec colname="c4" colwidth="20*" align="center" />
<colspec colname="c5" colwidth="20*" /> <colspec colname="c5" colwidth="20*" align="center" />
<colspec colname="c6" colwidth="20*" /> <colspec colname="c6" colwidth="20*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -238,7 +238,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Processor</para> <para>Processor</para>
@ -451,7 +451,7 @@
</entry> </entry>
<entry> <entry>
<para>Firmware receives a machine check, OS receives <para>Firmware receives a machine check, OS receives
all=1&#8217;s data along with a all=1&#8217;s data along with a
<emphasis>Status</emphasis> of -1 from the RTAS call</para> <emphasis>Status</emphasis> of -1 from the RTAS call</para>
</entry> </entry>
<entry> <entry>
@ -466,7 +466,7 @@
</entry> </entry>
<entry> <entry>
<para>All-1&#8217;s data returned, along with a <para>All-1&#8217;s data returned, along with a
&#8220;Success&#8221; &#8220;Success&#8221;
<emphasis>Status</emphasis> from the RTAS call</para> <emphasis>Status</emphasis> from the RTAS call</para>
</entry> </entry>
<entry> <entry>
@ -482,7 +482,7 @@
<para>Various, except no response from IOA</para> <para>Various, except no response from IOA</para>
</entry> </entry>
<entry> <entry>
<para>Firmware receives a machine check, OS receives a <para>Firmware receives a machine check, OS receives a
<emphasis>Status</emphasis> of -1 from the RTAS call</para> <emphasis>Status</emphasis> of -1 from the RTAS call</para>
</entry> </entry>
<entry> <entry>
@ -496,7 +496,7 @@
<para>No response from an IOA</para> <para>No response from an IOA</para>
</entry> </entry>
<entry> <entry>
<para>Operation ignored, OS receives a &#8220;Success&#8221; <para>Operation ignored, OS receives a &#8220;Success&#8221;
<emphasis>Status</emphasis> from the RTAS call</para> <emphasis>Status</emphasis> from the RTAS call</para>
</entry> </entry>
<entry> <entry>
@ -603,21 +603,21 @@
</entry> </entry>
<entry> <entry>
<para>Various, including but not limited to:</para> <para>Various, including but not limited to:</para>

<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Invalid addr accepted by a bridge</para> <para>Invalid addr accepted by a bridge</para>
</listitem> </listitem>

<listitem> <listitem>
<para>TCE extent</para> <para>TCE extent</para>
</listitem> </listitem>

<listitem> <listitem>
<para>TCE Page Mapping and Control mis-match or invalid <para>TCE Page Mapping and Control mis-match or invalid
TCE</para> TCE</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>


</entry> </entry>
<entry> <entry>
@ -696,7 +696,7 @@
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>

<para><emphasis role="bold">Implementation Note:</emphasis> IOAs should, whenever possible, detect the <para><emphasis role="bold">Implementation Note:</emphasis> IOAs should, whenever possible, detect the
occurrence of PCI errors on DMA and report them via an external interrupt occurrence of PCI errors on DMA and report them via an external interrupt
(for possible device driver recovery) or retry the operation. Since (for possible device driver recovery) or retry the operation. Since
@ -705,7 +705,7 @@
cause a catastrophic error. Systems which wish to recover from these cause a catastrophic error. Systems which wish to recover from these
types of errors should choose devices and device drivers which are types of errors should choose devices and device drivers which are
designed to handle them correctly.</para> designed to handle them correctly.</para>

</section> </section>


</section> </section>

2
LoPAR/sec_rtas_error_reporting.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

16
LoPAR/sec_rtas_error_reporting_introduction.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation

Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
@ -13,16 +13,16 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.

--> -->
<section xmlns="http://docbook.org/ns/docbook" <section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" version="5.0"
xml:id="sec_rtas_error_reporting_intro"> xml:id="sec_rtas_error_reporting_intro">


<title>Introduction</title> <title>Introduction</title>

<para>This section describes the data formats used to report events and <para>This section describes the data formats used to report events and
errors from RTAS to the OS. A common format is used for errors and events errors from RTAS to the OS. A common format is used for errors and events
to simplify software both in RTAS and in the OS. Both errors and events to simplify software both in RTAS and in the OS. Both errors and events
@ -36,5 +36,5 @@
mapping exists, and platform features may not be fully supported by the mapping exists, and platform features may not be fully supported by the
OS. In such cases, error reports may also be non-specific, leaving OS. In such cases, error reports may also be non-specific, leaving
platform-specific details to platform-aware software.</para> platform-specific details to platform-aware software.</para>

</section> </section>

2
LoPAR/sec_rtas_error_reporting_location_codes.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

153
LoPAR/sec_rtas_error_reporting_return_format.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -311,10 +311,9 @@
indicated in decimal unless noted otherwise.</para> indicated in decimal unless noted otherwise.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569337_21249"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569337_21249">
<title>RTAS Event Return Format (Fixed Part) <title>RTAS Event Return Format (Fixed Part)</title>
<emphasis>(Continued)</emphasis></title>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="30*" /> <colspec colname="c1" colwidth="30*" align="center" />
<colspec colname="c2" colwidth="70*" /> <colspec colname="c2" colwidth="70*" />
<thead> <thead>
<row> <row>
@ -324,7 +323,7 @@
number(s))</emphasis> number(s))</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Description, Values (Described in <emphasis role="bold">Description, Values (Described in
<xref linkend="dbdoclet.50569337_75663"/>)</emphasis> <xref linkend="dbdoclet.50569337_75663"/>)</emphasis>
@ -332,7 +331,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Version (0:7)</para> <para>Version (0:7)</para>
@ -664,8 +663,8 @@
<table frame="all" pgwide="1" xml:id="dbdoclet.50569337_85491"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569337_85491">
<title>RTAS General Extended Event Log Format, Version 6</title> <title>RTAS General Extended Event Log Format, Version 6</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -675,12 +674,12 @@
<entry> <entry>
<para><emphasis role="bold">Bit</emphasis></para> <para><emphasis role="bold">Bit</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="7"> <entry morerows="7">
<para>0</para> <para>0</para>
@ -861,8 +860,8 @@
<title>Overview of Platform Event Log Format, Version <title>Overview of Platform Event Log Format, Version
6</title> 6</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -872,12 +871,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>12-15</para> <para>12-15</para>
@ -1076,8 +1075,8 @@
<title>Platform Event Log Format, Version 6, Main-A <title>Platform Event Log Format, Version 6, Main-A
Section</title> Section</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -1087,12 +1086,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -1288,8 +1287,8 @@
<title>Platform Event Log Format, Version 6, Main-B <title>Platform Event Log Format, Version 6, Main-B
Section</title> Section</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -1299,12 +1298,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -1897,8 +1896,8 @@
<title>Platform Event Log Format, Version 6, Logical <title>Platform Event Log Format, Version 6, Logical
Resource Identification Section</title> Resource Identification Section</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -1908,12 +1907,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -2052,8 +2051,8 @@
<title>Platform Event Log Format, Version 6, Primary SRC <title>Platform Event Log Format, Version 6, Primary SRC
Section</title> Section</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -2063,12 +2062,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -2357,8 +2356,8 @@
<title>Platform Event Log Format, Version 6, FRU Call-out <title>Platform Event Log Format, Version 6, FRU Call-out
Structure</title> Structure</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -2368,12 +2367,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -2747,8 +2746,8 @@
<title>Platform Event Log Format, Version 6, Dump Locator <title>Platform Event Log Format, Version 6, Dump Locator
Section</title> Section</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -2758,12 +2757,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -2928,8 +2927,8 @@
<title>Platform Event Log Format, Version 6, EPOW <title>Platform Event Log Format, Version 6, EPOW
Section</title> Section</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -2939,12 +2938,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -3089,8 +3088,8 @@
<title>Platform Event Log Format, Version 6, IO Events <title>Platform Event Log Format, Version 6, IO Events
Section</title> Section</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -3100,12 +3099,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -3287,8 +3286,8 @@
<title>Platform Event Log Format, Version 6, Failing <title>Platform Event Log Format, Version 6, Failing
Enclosure MTMS</title> Enclosure MTMS</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -3298,12 +3297,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -3432,12 +3431,12 @@
<title>Platform Event Log Format, Version 6, Impacted <title>Platform Event Log Format, Version 6, Impacted
Partitions</title> Partitions</title>
<tgroup cols="6"> <tgroup cols="6">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="20*" /> <colspec colname="c3" colwidth="20*" align="center" />
<colspec colname="c4" colwidth="20*" /> <colspec colname="c4" colwidth="20*" align="center" />
<colspec colname="c5" colwidth="20*" /> <colspec colname="c5" colwidth="20*" align="center" />
<colspec colname="c6" colwidth="20*" /> <colspec colname="c6" colwidth="20*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -3460,7 +3459,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0</para> <para>0</para>
@ -3584,8 +3583,8 @@
<title>Platform Error Event Log Format, Version 6, Failing <title>Platform Error Event Log Format, Version 6, Failing
Memory Address</title> Memory Address</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -3595,12 +3594,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00</para> <para>0x00</para>
@ -3721,8 +3720,8 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>UE Error Information</title> <title>UE Error Information</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -3732,12 +3731,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x11</para> <para>0x11</para>
@ -3820,8 +3819,8 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>SLB Error Information</title> <title>SLB Error Information</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -3831,12 +3830,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x11</para> <para>0x11</para>
@ -3902,8 +3901,8 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>ERAT Error Information</title> <title>ERAT Error Information</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -3913,12 +3912,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x11</para> <para>0x11</para>
@ -3984,8 +3983,8 @@
<table frame="all" pgwide="1"> <table frame="all" pgwide="1">
<title>TLB Error Information</title> <title>TLB Error Information</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="10*" /> <colspec colname="c1" colwidth="10*" align="center" />
<colspec colname="c2" colwidth="10*" /> <colspec colname="c2" colwidth="10*" align="center" />
<colspec colname="c3" colwidth="80*" /> <colspec colname="c3" colwidth="80*" />
<thead> <thead>
<row> <row>
@ -3995,12 +3994,12 @@
<entry> <entry>
<para><emphasis role="bold">Length in Bytes</emphasis></para> <para><emphasis role="bold">Length in Bytes</emphasis></para>
</entry> </entry>
<entry> <entry align="center">
<para><emphasis role="bold">Description</emphasis></para> <para><emphasis role="bold">Description</emphasis></para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x11</para> <para>0x11</para>

13
LoPAR/sec_rtas_get_dynamic_sensor_state.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -49,11 +49,10 @@
<xref linkend="dbdoclet.50569332_71500" />.</para> <xref linkend="dbdoclet.50569332_71500" />.</para>
<para>&#160;</para> <para>&#160;</para>
<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_71500"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_71500">
<title>Argument Call Buffer <title><emphasis>ibm,get-dynamic-sensor-state</emphasis> Argument Call Buffer</title>
<emphasis>ibm,get-dynamic-sensor-state</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -67,14 +66,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>In</para> <para>In</para>

13
LoPAR/sec_rtas_get_indices.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -64,11 +64,10 @@
<xref linkend="dbdoclet.50569332_50675" />.</para> <xref linkend="dbdoclet.50569332_50675" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_50675"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_50675">
<title>Argument Call Buffer <title><emphasis>ibm,get-indices</emphasis> Argument Call Buffer</title>
<emphasis>ibm,get-indices</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -82,14 +81,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="7" valign="middle"> <entry morerows="7" valign="middle">
<para>In</para> <para>In</para>

13
LoPAR/sec_rtas_get_vpd.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -54,11 +54,10 @@
<xref linkend="dbdoclet.50569332_62393" />.</para> <xref linkend="dbdoclet.50569332_62393" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_62393"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_62393">
<title>Argument Call Buffer <title><emphasis>ibm,get-vpd</emphasis> Argument Call Buffer</title>
<emphasis>ibm,get-vpd</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -72,14 +71,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="6" valign="middle"> <entry morerows="6" valign="middle">
<para>In</para> <para>In</para>

2
LoPAR/sec_rtas_hot_plug.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

2
LoPAR/sec_rtas_introduction.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

13
LoPAR/sec_rtas_lpar_perftools.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -49,11 +49,10 @@
<xref linkend="dbdoclet.50569332_48993" />.</para> <xref linkend="dbdoclet.50569332_48993" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_48993"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_48993">
<title>Argument Call Buffer <title><emphasis>ibm,lpar-perftools</emphasis> Argument Call Buffer</title>
<emphasis>ibm,lpar-perftools</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -67,14 +66,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="7" valign="middle"> <entry morerows="7" valign="middle">
<para>In</para> <para>In</para>

12
LoPAR/sec_rtas_manage_storage_preservation.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -42,9 +42,9 @@
<title><emphasis>ibm,manage-storage-preservation</emphasis> Argument Call <title><emphasis>ibm,manage-storage-preservation</emphasis> Argument Call
Buffer</title> Buffer</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -57,14 +57,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="5" valign="middle"> <entry morerows="5" valign="middle">
<para>In</para> <para>In</para>

13
LoPAR/sec_rtas_set_dynamic_indicator.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -50,11 +50,10 @@
<xref linkend="dbdoclet.50569332_14870" />.</para> <xref linkend="dbdoclet.50569332_14870" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_14870"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_14870">
<title>Argument Call Buffer <title><emphasis>ibm,set-dynamic-indicator</emphasis> Argument Call Buffer</title>
<emphasis>ibm,set-dynamic-indicator</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -70,14 +69,14 @@
</emphasis> </emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="5" valign="middle"> <entry morerows="5" valign="middle">
<para>In</para> <para>In</para>

21
LoPAR/sec_rtas_suspend_me.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -78,11 +78,10 @@
<xref linkend="dbdoclet.50569332_91600" />.</para> <xref linkend="dbdoclet.50569332_91600" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_91600"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_91600">
<title>Argument Call Buffer <title><emphasis>ibm,suspend-me</emphasis> Argument Call Buffer</title>
<emphasis>ibm,suspend-me</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -96,14 +95,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="2" valign="middle"> <entry morerows="2" valign="middle">
<para>In</para> <para>In</para>
@ -379,9 +378,9 @@
<title>System Parameters that May Change During Partition <title>System Parameters that May Change During Partition
Migration and Hibernation</title> Migration and Hibernation</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="33*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="33*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="33*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -401,7 +400,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0-15</para> <para>0-15</para>

29
LoPAR/sec_rtas_update_nodes.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -110,11 +110,10 @@
<xref linkend="dbdoclet.50569332_55185" />.</para> <xref linkend="dbdoclet.50569332_55185" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_55185"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_55185">
<title>Argument Call Buffer <title><emphasis>ibm,update-nodes</emphasis> Argument Call Buffer</title>
<emphasis>ibm,update-nodes</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -128,14 +127,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="4" valign="middle"> <entry morerows="4" valign="middle">
<para>In</para> <para>In</para>
@ -248,7 +247,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>12 bytes of 0x00 (reserved)</para> <para>12 bytes of 0x00 (reserved)</para>
@ -281,7 +280,7 @@
<emphasis>ibm,update-nodes</emphasis></title> <emphasis>ibm,update-nodes</emphasis></title>
<tgroup cols="1"> <tgroup cols="1">
<colspec colname="c1" colwidth="100*" align="center" /> <colspec colname="c1" colwidth="100*" align="center" />
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>State Variable (4 Bytes)</para> <para>State Variable (4 Bytes)</para>
@ -463,7 +462,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Don&#8217;t Care . . .</para> <para>Don&#8217;t Care . . .</para>
@ -515,7 +514,7 @@
<emphasis>ibm,update-nodes</emphasis> with Device Reconfiguration Scope</title> <emphasis>ibm,update-nodes</emphasis> with Device Reconfiguration Scope</title>
<tgroup cols="1"> <tgroup cols="1">
<colspec colname="c1" colwidth="100*" align="center"/> <colspec colname="c1" colwidth="100*" align="center"/>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00000000 (State Variable indicates Initial call for specified <emphasis>Scope</emphasis>)</para> <para>0x00000000 (State Variable indicates Initial call for specified <emphasis>Scope</emphasis>)</para>
@ -549,9 +548,9 @@
<emphasis>ibm,update-nodes</emphasis> for a Given Value of the <emphasis>ibm,update-nodes</emphasis> for a Given Value of the
&#8220;<emphasis>Scope</emphasis>&#8221; Argument</title> &#8220;<emphasis>Scope</emphasis>&#8221; Argument</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="33*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="33*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="33*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -567,7 +566,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="7" valign="middle"> <entry morerows="7" valign="middle">
<para>Negative values: Platform Resource Reassignment events as <para>Negative values: Platform Resource Reassignment events as

35
LoPAR/sec_rtas_update_properties.xml
Unescape Escape View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- <!--
Copyright (c) 2016 OpenPOWER Foundation Copyright (c) 2016, 2020 OpenPOWER Foundation


Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -75,11 +75,10 @@
<xref linkend="dbdoclet.50569332_63317" />.</para> <xref linkend="dbdoclet.50569332_63317" />.</para>


<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_63317"> <table frame="all" pgwide="1" xml:id="dbdoclet.50569332_63317">
<title>Argument Call Buffer <title><emphasis>ibm,update-properties</emphasis> Argument Call Buffer</title>
<emphasis>ibm,update-properties</emphasis></title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="1*" /> <colspec colname="c1" colwidth="1*" align="center" />
<colspec colname="c2" colwidth="2*" /> <colspec colname="c2" colwidth="2*" align="center" />
<colspec colname="c3" colwidth="4*" /> <colspec colname="c3" colwidth="4*" />
<thead> <thead>
<row> <row>
@ -93,14 +92,14 @@
<emphasis role="bold">Name</emphasis> <emphasis role="bold">Name</emphasis>
</para> </para>
</entry> </entry>
<entry> <entry align="center">
<para> <para>
<emphasis role="bold">Values</emphasis> <emphasis role="bold">Values</emphasis>
</para> </para>
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="4" valign="middle"> <entry morerows="4" valign="middle">
<para>In</para> <para>In</para>
@ -204,7 +203,7 @@
<title>Initial Format of Work Area for <title>Initial Format of Work Area for
<emphasis>ibm,update-properties</emphasis></title> <emphasis>ibm,update-properties</emphasis></title>
<tgroup cols="1"> <tgroup cols="1">
<colspec colname="c1" colwidth="100*" /> <colspec colname="c1" colwidth="100*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -214,7 +213,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>0x00000000 (Indicates Initial call for specified <para>0x00000000 (Indicates Initial call for specified
@ -251,8 +250,8 @@
<title>Return Format of Work Area for <title>Return Format of Work Area for
<emphasis>ibm,update-properties</emphasis></title> <emphasis>ibm,update-properties</emphasis></title>
<tgroup cols="2"> <tgroup cols="2">
<colspec colname="c1" colwidth="50*" /> <colspec colname="c1" colwidth="50*" align="center" />
<colspec colname="c2" colwidth="50*" /> <colspec colname="c2" colwidth="50*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -265,7 +264,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para> <para>
@ -390,7 +389,7 @@
<title>Format of Work Area for Subsequent Calls to <title>Format of Work Area for Subsequent Calls to
<emphasis>ibm,update-properties</emphasis></title> <emphasis>ibm,update-properties</emphasis></title>
<tgroup cols="1"> <tgroup cols="1">
<colspec colname="c1" colwidth="100*" /> <colspec colname="c1" colwidth="100*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -400,7 +399,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry> <entry>
<para>Value from last call to <para>Value from last call to
@ -445,9 +444,9 @@
<emphasis>ibm,update-properties</emphasis> for a &#8220; <emphasis>ibm,update-properties</emphasis> for a &#8220;
<emphasis>Scope</emphasis>&#8221;</title> <emphasis>Scope</emphasis>&#8221;</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="c1" colwidth="33*" /> <colspec colname="c1" colwidth="33*" align="center" />
<colspec colname="c2" colwidth="33*" /> <colspec colname="c2" colwidth="33*" align="center" />
<colspec colname="c3" colwidth="33*" /> <colspec colname="c3" colwidth="33*" align="center" />
<thead> <thead>
<row> <row>
<entry> <entry>
@ -463,7 +462,7 @@
</entry> </entry>
</row> </row>
</thead> </thead>
<tbody> <tbody valign="middle" >
<row> <row>
<entry morerows="6" valign="middle"> <entry morerows="6" valign="middle">
<para>All negative values: Resource Reassignment events as from <para>All negative values: Resource Reassignment events as from

Write Preview
Loading…
Cancel
Save