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

Replace LoPAR.XXXX ids with proper document references.

Browse Source 
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
pull/2/head
Jeff Scheel 4 years ago
parent 809fc06d01
commit c250b41348
31 changed files with 3742 additions and 3785 deletions
Show Stats Download Patch File Download Diff File

32
LoPAR/app_bibliography.xml
Unescape Escape View File

@ -28,38 +28,6 @@
revision, the revision shall apply.</para> revision, the revision shall apply.</para>
<orderedlist> <orderedlist>


<!-- TODO: Uncomment documents needing referencing and comment out local document -->
<listitem>
<para><anchor xml:id="LoPAR.Platform"
xreflabel="Linux on Power Architecture Reference: Platform"/><citetitle>
Linux on Power Architecture Reference: Platform and Device Tree</citetitle></para>
</listitem>

<listitem>
<para><anchor xml:id="LoPAR.DeviceTree"
xreflabel="Linux on Power Architecture Reference: Device Tree"/><citetitle>
Linux on Power Architecture Reference: Device Tree</citetitle></para>
</listitem>

<listitem>
<para><anchor xml:id="LoPAR.Error"
xreflabel="Linux on Power Architecture Reference: Error Recovery and Logging"/><citetitle>
Linux on Power Architecture Reference: Error Recovery and Logging</citetitle></para>
</listitem>

<listitem>
<para><anchor xml:id="LoPAR.Virtualization"
xreflabel="Linux on Power Architecture Reference: Virtualization"/><citetitle>
Linux on Power Architecture Reference: Virtualization</citetitle></para>
</listitem>

<listitem>
<para><anchor xml:id="LoPAR.RTAS"
xreflabel="Linux on Power Architecture Reference: Runtime Abstraction Services (RTAS)"/><citetitle>
Linux on Power Architecture Reference: Runtime Abstraction Services (RTAS)</citetitle></para>
</listitem>
<!-- End TODO list -->

<listitem> <listitem>
<para><citetitle>Power ISA</citetitle><anchor xml:id="dbdoclet.50569387_99718" <para><citetitle>Power ISA</citetitle><anchor xml:id="dbdoclet.50569387_99718"
xreflabel="Power ISA specification"/></para> xreflabel="Power ISA specification"/></para>

2
LoPAR/app_fault_v_errorlog.xml
Unescape Escape View File

@ -39,7 +39,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<xref linkend="dbdoclet.50569347_86824" />.</para> <xref linkend="dbdoclet.50569347_86824" />.</para>
<para><xref linkend="dbdoclet.50569385_72358" /> gives the recommended models. The <para><xref linkend="dbdoclet.50569385_72358" /> gives the recommended models. The
general model, though, is still dictated by the following requirement, copied general model, though, is still dictated by the following requirement, copied
here from the <xref linkend="LoPAR.Platform" />:</para> here from the <xref linkend="dbdoclet.50569347_86824" />:</para>
<informalfigure> <informalfigure>
<mediaobject> <mediaobject>
<imageobject role="html"> <imageobject role="html">

4
LoPAR/app_firmware_dump.xml
Unescape Escape View File

@ -23,8 +23,8 @@
<title>Firmware Assisted Dump Data Format</title> <title>Firmware Assisted Dump Data Format</title>


<para>This appendix documents the dump data format, in support of the <para>This appendix documents the dump data format, in support of the
Configure Platform Assisted Kernel Dump option in Configure Platform Assisted Kernel Dump option
<xref linkend="LoPAR.Virtualization" />.</para> ()<xref linkend="dbdoclet.50569332_67111" />).</para>


<section xml:id="dbdoclet.50569380__Ref135446652"> <section xml:id="dbdoclet.50569380__Ref135446652">
<title>Register Save Area</title> <title>Register Save Area</title>

24
LoPAR/app_glossary.xml
Unescape Escape View File

@ -152,7 +152,7 @@
<varlistentry> <varlistentry>
<term>CMO</term> <term>CMO</term>
<listitem><para>Cooperative Memory Over-commitment option. See <listitem><para>Cooperative Memory Over-commitment option. See
<xref linkend="LoPAR.Virtualization"/> for more information.</para> <xref linkend="dbdoclet.50569344_44716"/> for more information.</para>
<!-- TODO: Use local reference in Virtualization document --> <!-- TODO: Use local reference in Virtualization document -->
<!-- xref linkend="dbdoclet.50569344_44716"/> for more information.</para>--></listitem> <!-- xref linkend="dbdoclet.50569344_44716"/> for more information.</para>--></listitem>
</varlistentry> </varlistentry>
@ -483,8 +483,7 @@
of supporting I/O (a physical IOA) or logical bus (a virtual IOA). The term &#8220;IOA&#8221; of supporting I/O (a physical IOA) or logical bus (a virtual IOA). The term &#8220;IOA&#8221;
without the usage of the qualifier &#8220;physical&#8221; or &#8220;virtual&#8221; will be without the usage of the qualifier &#8220;physical&#8221; or &#8220;virtual&#8221; will be
used to designate a physical IOA. Virtual IOAs are defined further in used to designate a physical IOA. Virtual IOAs are defined further in
<!-- TODO: Use local reference in Virtualization document --> <xref linkend="dbdoclet.50569348_71217"/>.
<!-- xref linkend="dbdoclet.50569348_71217"/--><xref linkend="LoPAR.Virtualization"/>.
In PCI terms, an IOA may be defined by a unique combination of its assigned In PCI terms, an IOA may be defined by a unique combination of its assigned
bus number and device number, but not necessarily including its function number. bus number and device number, but not necessarily including its function number.
That is, an IOA may be a single or multi-function device, unless otherwise specified by That is, an IOA may be a single or multi-function device, unless otherwise specified by
@ -684,9 +683,7 @@
<varlistentry> <varlistentry>
<term>MTT </term> <term>MTT </term>
<listitem><para>Multi-TCE-Table option. See <listitem><para>Multi-TCE-Table option. See
<!-- TODO: Use local reference in Virtualization specification --> <xref linkend="dbdoclet.50569344_50921"/>.</para>
<!-- xref linkend="dbdoclet.50569344_50921"/>.</para-->
<xref linkend="LoPAR.Virtualization"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -808,20 +805,17 @@
<term>PE</term> <term>PE</term>
<listitem><para>When referring to the body of the LoPAR, this refers to a Partitionable <listitem><para>When referring to the body of the LoPAR, this refers to a Partitionable
Endpoint.</para> Endpoint.</para>
<!-- TODO: Extend the definition in the virtualization document. --> <para>PE has a different meaning relative to
<!-- para>PE has a different meaning relative to
<xref linkend="dbdoclet.50569368_91814"/> <xref linkend="dbdoclet.50569368_91814"/>
(see (see
<xref linkend="dbdoclet.50569368_65447"/> for that definition).</para --> <xref linkend="sec_papr_binding_terms"/> for that definition).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


<varlistentry> <varlistentry>
<term>PEM</term> <term>PEM</term>
<listitem><para>Partition Energy Management option. See <listitem><para>Partition Energy Management option. See
<!-- TODO: Use local reference in Virtualization document --> <xref linkend="dbdoclet.50569344_18587"/>.</para>
<!-- xref linkend="dbdoclet.50569344_18587"/>.</para -->
<xref linkend="LoPAR.Virtualization"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -1270,9 +1264,7 @@
<varlistentry> <varlistentry>
<term>VPNH</term> <term>VPNH</term>
<listitem><para>Virtual Processor Home Node option. See <listitem><para>Virtual Processor Home Node option. See
<!-- TODO: Use local reference in Virtualization document --> <xref linkend="dbdoclet.50569344_56450"/>.</para>
<!-- xref linkend="dbdoclet.50569344_56450"/>.</para -->
<xref linkend="LoPAR.Virtualization"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -1285,5 +1277,3 @@




</appendix> </appendix>



2
LoPAR/app_pa_processor_binding.xml
Unescape Escape View File

@ -704,7 +704,7 @@
location of resources) to the processor are preserved by the device tree location of resources) to the processor are preserved by the device tree
once presented upon boot. For a list of properties that may change before once presented upon boot. For a list of properties that may change before
a reboot, see a reboot, see
<xref linkend="LoPAR.RTAS" />.</para> <xref linkend="dbdoclet.50569332_71049" />.</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>

400
LoPAR/app_papr_binding.xml
Unescape Escape View File

@ -1710,6 +1710,156 @@
</listitem> </listitem>
</varlistentry> </varlistentry>


<varlistentry>
<term><emphasis role="bold"><literal>&#8220;ibm,partition-uuid&#8221;</literal></emphasis></term>
<listitem>
<para>
<emphasis>property name</emphasis> specifies a universally unique identifier for this partition.</para>
<para>
<emphasis>prop-encoded-array</emphasis>: A string of data as described below, encoded as with
<emphasis role="bold">encode-string</emphasis></para>
<para>The Universally Unique IDentifier (UUID) option provides each partition with a
Universally Unique Identifier that is persisted by the platform across partition
reboots, reconfigurations, OS reinstalls, partition migration, hibernation etc.
The UUID is a 16 byte string of format fields and random bits as defined in
<xref linkend="dbdoclet.50569332_20419"/>.</para>
<para>The random bits are generated in an implementation-dependent manner to
achieve a projected probability of collision of not greater than one in 2<superscript>60</superscript>.</para>

<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_20419">
<title>UUID Format</title>
<tgroup cols="4">
<colspec colname="c1" colwidth="25*" />
<colspec colname="c2" colwidth="25*" />
<colspec colname="c3" colwidth="25*" />
<colspec colname="c4" colwidth="25*" />
<thead>
<row>
<entry>
<para>
<emphasis role="bold">Field</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">Byte:Bit</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">Size (Bits)</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">Values</emphasis>
</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry>
<para>Version</para>
</entry>
<entry>
<para>0:0</para>
</entry>
<entry>
<para>1</para>
</entry>
<entry>
<para>0: Initial Version</para>
<para>1: Reserved</para>
</entry>
</row>
<row>
<entry>
<para>Random Bits</para>
</entry>
<entry>
<para>0:1 thru 5:7</para>
</entry>
<entry>
<para>47</para>
</entry>
<entry>
<para>Random Bits</para>
</entry>
</row>
<row>
<entry>
<para>Generation Method</para>
</entry>
<entry>
<para>6:0-3</para>
</entry>
<entry>
<para>4</para>
</entry>
<entry>
<para>0b0000 Never Used</para>
<para>0b0100 Random Generated</para>
<para>All other values are reserved</para>
</entry>
</row>
<row>
<entry>
<para>Random Bits</para>
</entry>
<entry>
<para>6:4 - 7:7</para>
</entry>
<entry>
<para>12</para>
</entry>
<entry>
<para>Random Bits</para>
</entry>
</row>
<row>
<entry>
<para>Variant</para>
</entry>
<entry>
<para>8:0-1</para>
</entry>
<entry>
<para>2</para>
</entry>
<entry>
<para>0b10 DCE Variant UUID</para>
<para>All other values are reserved</para>
</entry>
</row>
<row>
<entry>
<para>Random Bits</para>
</entry>
<entry>
<para>8:2 - 15:7</para>
</entry>
<entry>
<para>62</para>
</entry>
<entry>
<para>Random Bits</para>
</entry>
</row>
</tbody>
</tgroup>
</table>


<para>For the GET_PARTNER_UUID subfunction (See <xref linkend="dbdoclet.50569348_62564"/>), the data is
represented as 16 bytes as described in <xref linkend="dbdoclet.50569332_20419"/>.</para>
<para>For the ibm,partition-uuid property, the data is represented as a string of
hexadecimal characters, with hyphens added for readability.
Hexadecimal values a through f are lower case. An example of the string
representation of the UUID is 648a9ca6-1fb4-4f7e-9436-14d015f3dd74</para>
</listitem>
</varlistentry>

<varlistentry> <varlistentry>
<term><emphasis role="bold"><literal>&#8220;ibm,platform-hardware-notification&#8221;</literal></emphasis></term> <term><emphasis role="bold"><literal>&#8220;ibm,platform-hardware-notification&#8221;</literal></emphasis></term>
<listitem> <listitem>
@ -1828,7 +1978,7 @@
<emphasis>prop-encoded-array</emphasis>: An integer encoded as with <emphasis>prop-encoded-array</emphasis>: An integer encoded as with
<emphasis role="bold"><literal>encode-int</literal></emphasis> that represents the maximum VIOS level <emphasis role="bold"><literal>encode-int</literal></emphasis> that represents the maximum VIOS level
that the client shall negotiate. See that the client shall negotiate. See
<xref linkend="LoPAR.Virtualization" /> for the definition of the <xref linkend="dbdoclet.50569379_75285" /> for the definition of the
values of this property.</para> values of this property.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1962,7 +2112,7 @@
<emphasis>property name</emphasis> to define that the OS may ignore <emphasis>property name</emphasis> to define that the OS may ignore
failures of Hot Plug power off and isolate operations during a DLPAR failures of Hot Plug power off and isolate operations during a DLPAR
remove operation. See also Note 2 in remove operation. See also Note 2 in
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569342_17600" />.</para>
<para> <para>
<emphasis>prop-encoded-array</emphasis>: None, this is a name only <emphasis>prop-encoded-array</emphasis>: None, this is a name only
property.</para> property.</para>
@ -2066,6 +2216,28 @@
<para>1 = Platform is operating in the Lightpath mode.</para> <para>1 = Platform is operating in the Lightpath mode.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>

<para>
<emphasis role="bold">Implementation Notes:</emphasis>
</para>

<orderedlist>
<listitem>
<para>In the absence of this property, the determination of how the OS
is to behave is made by the platform presenting or not presenting FRU
Fault indicators to the OS see chapter
<xref linkend="dbdoclet.50569347_31867" />. In the case where there are
no FRUs owned by the partition, the OS will not observe any FRU Fault
indicators assigned, even when the platform is operating in the Lightpath
mode.</para>
</listitem>

<listitem>
<para>Presenting this property does not imply any relaxation of the
requirements specified in chapter
<xref linkend="dbdoclet.50569347_31867" />.</para>
</listitem>
</orderedlist>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -2090,181 +2262,7 @@
<emphasis>prop-encoded-array</emphasis>: &lt;NULL&gt;</para> <emphasis>prop-encoded-array</emphasis>: &lt;NULL&gt;</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

<varlistentry>
<term><emphasis role="bold"><literal>&#8220;ibm,partition-uuid&#8221;</literal></emphasis></term>
<listitem>
<para>
<emphasis>property name</emphasis> specifies a universally unique identifier for this partition.</para>
<para>
<emphasis>prop-encoded-array</emphasis>: A string of data as described below, encoded as with
<emphasis role="bold">encode-string</emphasis></para>
<para>The Universally Unique IDentifier (UUID) option provides each partition with a
Universally Unique Identifier that is persisted by the platform across partition
reboots, reconfigurations, OS reinstalls, partition migration, hibernation etc.
The UUID is a 16 byte string of format fields and random bits as defined in
<xref linkend="dbdoclet.50569332_20419"/>.</para>
<para>The random bits are generated in an implementation-dependent manner to
achieve a projected probability of collision of not greater than one in 2<superscript>60</superscript>.</para>

<table frame="all" pgwide="1" xml:id="dbdoclet.50569332_20419">
<title>UUID Format</title>
<tgroup cols="4">
<colspec colname="c1" colwidth="25*" />
<colspec colname="c2" colwidth="25*" />
<colspec colname="c3" colwidth="25*" />
<colspec colname="c4" colwidth="25*" />
<thead>
<row>
<entry>
<para>
<emphasis role="bold">Field</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">Byte:Bit</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">Size (Bits)</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">Values</emphasis>
</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry>
<para>Version</para>
</entry>
<entry>
<para>0:0</para>
</entry>
<entry>
<para>1</para>
</entry>
<entry>
<para>0: Initial Version</para>
<para>1: Reserved</para>
</entry>
</row>
<row>
<entry>
<para>Random Bits</para>
</entry>
<entry>
<para>0:1 thru 5:7</para>
</entry>
<entry>
<para>47</para>
</entry>
<entry>
<para>Random Bits</para>
</entry>
</row>
<row>
<entry>
<para>Generation Method</para>
</entry>
<entry>
<para>6:0-3</para>
</entry>
<entry>
<para>4</para>
</entry>
<entry>
<para>0b0000 Never Used</para>
<para>0b0100 Random Generated</para>
<para>All other values are reserved</para>
</entry>
</row>
<row>
<entry>
<para>Random Bits</para>
</entry>
<entry>
<para>6:4 - 7:7</para>
</entry>
<entry>
<para>12</para>
</entry>
<entry>
<para>Random Bits</para>
</entry>
</row>
<row>
<entry>
<para>Variant</para>
</entry>
<entry>
<para>8:0-1</para>
</entry>
<entry>
<para>2</para>
</entry>
<entry>
<para>0b10 DCE Variant UUID</para>
<para>All other values are reserved</para>
</entry>
</row>
<row>
<entry>
<para>Random Bits</para>
</entry>
<entry>
<para>8:2 - 15:7</para>
</entry>
<entry>
<para>62</para>
</entry>
<entry>
<para>Random Bits</para>
</entry>
</row>
</tbody>
</tgroup>
</table>


<para>For the GET_PARTNER_UUID subfunction (See <xref linkend="LoPAR.Virtualization"/>), the data is
represented as 16 bytes as described in <xref linkend="dbdoclet.50569332_20419"/>.</para>
<para>For the ibm,partition-uuid property, the data is represented as a string of
hexadecimal characters, with hyphens added for readability.
Hexadecimal values a through f are lower case. An example of the string
representation of the UUID is 648a9ca6-1fb4-4f7e-9436-14d015f3dd74</para>
</listitem>
</varlistentry>
</variablelist> </variablelist>

<para>
<emphasis role="bold">Implementation Notes:</emphasis>
</para>


<orderedlist>
<listitem>
<para>In the absence of this property, the determination of how the OS
is to behave is made by the platform presenting or not presenting FRU
Fault indicators to the OS see chapter
<xref linkend="LoPAR.Error" />. In the case where there are
no FRUs owned by the partition, the OS will not observe any FRU Fault
indicators assigned, even when the platform is operating in the Lightpath
mode.</para>
</listitem>

<listitem>
<para>Presenting this property does not imply any relaxation of the
requirements spe3cified in chapter
<xref linkend="LoPAR.Error" />.</para>
</listitem>
</orderedlist>

</section> </section>


<section xml:id="dbdoclet.50569368_10192"> <section xml:id="dbdoclet.50569368_10192">
@ -2329,7 +2327,7 @@
<emphasis role="bold"><literal>&#8220;ibm,client-architecture-support&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,client-architecture-support&#8221;</literal></emphasis>
and invoke that method with the and invoke that method with the
<!-- TODO: complete/correct this sentence --> <!-- TODO: complete/correct this sentence -->
<emphasis role="bold"><literal>>ibm,???</literal></emphasis> compatible (wording???) with the Real Base and Real Size constraints of the <emphasis role="bold"><literal>>ibm,???</literal></emphasis> compatible with the Real Base and Real Size constraints of the
kernel being loaded.</para> kernel being loaded.</para>
</listitem> </listitem>


@ -3267,7 +3265,7 @@
value indicates that the client supports the I/O Super Page value indicates that the client supports the I/O Super Page
Option (Support of &gt;4K I/O pages) (Includes extensions to Option (Support of &gt;4K I/O pages) (Includes extensions to
H_MIGRATE_DMA for &gt;4K I/O pages and &gt;256 xlates). H_MIGRATE_DMA for &gt;4K I/O pages and &gt;256 xlates).
See <xref linkend="LoPAR.Virtualization" />.</para> See <xref linkend="dbdoclet.50569344_19308" />.</para>
<para>In the <para>In the
<emphasis role="bold"><literal>ibm,architecture-vec-5</literal></emphasis> property of the <emphasis role="bold"><literal>ibm,architecture-vec-5</literal></emphasis> property of the
<emphasis role="bold"><literal>/chosen</literal></emphasis> node, a non-zero value indicates <emphasis role="bold"><literal>/chosen</literal></emphasis> node, a non-zero value indicates
@ -3287,7 +3285,7 @@
<emphasis role="bold"><literal>/chosen</literal></emphasis> node, this field represents the <emphasis role="bold"><literal>/chosen</literal></emphasis> node, this field represents the
implementation dependent number of xlates entries supported per implementation dependent number of xlates entries supported per
migration operation as: 256 * 2**N. migration operation as: 256 * 2**N.
See <xref linkend="LoPAR.Virtualization" />.</para> See <xref linkend="dbdoclet.50569344_19308" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -3302,7 +3300,7 @@
<emphasis role="bold"><literal>/chosen</literal></emphasis> node, this field represents the <emphasis role="bold"><literal>/chosen</literal></emphasis> node, this field represents the
implementation dependent number of simultaneous migration implementation dependent number of simultaneous migration
options supported as: 2**N. options supported as: 2**N.
See <xref linkend="LoPAR.Virtualization" />.</para> See <xref linkend="dbdoclet.50569344_19308" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -3364,7 +3362,7 @@
<para>= the &#8220;Form value&#8221; of the <para>= the &#8220;Form value&#8221; of the
<emphasis role="bold"><literal>&#8220;ibm,associativity&#8221;</literal></emphasis> and <emphasis role="bold"><literal>&#8220;ibm,associativity&#8221;</literal></emphasis> and
<emphasis role="bold"><literal>&#8220;ibm,associativity-reference-points&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,associativity-reference-points&#8221;</literal></emphasis>
properties. See <xref linkend="LoPAR.Platform" /> for further details.</para> properties. See <xref linkend="dbdoclet.50569346_35960" /> for further details.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -3399,7 +3397,7 @@
<entry> <entry>
<para>Enable MTT Option</para> <para>Enable MTT Option</para>
<para>See <para>See
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_50921" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -3449,7 +3447,7 @@
</entry> </entry>
<entry> <entry>
<para>Enable Hotplug Interrupts<?linebreak?> <para>Enable Hotplug Interrupts<?linebreak?>
See Hot Plug Events in <xref linkend="LoPAR.Error" />.</para> See Hot Plug Events in <xref linkend="Hot_Plug_Events" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -4388,7 +4386,7 @@
<emphasis>token</emphasis>) for the defined indicators and the number of <emphasis>token</emphasis>) for the defined indicators and the number of
indicators ( indicators (
<emphasis>maxindex</emphasis>) for that token which are implemented (see <emphasis>maxindex</emphasis>) for that token which are implemented (see
<xref linkend="LoPAR.RTAS" />) on the platform.</para> <xref linkend="dbdoclet.50569332_13537" />) on the platform.</para>
<para> <para>
<emphasis role="bold">Note:</emphasis> The indicator indices for a given token are <emphasis role="bold">Note:</emphasis> The indicator indices for a given token are
numbered 0... maxindex-1.</para> numbered 0... maxindex-1.</para>
@ -4410,7 +4408,7 @@
<emphasis>token</emphasis>) for the defined sensors and the number of <emphasis>token</emphasis>) for the defined sensors and the number of
sensors ( sensors (
<emphasis>maxindex</emphasis>) for that token which are implemented (see <emphasis>maxindex</emphasis>) for that token which are implemented (see
<xref linkend="LoPAR.RTAS" />) on the platform.</para> <xref linkend="dbdoclet.50569332_13537" />) on the platform.</para>
<para> <para>
<emphasis role="bold">Note:</emphasis> The sensor indices for a given token are <emphasis role="bold">Note:</emphasis> The sensor indices for a given token are
numbered 0 ... maxindex-1.</para> numbered 0 ... maxindex-1.</para>
@ -4933,7 +4931,7 @@
<para> <para>
<emphasis>prop-encoded-array</emphasis>: Contains the description of the <emphasis>prop-encoded-array</emphasis>: Contains the description of the
registered kernel dump in the format described in registered kernel dump in the format described in
<xref linkend="LoPAR.RTAS" />.</para> <xref linkend="dbdoclet.50569332_76933" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -4949,7 +4947,7 @@
the first 3 inputs and the first 4 outputs ( the first 3 inputs and the first 4 outputs (
<emphasis>Number Inputs</emphasis> is required to be 3 and the <emphasis>Number Inputs</emphasis> is required to be 3 and the
<emphasis>Number Outputs</emphasis> is required to be 4), as defined in <emphasis>Number Outputs</emphasis> is required to be 4), as defined in
<xref linkend="LoPAR.RTAS" />.</para> <xref linkend="dbdoclet.50569332_80186" />.</para>
<para> <para>
<emphasis>prop-encoded-array</emphasis>: Contains a 32 bit cell, with the <emphasis>prop-encoded-array</emphasis>: Contains a 32 bit cell, with the
bits defined as follows:</para> bits defined as follows:</para>
@ -4958,13 +4956,13 @@
<emphasis>ibm,read-slot-reset-state2</emphasis> RTAS call checks the <emphasis>ibm,read-slot-reset-state2</emphasis> RTAS call checks the
<emphasis>Number Outputs</emphasis> and the implements the 5th output ( <emphasis>Number Outputs</emphasis> and the implements the 5th output (
<emphasis>Number Outputs</emphasis> of 5), as defined by <emphasis>Number Outputs</emphasis> of 5), as defined by
<xref linkend="LoPAR.RTAS" />.</para> <xref linkend="dbdoclet.50569332_80186" />.</para>
<para>Bit 31: When a value of 1, the <para>Bit 31: When a value of 1, the
<emphasis>ibm,read-slot-reset-state2</emphasis> RTAS call implements the <emphasis>ibm,read-slot-reset-state2</emphasis> RTAS call implements the
first 3 inputs and the first 4 outputs ( first 3 inputs and the first 4 outputs (
<emphasis>Number Inputs</emphasis> of 3 and the <emphasis>Number Inputs</emphasis> of 3 and the
<emphasis>Number Outputs</emphasis> of 4), as defined in <emphasis>Number Outputs</emphasis> of 4), as defined in
<xref linkend="LoPAR.RTAS" />. This bit is always required <xref linkend="dbdoclet.50569332_80186" />. This bit is always required
to be a value of 1 when this property is implemented.</para> to be a value of 1 when this property is implemented.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -5035,7 +5033,7 @@
<para><emphasis>property-name</emphasis> indicating that the platform supports <para><emphasis>property-name</emphasis> indicating that the platform supports
extended extended
<emphasis>ibm,os-term</emphasis> behavior as described in <emphasis>ibm,os-term</emphasis> behavior as described in
<xref linkend="LoPAR.RTAS" />.</para> <xref linkend="dbdoclet.50569332_42118" />.</para>
<para><emphasis>prop-encoded-array</emphasis>: encode-null</para> <para><emphasis>prop-encoded-array</emphasis>: encode-null</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -5048,8 +5046,8 @@


<para>This section defines the property names associated with the various <para>This section defines the property names associated with the various
RTAS functions defined by RTAS functions defined by
<xref linkend="LoPAR.RTAS" />. <xref linkend="dbdoclet.50569332_20008" />.
<xref linkend="LoPAR.RTAS" /> should be used as the reference <xref linkend="dbdoclet.50569332_20008" /> should be used as the reference
for RTAS Functions currently implemented. Each RTAS function that a for RTAS Functions currently implemented. Each RTAS function that a
platform implements shall platform implements shall
be represented by its own function property, be represented by its own function property,
@ -5076,7 +5074,7 @@
<emphasis>rtas-call</emphasis> interface (see below), invokes the named <emphasis>rtas-call</emphasis> interface (see below), invokes the named
RTAS function. If a RTAS function is not implemented, there will not be a RTAS function. If a RTAS function is not implemented, there will not be a
property corresponding to that function name. See the property corresponding to that function name. See the
<xref linkend="LoPAR.RTAS" /> for more information about RTAS <xref linkend="dbdoclet.50569332_13537" /> for more information about RTAS
functions.</para> functions.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -5502,7 +5500,7 @@
<para>The first specification shall specify the configured address and <para>The first specification shall specify the configured address and
size of this PHB&#8217;s I/O Space. (I/O Space is shown as size of this PHB&#8217;s I/O Space. (I/O Space is shown as
&#8220;BIOn&#8221; to &#8220;TIOn&#8221; in &#8220;BIOn&#8221; to &#8220;TIOn&#8221; in
<xref linkend="LoPAR.Platform" /> "Address Map" section.) The <xref linkend="dbdoclet.50569328_Address-Map" />.) The
second specification shall specify the configured address and size of second specification shall specify the configured address and size of
this PHB&#8217;s Memory Space. (Memory Space is shown as this PHB&#8217;s Memory Space. (Memory Space is shown as
&#8220;BPMn&#8221; to &#8220;TPMn&#8221; in the Common Hardware Reference &#8220;BPMn&#8221; to &#8220;TPMn&#8221; in the Common Hardware Reference
@ -5595,7 +5593,7 @@
<para><emphasis>prop-encoded-array</emphasis>: Integer, encoded as with <para><emphasis>prop-encoded-array</emphasis>: Integer, encoded as with
<emphasis role="bold"><literal>encode-int</literal></emphasis>.</para> <emphasis role="bold"><literal>encode-int</literal></emphasis>.</para>
<para>This property, when present (for example, see Requirement <para>This property, when present (for example, see Requirement
<xref linkend="LoPAR.Platform" />), indicates the maximum DMA <xref linkend="dbdoclet.50569335_65475" />), indicates the maximum DMA
Read completion latency for IOAs under this PHB, in microseconds. For Read completion latency for IOAs under this PHB, in microseconds. For
plug-in adapters, the latency value does not include latency of any plug-in adapters, the latency value does not include latency of any
additional PCI fabric (for example, PCI Express switches) on the plug-in additional PCI fabric (for example, PCI Express switches) on the plug-in
@ -5974,7 +5972,7 @@
as a token for an additional RTAS call or an architectural level of an as a token for an additional RTAS call or an architectural level of an
extended interface. The value of one indicates that only a single extended interface. The value of one indicates that only a single
extension is implemented as specified by the second integer in the list. extension is implemented as specified by the second integer in the list.
<xref linkend="LoPAR.RTAS" /> provides the definition of the <xref linkend="dbdoclet.50569332_25585" /> provides the definition of the
subsequent integers as defined for the LoPAR level of the DDW subsequent integers as defined for the LoPAR level of the DDW
option.</para> option.</para>
</listitem> </listitem>
@ -7452,7 +7450,7 @@
<listitem> <listitem>
<para><emphasis>property name</emphasis> to provide Vital Product Data (VPD) <para><emphasis>property name</emphasis> to provide Vital Product Data (VPD)
information as defined in information as defined in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_29745" />.</para>
<para> <para>
<emphasis>prop-encoded-array</emphasis>: the concatenation, with <emphasis>prop-encoded-array</emphasis>: the concatenation, with
<emphasis role="bold"><literal>encode+</literal></emphasis>, of one or more pairs of elements, the first <emphasis role="bold"><literal>encode+</literal></emphasis>, of one or more pairs of elements, the first
@ -7831,7 +7829,7 @@


</section> </section>


<section> <section xml:id="sec_papr_bindings_hot_plug_events">
<title>hot-plug-events</title> <title>hot-plug-events</title>


<para>The presence of the node indicates that all or some of the function <para>The presence of the node indicates that all or some of the function
@ -8367,7 +8365,7 @@
</tgroup> </tgroup>
</table> </table>
<para>See <para>See
<xref linkend="LoPAR.Error" /> for further detail on this <xref linkend="dbdoclet.50569352_15379" /> for further detail on this
virtual device.</para> virtual device.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -8412,7 +8410,7 @@
<emphasis role="bold"><literal>&#8220;reg&#8221;</literal></emphasis> property value. The following <emphasis role="bold"><literal>&#8220;reg&#8221;</literal></emphasis> property value. The following
properties are the minimum required, optional support such as dynamic properties are the minimum required, optional support such as dynamic
reconfiguration will add properties per requirements called out in the reconfiguration will add properties per requirements called out in the
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569342_82208" />.</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -10643,7 +10641,7 @@ where:
power management related information shall be resident in the OF device power management related information shall be resident in the OF device
tree prior to the transfer phase of software operation (see the tree prior to the transfer phase of software operation (see the
definition of transfer phase in definition of transfer phase in
<xref linkend="LoPAR.Platform" />). Dummy devices shall be <xref linkend="dbdoclet.50569327_31987" />). Dummy devices shall be
placed in the device tree for all standard I/O bus connectors which are placed in the device tree for all standard I/O bus connectors which are
not in use to provide a node to assign the slot-names, power-domains, and not in use to provide a node to assign the slot-names, power-domains, and
power-sources properties.</para> power-sources properties.</para>

2
LoPAR/app_splar.xml
Unescape Escape View File

@ -7,7 +7,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<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
(SPLPAR Characteristics) is specified on the ibm,get-system-parameter RTAS (SPLPAR Characteristics) is specified on the ibm,get-system-parameter RTAS
call as per <xref linkend="LoPAR.RTAS" />.</para> call as per <xref linkend="dbdoclet.50569332_24237" />.</para>
</section> </section>
<section> <section>
<title>SPLPAR Terms</title> <title>SPLPAR Terms</title>

22
LoPAR/ch_address_map.xml
Unescape Escape View File

@ -1,7 +1,7 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<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>3 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
areas. These areas are one of five basic types. Each of these types has its own areas. These areas are one of five basic types. Each of these types has its own
@ -49,7 +49,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
range, the Peripheral I/O Space.<footnote xml:id="pgfId-128932"><para>A range, the Peripheral I/O Space.<footnote xml:id="pgfId-128932"><para>A
peripheral space may also include a &#x201C;configuration&#x201D; address peripheral space may also include a &#x201C;configuration&#x201D; address
space. The configuration space is abstracted by a Run-Time Abstraction Service space. The configuration space is abstracted by a Run-Time Abstraction Service
(for example, see <xref linkend="LoPAR.RTAS"/>).</para></footnote></para> (for example, see <xref linkend="dbdoclet.50569332_14852"/>).</para></footnote></para>
</listitem> </listitem>


<listitem> <listitem>
@ -74,7 +74,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<listitem> <listitem>
<para>Undefined refers to areas that are not one of the above four <para>Undefined refers to areas that are not one of the above four
areas. The result of accessing one of these areas is defined in <xref areas. The result of accessing one of these areas is defined in <xref
linkend="LoPAR.Error"/> as an invalid address error.</para> linkend="dbdoclet.50569337_52952"/> as an invalid address error.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>


@ -471,7 +471,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<para> All other addresses</para> <para> All other addresses</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Error"/>.</para> <para> See <xref linkend="dbdoclet.50569337_52952"/>.</para>
</entry> </entry>
<entry> <entry>
<para> Access is to undefined space.</para> <para> Access is to undefined space.</para>
@ -759,7 +759,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
<entry> <entry>
<para> HB does not respond or responds and signals an invalid <para> HB does not respond or responds and signals an invalid
address error (See <xref linkend="LoPAR.Error"/>).</para> address error (See <xref linkend="dbdoclet.50569337_52952"/>).</para>
</entry> </entry>
<entry> <entry>
<para> &#xA0;</para> <para> &#xA0;</para>
@ -777,7 +777,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
to access this space, then translate via the TCE table (as specified in <xref to access this space, then translate via the TCE table (as specified in <xref
linkend="dbdoclet.50569328_76588"/>) and pass the translated address through linkend="dbdoclet.50569328_76588"/>) and pass the translated address through
the HB, otherwise generate an invalid address or TCE extent error, as the HB, otherwise generate an invalid address or TCE extent error, as
appropriate (See <xref linkend="LoPAR.Error"/>). </para> appropriate (See <xref linkend="dbdoclet.50569337_52952"/>). </para>
</entry> </entry>
<entry> <entry>
<para> See Notes 2, 3</para> <para> See Notes 2, 3</para>
@ -788,7 +788,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<para> All other addresses</para> <para> All other addresses</para>
</entry> </entry>
<entry> <entry>
<para> Generate an invalid address error (See <xref linkend="LoPAR.Error"/>).</para> <para> Generate an invalid address error (See <xref linkend="dbdoclet.50569337_52952"/>).</para>
</entry> </entry>
<entry> <entry>
<para> See Note 3</para> <para> See Note 3</para>
@ -808,7 +808,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
address would re-access the same HB or another HB (for example, is in the address would re-access the same HB or another HB (for example, is in the
Peripheral Memory Space or Peripheral I/O Space of that HB or another HB), then Peripheral Memory Space or Peripheral I/O Space of that HB or another HB), then
the HB generates an invalid address error (See <xref the HB generates an invalid address error (See <xref
linkend="LoPAR.Error"/>).</para> linkend="dbdoclet.50569337_52952"/>).</para>
</listitem> </listitem>


<listitem> <listitem>
@ -971,7 +971,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
set in this field of the TCE.</para> set in this field of the TCE.</para>
<para> For accesses to system address space with an invalid <para> For accesses to system address space with an invalid
operation (write to a read-only page or read to a write-only page), the HB operation (write to a read-only page or read to a write-only page), the HB
generates an error. See <xref linkend="LoPAR.Error"/> for more information generates an error. See <xref linkend="dbdoclet.50569337_52952"/> for more information
about error handling.</para> about error handling.</para>
</entry> </entry>
</row> </row>
@ -987,7 +987,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<para>If the address that the HB would use to <para>If the address that the HB would use to
access the TCE table (in order to get the TCE) would access outside of the TCE access the TCE table (in order to get the TCE) would access outside of the TCE
table, then the HB must create a TCE extent error (See <xref table, then the HB must create a TCE extent error (See <xref
linkend="LoPAR.Error"/>).</para> linkend="dbdoclet.50569337_52952"/>).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -1015,7 +1015,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<listitem> <listitem>
<para>Any non-recoverable error while an HB <para>Any non-recoverable error while an HB
is accessing its TCE table must result in a TCE access error; the action to be is accessing its TCE table must result in a TCE access error; the action to be
taken by the HB being defined under the TCE access error in <xref linkend="LoPAR.Error"/>.</para> taken by the HB being defined under the TCE access error in <xref linkend="dbdoclet.50569337_52952"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>



55
LoPAR/ch_dynamic_reconfig.xml
Unescape Escape View File

@ -1,6 +1,9 @@
<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"
<title xml:id="dbdoclet.50569342_75822">Dynamic Reconfiguration (DR) Architecture</title> version="5.0"
xml:lang="en"
xml:id="dbdoclet.50569342_75822">
<title>Dynamic Reconfiguration (DR) Architecture</title>


<para>Dynamic Reconfiguration (DR) is the capability of a system to adapt to <para>Dynamic Reconfiguration (DR) is the capability of a system to adapt to
changes in the hardware/firmware physical or logical configuration, and to be changes in the hardware/firmware physical or logical configuration, and to be
@ -283,7 +286,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<entry> <entry>
<para>A DR entity which does not have to be physically plugged or <para>A DR entity which does not have to be physically plugged or
unplugged during a DR operation on that entity. See unplugged during a DR operation on that entity. See
<xref linkend="LoPAR.DeviceTree" /> for a list of the supported <xref linkend="dbdoclet.50569368_97022" /> for a list of the supported
Logical DR types.</para> Logical DR types.</para>
</entry> </entry>
</row> </row>
@ -317,7 +320,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<entry> <entry>
<para>A DR entity which may need to be physically plugged or <para>A DR entity which may need to be physically plugged or
unplugged during a DR operation on that entity. See unplugged during a DR operation on that entity. See
<xref linkend="LoPAR.DeviceTree" /> for a list of the supported <xref linkend="dbdoclet.50569368_97022" /> for a list of the supported
physical DR types.</para> physical DR types.</para>
</entry> </entry>
</row> </row>
@ -448,7 +451,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
these operations. In this case, the OS may ignore these operations. In this case, the OS may ignore
those errors if the operation is a DLPAR to remove the those errors if the operation is a DLPAR to remove the
hardware. See also the <emphasis role="bold"><literal>&#8220;ibm,ignore-hp-po-fails-for-dlpar&#8221;</literal></emphasis> hardware. See also the <emphasis role="bold"><literal>&#8220;ibm,ignore-hp-po-fails-for-dlpar&#8221;</literal></emphasis>
property in <xref linkend="LoPAR.DeviceTree" />.</para> property in <xref linkend="dbdoclet.50569368_54493" />.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</para> </para>
@ -1127,7 +1130,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
connector an index to be passed between the OS and RTAS to identify the connector an index to be passed between the OS and RTAS to identify the
DR connector to be operated upon. This property is in the parent node of DR connector to be operated upon. This property is in the parent node of
the DR connector to which the property applies. See the DR connector to which the property applies. See
<xref linkend="LoPAR.DeviceTree" /> for the definition of this <xref linkend="dbdoclet.50569368_13582" /> for the definition of this
property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para> property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para>


<variablelist> <variablelist>
@ -1151,7 +1154,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
entry in the entry in the
<emphasis role="bold"><literal>&#8220;ibm,drc-indexes&#8221;</literal></emphasis> property for that <emphasis role="bold"><literal>&#8220;ibm,drc-indexes&#8221;</literal></emphasis> property for that
connector. This property is used for correlation purposes. See connector. This property is used for correlation purposes. See
<xref linkend="LoPAR.DeviceTree" /> for the definition of this <xref linkend="dbdoclet.50569368_13582" /> for the definition of this
property.</para> property.</para>


<variablelist> <variablelist>
@ -1172,7 +1175,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<title><emphasis role="bold"><literal>&#8220;ibm,drc-names&#8221;</literal></emphasis> Property</title> <title><emphasis role="bold"><literal>&#8220;ibm,drc-names&#8221;</literal></emphasis> Property</title>
<para>This property is added for the DR option to specify for each DR <para>This property is added for the DR option to specify for each DR
connector a user-readable location code for the connector. See connector a user-readable location code for the connector. See
<xref linkend="LoPAR.DeviceTree" /> for the definition of this <xref linkend="dbdoclet.50569368_13582" /> for the definition of this
property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para> property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para>


<variablelist> <variablelist>
@ -1299,7 +1302,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<title><emphasis role="bold"><literal>&#8220;ibm,drc-power-domains&#8221;</literal></emphasis> Property</title> <title><emphasis role="bold"><literal>&#8220;ibm,drc-power-domains&#8221;</literal></emphasis> Property</title>
<para>This property is added for the DR option to specify for each DR <para>This property is added for the DR option to specify for each DR
connector the power domain in which the connector resides. See connector the power domain in which the connector resides. See
<xref linkend="LoPAR.DeviceTree" /> for the definition of this <xref linkend="dbdoclet.50569368_13582" /> for the definition of this
property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para> property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para>


<variablelist> <variablelist>
@ -1339,7 +1342,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<title><emphasis role="bold"><literal>&#8220;ibm,drc-types&#8221;</literal></emphasis> Property</title> <title><emphasis role="bold"><literal>&#8220;ibm,drc-types&#8221;</literal></emphasis> Property</title>
<para>This property is added for the DR option to specify for each DR <para>This property is added for the DR option to specify for each DR
connector a user-readable connector type for the connector. See connector a user-readable connector type for the connector. See
<xref linkend="LoPAR.DeviceTree" /> for the definition of this <xref linkend="dbdoclet.50569368_13582" /> for the definition of this
property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para> property. See <xref linkend="sec_ibmdrcinfo_property" /> for additional information.</para>
<para> <para>
<emphasis role="bold">Architecture Note:</emphasis> The logical connectors (CPU, MEM <emphasis role="bold">Architecture Note:</emphasis> The logical connectors (CPU, MEM
@ -1369,7 +1372,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<title><emphasis role="bold"><literal>&#8220;ibm,phandle&#8221;</literal></emphasis> Property</title> <title><emphasis role="bold"><literal>&#8220;ibm,phandle&#8221;</literal></emphasis> Property</title>
<para>This property is added for the DR option to specify the phandle for <para>This property is added for the DR option to specify the phandle for
each OF device tree node returned by ibm,configure-connector. See each OF device tree node returned by ibm,configure-connector. See
<xref linkend="LoPAR.DeviceTree" /> for the definition of this <xref linkend="dbdoclet.50569368_13582" /> for the definition of this
property.</para> property.</para>


<variablelist> <variablelist>
@ -1473,7 +1476,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<section xml:id="sec_set_power_level"> <section xml:id="sec_set_power_level">
<title><emphasis>set-power-level</emphasis></title> <title><emphasis>set-power-level</emphasis></title>
<para>This RTAS call is defined in <para>This RTAS call is defined in
<xref linkend="LoPAR.RTAS" />. Several additional requirements are placed <xref linkend="dbdoclet.50569332_45884" />. Several additional requirements are placed
on this call when the platform implements DR along with PM.</para> on this call when the platform implements DR along with PM.</para>
<para>This RTAS call is used in DR to power up or power down a DR <para>This RTAS call is used in DR to power up or power down a DR
connector, if necessary (that is, if there is a non-zero power domain connector, if necessary (that is, if there is a non-zero power domain
@ -1497,7 +1500,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para><emphasis role="bold">For all DR options:</emphasis> the <para><emphasis role="bold">For all DR options:</emphasis> the
<emphasis>set-power-level</emphasis> RTAS call must be implemented as <emphasis>set-power-level</emphasis> RTAS call must be implemented as
specified in specified in
<xref linkend="LoPAR.RTAS" /> and the further requirements of this DR <xref linkend="dbdoclet.50569332_45884" /> and the further requirements of this DR
option.</para> option.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1859,7 +1862,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<section xml:id="dbdoclet.50569342_61130"> <section xml:id="dbdoclet.50569342_61130">
<title><emphasis>set-indicator</emphasis></title> <title><emphasis>set-indicator</emphasis></title>
<para>This RTAS call is defined as shown in <para>This RTAS call is defined as shown in
<xref linkend="LoPAR.RTAS" />. This RTAS call is used in DR to transition <xref linkend="dbdoclet.50569332_27587" />. This RTAS call is used in DR to transition
between isolation states, allocation states, and control DR indicators. between isolation states, allocation states, and control DR indicators.
In some cases, a state transition fails due to various conditions, In some cases, a state transition fails due to various conditions,
however, a null transition (commanding that the new state be what it however, a null transition (commanding that the new state be what it
@ -2015,7 +2018,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
connector, then they are used to indicate the state of the DR connector, then they are used to indicate the state of the DR
connector to the user. Usage of these states are as defined in connector to the user. Usage of these states are as defined in
<xref linkend="dbdoclet.50569342_42695" /> and <xref linkend="dbdoclet.50569342_42695" /> and
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2074,7 +2077,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<emphasis>set-indicator</emphasis> call must return a -2 status, or <emphasis>set-indicator</emphasis> call must return a -2 status, or
optionally for indicator type 9001 the 990x status, for each call until optionally for indicator type 9001 the 990x status, for each call until
the operation is complete; where the 990x status is defined in the operation is complete; where the 990x status is defined in
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569332_10584" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -2512,7 +2515,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
requirement, in order to provide for a consistent user interface across requirement, in order to provide for a consistent user interface across
platforms. Information on implementation dependent aspects of the DR platforms. Information on implementation dependent aspects of the DR
indicators can be found in indicators can be found in
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -2557,7 +2560,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
power off at the connector, then the caller of power off at the connector, then the caller of
<emphasis>set-indicator</emphasis> must turn power off prior to <emphasis>set-indicator</emphasis> must turn power off prior to
setting the indicator to this state. See also setting the indicator to this state. See also
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2569,7 +2572,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
identify the physical location of the DR connector. This state identify the physical location of the DR connector. This state
may map to the same visual state (for example, blink rate) as may map to the same visual state (for example, blink rate) as
the Action state, or may map to a different state. See also the Action state, or may map to a different state. See also
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2581,7 +2584,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
the user is to perform the current DR operation. This state may the user is to perform the current DR operation. This state may
map to the same visual state (for example, blink rate) as the map to the same visual state (for example, blink rate) as the
Identify state, or may map to a different state. See also Identify state, or may map to a different state. See also
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2591,7 +2594,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<entry> <entry>
<para>The DR connector is active and entity removal may disrupt <para>The DR connector is active and entity removal may disrupt
system operation. See also system operation. See also
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
</row> </row>
</tbody> </tbody>
@ -2671,7 +2674,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<listitem> <listitem>
<para>When bringing a DR entity online that <para>When bringing a DR entity online that
utilizes TCEs (see utilizes TCEs (see
<xref linkend="LoPAR.Platform" />), the OS must initialize the DR <xref linkend="dbdoclet.50569328_76588" />), the OS must initialize the DR
entity's TCEs.</para> entity's TCEs.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -2743,7 +2746,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para>The other indicator must be amber and must be controllable by <para>The other indicator must be amber and must be controllable by
RTAS, separately from all other indicators, and must be used as a slot RTAS, separately from all other indicators, and must be used as a slot
Identify indicator, as defined in Identify indicator, as defined in
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</para> </para>
@ -3295,7 +3298,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para>Always present for sub-systems and for PCI IOAs which <para>Always present for sub-systems and for PCI IOAs which
follow the PCI VPD proposed standard. See follow the PCI VPD proposed standard. See
<!-- FIXME: Requirement R1-12.4.2-1--> <!-- FIXME: Requirement R1-12.4.2-1-->
<xref linkend="LoPAR.Platform" /> and note to see the effect of <xref linkend="dbdoclet.50569341_65980" /> and note to see the effect of
using different PCI versions.</para> using different PCI versions.</para>
</entry> </entry>
</row> </row>
@ -3735,7 +3738,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para>Shall be one of the values &#8220;CPU&#8221;, <para>Shall be one of the values &#8220;CPU&#8221;,
&#8220;MEM&#8221;, &#8220;PHB&#8221;, or &#8220;SLOT&#8221; as &#8220;MEM&#8221;, &#8220;PHB&#8221;, or &#8220;SLOT&#8221; as
defined in defined in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_97022" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -3865,7 +3868,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<emphasis role="bold"><literal>&#8220;ibm,lrdr-capacity&#8221;</literal></emphasis> property must be <emphasis role="bold"><literal>&#8220;ibm,lrdr-capacity&#8221;</literal></emphasis> property must be
included in the included in the
<emphasis role="bold"><literal>/rtas</literal></emphasis> node of the partition device tree (see <emphasis role="bold"><literal>/rtas</literal></emphasis> node of the partition device tree (see
<xref linkend="LoPAR.DeviceTree" />).</para> <xref linkend="dbdoclet.50569368_41461" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>

6
LoPAR/ch_interrupt_controller.xml
Unescape Escape View File

@ -13,7 +13,7 @@ xml:lang="en">
<section> <section>
<title>Interrupt Controller Virtualization</title> <title>Interrupt Controller Virtualization</title>
<para>Virtualization of the interrupt controller is done through the <para>Virtualization of the interrupt controller is done through the
Interrupt Support hcalls. See <xref linkend="LoPAR.Virtualization"/>.</para> Interrupt Support hcalls. See <xref linkend="dbdoclet.50569344_26787"/>.</para>
</section> </section>


<section xml:id="dbdoclet.50569331_29157"> <section xml:id="dbdoclet.50569331_29157">
@ -289,7 +289,7 @@ xml:lang="en">


<section> <section>
<title>PowerPC External Interrupt Option Properties</title> <title>PowerPC External Interrupt Option Properties</title>
<para>See <xref linkend="LoPAR.DeviceTree"/> for property definitions.</para> <para>See <xref linkend="dbdoclet.50569368_91814"/> for property definitions.</para>
</section> </section>


<section xml:id="dbdoclet.50569331_33067"> <section xml:id="dbdoclet.50569331_33067">
@ -306,7 +306,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="LoPAR.RTAS"/> 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

8
LoPAR/ch_io_devices.xml
Unescape Escape View File

@ -163,7 +163,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para>It is strongly advised that system board designers assign one <para>It is strongly advised that system board designers assign one
interrupt for each interrupt source. Additionally, multi-function PCI IOAs interrupt for each interrupt source. Additionally, multi-function PCI IOAs
should have multiple interrupt sources. For restrictions on sharing interrupts should have multiple interrupt sources. For restrictions on sharing interrupts
with the LPAR option, see Requirement <xref linkend="LoPAR.Virtualization"/>. with the LPAR option, see Requirement <xref linkend="dbdoclet.50569344_19261"/>.
For restrictions on sharing MSIs, see Requirement <xref For restrictions on sharing MSIs, see Requirement <xref
linkend="dbdoclet.50569331_84312"/> and Requirement <xref linkend="dbdoclet.50569331_84312"/> and Requirement <xref
linkend="dbdoclet.50569331_63544"/>.</para> linkend="dbdoclet.50569331_63544"/>.</para>
@ -381,7 +381,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<listitem> <listitem>
<para>All IOAs that implement PCI-X Mode 2 or PCI Express must supply <para>All IOAs that implement PCI-X Mode 2 or PCI Express must supply
the <emphasis role="bold"><literal>&#x201C;ibm,pci-config-space-type&#x201D;</literal></emphasis> property the <emphasis role="bold"><literal>&#x201C;ibm,pci-config-space-type&#x201D;</literal></emphasis> property
(see <xref linkend="LoPAR.RTAS"/>).</para> (see <xref linkend="dbdoclet.50569368_69645"/>).</para>
<para><emphasis role="bold">Implementation Note:</emphasis> The <para><emphasis role="bold">Implementation Note:</emphasis> The
<emphasis role="bold"><literal>&#x201C;ibm,pci-config-space-type&#x201D;</literal></emphasis> <emphasis role="bold"><literal>&#x201C;ibm,pci-config-space-type&#x201D;</literal></emphasis>
property in Requirement <xref linkend="dbdoclet.50569335_17839"/> is added for platforms that support property in Requirement <xref linkend="dbdoclet.50569335_17839"/> is added for platforms that support
@ -804,7 +804,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para>The platform must present within the <para>The platform must present within the
device tree nodes for all PCI Express adapters configured to operate in IOV device tree nodes for all PCI Express adapters configured to operate in IOV
mode the <emphasis role="bold"><literal>"ibm,is-vf"</literal></emphasis> property as defined in section mode the <emphasis role="bold"><literal>"ibm,is-vf"</literal></emphasis> property as defined in section
<xref linkend="LoPAR.RTAS"/>. </para> <xref linkend="dbdoclet.50569368_94451"/>. </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -822,7 +822,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<listitem> <listitem>
<para><emphasis role="bold">Platform Implementation:</emphasis> <para><emphasis role="bold">Platform Implementation:</emphasis>
Platforms must support the <emphasis role="bold"><literal>&#x201C;scsi-initiator-id&#x201D;</literal></emphasis> Platforms must support the <emphasis role="bold"><literal>&#x201C;scsi-initiator-id&#x201D;</literal></emphasis>
property as described in <xref linkend="LoPAR.DeviceTree"/> and <xref linkend="dbdoclet.50569387_27008"/>.</para> property as described in <xref linkend="dbdoclet.50569368_91814"/> and <xref linkend="dbdoclet.50569387_27008"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>

35
LoPAR/ch_io_topology.xml
Unescape Escape View File

@ -24,7 +24,8 @@ xml:lang="en">
In addition, Logical Partitioning (LPAR) allows the isolation of resources used In addition, Logical Partitioning (LPAR) allows the isolation of resources used
by one OS from those used by another. This section will discuss aspects of the by one OS from those used by another. This section will discuss aspects of the
partitioning of the I/O subsystem. Further information on DR and LPAR can be partitioning of the I/O subsystem. Further information on DR and LPAR can be
found in <xref linkend="LoPAR.Virtualization"/>.</para> found in <xref linkend="dbdoclet.50569342_75822"/> and
<xref linkend="dbdoclet.50569344_14591"/>.</para>
<para>To be useful, the granularity of assignment of I/O resources to an OS <para>To be useful, the granularity of assignment of I/O resources to an OS
needs to be fairly fine-grained. For example, it is not generally acceptable to needs to be fairly fine-grained. For example, it is not generally acceptable to
require assignment of all I/O under the same PCI Host Bridge (PHB) to the same require assignment of all I/O under the same PCI Host Bridge (PHB) to the same
@ -32,10 +33,10 @@ xml:lang="en">
including the capability to dynamically move resources between including the capability to dynamically move resources between
partitions<footnote xml:id="pgfId-1009114"><para>Dynamic LPAR or DLPAR is partitions<footnote xml:id="pgfId-1009114"><para>Dynamic LPAR or DLPAR is
defined by the Logical Resource Dynamic Reconfiguration (LRDR) option. See defined by the Logical Resource Dynamic Reconfiguration (LRDR) option. See
<xref linkend="LoPAR.Virtualization"/> for more information. Assignment of all <xref linkend="dbdoclet.50569342_75053"/> for more information. Assignment of all
IOAs under the same PHB to one partition may be acceptable if that I/O is IOAs under the same PHB to one partition may be acceptable if that I/O is
shared via the Virtual I/O (VIO) capability defined in <xref shared via the Virtual I/O (VIO) capability defined in <xref
linkend="LoPAR.Virtualization"/>.</para></footnote>. To be able to partition linkend="dbdoclet.50569348_71217"/>.</para></footnote>. To be able to partition
I/O adapters (IOAs), groups of IOAs or portions of IOAs for DR or to different I/O adapters (IOAs), groups of IOAs or portions of IOAs for DR or to different
OSs for LPAR will generally require some extra functionality in the platform OSs for LPAR will generally require some extra functionality in the platform
(for example, I/O bridges and firmware) in order to be able to partition the (for example, I/O bridges and firmware) in order to be able to partition the
@ -346,7 +347,7 @@ xml:lang="en">
(activate/deactivate reset) sequence for an IOA function, then the platform (activate/deactivate reset) sequence for an IOA function, then the platform
provides the <emphasis role="bold"><literal>&#x201C;ibm,pe-reset-is-flr&#x201D;</literal></emphasis> property provides the <emphasis role="bold"><literal>&#x201C;ibm,pe-reset-is-flr&#x201D;</literal></emphasis> property
in the function&#x2019;s node of the OF device tree, See in the function&#x2019;s node of the OF device tree, See
<xref linkend="LoPAR.RTAS"/> for more information.</para> <xref linkend="dbdoclet.50569332_86249"/> for more information.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -411,7 +412,7 @@ xml:lang="en">
<para><emphasis role="bold">Implementation Notes:</emphasis> <para><emphasis role="bold">Implementation Notes:</emphasis>
<orderedlist> <orderedlist>
<listitem> <listitem>
<para>See <xref linkend="LoPAR.Virtualization"/> for requirements <para>See <xref linkend="dbdoclet.50569344_19261"/> and <xref linkend="sec_interrupt_req"/> for requirements
relative to EEH requirements with LPAR.</para> relative to EEH requirements with LPAR.</para>
</listitem> </listitem>


@ -546,7 +547,8 @@ xml:lang="en">
<listitem> <listitem>
<para>All PHBs <para>All PHBs
for use in platforms which implement LPAR must support EEH, in support of virtualizations for use in platforms which implement LPAR must support EEH, in support of virtualizations
requirements in <xref linkend="LoPAR.Virtualization"/>.</para> requirements in <xref linkend="dbdoclet.50569344_19261"/> and
<xref linkend="sec_interrupt_req"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -962,7 +964,7 @@ xml:lang="en">
handle values in the <emphasis role="bold"><literal>&#x201C;ibm,dma-window&#x201D;</literal></emphasis> handle values in the <emphasis role="bold"><literal>&#x201C;ibm,dma-window&#x201D;</literal></emphasis>
property that are greater than or equal to 4 GB. Therefore, it is recommended property that are greater than or equal to 4 GB. Therefore, it is recommended
that 64-bit DMA addresses be implemented through the Dynamic DMA Window option that 64-bit DMA addresses be implemented through the Dynamic DMA Window option
(see <xref linkend="LoPAR.RTAS"/>).</para> (see <xref linkend="dbdoclet.50569332_14137"/>).</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1336,7 +1338,7 @@ xml:lang="en">
of a PHB may be to System Memory or may be to another IOA via the Peripheral of a PHB may be to System Memory or may be to another IOA via the Peripheral
Memory Space of another HB. Transfers that are directed to the Peripheral I/O Memory Space of another HB. Transfers that are directed to the Peripheral I/O
Space of another HB are considered to be an addressing error (see Space of another HB are considered to be an addressing error (see
<xref linkend="LoPAR.Error"/>). For information about decoding these address spaces <xref linkend="dbdoclet.50569337_37595"/>). For information about decoding these address spaces
and the address transforms necessary, see and the address transforms necessary, see
<xref linkend="dbdoclet.50569328_Address-Map"/>.</para> <xref linkend="dbdoclet.50569328_Address-Map"/>.</para>
</section> </section>
@ -1372,7 +1374,7 @@ xml:lang="en">
produce unpredictable results (for example, the system may crash).</para> produce unpredictable results (for example, the system may crash).</para>
<para>PHBs in platforms that support the PCI Hot Plug Dynamic <para>PHBs in platforms that support the PCI Hot Plug Dynamic
Reconfiguration (DR) option may have some unique design considerations. For Reconfiguration (DR) option may have some unique design considerations. For
information about the DR options, see <xref linkend="LoPAR.Virtualization"/>.</para> information about the DR options, see <xref linkend="dbdoclet.50569342_75822"/>.</para>
</section> </section>


<section> <section>
@ -1545,7 +1547,7 @@ xml:lang="en">
peer to peer operations between themselves. Peer to peer operations in an LPAR peer to peer operations between themselves. Peer to peer operations in an LPAR
environment, when the operations are between IOAs that are not in the same environment, when the operations are between IOAs that are not in the same
partition, is specifically prohibited (see Requirement partition, is specifically prohibited (see Requirement
<xref linkend="LoPAR.Virtualization"/>).</para> <xref linkend="dbdoclet.50569344_34063"/>).</para>
</section> </section>
<section xml:id="sec_pci_pci_bridges"> <section xml:id="sec_pci_pci_bridges">
<title>PCI to PCI Bridges </title> <title>PCI to PCI Bridges </title>
@ -1743,8 +1745,8 @@ xml:lang="en">
correctly implement MA recovery, make sure that the EEH option can be enabled correctly implement MA recovery, make sure that the EEH option can be enabled
and disabled independently for each PE.<footnote xml:id="pgfId-1007735"><para>LPAR and disabled independently for each PE.<footnote xml:id="pgfId-1007735"><para>LPAR
implementations limit the capability of implementations limit the capability of
running with EEH disabled (see virtualization rsequirements in running with EEH disabled (see Requirement <xref linkend="dbdoclet.50569344_47137"/>
<xref linkend="LoPAR.Virtualization"/>).</para></footnote></para> and Requirement <xref linkend="dbdoclet.50569344_28369"/>).</para></footnote></para>
</listitem> </listitem>


<listitem> <listitem>
@ -1755,7 +1757,7 @@ xml:lang="en">
</itemizedlist> </itemizedlist>


<para>Hardware changes for this option are detailed in the next section. <para>Hardware changes for this option are detailed in the next section.
RTAS changes required are detailed in <xref linkend="LoPAR.RTAS"/>.</para> RTAS changes required are detailed in <xref linkend="dbdoclet.50569332_39444"/>.</para>


<section xml:id="sec_eeh_req"> <section xml:id="sec_eeh_req">
<title>EEH Option Requirements</title> <title>EEH Option Requirements</title>
@ -1767,7 +1769,7 @@ xml:lang="en">
implemented concurrently.</para> implemented concurrently.</para>
<para>The additional requirements on the hardware for this option are as <para>The additional requirements on the hardware for this option are as
follows. For the RTAS requirements for this option, see follows. For the RTAS requirements for this option, see
<xref linkend="LoPAR.RTAS"/>.</para> <xref linkend="dbdoclet.50569332_39444"/>.</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -2075,8 +2077,9 @@ xml:lang="en">
from being enabled, may instead turn off EEH when such an enable is attempted from being enabled, may instead turn off EEH when such an enable is attempted
without first an attempt by the device driver to enable EEH (by the without first an attempt by the device driver to enable EEH (by the
<emphasis>ibm,set-eeh-option</emphasis> ), providing such EEH disablement does not <emphasis>ibm,set-eeh-option</emphasis> ), providing such EEH disablement does not
violate any other requirement for EEH enablement (for example, virtualization violate any other requirement for EEH enablement (for example, Requirement
requirement in <xref linkend="LoPAR.Virtualization"/>).</para> <xref linkend="dbdoclet.50569344_47137"/> or
<xref linkend="dbdoclet.50569344_28369"/>>).</para>
<para><emphasis role="bold">Software Implementation Note:</emphasis> To be EEH <para><emphasis role="bold">Software Implementation Note:</emphasis> To be EEH
aware, a device driver does not need to be able to recover from an MMIO Stopped aware, a device driver does not need to be able to recover from an MMIO Stopped
or DMA Stopped state, only recognize the all-1's condition and not use data or DMA Stopped state, only recognize the all-1's condition and not use data

58
LoPAR/ch_lpar_option.xml
Unescape Escape View File

@ -211,7 +211,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<title>I/O Sub-System Requirements</title> <title>I/O Sub-System Requirements</title>
<para>The platform divides the I/O subsystem up into Partitionable <para>The platform divides the I/O subsystem up into Partitionable
Endpoints (PEs). See Endpoints (PEs). See
<xref linkend="LoPAR.Platform" /> for more information on PEs. Each PE has <xref linkend="dbdoclet.50569330_34831" /> for more information on PEs. Each PE has
its own (separate) error, addressing, and interrupt domains which allows its own (separate) error, addressing, and interrupt domains which allows
the assignment of separate PEs to different LPAR partitions.</para> the assignment of separate PEs to different LPAR partitions.</para>
<para>The following are the requirements for I/O subsystems when the <para>The following are the requirements for I/O subsystems when the
@ -2034,7 +2034,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<listitem> <listitem>
<para><emphasis role="bold">For the LPAR option:</emphasis> If a platform reports in its <para><emphasis role="bold">For the LPAR option:</emphasis> If a platform reports in its
<emphasis role="bold"><literal>&#8220;ibm,hypertas-functions&#8221;</literal></emphasis> property (see <emphasis role="bold"><literal>&#8220;ibm,hypertas-functions&#8221;</literal></emphasis> property (see
<xref linkend="LoPAR.RTAS" />) that it supports a function set, then it <xref linkend="dbdoclet.50569368_41461" />) that it supports a function set, then it
must support all hcall()s of that function set as defined in must support all hcall()s of that function set as defined in
<xref linkend="dbdoclet.50569344_49986" />.</para> <xref linkend="dbdoclet.50569344_49986" />.</para>
</listitem> </listitem>
@ -6190,7 +6190,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
using 64 bit linkage conventions and apply to all page sizes that the using 64 bit linkage conventions and apply to all page sizes that the
platform supports as specified by the platform supports as specified by the
<emphasis role="bold"><literal>&#8220;ibm,processor-page-sizes&#8221;</literal></emphasis> property. (See <emphasis role="bold"><literal>&#8220;ibm,processor-page-sizes&#8221;</literal></emphasis> property. (See
<xref linkend="LoPAR.DeviceTree" /> for more details.) <xref linkend="dbdoclet.50569374_59715" /> for more details.)
The Page actual size is encoded in the PFT entry The Page actual size is encoded in the PFT entry
per the <xref linkend="dbdoclet.50569387_99718" /> architecture Book IIIs along with the per the <xref linkend="dbdoclet.50569387_99718" /> architecture Book IIIs along with the
segment base page size per the <xref linkend="dbdoclet.50569387_99718" /> segment base page size per the <xref linkend="dbdoclet.50569387_99718" />
@ -6463,7 +6463,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
logical region supports (see logical region supports (see
<emphasis role="bold"><literal>&#8220;ibm,dynamic-memory&#8221;</literal></emphasis> and <emphasis role="bold"><literal>&#8220;ibm,dynamic-memory&#8221;</literal></emphasis> and
<emphasis role="bold"><literal>&#8220;ibm,lmb-page-sizes&#8221;</literal></emphasis> in <emphasis role="bold"><literal>&#8220;ibm,lmb-page-sizes&#8221;</literal></emphasis> in
<xref linkend="LoPAR.DeviceTree" /> as well as <xref linkend="dbdoclet.50569368_91814" /> as well as
<xref linkend="dbdoclet.50569344_65610" /> for more details).</para> <xref linkend="dbdoclet.50569344_65610" /> for more details).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -6487,7 +6487,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<para><emphasis role="bold">For the LPAR option:</emphasis> <para><emphasis role="bold">For the LPAR option:</emphasis>
Each logical region must support all page sizes presented in the Each logical region must support all page sizes presented in the
<emphasis role="bold"><literal>&#8220;ibm,processor-page-sizes&#8221;</literal></emphasis> property in <emphasis role="bold"><literal>&#8220;ibm,processor-page-sizes&#8221;</literal></emphasis> property in
<xref linkend="LoPAR.DeviceTree" /> that are less than or equal to the <xref linkend="dbdoclet.50569374_59715" /> that are less than or equal to the
size of the logical region as specified by either the OF standard size of the logical region as specified by either the OF standard
<emphasis role="bold"><literal>&#8220;reg&#8221;</literal></emphasis> property of the logical <emphasis role="bold"><literal>&#8220;reg&#8221;</literal></emphasis> property of the logical
region&#8217;s OF region&#8217;s OF
@ -6495,7 +6495,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
<emphasis role="bold"><literal>&#8220;ibm,lmb-size&#8221;</literal></emphasis> property of the logical <emphasis role="bold"><literal>&#8220;ibm,lmb-size&#8221;</literal></emphasis> property of the logical
region&#8217;s region&#8217;s
<emphasis role="bold"><literal>/ibm,dynamic-reconfiguration-memory</literal></emphasis> node in <emphasis role="bold"><literal>/ibm,dynamic-reconfiguration-memory</literal></emphasis> node in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>


<para><emphasis role="bold">Implementation Note:</emphasis> 32 bit versions of AIX only support 36 bit <para><emphasis role="bold">Implementation Note:</emphasis> 32 bit versions of AIX only support 36 bit
logical address memory spaces. Providing such a partition with a larger logical address memory spaces. Providing such a partition with a larger
@ -7883,7 +7883,7 @@ hcall ( const int64 H_BULK_REMOVE, /* Function Code */
fewer than 8 entries for a given actual page size / base page fewer than 8 entries for a given actual page size / base page
size combination as communicated by the “Block Invalidate size combination as communicated by the “Block Invalidate
Characteristics” system parameter (see Characteristics” system parameter (see
<xref linkend="LoPAR.RTAS" />). <xref linkend="sec_tlb_block_invalidate" />).
The virtual pages are all within The virtual pages are all within
the same naturally aligned 8 page virtual address block and the same naturally aligned 8 page virtual address block and
have the same page and segment size encodings. The AVA parameter, have the same page and segment size encodings. The AVA parameter,
@ -8648,7 +8648,7 @@ hcall ( const int64 H_RESIZE_HPT_COMMIT, /* Function Code */
<emphasis role="bold"><literal>&#8220;ibm,dma-window&#8221;</literal></emphasis> property associated with <emphasis role="bold"><literal>&#8220;ibm,dma-window&#8221;</literal></emphasis> property associated with
the particular IOA. For the format of the the particular IOA. For the format of the
<emphasis role="bold"><literal>&#8220;ibm,dma-window&#8221;</literal></emphasis> property, reference <emphasis role="bold"><literal>&#8220;ibm,dma-window&#8221;</literal></emphasis> property, reference
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>


<section xml:id="dbdoclet.50569344_38645"> <section xml:id="dbdoclet.50569344_38645">
<title>H_GET_TCE</title> <title>H_GET_TCE</title>
@ -8710,7 +8710,7 @@ hcall ( const uint64 H_GET_TCE, /* Return the contents of the specified TCE */


<listitem> <listitem>
<para>If specified TCE&#8217;s Page Mapping and Control bits (see <para>If specified TCE&#8217;s Page Mapping and Control bits (see
<xref linkend="LoPAR.Platform" />) specify &#8220;Page Fault&#8221; then <xref linkend="dbdoclet.50569328_76588" />) specify &#8220;Page Fault&#8221; then
return H_Success</para> return H_Success</para>
</listitem> </listitem>


@ -8783,7 +8783,7 @@ hcall ( const uint64 H_PUT_TCE, /* Function Token */
<listitem> <listitem>
<para>If the Page Mapping and Control field of the TCE is not <para>If the Page Mapping and Control field of the TCE is not
&#8220;Page Fault&#8221; (see &#8220;Page Fault&#8221; (see
<xref linkend="LoPAR.Platform" />)</para> <xref linkend="dbdoclet.50569328_76588" />)</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -8882,7 +8882,7 @@ hcall ( const uint64 H_STUFF_TCE, /* Function Token */
<listitem> <listitem>
<para>If the Page Mapping and Control field of the TCE is not <para>If the Page Mapping and Control field of the TCE is not
&#8220;Page Fault&#8221; (see &#8220;Page Fault&#8221; (see
<xref linkend="LoPAR.Platform" />)</para> <xref linkend="dbdoclet.50569328_76588" />)</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -9136,7 +9136,7 @@ hcall ( const uint64 H_PUT_TCE_INDIRECT, /* Function Token */
<listitem> <listitem>
<para>If the Page Mapping and Control field of the 8 byte entry <para>If the Page Mapping and Control field of the 8 byte entry
&#8220;T&#8221; is not &#8220;Page Fault&#8221; (see &#8220;T&#8221; is not &#8220;Page Fault&#8221; (see
<xref linkend="LoPAR.Platform" />) then do</para> <xref linkend="dbdoclet.50569328_91476" />) then do</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -10314,7 +10314,7 @@ hcall ( const uint64 H_CLEAR_HPT);]]></programlisting>
<literal>/chosen</literal> <literal>/chosen</literal>
<emphasis role="bold"><literal>&#8220;ibm,architecture-vec&#8221;</literal></emphasis> Byte 23 bits 0-1 undefined or 0b00<footnote xml:id="fn_cas_option_vec_p9"> <emphasis role="bold"><literal>&#8220;ibm,architecture-vec&#8221;</literal></emphasis> Byte 23 bits 0-1 undefined or 0b00<footnote xml:id="fn_cas_option_vec_p9">
<para>See ibm,architecture vector 5, byte 23 in <para>See ibm,architecture vector 5, byte 23 in
<xref linkend="LoPAR.DeviceTree" /> <xref linkend="dbdoclet.50569368_10077" />
for more details. for more details.
</para> </para>
</footnote> </footnote>
@ -12314,7 +12314,7 @@ hcall ( const uint64 H_INT_RESET, /* Reset all interrupt structures */
returns; this requires that the OS not reuse/modify the data within the returns; this requires that the OS not reuse/modify the data within the
old page until the worst case DMA read access time has expired. The old page until the worst case DMA read access time has expired. The
<emphasis role="bold"><literal>&#8220;ibm,dma-delay-time&#8221;</literal></emphasis> property (see <emphasis role="bold"><literal>&#8220;ibm,dma-delay-time&#8221;</literal></emphasis> property (see
<xref linkend="LoPAR.DeviceTree" />) gives the OS this implementation <xref linkend="dbdoclet.50569368_41461" />) gives the OS this implementation
dependent delay value. Failure to observe this delay time may result in dependent delay value. Failure to observe this delay time may result in
data corruption as seen by the caller&#8217;s I/O adapter(s).</para> data corruption as seen by the caller&#8217;s I/O adapter(s).</para>


@ -15913,7 +15913,7 @@ hcall ( const uint64 H_GET_DMA_XLATES_LIMITED, /*Return I/O Bus and correspondin
performed, resulting in a constrained return from such a request.</para> performed, resulting in a constrained return from such a request.</para>
<para>System Parameters readable via the <para>System Parameters readable via the
<emphasis>ibm,get-system-parameter</emphasis> RTAS call (see <emphasis>ibm,get-system-parameter</emphasis> RTAS call (see
<xref linkend="LoPAR.RTAS" />) <xref linkend="dbdoclet.50569332_62190" />)
communicate a variety of configuration and communicate a variety of configuration and
constraint parameters among which are determined by the partition constraint parameters among which are determined by the partition
definition.</para> definition.</para>
@ -16742,7 +16742,7 @@ hcall ( const uint64 H_PROD, /* Mark the target processor runable */
<listitem> <listitem>
<para>When the value of the <para>When the value of the
<emphasis role="bold"><literal>&#8220;ibm,partition-performance-parameters-level&#8221;</literal></emphasis> see <emphasis role="bold"><literal>&#8220;ibm,partition-performance-parameters-level&#8221;</literal></emphasis> see
<xref linkend="LoPAR.DeviceTree" />) is &gt;=1 then register R8 contains <xref linkend="dbdoclet.50569368_54493" />) is &gt;=1 then register R8 contains
the processor virtualization resource allocations. In the case of a the processor virtualization resource allocations. In the case of a
dedicated processor partition R8 contains 0:</para> dedicated processor partition R8 contains 0:</para>


@ -16922,7 +16922,7 @@ hcall ( const uint64 H_SET_PPP, /* Modifies the specified partition’s performa
running on processors that do not implement the register in hardware, running on processors that do not implement the register in hardware,
firmware simulates the function. On platforms that present the property firmware simulates the function. On platforms that present the property
<emphasis role="bold"><literal>&#8220;ibm,rks-hcalls&#8221;</literal></emphasis> with bit 2 set (see <emphasis role="bold"><literal>&#8220;ibm,rks-hcalls&#8221;</literal></emphasis> with bit 2 set (see
<xref linkend="LoPAR.DeviceTree" />), this call provides a reduced <xref linkend="dbdoclet.50569368_41461" />), this call provides a reduced
&#8220;kill set&#8221; of volatile registers, GPRs r0 and r5-r13 are &#8220;kill set&#8221; of volatile registers, GPRs r0 and r5-r13 are
preserved.</para> preserved.</para>


@ -17086,7 +17086,7 @@ hcall ( const uint64 H_PIC ); /*Returns in R4 the value of the Pool Idle Count *
<listitem> <listitem>
<para>When the value of the <para>When the value of the
<emphasis role="bold"><literal>&#8220;ibm,partition-performance-parameters-level&#8221;</literal></emphasis> (see <emphasis role="bold"><literal>&#8220;ibm,partition-performance-parameters-level&#8221;</literal></emphasis> (see
<xref linkend="LoPAR.DeviceTree" />) is &gt;=1 then:</para> <xref linkend="dbdoclet.50569368_54493" />) is &gt;=1 then:</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -17338,7 +17338,7 @@ hcall ( const uint64 H_JOIN /* Join active threads and return H_CONTINUE to fina
<para><emphasis role="bold">For the Virtual Processor Home Node option:</emphasis> The <para><emphasis role="bold">For the Virtual Processor Home Node option:</emphasis> The
platform must support the &#8220;Form 1&#8221; of the platform must support the &#8220;Form 1&#8221; of the
<emphasis role="bold"><literal>&#8220;ibm,associativity-reference-points&#8221;</literal></emphasis> property per <emphasis role="bold"><literal>&#8220;ibm,associativity-reference-points&#8221;</literal></emphasis> property per
<xref linkend="LoPAR.Platform" />. The client program may call <xref linkend="dbdoclet.50569346_82008" />. The client program may call
H_HOME_NODE_ASSOCIATIVITY hcall() with a valid identifier input parameter H_HOME_NODE_ASSOCIATIVITY hcall() with a valid identifier input parameter
(such as from the device tree or from the (such as from the device tree or from the
<emphasis>ibm,configure-connector</emphasis> RTAS call) even if the <emphasis>ibm,configure-connector</emphasis> RTAS call) even if the
@ -17581,7 +17581,7 @@ hcall ( const uint64 H_HOME_NODE_ASSOCIATIVITY), /* Returns in R4-R9 the home no
<para><emphasis role="bold">For the Partition Migration and Partition Hibernation <para><emphasis role="bold">For the Partition Migration and Partition Hibernation
options:</emphasis> The platform must implement the Partition Suspension options:</emphasis> The platform must implement the Partition Suspension
option (See option (See
<xref linkend="LoPAR.RTAS" />).</para> <xref linkend="dbdoclet.50569332_45918" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -17613,7 +17613,7 @@ hcall ( const uint64 H_HOME_NODE_ASSOCIATIVITY), /* Returns in R4-R9 the home no
<para><emphasis role="bold">For the Partition Migration and Partition Hibernation <para><emphasis role="bold">For the Partition Migration and Partition Hibernation
options:</emphasis> The platform must implement the Version 6 Extensions options:</emphasis> The platform must implement the Version 6 Extensions
of Event Log Format for all reported events (See of Event Log Format for all reported events (See
<xref linkend="LoPAR.Error" />).</para> <xref linkend="dbdoclet.50569337_79682" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -17658,7 +17658,7 @@ hcall ( const uint64 H_HOME_NODE_ASSOCIATIVITY), /* Returns in R4-R9 the home no
<para><emphasis role="bold">For the Partition Migration and Partition Hibernation <para><emphasis role="bold">For the Partition Migration and Partition Hibernation
options:</emphasis> The platform must present the options:</emphasis> The platform must present the
<emphasis role="bold"><literal>&#8220;ibm,nominal-tbf&#8221;</literal></emphasis> property (See <emphasis role="bold"><literal>&#8220;ibm,nominal-tbf&#8221;</literal></emphasis> property (See
<xref linkend="LoPAR.DeviceTree" />) with the value of 512 MHz.</para> <xref linkend="dbdoclet.50569374_89868" />) with the value of 512 MHz.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -17668,7 +17668,7 @@ hcall ( const uint64 H_HOME_NODE_ASSOCIATIVITY), /* Returns in R4-R9 the home no
<listitem> <listitem>
<para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform <para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform
must present the properties from must present the properties from
<xref linkend="LoPAR.DeviceTree" />, as specified by <xref linkend="dbdoclet.50569374_59715" />, as specified by
<xref linkend="dbdoclet.50569344_83870" />, to a partition.</para> <xref linkend="dbdoclet.50569344_83870" />, to a partition.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -17681,7 +17681,7 @@ hcall ( const uint64 H_HOME_NODE_ASSOCIATIVITY), /* Returns in R4-R9 the home no
value of all properties in value of all properties in
<xref linkend="dbdoclet.50569344_83870" /> must not change while a <xref linkend="dbdoclet.50569344_83870" /> must not change while a
partition is suspended except for those properties described by partition is suspended except for those properties described by
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569332_40069" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -18300,7 +18300,7 @@ hcall ( const uint64 H_HOME_NODE_ASSOCIATIVITY), /* Returns in R4-R9 the home no
<listitem> <listitem>
<para><emphasis role="bold">For the VRMA option:</emphasis> The platform must include the <para><emphasis role="bold">For the VRMA option:</emphasis> The platform must include the
<emphasis role="bold"><literal>&#8220;ibm,vrma-page-sizes&#8221;</literal></emphasis> property (See <emphasis role="bold"><literal>&#8220;ibm,vrma-page-sizes&#8221;</literal></emphasis> property (See
<xref linkend="LoPAR.DeviceTree" />) in the <xref linkend="dbdoclet.50569374_59715" />) in the
<emphasis role="bold"><literal>/cpu</literal></emphasis> node.</para> <emphasis role="bold"><literal>/cpu</literal></emphasis> node.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -18450,7 +18450,7 @@ hcall ( const uint64 H_VRMASD, /* Change the page mapping characteristics of the
(except for time delays) handle all effects of any memory expropriation (except for time delays) handle all effects of any memory expropriation
that it may introduce unless the CMO option is explicitly enabled by the that it may introduce unless the CMO option is explicitly enabled by the
setting of architecture.vec option vector 5 byte 4 bit 0 (See setting of architecture.vec option vector 5 byte 4 bit 0 (See
<xref linkend="LoPAR.DeviceTree" /> for details).</para> <xref linkend="dbdoclet.50569368_10077" /> for details).</para>
<para>The CMO option consists of the following LoPAR extensions:</para> <para>The CMO option consists of the following LoPAR extensions:</para>


<itemizedlist> <itemizedlist>
@ -19977,7 +19977,7 @@ hcall ( const H_GET_MPP_X /* Returns in R4-R10 extended Memory Performance */
Check Interrupt by returning to the partition&#8217;s interrupt vector at Check Interrupt by returning to the partition&#8217;s interrupt vector at
location 0x0200. Note the subsequent firmware assisted NMI and check location 0x0200. Note the subsequent firmware assisted NMI and check
exception processing returns a VPM SUE error log (See exception processing returns a VPM SUE error log (See
<xref linkend="LoPAR.Error" />).</para> <xref linkend="dbdoclet.50569337_54366" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -21604,7 +21604,7 @@ hcall ( const uint64 H_REGISTER_PROCESS_TABLE, /* Set translation mode */
the value 1) cede latency specifier settings. Platforms that implement the value 1) cede latency specifier settings. Platforms that implement
cede latency specifier settings greater than the value of 1 implement the cede latency specifier settings greater than the value of 1 implement the
cede latency settings system parameter see cede latency settings system parameter see
<xref linkend="LoPAR.RTAS" />. The hypervisor is then free to take energy <xref linkend="dbdoclet.50569332_63170" />. The hypervisor is then free to take energy
management actions with this hint in mind.</para> management actions with this hint in mind.</para>


<variablelist> <variablelist>
@ -21666,7 +21666,7 @@ hcall ( const uint64 H_REGISTER_PROCESS_TABLE, /* Set translation mode */
<para><emphasis role="bold">For the PEM option:</emphasis> If the platform implements cede <para><emphasis role="bold">For the PEM option:</emphasis> If the platform implements cede
latency specifier values greater than 1 it must implement the cede latency specifier values greater than 1 it must implement the cede
latency settings system parameter see latency settings system parameter see
<xref linkend="LoPAR.RTAS" />.</para> <xref linkend="dbdoclet.50569332_63170" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>

6
LoPAR/ch_nonvolatile_memory.xml
Unescape Escape View File

@ -63,7 +63,7 @@ version="5.0" xml:lang="en">
<emphasis>nvram-fetch</emphasis> and <emphasis>nvram-store</emphasis> RTAS <emphasis>nvram-fetch</emphasis> and <emphasis>nvram-store</emphasis> RTAS
calls do not allow a &#x201C;busy&#x201D; Status return, and this may further calls do not allow a &#x201C;busy&#x201D; Status return, and this may further
limit the implementation choices.</para> limit the implementation choices.</para>
<para><emphasis role="bold">Software Implementation Note:</emphasis> Refer to <xref linkend="LoPAR.RTAS"/> <para><emphasis role="bold">Software Implementation Note:</emphasis> Refer to <xref linkend="dbdoclet.50569332_26944"/>
for information on accessing NVRAM.</para> for information on accessing NVRAM.</para>
</section> </section>


@ -391,7 +391,7 @@ unsigned int nbytes; /* number of bytes to sum */
<title>System (0x70)</title> <title>System (0x70)</title>
<para>System NVRAM partitions are used for storing information <para>System NVRAM partitions are used for storing information
(typically, configuration variables) accessible to both OF and the OS. Refer to (typically, configuration variables) accessible to both OF and the OS. Refer to
<xref linkend="LoPAR.DeviceTree"/> for the definition of the contents of the <xref linkend="dbdoclet.50569368_91814"/> for the definition of the contents of the
System NVRAM partition named <emphasis role="bold"><literal>common</literal></emphasis>.</para> System NVRAM partition named <emphasis role="bold"><literal>common</literal></emphasis>.</para>


<variablelist> <variablelist>
@ -493,7 +493,7 @@ unsigned int nbytes; /* number of bytes to sum */
<para>OF configuration variables control the operation of OF. In addition <para>OF configuration variables control the operation of OF. In addition
to the standard configuration variables defined in to the standard configuration variables defined in
<xref linkend="dbdoclet.50569387_45524"/>, other configuration variables are defined <xref linkend="dbdoclet.50569387_45524"/>, other configuration variables are defined
in <xref linkend="LoPAR.RTAS"/>. While such variables are stored in the System in <xref linkend="dbdoclet.50569374_59715"/>. While such variables are stored in the System
NVRAM partition as described above, they have additional rules placed on the NVRAM partition as described above, they have additional rules placed on the
format of the value component. Each configuration variable is also represented format of the value component. Each configuration variable is also represented
by a user interface word (of the same name) that returns stack value(s) when by a user interface word (of the same name) that returns stack value(s) when

16
LoPAR/ch_numa.xml
Unescape Escape View File

@ -72,7 +72,7 @@ xml:lang="en">
(processor, memory region, and IO slot) conveys information about the resources (processor, memory region, and IO slot) conveys information about the resources
statically assigned to the client program; and contains the statically assigned to the client program; and contains the
<emphasis role="bold"><literal>&#x201C;ibm,associativity&#x201D;</literal></emphasis> <emphasis role="bold"><literal>&#x201C;ibm,associativity&#x201D;</literal></emphasis>
property (see <xref linkend="LoPAR.RTAS"/>). This property allows the client property (see <xref linkend="dbdoclet.50569368_10192"/>). This property allows the client
program to determine the associativity between any two of it&#x2019;s program to determine the associativity between any two of it&#x2019;s
resources. The greater the associativity the greater the expected performance resources. The greater the associativity the greater the expected performance
when using those two resources in a given operation.</para> when using those two resources in a given operation.</para>
@ -96,7 +96,7 @@ xml:lang="en">
information for the resources is not provided to prevent erroneous operation. information for the resources is not provided to prevent erroneous operation.
If the long term mapping changes the client program can be made aware of the If the long term mapping changes the client program can be made aware of the
new associativity information using the <emphasis>ibm,update-properties</emphasis> RTAS call (See new associativity information using the <emphasis>ibm,update-properties</emphasis> RTAS call (See
<xref linkend="LoPAR.RTAS"/>).</para> <xref linkend="dbdoclet.50569332_40069"/>).</para>


<variablelist> <variablelist>
<varlistentry xml:id="dbdoclet.50569346_19785"> <varlistentry xml:id="dbdoclet.50569346_19785">
@ -221,7 +221,7 @@ xml:lang="en">
property byte 5 bit 0 has the value of zero, the property byte 5 bit 0 has the value of zero, the
<emphasis role="bold"><literal>&#x201C;ibm,associativity-reference-points&#x201D;</literal></emphasis> property defines <emphasis role="bold"><literal>&#x201C;ibm,associativity-reference-points&#x201D;</literal></emphasis> property defines
reference points in the <emphasis role="bold"><literal>&#x201C;ibm,associativity&#x201D;</literal></emphasis> reference points in the <emphasis role="bold"><literal>&#x201C;ibm,associativity&#x201D;</literal></emphasis>
property (see <xref linkend="LoPAR.DeviceTree"/>) which roughly correspond to property (see <xref linkend="dbdoclet.50569368_41461"/>) which roughly correspond to
traditional notions of platform topology constructs. It is important for the traditional notions of platform topology constructs. It is important for the
user to realize that these reference points are not exact and their user to realize that these reference points are not exact and their
characteristics vary among implementations. </para> characteristics vary among implementations. </para>
@ -281,7 +281,7 @@ xml:lang="en">
<title>Dynamic Reconfiguration with Cross CEC I/O Drawers</title> <title>Dynamic Reconfiguration with Cross CEC I/O Drawers</title>
<para>Should the configuration change in such a way that the associativity <para>Should the configuration change in such a way that the associativity
between an OS image&#x2019;s resources changes, the platform notifies the OS between an OS image&#x2019;s resources changes, the platform notifies the OS
via an event scan log. See <xref linkend="LoPAR.Error"/>. </para> via an event scan log. See <xref linkend="dbdoclet.50569337_37595"/>. </para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -307,7 +307,7 @@ xml:lang="en">
and the and the
<emphasis role="bold"><literal>&#x201C;ibm,current-associativity-domains&#x201D;</literal></emphasis> <emphasis role="bold"><literal>&#x201C;ibm,current-associativity-domains&#x201D;</literal></emphasis>
properties in the <emphasis role="bold"><literal>/rtas</literal></emphasis> node of the device tree (see properties in the <emphasis role="bold"><literal>/rtas</literal></emphasis> node of the device tree (see
<xref linkend="LoPAR.DeviceTree"/>).</para> <xref linkend="dbdoclet.50569368_41461"/>).</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -343,7 +343,7 @@ xml:lang="en">
preferred.</para> preferred.</para>
<para>The OS and platform firmware negotiate their mutual support of the <para>The OS and platform firmware negotiate their mutual support of the
PRRN option via the <emphasis role="bold"><literal>ibm,client-architecture-support</literal></emphasis> PRRN option via the <emphasis role="bold"><literal>ibm,client-architecture-support</literal></emphasis>
interface (See <xref linkend="LoPAR.DeviceTree"/>). Should a partition be interface (See <xref linkend="dbdoclet.50569368_13649"/>). Should a partition be
migrated from a platform that did not support the PRRN option, the target migrated from a platform that did not support the PRRN option, the target
platform does not notify the partition&#x2019;s OS of any PRRN events and, when platform does not notify the partition&#x2019;s OS of any PRRN events and, when
possible avoids changing the affinity among the partition&#x2019;s resources. possible avoids changing the affinity among the partition&#x2019;s resources.
@ -353,7 +353,7 @@ xml:lang="en">
events.</para> events.</para>
<para>A PRRN event is signaled via the RTAS <emphasis>event-scan</emphasis> <para>A PRRN event is signaled via the RTAS <emphasis>event-scan</emphasis>
mechanism, which returns a Hot Plug Event message &#x201C;fixed mechanism, which returns a Hot Plug Event message &#x201C;fixed
part&#x201D; (See <xref linkend="LoPAR.Error"/>) indicating &#x201C;Platform part&#x201D; (See <xref linkend="dbdoclet.50569337_28848"/>) indicating &#x201C;Platform
Resource Reassignment&#x201D;. In response to the Hot Plug Event message, the Resource Reassignment&#x201D;. In response to the Hot Plug Event message, the
OS may call <emphasis>ibm,update-nodes</emphasis> to determine which resources OS may call <emphasis>ibm,update-nodes</emphasis> to determine which resources
were reassigned, and then <emphasis>ibm,update-properties</emphasis> to obtain were reassigned, and then <emphasis>ibm,update-properties</emphasis> to obtain
@ -443,7 +443,7 @@ xml:lang="en">
</entry> </entry>
<entry align="center"> <entry align="center">
<para> <para>
<emphasis role="bold">Description, Values (Described in <xref linkend="LoPAR.RTAS"/>)</emphasis> <emphasis role="bold">Description, Values (Described in <xref linkend="dbdoclet.50569337_75663"/>)</emphasis>
</para> </para>
</entry> </entry>
</row> </row>

18
LoPAR/ch_processors_memory.xml
Unescape Escape View File

@ -89,7 +89,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<emphasis role="bold"><literal>cpu</literal></emphasis> node of the OF device tree. Examples of OF device <emphasis role="bold"><literal>cpu</literal></emphasis> node of the OF device tree. Examples of OF device
tree properties which support these differences include <emphasis role="bold"><literal>&#x201C;64-bit&#x201D;</literal></emphasis> tree properties which support these differences include <emphasis role="bold"><literal>&#x201C;64-bit&#x201D;</literal></emphasis>
and <emphasis role="bold"><literal>&#x201C;performance-monitor&#x201D;</literal></emphasis>. See and <emphasis role="bold"><literal>&#x201C;performance-monitor&#x201D;</literal></emphasis>. See
<xref linkend="LoPAR.RTAS"/> for a complete listing and more details. </para> <xref linkend="dbdoclet.50569374_59715"/> for a complete listing and more details. </para>


<variablelist> <variablelist>
<varlistentry xml:id="dbdoclet.50569329_14931"> <varlistentry xml:id="dbdoclet.50569329_14931">
@ -143,7 +143,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para>Platforms must restrict their choice of processors to those whose <para>Platforms must restrict their choice of processors to those whose
programming models may be described by the properties defined for the programming models may be described by the properties defined for the
<emphasis role="bold"><literal>cpu</literal></emphasis> node of the OF device tree in <emphasis role="bold"><literal>cpu</literal></emphasis> node of the OF device tree in
<xref linkend="LoPAR.RTAS"/>.</para> <xref linkend="dbdoclet.50569374_59715"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -172,7 +172,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<listitem> <listitem>
<para>Platforms must implement the <para>Platforms must implement the
<emphasis role="bold"><literal>&#x201C;ibm,platform-hardware-notification&#x201D;</literal></emphasis> property (see <emphasis role="bold"><literal>&#x201C;ibm,platform-hardware-notification&#x201D;</literal></emphasis> property (see
<xref linkend="LoPAR.DeviceTree"/>) and include all PVRs that the platform may <xref linkend="dbdoclet.50569368_91814"/>) and include all PVRs that the platform may
contain.</para> contain.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -275,7 +275,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">


<section> <section>
<title><emphasis role="bold"><literal>cpu</literal></emphasis> Node <emphasis role="bold"><literal>&#x201C;Status&#x201D;</literal></emphasis> Property</title> <title><emphasis role="bold"><literal>cpu</literal></emphasis> Node <emphasis role="bold"><literal>&#x201C;Status&#x201D;</literal></emphasis> Property</title>
<para>See <xref linkend="LoPAR.RTAS"/> for the values of the <para>See <xref linkend="dbdoclet.50569374_59715"/> for the values of the
<emphasis role="bold"><literal>&#x201C;status&#x201D;</literal></emphasis> property of the <emphasis role="bold"><literal>cpu</literal></emphasis> <emphasis role="bold"><literal>&#x201C;status&#x201D;</literal></emphasis> property of the <emphasis role="bold"><literal>cpu</literal></emphasis>
node.</para> node.</para>
</section> </section>
@ -296,7 +296,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Refer to <xref linkend="LoPAR.DeviceTree"/> for the definition of <para>Refer to <xref linkend="dbdoclet.50569368_31401"/> for the definition of
the <emphasis role="bold"><literal>ibm,ppc-interrupt-server#s</literal></emphasis> property.</para> the <emphasis role="bold"><literal>ibm,ppc-interrupt-server#s</literal></emphasis> property.</para>
</section> </section>
</section> </section>
@ -713,7 +713,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<para>Each first level cache will be defined via properties of the <para>Each first level cache will be defined via properties of the
<emphasis role="bold"><literal>cpu</literal></emphasis> node(s) of the OF device tree. Each higher level cache will be <emphasis role="bold"><literal>cpu</literal></emphasis> node(s) of the OF device tree. Each higher level cache will be
defined via properties of the <emphasis role="bold"><literal>l2-cache</literal></emphasis> node(s) defined via properties of the <emphasis role="bold"><literal>l2-cache</literal></emphasis> node(s)
of the OF device tree. See <xref linkend="LoPAR.RTAS"/> for more details.</para> of the OF device tree. See <xref linkend="dbdoclet.50569374_59715"/> for more details.</para>
</listitem> </listitem>


<listitem> <listitem>
@ -736,7 +736,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term>
<listitem> <listitem>
<para>Firmware must implement all of the <para>Firmware must implement all of the
properties for memory modules, as specified by <xref linkend="LoPAR.DeviceTree"/>, properties for memory modules, as specified by <xref linkend="dbdoclet.50569368_91814"/>,
and any other properties defined by this document which apply to memory modules.</para> and any other properties defined by this document which apply to memory modules.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -805,8 +805,8 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<section xml:id="dbdoclet.50569329_70628"> <section xml:id="dbdoclet.50569329_70628">
<title>Persistent Memory</title> <title>Persistent Memory</title>
<para>Selected regions of storage (LMBs) may be optionally preserved <para>Selected regions of storage (LMBs) may be optionally preserved
across client program boot cycles. See <xref linkend="dbdoclet.50569327_70628"/> and across client program boot cycles. See <xref linkend="dbdoclet.50569327_70628"/>
"Managing Storage Preservations" in <xref linkend="LoPAR.RTAS"/> specification.</para> and <xref linkend="dbdoclet.50569332_28221"/>.</para>
</section> </section>
</section> </section>



8
LoPAR/ch_product_topology.xml
Unescape Escape View File

@ -10,7 +10,7 @@ xml:lang="en">
<title>VPD and Location Code OF Properties</title> <title>VPD and Location Code OF Properties</title>
<para>A set of OF properties is defined to facilitate asset protection and <para>A set of OF properties is defined to facilitate asset protection and
RAS capabilities in LoPAR systems. The following properties are defined in RAS capabilities in LoPAR systems. The following properties are defined in
<xref linkend="LoPAR.DeviceTree"/>):</para> <xref linkend="dbdoclet.50569368_31220"/>):</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -137,7 +137,7 @@ xml:lang="en">


<section xml:id="dbdoclet.50569341_23269"> <section xml:id="dbdoclet.50569341_23269">
<title>System Identification</title> <title>System Identification</title>
<para><xref linkend="LoPAR.DeviceTree"/> provides properties in the <para><xref linkend="dbdoclet.50569368_91814"/> provides properties in the
&#x201C;OF Root Node&#x201D; section called <emphasis role="bold"><literal>&#x201C;system-id&#x201D;</literal></emphasis> &#x201C;OF Root Node&#x201D; section called <emphasis role="bold"><literal>&#x201C;system-id&#x201D;</literal></emphasis>
and<emphasis role="bold"><literal>&#x201C;model&#x201D;</literal></emphasis>.</para> and<emphasis role="bold"><literal>&#x201C;model&#x201D;</literal></emphasis>.</para>


@ -4707,7 +4707,7 @@ xml:lang="en">
<para> Up to 56</para> <para> Up to 56</para>
</entry> </entry>
<entry> <entry>
<para> Processor CoD Capacity Card Info per <xref linkend="LoPAR.RTAS"/></para> <para> Processor CoD Capacity Card Info per <xref linkend="dbdoclet.50569332_47931"/></para>
</entry> </entry>
</row> </row>
<row> <row>
@ -4721,7 +4721,7 @@ xml:lang="en">
<para> Up to 56</para> <para> Up to 56</para>
</entry> </entry>
<entry> <entry>
<para> Memory CoD Capacity Card Info per <xref linkend="LoPAR.RTAS"/></para> <para> Memory CoD Capacity Card Info per <xref linkend="dbdoclet.50569332_47931"/></para>
</entry> </entry>
</row> </row>
<row> <row>

2
LoPAR/ch_service_indicators.xml
Unescape Escape View File

@ -431,7 +431,7 @@
<para>Dynamic Reconfiguration (LoPAR indicator type 9002) to indicate <para>Dynamic Reconfiguration (LoPAR indicator type 9002) to indicate
the status of DR operations on a Field Replacable Unit (FRU). More the status of DR operations on a Field Replacable Unit (FRU). More
information on DR indicators can be found in information on DR indicators can be found in
<xref linkend="LoPAR.Virtualization" />. This indicator is amber <xref linkend="dbdoclet.50569342_75822" />. This indicator is amber
<footnote xml:id="pgfId-630879"> <footnote xml:id="pgfId-630879">
<para>The term &#8220;amber&#8221; will be used in this chapter to mean <para>The term &#8220;amber&#8221; will be used in this chapter to mean
any wavelength between yellow and amber.</para> any wavelength between yellow and amber.</para>

14
LoPAR/ch_smp.xml
Unescape Escape View File

@ -9,7 +9,7 @@ xml:lang="en">
<para>This architecture supports the implementation of symmetric <para>This architecture supports the implementation of symmetric
multiprocessor (SMP) systems as an optional feature. This Chapter provides multiprocessor (SMP) systems as an optional feature. This Chapter provides
information concerning the design and programming of such systems. For SMP OF information concerning the design and programming of such systems. For SMP OF
binding information, see <xref linkend="LoPAR.DeviceTree"/>.</para> binding information, see <xref linkend="dbdoclet.50569368_56107"/>.</para>
<para>SMP systems differ from uniprocessors in a number of ways. These <para>SMP systems differ from uniprocessors in a number of ways. These
differences are not all covered in this chapter. Other chapters that cover differences are not all covered in this chapter. Other chapters that cover
SMP-related topics include:</para> SMP-related topics include:</para>
@ -25,7 +25,7 @@ xml:lang="en">
</listitem> </listitem>


<listitem> <listitem>
<para>Error handling: <xref linkend="LoPAR.Error"/></para> <para>Error handling: <xref linkend="dbdoclet.50569337_37595"/></para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>


@ -85,8 +85,8 @@ xml:lang="en">
<listitem> <listitem>
<para><emphasis role="bold">For the Symmetric Multiprocessor <para><emphasis role="bold">For the Symmetric Multiprocessor
option:</emphasis> The extensions defined in option:</emphasis> The extensions defined in
<xref linkend="LoPAR.DeviceTree"/>, and the SMP support section of the RTAS <xref linkend="dbdoclet.50569368_56107"/>, and the SMP support section of the RTAS
specifications (see <xref linkend="LoPAR.RTAS"/>) must be implemented.</para> specifications (see <xref linkend="dbdoclet.50569332_36251"/>) must be implemented.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -144,7 +144,7 @@ xml:lang="en">
<listitem> <listitem>
<para>Hardware for SMPs must provide a means for synchronizing all the <para>Hardware for SMPs must provide a means for synchronizing all the
time bases of all the processors in the platform, for use by platform firmware. time bases of all the processors in the platform, for use by platform firmware.
See <xref linkend="LoPAR.RTAS"/>. This is for purposes of clock synchronization See <xref linkend="dbdoclet.50569332_36251"/>. This is for purposes of clock synchronization
at initialization and at times when the processor loses time base state.</para> at initialization and at times when the processor loses time base state.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -262,7 +262,7 @@ xml:lang="en">
the state of the system and will continue to be in that state until awakened by the state of the system and will continue to be in that state until awakened by
some outside force, such as an inter-processor interrupt (IPI).<footnote xml:id="pgfId-242214"><para>Another some outside force, such as an inter-processor interrupt (IPI).<footnote xml:id="pgfId-242214"><para>Another
characteristic of the <emphasis>stopped</emphasis> state, characteristic of the <emphasis>stopped</emphasis> state,
defined in <xref linkend="LoPAR.RTAS"/>, is that the defined in <xref linkend="dbdoclet.50569374_59715"/>, is that the
processor remembers nothing of its prior life when placed in a processor remembers nothing of its prior life when placed in a
<emphasis>stopped</emphasis> state; this distinguishes it from the <emphasis>stopped</emphasis> state; this distinguishes it from the
<emphasis>idle</emphasis> state. That isn&#x2019;t strictly necessary for this booting <emphasis>idle</emphasis> state. That isn&#x2019;t strictly necessary for this booting
@ -340,7 +340,7 @@ xml:lang="en">
interrupts directed at it. This identity is determined by board wiring: The interrupts directed at it. This identity is determined by board wiring: The
processor attached to the &#x201C;processor 0&#x201D; wire from the interrupt processor attached to the &#x201C;processor 0&#x201D; wire from the interrupt
controller has identity 0. For information about how this identity is used, see controller has identity 0. For information about how this identity is used, see
<xref linkend="LoPAR.DeviceTree"/>.</para> <xref linkend="dbdoclet.50569368_56107"/>.</para>
<para>The method used by a platform to identify its processors is <para>The method used by a platform to identify its processors is
dependent upon the platform hardware design and may be based upon service dependent upon the platform hardware design and may be based upon service
processor information, identification registers, inter-processor interrupts, or processor information, identification registers, inter-processor interrupts, or

121
LoPAR/ch_system_reqs.xml
Unescape Escape View File

@ -331,7 +331,7 @@ xml:lang="en">
<section xml:id="dbdoclet.50569327_28943"> <section xml:id="dbdoclet.50569327_28943">
<title>Locate an OS Boot Image </title> <title>Locate an OS Boot Image </title>
<para>The OS boot image is located as described in <para>The OS boot image is located as described in
<xref linkend="LoPAR.DeviceTree"/>. A device and filename can be specified directly <xref linkend="dbdoclet.50569368_91814"/>. A device and filename can be specified directly
from the command interpreter (the <emphasis>boot</emphasis> command) or OF from the command interpreter (the <emphasis>boot</emphasis> command) or OF
will locate the image through an automatic boot process controlled by will locate the image through an automatic boot process controlled by
configuration variables. Once a boot image is located, the device path is set configuration variables. Once a boot image is located, the device path is set
@ -345,7 +345,7 @@ xml:lang="en">
<emphasis role="bold"><literal>boot-device</literal></emphasis> entries that the platform processes.</para> <emphasis role="bold"><literal>boot-device</literal></emphasis> entries that the platform processes.</para>
<para>If multi-boot (multiple bootable OSs residing on the same platform) is supported, <para>If multi-boot (multiple bootable OSs residing on the same platform) is supported,
a configuration variable instructs the firmware to display a multi-boot menu a configuration variable instructs the firmware to display a multi-boot menu
from which the OS and bootpath are selected. See <xref linkend="LoPAR.DeviceTree"/> from which the OS and bootpath are selected. See <xref linkend="dbdoclet.50569368_91814"/>
for information relating to the multiboot process.</para> for information relating to the multiboot process.</para>


<variablelist> <variablelist>
@ -368,10 +368,10 @@ xml:lang="en">


<section xml:id="dbdoclet.50569327_26247"> <section xml:id="dbdoclet.50569327_26247">
<title>Boot Process</title> <title>Boot Process</title>
<para>The boot process is described in <xref linkend="LoPAR.DeviceTree"/>. <para>The boot process is described in <xref linkend="dbdoclet.50569368_91814"/>.
Steps in the process are reviewed here, but the Steps in the process are reviewed here, but the
authoritative and complete description of the process is included in authoritative and complete description of the process is included in
<xref linkend="LoPAR.DeviceTree"/>. <xref linkend="dbdoclet.50569327_17087"/> is a <xref linkend="dbdoclet.50569368_91814"/>. <xref linkend="dbdoclet.50569327_17087"/> is a
depiction of the boot flow showing the action of the f1, f5, and f6 function depiction of the boot flow showing the action of the f1, f5, and f6 function
keys. The figure should only be used as an aid in understanding the keys. The figure should only be used as an aid in understanding the
requirements for LoPAR systems.</para> requirements for LoPAR systems.</para>
@ -431,7 +431,7 @@ xml:lang="en">
<para>Once the boot prompt is displayed, the System Management Services <para>Once the boot prompt is displayed, the System Management Services
(SMS) menu can be invoked. SMS provides a user interface for utilities, (SMS) menu can be invoked. SMS provides a user interface for utilities,
configuration, and the Multiboot Menu (as introduced in configuration, and the Multiboot Menu (as introduced in
<xref linkend="LoPAR.DeviceTree"/>) for boot/install and the OF command <xref linkend="dbdoclet.50569368_91814"/>) for boot/install and the OF command
interpreter.</para> interpreter.</para>
<para>The Multiboot menu is formatted so that block devices that <para>The Multiboot menu is formatted so that block devices that
currently contain boot information are most easily selected by the user. currently contain boot information are most easily selected by the user.
@ -721,7 +721,7 @@ xml:lang="en">
<emphasis role="bold"><literal>diag-device</literal></emphasis> <emphasis role="bold"><literal>diag-device</literal></emphasis>
configuration variables must include the standard block device configuration variables must include the standard block device
<literal>bootinfo.txt</literal> file specification as documented in <literal>bootinfo.txt</literal> file specification as documented in
<xref linkend="LoPAR.DeviceTree"/> (<literal>\ppc\bootinfo.txt</literal>).</para> <xref linkend="dbdoclet.50569368_91814"/> (<literal>\ppc\bootinfo.txt</literal>).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -729,7 +729,7 @@ xml:lang="en">


<section xml:id="dbdoclet.50569327_20641"> <section xml:id="dbdoclet.50569327_20641">
<title>Tape Boot</title> <title>Tape Boot</title>
<para>Boot from tape is defined in <xref linkend="LoPAR.DeviceTree"/>.</para> <para>Boot from tape is defined in <xref linkend="dbdoclet.50569368_91814"/>.</para>
</section> </section>


<section xml:id="sec_network_boot"> <section xml:id="sec_network_boot">
@ -897,7 +897,7 @@ ELSE
the platform using the <emphasis>ibm,manage-storage-preservation</emphasis> the platform using the <emphasis>ibm,manage-storage-preservation</emphasis>
RTAS call if it wants the contents of the storage preserved across client boot RTAS call if it wants the contents of the storage preserved across client boot
cycles (see also "Managing Storage Preservations" in cycles (see also "Managing Storage Preservations" in
<xref linkend="LoPAR.RTAS"/> specification). The architectural intent of this <xref linkend="dbdoclet.50569332_28221"/> specification). The architectural intent of this
facility is to enable client programs to emulate persistent storage. This is facility is to enable client programs to emulate persistent storage. This is
done by a client program registering preservable LMBs. Then, after a subsequent done by a client program registering preservable LMBs. Then, after a subsequent
boot cycle (perhaps due to error or impending power loss) the presence of the boot cycle (perhaps due to error or impending power loss) the presence of the
@ -1029,7 +1029,7 @@ ELSE
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569327_22507" <term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569327_22507"
xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term>
<listitem> <listitem>
<para>Platforms must implement OF as defined in <xref linkend="LoPAR.DeviceTree"/>.</para> <para>Platforms must implement OF as defined in <xref linkend="dbdoclet.50569368_91814"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -1053,7 +1053,7 @@ ELSE
xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term>
<listitem> <listitem>
<para>Platforms must implement the Run-Time Abstraction Services (RTAS) as described in <para>Platforms must implement the Run-Time Abstraction Services (RTAS) as described in
<xref linkend="LoPAR.RTAS"/>.</para> <xref linkend="dbdoclet.50569332_13537"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -1138,7 +1138,7 @@ ELSE
<section> <section>
<title>Tape Install</title> <title>Tape Install</title>
<para>The OF definition of installation from tape is defined in <para>The OF definition of installation from tape is defined in
<xref linkend="LoPAR.DeviceTree"/>.</para> <xref linkend="dbdoclet.50569368_91814"/>.</para>
</section> </section>


<section xml:id="sec_network_install"> <section xml:id="sec_network_install">
@ -1167,7 +1167,7 @@ ELSE
will run on other vendors&#x2019; platforms which might not have permission to will run on other vendors&#x2019; platforms which might not have permission to
use AIX diagnostics, the <emphasis role="bold"><literal>&#x201C;ibm,aix-diagnostics&#x201D;</literal></emphasis> use AIX diagnostics, the <emphasis role="bold"><literal>&#x201C;ibm,aix-diagnostics&#x201D;</literal></emphasis>
property indicates that AIX diagnostics are permitted (see "Root property indicates that AIX diagnostics are permitted (see "Root
Node Properties" in <xref linkend="LoPAR.DeviceTree"/>).</para> Node Properties" in <xref linkend="dbdoclet.50569337_42315"/>).</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -1184,15 +1184,14 @@ ELSE


<para><emphasis role="bold">Software Implementation Note:</emphasis> Each OS may implement an OS-specific <para><emphasis role="bold">Software Implementation Note:</emphasis> Each OS may implement an OS-specific
run-time diagnostics package, but should, for purposes of consistency, adhere run-time diagnostics package, but should, for purposes of consistency, adhere
to the error log formats in <xref linkend="LoPAR.Error"/>.</para> to the error log formats in <xref linkend="dbdoclet.50569337_42315"/>.</para>
</section> </section>


<section xml:id="sec_platform_class"> <section xml:id="sec_platform_class">
<title>Platform Class</title> <title>Platform Class</title>
<para>The <emphasis role="bold"><literal>&#x201C;ibm,model-class&#x201D;</literal></emphasis> OF property <para>The <emphasis role="bold"><literal>&#x201C;ibm,model-class&#x201D;</literal></emphasis> OF property
is defined to classify platforms for planning, marketing, licensing, and is defined to classify platforms for planning, marketing, licensing, and
service purposes (see "Root Node Properties" in service purposes (see <xref linkend="dbdoclet.50569368_54493"/>).</para>
<xref linkend="LoPAR.DeviceTree"/>).</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -1696,7 +1695,7 @@ ELSE
<para> OR</para> <para> OR</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/> for more information. </para> <para> See <xref linkend="dbdoclet.50569342_75822"/> for more information. </para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1710,7 +1709,7 @@ ELSE
<para> OR</para> <para> OR</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569342_75053"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1726,8 +1725,8 @@ ELSE
<entry> <entry>
<para> See <xref linkend="dbdoclet.50569330_34831"/> and <para> See <xref linkend="dbdoclet.50569330_34831"/> and
<xref linkend="dbdoclet.50569330_17337"/>. Requirements for platforms that implement <xref linkend="dbdoclet.50569330_17337"/>. Requirements for platforms that implement
LPAR, regardless of the number of partitions, are contained in LPAR, regardless of the number of partitions (Requirements <xref linkend="dbdoclet.50569344_47137"/>
<xref linkend="LoPAR.Virtualization"/>.</para> and <xref linkend="dbdoclet.50569344_28369"/>).</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1755,7 +1754,7 @@ ELSE
<para> R</para> <para> R</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/>.</para> <para> See <xref linkend="dbdoclet.50569344_14591"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1801,7 +1800,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.RTAS"/> for more information on <para> See <xref linkend="dbdoclet.50569332_19739"/> for more information on
support of I<superscript>2</superscript>C buses.</para> support of I<superscript>2</superscript>C buses.</para>
</entry> </entry>
</row> </row>
@ -1816,7 +1815,7 @@ ELSE
<para> R</para> <para> R</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.RTAS"/>. </para> <para><xref linkend="dbdoclet.50569332_12478"/>. </para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1830,7 +1829,7 @@ ELSE
<para> R</para> <para> R</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.RTAS"/>.</para> <para><xref linkend="dbdoclet.50569332_24237"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1844,7 +1843,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.RTAS"/>.</para> <para><xref linkend="dbdoclet.50569332_41873"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1858,7 +1857,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.RTAS"/>.</para> <para><xref linkend="dbdoclet.50569332_61466"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1888,7 +1887,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569344_27067"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1902,7 +1901,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569348_48491"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1916,7 +1915,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569348_61656"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1930,7 +1929,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569350_23147"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1944,7 +1943,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569350_17923"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1958,7 +1957,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569350_53238"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1972,7 +1971,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/>.</para> <para> See <xref linkend="dbdoclet.50569350_39278"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1986,7 +1985,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="LoPAR.Virtualization"/>.</para> <para><xref linkend="dbdoclet.50569351_35753"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2000,7 +1999,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/>.</para> <para> See <xref linkend="dbdoclet.50569364_64078"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2014,8 +2013,7 @@ ELSE
<para> NS</para> <para> NS</para>
</entry> </entry>
<entry> <entry>
<para><xref linkend="dbdoclet.50569327_70628"/> and "Managing <para><xref linkend="dbdoclet.50569327_70628"/> and <xref linkend="dbdoclet.50569332_28221"/>.</para>
Storage Preservations" in <xref linkend="LoPAR.RTAS"/> specification.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2032,7 +2030,7 @@ ELSE
<para> Required of all platforms that support LPAR, otherwise not <para> Required of all platforms that support LPAR, otherwise not
implemented. Provides a virtual &#x201C;Asynchronous&#x201D; IOA for connecting implemented. Provides a virtual &#x201C;Asynchronous&#x201D; IOA for connecting
to a server Vterm IOA, the hypervisor, or HMC (for example, to a virtual to a server Vterm IOA, the hypervisor, or HMC (for example, to a virtual
console). See <xref linkend="LoPAR.Virtualization"/> for more console). See <xref linkend="dbdoclet.50569352_15379"/> for more
information.</para> information.</para>
</entry> </entry>
</row> </row>
@ -2068,7 +2066,7 @@ ELSE
</row> </row>
<row> <row>
<entry> <entry>
<para> Performance Tool Support</para> <para>Performance Tool Support</para>
</entry> </entry>
<entry> <entry>
<para> O</para> <para> O</para>
@ -2078,8 +2076,9 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> Provides access to platform-level facilities for <para> Provides access to platform-level facilities for
performance tools running in a partition on an LPAR system. See performance tools running in a partition on an LPAR system.
<xref linkend="LoPAR.Virtualization"/>.</para> See
<xref linkend="dbdoclet.50569332_26596"/>.></para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2107,7 +2106,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/>.</para> <para> See <xref linkend="dbdoclet.50569350_39077"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2121,7 +2120,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/>.</para> <para> See <xref linkend="sec_vmc"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2216,7 +2215,7 @@ ELSE
<entry> <entry>
<para> Allows an authorized virtual server partition (VSP) to <para> Allows an authorized virtual server partition (VSP) to
safely access the internal state of a specific partition. See safely access the internal state of a specific partition. See
<xref linkend="LoPAR.Virtualization"/> for more details. Requires the Reliable <xref linkend="sec_vasi"/> for more details. Requires the Reliable
Command/Response Transport option.</para> Command/Response Transport option.</para>
</entry> </entry>
</row> </row>
@ -2248,7 +2247,7 @@ ELSE
<entry> <entry>
<para> Allows the OS to indicate that there is no need to search <para> Allows the OS to indicate that there is no need to search
secondary page table entry groups to determine a page table search has failed. secondary page table entry groups to determine a page table search has failed.
See <xref linkend="LoPAR.Virtualization"/> for more details.</para> See <xref linkend="dbdoclet.50569344_39908"/> for more details.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2292,7 +2291,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> Support for the Subordinate CRQs as needed by some Virtual <para> Support for the Subordinate CRQs as needed by some Virtual
IOAs. See <xref linkend="LoPAR.Virtualization"/>.</para> IOAs. See <xref linkend="dbdoclet.50569348_28179"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2308,7 +2307,7 @@ ELSE
<entry> <entry>
<para> The CMO option allows for partition participation in the <para> The CMO option allows for partition participation in the
over-commitment of logical memory by the platform. See over-commitment of logical memory by the platform. See
<xref linkend="LoPAR.Virtualization"/>.</para> <xref linkend="dbdoclet.50569344_44716"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2323,7 +2322,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> Allows the OS to cooperate with platform energy <para> Allows the OS to cooperate with platform energy
management. See <xref linkend="LoPAR.Virtualization"/>.</para> management. See <xref linkend="dbdoclet.50569344_18587"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2338,7 +2337,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> Support for the Multi-TCE-Table Option. See <para> Support for the Multi-TCE-Table Option. See
<xref linkend="LoPAR.Virtualization"/>.</para> <xref linkend="dbdoclet.50569344_50921"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2354,7 +2353,7 @@ ELSE
<entry> <entry>
<para> Provides substantially consistent virtual processor <para> Provides substantially consistent virtual processor
associativity in a shared processor LPAR environment. See associativity in a shared processor LPAR environment. See
<xref linkend="LoPAR.Virtualization"/>.</para> <xref linkend="dbdoclet.50569344_56450"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2382,7 +2381,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/>.</para> <para> See <xref linkend="dbdoclet.50569366_19541"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2397,7 +2396,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> Allows OS notification of a cooperative memory <para> Allows OS notification of a cooperative memory
overcommitment page fault see <xref linkend="LoPAR.Virtualization"/>.</para> overcommitment page fault see <xref linkend="dbdoclet.50569344_20827"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2413,7 +2412,7 @@ ELSE
<entry> <entry>
<para> Allows the platform to communicate and the availability of <para> Allows the platform to communicate and the availability of
performance boost modes along with any ability to manage the same. See performance boost modes along with any ability to manage the same. See
<xref linkend="LoPAR.RTAS"/></para> <xref linkend="dbdoclet.50569332_57301"/></para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2445,7 +2444,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> Allows the creation of DMA Windows above 4 GB. See <para> Allows the creation of DMA Windows above 4 GB. See
<xref linkend="LoPAR.RTAS"/>.</para> <xref linkend="dbdoclet.50569332_14137"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2460,7 +2459,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> <para>
<xref linkend="LoPAR.DeviceTree"/> for information on ibm,partition-uuid. <xref linkend="dbdoclet.50569368_54493"/> for information on ibm,partition-uuid.
</para> </para>
</entry> </entry>
</row> </row>
@ -2475,7 +2474,9 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/> for more information.</para> <para> See <xref linkend="dbdoclet.50569344_80550"/>,
<xref linkend="dbdoclet.50569344_61580"/>, and
<xref linkend="dbdoclet.50569344_93738"/> for more information.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2490,7 +2491,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para> Introduces additional cooperative memory overcommitment <para> Introduces additional cooperative memory overcommitment
functions see <xref linkend="LoPAR.Virtualization"/></para> functions see <xref linkend="dbdoclet.50569344_44716"/></para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2504,7 +2505,7 @@ ELSE
<para> O</para> <para> O</para>
</entry> </entry>
<entry> <entry>
<para> See <xref linkend="LoPAR.Virtualization"/>.</para> <para> See <xref linkend="sec_mui_opt"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2563,7 +2564,7 @@ ELSE
</entry> </entry>
<entry> <entry>
<para>Allows partitions to resize their HPT. See <para>Allows partitions to resize their HPT. See
<xref linkend="LoPAR.Virtualization"/>.</para> <xref linkend="sec_hash_page_table_resize_option"/>.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -2577,8 +2578,8 @@ ELSE
<para>O</para> <para>O</para>
</entry> </entry>
<entry> <entry>
<para>Allows partitions to resize their HPT. See <para>See
<xref linkend="LoPAR.Virtualization"/>.</para> <xref linkend="sec_coherent_platform_facilities"/>.</para>
</entry> </entry>
</row> </row>
</tbody> </tbody>

73
LoPAR/ch_virtual_io.xml
Unescape Escape View File

@ -193,7 +193,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
access modes, like writing to a read only page). More access modes, like writing to a read only page). More
information on TCEs and TCE tables, which are used for physical information on TCEs and TCE tables, which are used for physical
IOAs, can be found in IOAs, can be found in
<xref linkend="LoPAR.Platform" />. The RTCE table for Remote <xref linkend="dbdoclet.50569328_76588" />. The RTCE table for Remote
DMA (RDMA) is analogous to the TCE table for physical IOAs. The DMA (RDMA) is analogous to the TCE table for physical IOAs. The
RTCE table does, however, have a little more information in it RTCE table does, however, have a little more information in it
(as placed there by the hypervisor) in order to, among other (as placed there by the hypervisor) in order to, among other
@ -728,7 +728,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
</entry> </entry>
<entry> <entry>
<para>The virtual location code (see <para>The virtual location code (see
<xref linkend="LoPAR.Platform" />)</para> <xref linkend="dbdoclet.50569341_32742" />)</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -953,7 +953,7 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="dbdo
assignment number is uniquely generated when the virtual IOA is assigned assignment number is uniquely generated when the virtual IOA is assigned
to the partition and remains invariably associated with that virtual IOA to the partition and remains invariably associated with that virtual IOA
for the duration of the partition definition. For more information, see for the duration of the partition definition. For more information, see
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</section> </section>


<section xml:id="dbdoclet.50569348_27549"> <section xml:id="dbdoclet.50569348_27549">
@ -1153,7 +1153,7 @@ hcall ( const int64 H_VIO_SIGNAL, /* Function Code */
<emphasis role="bold"><literal>root</literal></emphasis> node, a node of type <emphasis role="bold"><literal>root</literal></emphasis> node, a node of type
<emphasis role="bold"><literal>vdevice</literal></emphasis> as the parent of a sub-tree representing the <emphasis role="bold"><literal>vdevice</literal></emphasis> as the parent of a sub-tree representing the
virtual IOAs assigned to the partition (see virtual IOAs assigned to the partition (see
<xref linkend="LoPAR.DeviceTree" /> for details).</para> <xref linkend="dbdoclet.50569368_91814" /> for details).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -1252,7 +1252,7 @@ hcall ( const int64 H_VIO_SIGNAL, /* Function Code */
<listitem> <listitem>
<para><emphasis role="bold">For all VIO options:</emphasis> The platform must assign an <para><emphasis role="bold">For all VIO options:</emphasis> The platform must assign an
invariant virtual location code to each virtual IOA as described in invariant virtual location code to each virtual IOA as described in
<xref linkend="LoPAR.Platform" />. <xref linkend="dbdoclet.50569341_32742" />.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -3326,7 +3326,7 @@ hcall ( const unit64 H_VIOCTL, /* Query/Set behaviors for the virtual IOA */
<para>Transfer into registers R4 (High order 8 bytes) and R5 (low order <para>Transfer into registers R4 (High order 8 bytes) and R5 (low order
8 bytes) of the UUID of the client partition that owns the virtual device 8 bytes) of the UUID of the client partition that owns the virtual device
( (
<xref linkend="LoPAR.DeviceTree" /> for the format of the UUID string.</para> <xref linkend="dbdoclet.50569332_20419" /> for the format of the UUID string.</para>
</listitem> </listitem>


<listitem> <listitem>
@ -8852,7 +8852,7 @@ hcall ( const int64 H_SEND_SUB_CRQ, /* Function Code */
<para>Property name specifying the unique and persistent <para>Property name specifying the unique and persistent
location code associated with this virtual IOA, the value shall location code associated with this virtual IOA, the value shall
be of the form defined in be of the form defined in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -9108,7 +9108,7 @@ hcall ( const int64 H_SEND_SUB_CRQ, /* Function Code */
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -9128,7 +9128,7 @@ hcall ( const int64 H_SEND_SUB_CRQ, /* Function Code */
format cannot be derived using the method described in the format cannot be derived using the method described in the
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
</tbody> </tbody>
@ -12455,7 +12455,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
encoded array as with encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the <emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the
form specified in form specified in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -12552,7 +12552,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -12572,7 +12572,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
format cannot be derived using the method described in the format cannot be derived using the method described in the
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
</tbody> </tbody>
@ -12750,7 +12750,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
encoded array as with encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the <emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the
form form
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -12872,7 +12872,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -12892,7 +12892,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
format cannot be derived using the method described in the format cannot be derived using the method described in the
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
</tbody> </tbody>
@ -13467,7 +13467,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
encoded array as with encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the <emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the
form specified in form specified in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -13720,7 +13720,7 @@ hcall ( const uint64 H_ILLAN_ATTRIBUTES,/* Returns in R4 the resulting ILLAN */
encoded array as with encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the <emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the
form form
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -15231,8 +15231,7 @@ hcall ( const uint64 H_FREE_VTERM, /* Break connection between server and partne
presented as an encoded array as with presented as an encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. <emphasis role="bold"><literal>encode-string</literal></emphasis>.
The value shall be of the form specified in The value shall be of the form specified in
<xref linkend="LoPAR.Platform" /> information on <xref linkend="dbdoclet.50569341_32742" />.</para>
Virtual Card Connector Location Codes.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -15317,7 +15316,7 @@ hcall ( const uint64 H_FREE_VTERM, /* Break connection between server and partne
the method described in the definition for the the method described in the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis>
property in property in
<xref linkend="LoPAR.DeviceTree" /> section on System Bindings.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -15336,7 +15335,7 @@ hcall ( const uint64 H_FREE_VTERM, /* Break connection between server and partne
the method described in the definition for the the method described in the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis>
property in property in
<xref linkend="LoPAR.DeviceTree" /> section on System Bindings.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
</tbody> </tbody>
@ -15542,8 +15541,7 @@ hcall ( const uint64 H_FREE_VTERM, /* Break connection between server and partne
presented as an encoded array as with presented as an encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. <emphasis role="bold"><literal>encode-string</literal></emphasis>.
The value shall be of the form specified in The value shall be of the form specified in
<xref linkend="LoPAR.Platform" /> information on <xref linkend="dbdoclet.50569341_32742" />.</para>
Virtual Card Connector Location Codes.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -15633,7 +15631,7 @@ hcall ( const uint64 H_FREE_VTERM, /* Break connection between server and partne
the method described in the definition for the the method described in the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis>
property in property in
<xref linkend="LoPAR.DeviceTree" /> section on System Bindings.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -15652,7 +15650,7 @@ hcall ( const uint64 H_FREE_VTERM, /* Break connection between server and partne
the method described in the definition for the the method described in the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis>
property in property in
<xref linkend="LoPAR.DeviceTree" /> section on System Bindings.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
</tbody> </tbody>
@ -18503,8 +18501,7 @@ able 252‚ “VASI Reliable CRQ Response Status Values‚” on page 721.
presented as an encoded array as with presented as an encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. <emphasis role="bold"><literal>encode-string</literal></emphasis>.
The value shall be of the form specified in The value shall be of the form specified in
<xref linkend="LoPAR.Platform" /> information on <xref linkend="dbdoclet.50569341_32742" />.</para>
Virtual Card Connector Location Codes.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -20749,7 +20746,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
encoded array as with encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the <emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the
form specified in form specified in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -20846,7 +20843,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -20866,7 +20863,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
format cannot be derived using the method described in the format cannot be derived using the method described in the
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -21101,7 +21098,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
encoded array as with encoded array as with
<emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the <emphasis role="bold"><literal>encode-string</literal></emphasis>. The value shall be of the
form form
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569341_32742" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -21223,7 +21220,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -21243,7 +21240,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
format cannot be derived using the method described in the format cannot be derived using the method described in the
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -21717,7 +21714,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -21740,7 +21737,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
format cannot be derived using the method described in the format cannot be derived using the method described in the
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -22208,7 +22205,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
using the method described in the definition for the using the method described in the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-address-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -22229,7 +22226,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
definition for the definition for the
<emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property <emphasis role="bold"><literal>&#8220;ibm,#dma-size-cells&#8221;</literal></emphasis> property
in in
<xref linkend="LoPAR.DeviceTree" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -22270,7 +22267,7 @@ hcall ( const uint64 H_VASI_STATE, /* Return the state of the VASI service */
</entry> </entry>
<entry> <entry>
<para>Vendor unique property name indicating ranges of the client program virtual address space that are used by the virtual device serving partition adjunct. <para>Vendor unique property name indicating ranges of the client program virtual address space that are used by the virtual device serving partition adjunct.
See <xref linkend="LoPAR.DeviceTree" /> information about the children See <xref linkend="dbdoclet.50569368_26956" /> information about the children
of the <literal>/vdevice</literal> node.</para> of the <literal>/vdevice</literal> node.</para>
</entry> </entry>
</row> </row>

137
LoPAR/sec_rtas_call_defn.xml
Unescape Escape View File

@ -33,7 +33,7 @@
to hold OF options, RTAS information, machine configuration state, OS to hold OF options, RTAS information, machine configuration state, OS
state, diagnostic logs, etc. The type and size of NVRAM is specified in state, diagnostic logs, etc. The type and size of NVRAM is specified in
the OF device tree. The format of NVRAM is detailed in the OF device tree. The format of NVRAM is detailed in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569333_15433" />.</para>
<para>In order to give the OS the ability to access <para>In order to give the OS the ability to access
NVRAM on NVRAM on
different platforms that may use different implementations or locations different platforms that may use different implementations or locations
@ -346,7 +346,7 @@
<para>The caller of the <para>The caller of the
<emphasis>nvram-store</emphasis> RTAS call must maintain the NVRAM <emphasis>nvram-store</emphasis> RTAS call must maintain the NVRAM
partitions as specified in partitions as specified in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569333_15433" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -362,7 +362,7 @@
clock which maintains the time of day even if power to the machine is clock which maintains the time of day even if power to the machine is
removed. Minimum requirements for this clock are described in Requirement removed. Minimum requirements for this clock are described in Requirement


<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569327_71913" />.</para>


<section xml:id="sec_TOD"> <section xml:id="sec_TOD">
<title>Time of Day Inputs/Outputs</title> <title>Time of Day Inputs/Outputs</title>
@ -785,7 +785,7 @@
<para><emphasis role="bold">Software Implementation Note:</emphasis> The OS maintains the clock in UTC. <para><emphasis role="bold">Software Implementation Note:</emphasis> The OS maintains the clock in UTC.
This allows the OS and diagnostics to co-exist with each other and This allows the OS and diagnostics to co-exist with each other and
provide uniform handling of time. Refer to Requirement provide uniform handling of time. Refer to Requirement
<xref linkend="LoPAR.Platform" /> for further details on the time <xref linkend="dbdoclet.50569327_71913" /> for further details on the time
of day clock.</para> of day clock.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1232,7 +1232,7 @@
<listitem> <listitem>
<para>The <emphasis>event-scan</emphasis> call must fill in the error log with a <para>The <emphasis>event-scan</emphasis> call must fill in the error log with a
single error log formatted as specified in single error log formatted as specified in
<xref linkend="LoPAR.Error" />. If necessary, the data placed <xref linkend="dbdoclet.50569337_22801" />. If necessary, the data placed
into the error log must be truncated to into the error log must be truncated to
<emphasis>length</emphasis> bytes.</para> <emphasis>length</emphasis> bytes.</para>
</listitem> </listitem>
@ -1246,7 +1246,7 @@
that are within the classes defined by the that are within the classes defined by the
<emphasis>Event mask. Event mask</emphasis> is a bit mask of error and <emphasis>Event mask. Event mask</emphasis> is a bit mask of error and
event classes. Refer to event classes. Refer to
<xref linkend="LoPAR.Error" /> for the definition of the bit <xref linkend="dbdoclet.50569337_82470" /> for the definition of the bit
positions.</para> positions.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1602,7 +1602,7 @@
<listitem> <listitem>
<para>The <emphasis>check-exception</emphasis> call must fill in the error log with <para>The <emphasis>check-exception</emphasis> call must fill in the error log with
a single error log formatted as specified in a single error log formatted as specified in
<xref linkend="LoPAR.Error" />. The data in the error log <xref linkend="dbdoclet.50569337_22801" />. The data in the error log
must be truncated to must be truncated to
<emphasis>length</emphasis> bytes.</para> <emphasis>length</emphasis> bytes.</para>
</listitem> </listitem>
@ -1636,7 +1636,7 @@
that are within the classes defined by the that are within the classes defined by the
<emphasis>Event mask. Event mask</emphasis> is a bit mask of error and <emphasis>Event mask. Event mask</emphasis> is a bit mask of error and
event classes. Refer to event classes. Refer to
<xref linkend="LoPAR.Error" /> for the definition of the bit <xref linkend="dbdoclet.50569337_82470" /> for the definition of the bit
positions.</para> positions.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1655,7 +1655,7 @@
<para>The <para>The
<emphasis>interrupt number</emphasis> for external device interrupts is <emphasis>interrupt number</emphasis> for external device interrupts is
provided in the OF device tree as specified in provided in the OF device tree as specified in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569368_91814" />.</para>
</listitem> </listitem>


<listitem> <listitem>
@ -1789,7 +1789,7 @@
<listitem> <listitem>
<para>The <emphasis>rtas-last-error</emphasis> call must fill in the error log with <para>The <emphasis>rtas-last-error</emphasis> call must fill in the error log with
a single error log formatted as specified in a single error log formatted as specified in
<xref linkend="LoPAR.Error" />. If necessary, the data placed <xref linkend="dbdoclet.50569337_22801" />. If necessary, the data placed
into the error log must be truncated to &#8216;length&#8221; into the error log must be truncated to &#8216;length&#8221;
bytes.</para> bytes.</para>
</listitem> </listitem>
@ -2689,7 +2689,7 @@
<para>Device drivers and system software need access to <para>Device drivers and system software need access to
PCI PCI
configuration space. configuration space.
<xref linkend="LoPAR.Platform" /> section on "Address Map" defines <xref linkend="dbdoclet.50569328_Address-Map" /> defines
system address spaces for PCI memory and PCI I/O spaces. It does not system address spaces for PCI memory and PCI I/O spaces. It does not
define an address space for PCI configuration. Different PCI bridges may define an address space for PCI configuration. Different PCI bridges may
implement the mechanisms for accessing PCI configuration space in implement the mechanisms for accessing PCI configuration space in
@ -2842,7 +2842,7 @@
xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-3.</emphasis></term>
<listitem> <listitem>
<para>RTAS must follow the rules of <para>RTAS must follow the rules of
<xref linkend="LoPAR.Platform" /> when accessing PCI <xref linkend="dbdoclet.50569330_49381" /> when accessing PCI
configuration space.</para> configuration space.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -2866,7 +2866,7 @@
PCI-X Mode 2 and PCI Express devices, an IOA device driver is responsible PCI-X Mode 2 and PCI Express devices, an IOA device driver is responsible
for checking if the for checking if the
<emphasis role="bold"><literal>&#8220;ibm,pci-config-space-type&#8221;</literal></emphasis> property (see <emphasis role="bold"><literal>&#8220;ibm,pci-config-space-type&#8221;</literal></emphasis> property (see
<xref linkend="LoPAR.DeviceTree" />) of the IOA's node exists and <xref linkend="dbdoclet.50569368_43390" />) of the IOA's node exists and
is set to a non-zero value.</para> is set to a non-zero value.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
@ -3677,7 +3677,7 @@
control characters carriage-return (CR) (0x0D) and line-feed (LF) control characters carriage-return (CR) (0x0D) and line-feed (LF)
(0x0A).</para> (0x0A).</para>
<para>The following OF properties are defined in <para>The following OF properties are defined in
<xref linkend="LoPAR.DeviceTree" />:</para> <xref linkend="dbdoclet.50569368_41461" />:</para>


<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -4993,7 +4993,7 @@
</entry> </entry>
<entry> <entry>
<para>When tone is required. See Requirement <para>When tone is required. See Requirement
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569327_91037" />.</para>
</entry> </entry>
<entry> <entry>
<para>ibm</para> <para>ibm</para>
@ -5023,7 +5023,7 @@
</entry> </entry>
<entry> <entry>
<para>When tone is required. See Requirement <para>When tone is required. See Requirement
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569327_91037" />.</para>
</entry> </entry>
<entry> <entry>
<para>ibm</para> <para>ibm</para>
@ -5170,7 +5170,7 @@
<para>Isolate refers to the DR action to logically disconnect <para>Isolate refers to the DR action to logically disconnect
from the platform and/or OS (for example, for PCI, isolate from from the platform and/or OS (for example, for PCI, isolate from
the bus and from the OS). See the bus and from the OS). See
<xref linkend="LoPAR.Virtualization" /> for more <xref linkend="dbdoclet.50569342_61130" /> for more
details.</para> details.</para>
</entry> </entry>
</row> </row>
@ -5206,8 +5206,8 @@
or just an Identify/Action indicator. Identify and Action may or just an Identify/Action indicator. Identify and Action may
map to the same visual state (for example, the same blink map to the same visual state (for example, the same blink
rate). See rate). See
<xref linkend="LoPAR.Error" /> and <xref linkend="dbdoclet.50569347_31867" /> and
<xref linkend="LoPAR.Virtualization" /> for more <xref linkend="dbdoclet.50569342_42695" /> for more
information.</para> information.</para>
</entry> </entry>
</row> </row>
@ -5240,7 +5240,7 @@
<para>Allows an OS image to assign (usable, exchange, or <para>Allows an OS image to assign (usable, exchange, or
recover) resources from the firmware or, release resources from recover) resources from the firmware or, release resources from
the OS to the firmware. See the OS to the firmware. See
<xref linkend="LoPAR.Virtualization" /> for more <xref linkend="dbdoclet.50569342_61130" /> for more
details.</para> details.</para>
</entry> </entry>
</row> </row>
@ -5321,7 +5321,7 @@
<entry> <entry>
<para>Yes</para> <para>Yes</para>
<para>See <para>See
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
<entry> <entry>
<para>ibm</para> <para>ibm</para>
@ -5335,8 +5335,8 @@
system or a partition requires operator intervention for system or a partition requires operator intervention for
another reason. The Error Log indicator is located only on the another reason. The Error Log indicator is located only on the
Primary Enclosure. See Primary Enclosure. See
<xref linkend="LoPAR.Error" /> and <xref linkend="dbdoclet.50569347_31867" /> and
<xref linkend="LoPAR.Virtualization" /> for more <xref linkend="dbdoclet.50569342_42695" /> for more
information.</para> information.</para>
</entry> </entry>
</row> </row>
@ -5360,7 +5360,7 @@
<entry> <entry>
<para>Yes</para> <para>Yes</para>
<para>See <para>See
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
<entry> <entry>
<para>ibm</para> <para>ibm</para>
@ -5377,8 +5377,8 @@
protect against the use of multiple 9007 indicators protect against the use of multiple 9007 indicators
simultaneously or multiple uses of the same 9007 indicator simultaneously or multiple uses of the same 9007 indicator
simultaneously. See simultaneously. See
<xref linkend="LoPAR.Error" /> and <xref linkend="dbdoclet.50569347_31867" /> and
<xref linkend="LoPAR.Virtualization" /> for more <xref linkend="dbdoclet.50569342_42695" /> for more
information.</para> information.</para>
</entry> </entry>
</row> </row>
@ -5696,8 +5696,7 @@
<para>-1: Hardware Error</para> <para>-1: Hardware Error</para>
<para>-2: Hardware Busy, Try again later</para> <para>-2: Hardware Busy, Try again later</para>
<para>-3: No such sensor implemented</para> <para>-3: No such sensor implemented</para>
<para>-9000: DR Entity isolated ( <para>-9000: DR Entity isolated (<xref linkend="dbdoclet.50569342_75822" />)</para>
<xref linkend="LoPAR.Virtualization" />)</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -5774,7 +5773,7 @@
<listitem> <listitem>
<para>Critical High - The sensor value is greater than or equal to this <para>Critical High - The sensor value is greater than or equal to this
limit. The platform may take some action and may initiate an EPOW (see limit. The platform may take some action and may initiate an EPOW (see
<xref linkend="LoPAR.Error" />). The OS may take some action <xref linkend="dbdoclet.50569337_17513" />). The OS may take some action
to correct this situation or to perform an orderly shutdown.</para> to correct this situation or to perform an orderly shutdown.</para>
</listitem> </listitem>


@ -6260,8 +6259,8 @@
<para>Used in Dynamic Reconfiguration operations to determine <para>Used in Dynamic Reconfiguration operations to determine
if connector is available and whether the user performed a if connector is available and whether the user performed a
particular DR operation correctly. See particular DR operation correctly. See
<xref linkend="LoPAR.Virtualization" /> and <xref linkend="dbdoclet.50569342_75822" /> and
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569342_85040" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -6331,7 +6330,7 @@
<entry> <entry>
<para>Yes</para> <para>Yes</para>
<para>See <para>See
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
<entry> <entry>
<para>ibm</para> <para>ibm</para>
@ -6359,7 +6358,7 @@
<entry> <entry>
<para>Yes</para> <para>Yes</para>
<para>See <para>See
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569347_31867" />.</para>
</entry> </entry>
<entry> <entry>
<para>ibm</para> <para>ibm</para>
@ -6743,7 +6742,7 @@
sensor. For example, the first entry of sensor. For example, the first entry of
<emphasis role="bold"><literal>&#8220;ibm,sensor-9001&#8221;</literal></emphasis> contains the location <emphasis role="bold"><literal>&#8220;ibm,sensor-9001&#8221;</literal></emphasis> contains the location
code for fan#1. Location codes are shown in code for fan#1. Location codes are shown in
<xref linkend="LoPAR.Platform" />. Of course, since it is an <xref linkend="dbdoclet.50569341_35066" />. Of course, since it is an
abstracted sensor, the entry for abstracted sensor, the entry for
<emphasis role="bold"><literal>&#8220;ibm,sensor-9000&#8221;</literal></emphasis> is NULL.</para> <emphasis role="bold"><literal>&#8220;ibm,sensor-9000&#8221;</literal></emphasis> is NULL.</para>
</section> </section>
@ -6853,7 +6852,7 @@
property property
<emphasis role="bold"><literal>&#8220;ibm,environmental-sensors&#8221;</literal></emphasis> in the <emphasis role="bold"><literal>&#8220;ibm,environmental-sensors&#8221;</literal></emphasis> in the
<emphasis role="bold"><literal>/rtas</literal></emphasis> node (see <emphasis role="bold"><literal>/rtas</literal></emphasis> node (see
<xref linkend="LoPAR.DeviceTree" />).</para> <xref linkend="dbdoclet.50569368_41461" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -7749,7 +7748,7 @@
under a UPS would be given by the platform as an EPOW event with EPOW under a UPS would be given by the platform as an EPOW event with EPOW
event modifier being given as, 0x02 = Loss of utility power, system is event modifier being given as, 0x02 = Loss of utility power, system is
running on UPS/Battery, as described in section running on UPS/Battery, as described in section
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569337_81250" />.</para>
</listitem> </listitem>


<listitem> <listitem>
@ -7786,7 +7785,7 @@
<emphasis>system-reboot</emphasis> call which resets all processors and <emphasis>system-reboot</emphasis> call which resets all processors and
all attached devices. After reset, the system must be booted with the all attached devices. After reset, the system must be booted with the
current settings of the System Environment Variables (refer to current settings of the System Environment Variables (refer to
<xref linkend="LoPAR.Platform" /> for more information).</para> <xref linkend="dbdoclet.50569333_25869" /> for more information).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -7894,7 +7893,7 @@
in this section. It does not return to the OS if successful. This call in this section. It does not return to the OS if successful. This call
supports RTAS instantiated in 32 bit mode to access storage at addresses supports RTAS instantiated in 32 bit mode to access storage at addresses
above 4GB. In an exception to the LPAR Requirement above 4GB. In an exception to the LPAR Requirement
<xref linkend="LoPAR.Virtualization" /> this call supports block lists <xref linkend="dbdoclet.50569344_48079" /> this call supports block lists
being outside of the Real Mode Area (RMA) as long as the initial block being outside of the Real Mode Area (RMA) as long as the initial block
list is at an address below the limits of the cell size of the list is at an address below the limits of the cell size of the
<emphasis>Block_list</emphasis> argument.</para> <emphasis>Block_list</emphasis> argument.</para>
@ -8213,7 +8212,7 @@
<title>Flash Update with Discontiguous Block Lists</title> <title>Flash Update with Discontiguous Block Lists</title>
<para>The property <para>The property
<emphasis role="bold"><literal>&#8220;ibm,flash-block-version&#8221;</literal></emphasis> (see <emphasis role="bold"><literal>&#8220;ibm,flash-block-version&#8221;</literal></emphasis> (see
<xref linkend="LoPAR.DeviceTree" />) is defined to describe the <xref linkend="dbdoclet.50569368_41461" />) is defined to describe the
following definition and operation of the following definition and operation of the
<emphasis>Block_list</emphasis> shown in <emphasis>Block_list</emphasis> shown in
<xref linkend="dbdoclet.50569332_71043" />.</para> <xref linkend="dbdoclet.50569332_71043" />.</para>
@ -9014,7 +9013,7 @@
xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term>
<listitem> <listitem>
<para><emphasis>(Merged into Requirement <para><emphasis>(Merged into Requirement
<xref linkend="LoPAR.Platform" />)</emphasis></para> <xref linkend="dbdoclet.50569340_88608" />)</emphasis></para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -9023,7 +9022,7 @@
xrefstyle="select: labelnumber nopage"/>-2.</emphasis></term> xrefstyle="select: labelnumber nopage"/>-2.</emphasis></term>
<listitem> <listitem>
<para><emphasis>(Merged into Requirement <para><emphasis>(Merged into Requirement
<xref linkend="LoPAR.Platform" />)</emphasis></para> <xref linkend="dbdoclet.50569340_88608" />)</emphasis></para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -9363,7 +9362,7 @@


<para> <para>
<emphasis role="bold">Note:</emphasis> Requirement <emphasis role="bold">Note:</emphasis> Requirement
<xref linkend="LoPAR.Platform" /> applies to the start-cpu RTAS <xref linkend="dbdoclet.50569329_35915" /> applies to the start-cpu RTAS
call. At the completion of start-cpu, the caches to be used by the call. At the completion of start-cpu, the caches to be used by the
specified processor must have been initialized and the state bits made specified processor must have been initialized and the state bits made
accurate prior to beginning execution at the start address.</para> accurate prior to beginning execution at the start address.</para>
@ -10593,7 +10592,7 @@
favored level by firmware at boot), of the External Interrupt Vector favored level by firmware at boot), of the External Interrupt Vector
Entry associated with the interrupt number provided as an input argument Entry associated with the interrupt number provided as an input argument
unless prevented by Requirement unless prevented by Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_75733" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -10789,7 +10788,7 @@
<emphasis>ibm,int-on</emphasis> call since boot), associated with the <emphasis>ibm,int-on</emphasis> call since boot), associated with the
interrupt number provided as an input argument unless prevented by interrupt number provided as an input argument unless prevented by
Requirement Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_35543" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -10978,7 +10977,7 @@
<emphasis>ibm,int-off</emphasis> call must disable interrupts from the <emphasis>ibm,int-off</emphasis> call must disable interrupts from the
interrupt source associated with the interrupt number provided as an interrupt source associated with the interrupt number provided as an
input argument unless prevented by Requirement input argument unless prevented by Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_77100" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -10997,7 +10996,7 @@
<emphasis>ibm,get-xive</emphasis> call and set the priority value of the <emphasis>ibm,get-xive</emphasis> call and set the priority value of the
XIVE to the least favored priority value (0xFF), unless prevented by XIVE to the least favored priority value (0xFF), unless prevented by
Requirement Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_77100" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -11150,7 +11149,7 @@
<emphasis>ibm,int-on</emphasis> call must enable interrupts from the <emphasis>ibm,int-on</emphasis> call must enable interrupts from the
interrupt source associated with the interrupt number provided as an interrupt source associated with the interrupt number provided as an
input argument unless prevented by Requirement input argument unless prevented by Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_77846" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -11167,7 +11166,7 @@
saved by the previous saved by the previous
<emphasis>ibm,int-off</emphasis> call (initialized by the firmware to the <emphasis>ibm,int-off</emphasis> call (initialized by the firmware to the
least favored level at boot) unless prevented by Requirement least favored level at boot) unless prevented by Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_77100" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -11280,7 +11279,7 @@
<title>MSI Support</title> <title>MSI Support</title>
<para>This section describes the RTAS calls required when the MSI option <para>This section describes the RTAS calls required when the MSI option
is implemented. See is implemented. See
<xref linkend="LoPAR.Platform" /> for other platform requirements <xref linkend="dbdoclet.50569331_33067" /> for other platform requirements
for the MSI option.</para> for the MSI option.</para>
<para>The Message Signaled Interrupt (MSI) and Enhanced MSI (MSI-X) <para>The Message Signaled Interrupt (MSI) and Enhanced MSI (MSI-X)
capability of PCI IOAs in many cases allows for greater flexibility in capability of PCI IOAs in many cases allows for greater flexibility in
@ -11371,7 +11370,7 @@
interrupts from the IOA function. It is permissible to use LSI, MSI and interrupts from the IOA function. It is permissible to use LSI, MSI and
MSI-X on different IOA functions.</para> MSI-X on different IOA functions.</para>
<para>The default (initial) assignment of interrupts is defined in <para>The default (initial) assignment of interrupts is defined in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569331_33067" />.</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -11818,7 +11817,7 @@


<listitem> <listitem>
<para>MSIs and MSI source numbers are not shared (see Requirement <para>MSIs and MSI source numbers are not shared (see Requirement
<xref linkend="LoPAR.Platform" />).</para> <xref linkend="dbdoclet.50569331_84312" />).</para>
</listitem> </listitem>


<listitem> <listitem>
@ -11859,8 +11858,7 @@
<listitem> <listitem>
<para>The platform will return a status -2 or 990x only when the OS <para>The platform will return a status -2 or 990x only when the OS
indicates support. The OS indicates support via ibm,client-architecture-support, indicates support. The OS indicates support via ibm,client-architecture-support,
vector 4. See <xref linkend="LoPAR.DeviceTree" /> section on "Root Node Methods" vector 4. See <xref linkend="dbdoclet.50569368_13649" />.</para>
for more information.</para>
</listitem> </listitem>
</orderedlist> </orderedlist>


@ -12121,7 +12119,7 @@
order to be able to test device driver code that implements recovery order to be able to test device driver code that implements recovery
based on the EEH option.</para> based on the EEH option.</para>
<para>See also, <para>See also,
<xref linkend="LoPAR.Platform" />, for additional information <xref linkend="dbdoclet.50569381_46906" />, for additional information
about implementing EEH error recovery.</para> about implementing EEH error recovery.</para>


<variablelist> <variablelist>
@ -13212,15 +13210,14 @@
</tgroup> </tgroup>
</table> </table>


<para>The PE configuration address ( <para>The PE configuration address (<emphasis>PHB_Unit_ID_Hi, PHB_Unit_ID_Low, and config_addr</emphasis>)
<emphasis>PHB_Unit_ID_Hi, PHB_Unit_ID_Low, and config_addr</emphasis>)
for the domain is the PCI configuration address for the PE primary bus for the domain is the PCI configuration address for the PE primary bus
and is the same format as used for the ibm,read-pci-config and and is the same format as used for the ibm,read-pci-config and
ibm,write-pci-config calls (see Requirement ibm,write-pci-config calls (see Requirement
<xref linkend="dbdoclet.50569332_13648" />), except that the Register <xref linkend="dbdoclet.50569332_13648" />), except that the Register
field is set to 0. The PE configuration address is obtained as indicated field is set to 0. The PE configuration address is obtained as indicated
in in
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569330_40070" />.</para>


<section xml:id="dbdoclet.50569332_27269"> <section xml:id="dbdoclet.50569332_27269">
<title><emphasis>ibm,set-eeh-option</emphasis></title> <title><emphasis>ibm,set-eeh-option</emphasis></title>
@ -13386,7 +13383,7 @@
<emphasis>ibm,set-eeh-option Function</emphasis> 1 (enable EEH) is still <emphasis>ibm,set-eeh-option Function</emphasis> 1 (enable EEH) is still
required as a signalling method from the device driver to the platform required as a signalling method from the device driver to the platform
that the device driver is at least EEH aware (see Requirement that the device driver is at least EEH aware (see Requirement
<xref linkend="LoPAR.Platform" />).</para> <xref linkend="dbdoclet.50569330_49770" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -13910,7 +13907,7 @@
that call can be used instead of this one to determine the PE that call can be used instead of this one to determine the PE
configuration address. See configuration address. See
<xref linkend="dbdoclet.50569332_68098" /> and <xref linkend="dbdoclet.50569332_68098" /> and
<xref linkend="LoPAR.Platform" />.</para> <xref linkend="dbdoclet.50569330_40070" />.</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -13986,7 +13983,7 @@
&#8220;ibm,read-slot-reset-state-functions&#8221;</literal></emphasis> property &#8220;ibm,read-slot-reset-state-functions&#8221;</literal></emphasis> property
in the in the
<emphasis>RTAS</emphasis> node of the device tree ( <emphasis>RTAS</emphasis> node of the device tree (
<xref linkend="LoPAR.DeviceTree" />).</para> <xref linkend="dbdoclet.50569368_41461" />).</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -14345,7 +14342,7 @@


<para>This call is used obtain information about fabric configuration <para>This call is used obtain information about fabric configuration
addresses, given the PCI configuration address. See addresses, given the PCI configuration address. See
<xref linkend="LoPAR.Platform" /> for more information on PEs and <xref linkend="dbdoclet.50569330_34831" /> for more information on PEs and
determining PE configuration addresses.</para> determining PE configuration addresses.</para>
<para>The PCI configuration address ( <para>The PCI configuration address (
<emphasis>PHB_Unit_ID_Hi, PHB_Unit_ID_Low, and config_addr</emphasis>) <emphasis>PHB_Unit_ID_Hi, PHB_Unit_ID_Low, and config_addr</emphasis>)
@ -14617,7 +14614,7 @@
log version used, the data in the log version used, the data in the
<emphasis>Returned_Error_Buffer</emphasis> is in an extended log format as <emphasis>Returned_Error_Buffer</emphasis> is in an extended log format as
defined in defined in
<xref linkend="LoPAR.Error" />. When the call returns data <xref linkend="dbdoclet.50569337_22801" />. When the call returns data
for version 6 or greater, the device driver error buffer data is included for version 6 or greater, the device driver error buffer data is included
as the last User Data section. The device driver data in the return as the last User Data section. The device driver data in the return
buffer may be truncated from what is passed by the device driver or buffer may be truncated from what is passed by the device driver or
@ -14932,7 +14929,7 @@
<emphasis>Device_Driver_Error_Buffer_Length</emphasis> argument is <emphasis>Device_Driver_Error_Buffer_Length</emphasis> argument is
non-zero, indicating the existence of optional device driver error data, non-zero, indicating the existence of optional device driver error data,
the referenced buffer must contain an extended event log as defined in the referenced buffer must contain an extended event log as defined in
<xref linkend="LoPAR.Error" />.</para> <xref linkend="dbdoclet.50569337_22801" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -16023,7 +16020,7 @@
device driver or OS from the restoration of non-interrupts the PCI device driver or OS from the restoration of non-interrupts the PCI
configuration space for changes that were made to the configuration space configuration space for changes that were made to the configuration space
after boot (see Requirement after boot (see Requirement
<xref linkend="LoPAR.Platform" />).</para> <xref linkend="dbdoclet.50569335_13568" />).</para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</listitem> </listitem>
@ -16596,7 +16593,7 @@
<emphasis role="bold"><literal>&#8220;ibm,errinjct-tokens&#8221;</literal></emphasis> property as defined <emphasis role="bold"><literal>&#8220;ibm,errinjct-tokens&#8221;</literal></emphasis> property as defined
below in the below in the
<emphasis role="bold"><literal>/rtas</literal></emphasis> node (see <emphasis role="bold"><literal>/rtas</literal></emphasis> node (see
<xref linkend="LoPAR.DeviceTree" />) of the OF device tree with a <xref linkend="dbdoclet.50569368_41461" />) of the OF device tree with a
specification for each implemented error injection class.</para> specification for each implemented error injection class.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -17173,7 +17170,7 @@
<para>For PHB implementations that do not allow injection of <para>For PHB implementations that do not allow injection of
a TLP ECRC error into the request, or for the case where the a TLP ECRC error into the request, or for the case where the
injection would be in violation of Requirement injection would be in violation of Requirement
<xref linkend="LoPAR.Platform" /> due to the hardware <xref linkend="dbdoclet.50569330_20501" /> due to the hardware
configuration, the platform should emulate the error by configuration, the platform should emulate the error by
setting the appropriate error state in the PHB when EEH is setting the appropriate error state in the PHB when EEH is
enabled.</para> enabled.</para>
@ -17486,7 +17483,7 @@
should the hardware signal a machine check or system reset interrupt. The should the hardware signal a machine check or system reset interrupt. The
results of an error analysis are reported via a standard error log results of an error analysis are reported via a standard error log
structure as defined in structure as defined in
<xref linkend="LoPAR.Error" />. The storage containing the <xref linkend="dbdoclet.50569337_21249" />. The storage containing the
error log structure is subsequently released back to firmware use by the error log structure is subsequently released back to firmware use by the
OS after it has completed its event handling by the issuance, from the OS after it has completed its event handling by the issuance, from the
interrupted processor, of the interrupted processor, of the
@ -17819,7 +17816,7 @@
contains the real address of a 16 byte memory buffer containing the contains the real address of a 16 byte memory buffer containing the
original contents of GPR R3 in the first 8 bytes and the RTAS Error Log original contents of GPR R3 in the first 8 bytes and the RTAS Error Log
(fixed part) (per (fixed part) (per
<xref linkend="LoPAR.Error" />) in the second 8 bytes.</para> <xref linkend="dbdoclet.50569337_21249" />) in the second 8 bytes.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -17841,7 +17838,7 @@
<para><emphasis role="bold">For the FWNMI option:</emphasis> Once the firmware has reported <para><emphasis role="bold">For the FWNMI option:</emphasis> Once the firmware has reported
a &#8220;fatal&#8221; machine check event to an OS image it must only a &#8220;fatal&#8221; machine check event to an OS image it must only
report &#8220;fatal error previously reported&#8221; (see report &#8220;fatal error previously reported&#8221; (see
<xref linkend="LoPAR.Error" />) in response to machine checks <xref linkend="dbdoclet.50569337_37595" />) in response to machine checks
on any processor belonging to that image.</para> on any processor belonging to that image.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -19012,7 +19009,7 @@
<listitem> <listitem>
<para>The format of the SPLPAR string is beyond the scope of this <para>The format of the SPLPAR string is beyond the scope of this
architecture. See also, architecture. See also,
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569367_15730" />.</para>
</listitem> </listitem>


<listitem> <listitem>

2
LoPAR/sec_rtas_dma_window.xml
Unescape Escape View File

@ -833,7 +833,7 @@
<para>Platforms supporting the DDW option implement extensions described <para>Platforms supporting the DDW option implement extensions described
in this section. These extensions include: adding the in this section. These extensions include: adding the
<emphasis role="bold"><literal>&#8220;ibm,ddw-extensions&#8221;</literal></emphasis> property see <emphasis role="bold"><literal>&#8220;ibm,ddw-extensions&#8221;</literal></emphasis> property see
<xref linkend="LoPAR.DeviceTree" /> to those nodes that include the <xref linkend="dbdoclet.50569368_69645" /> to those nodes that include the
<emphasis role="bold"><literal>&#8220;ibm,ddw-applicable&#8221;</literal></emphasis> property, and <emphasis role="bold"><literal>&#8220;ibm,ddw-applicable&#8221;</literal></emphasis> property, and
implementing the functional extensions specified for the architectural implementing the functional extensions specified for the architectural
level in level in

30
LoPAR/sec_rtas_environment.xml
Unescape Escape View File

@ -43,7 +43,7 @@
<para>If the LPAR option is enabled, multiple partitions may exist, each <para>If the LPAR option is enabled, multiple partitions may exist, each
with its own OS instance. This requires some changes to the RTAS with its own OS instance. This requires some changes to the RTAS
environment. These changes are discussed in environment. These changes are discussed in
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569344_14591" />.</para>


<section xml:id="sec_machine_state"> <section xml:id="sec_machine_state">
<title>Machine State</title> <title>Machine State</title>
@ -1059,7 +1059,7 @@
</entry> </entry>
<entry morerows="1"> <entry morerows="1">
<para>Required for DR operations (see <para>Required for DR operations (see
<xref linkend="LoPAR.Virtualization" />)</para> <xref linkend="dbdoclet.50569342_75822" />)</para>
</entry> </entry>
<entry> <entry>
<para>&#160;</para> <para>&#160;</para>
@ -1327,7 +1327,7 @@
<emphasis role="bold"><literal>&#8220;ibm,configure-connector&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;ibm,configure-connector&#8221;</literal></emphasis>
</para> </para>
<para> <para>
<xref linkend="LoPAR.Virtualization" /> <xref linkend="dbdoclet.50569342_39636" />
</para> </para>
</entry> </entry>
<entry> <entry>
@ -1335,7 +1335,7 @@
</entry> </entry>
<entry> <entry>
<para>See <para>See
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569342_75822" />.</para>
</entry> </entry>
</row> </row>
<row> <row>
@ -1546,7 +1546,7 @@
</entry> </entry>
<entry> <entry>
<para>Sometimes (see <para>Sometimes (see
<xref linkend="LoPAR.Error" />)</para> <xref linkend="dbdoclet.50569347_31867" />)</para>
</entry> </entry>
<entry> <entry>
<para>&#160;</para> <para>&#160;</para>
@ -1924,8 +1924,8 @@
(9003). DR indicators and sensors are required to be there based on the (9003). DR indicators and sensors are required to be there based on the
DR entity being supported. Their indices are specified by the DR index DR entity being supported. Their indices are specified by the DR index
for the DR entity. See for the DR entity. See
<xref linkend="LoPAR.Virtualization" /> and <xref linkend="dbdoclet.50569342_92542" /> and
<xref linkend="LoPAR.Virtualization" /> for more information.</para> <xref linkend="dbdoclet.50569342_34333" /> for more information.</para>
</footnote>are static since they represent the base hardware, others are </footnote>are static since they represent the base hardware, others are
dynamic coming and going with extensions to the base hardware. Indices dynamic coming and going with extensions to the base hardware. Indices
for DR indicators and sensors are obtained from the DRC index for the DRC for DR indicators and sensors are obtained from the DRC index for the DRC
@ -1964,7 +1964,7 @@
contiguous, and any of the indices between 0 and contiguous, and any of the indices between 0 and
<emphasis>maxindex</emphasis> may be missing.</para> <emphasis>maxindex</emphasis> may be missing.</para>
<para>The formats for location codes are defined in <para>The formats for location codes are defined in
<xref linkend="LoPAR.Platform" />. For indicators and sensors, <xref linkend="dbdoclet.50569341_35066" />. For indicators and sensors,
these location codes are for the location of the device being manipulated these location codes are for the location of the device being manipulated
or measured, not the location of the specific controller or sensor. The or measured, not the location of the specific controller or sensor. The
location code for an abstracted indicator or sensor is a NULL location code for an abstracted indicator or sensor is a NULL
@ -1985,9 +1985,9 @@
<para>For static indicators, except DR indicators, the extension <para>For static indicators, except DR indicators, the extension
property, property,
<emphasis role="bold"><literal>&#8220;</literal></emphasis><emphasis><literal>&lt;vendor&gt;</literal></emphasis><emphasis role="bold"><literal>,indicator-</literal></emphasis><emphasis><literal>&lt;token&gt;</literal></emphasis><emphasis role="bold"><literal>&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;</literal></emphasis><emphasis><literal>&lt;vendor&gt;</literal></emphasis><emphasis role="bold"><literal>,indicator-</literal></emphasis><emphasis><literal>&lt;token&gt;</literal></emphasis><emphasis role="bold"><literal>&#8221;</literal></emphasis>
(see <xref linkend="LoPAR.DeviceTree" />), provides an array of strings (see <xref linkend="dbdoclet.50569368_41461" />), provides an array of strings
containing the FRU location codes associated with each indicator. See containing the FRU location codes associated with each indicator. See
<xref linkend="LoPAR.Platform" />. Here, &#8220; <xref linkend="dbdoclet.50569341_35066" />. Here, &#8220;
<emphasis>&lt;vendor&gt;</emphasis>&#8221; corresponds to the <emphasis>&lt;vendor&gt;</emphasis>&#8221; corresponds to the
&#8220;&lt;vendor&gt;&#8221; column of &#8220;&lt;vendor&gt;&#8221; column of
<emphasis> <emphasis>
@ -2007,7 +2007,7 @@
<emphasis role="bold"><literal>/rtas</literal></emphasis> node.</para> <emphasis role="bold"><literal>/rtas</literal></emphasis> node.</para>
<para>Indices for DR indicators 9001, 9002, and 9003 are obtained from <para>Indices for DR indicators 9001, 9002, and 9003 are obtained from
the DRC index for the DRC connector. See Requirement the DRC index for the DRC connector. See Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569342_16260" />.</para>


<variablelist> <variablelist>
<varlistentry xml:id="dbdoclet.50569332_74895"> <varlistentry xml:id="dbdoclet.50569332_74895">
@ -2082,9 +2082,9 @@
platform provides.</para> platform provides.</para>
<para>For static sensors, except DR sensors, the extension property, <para>For static sensors, except DR sensors, the extension property,
<emphasis role="bold"><literal>&#8220;</literal></emphasis><emphasis><literal>&lt;vendor&gt;</literal></emphasis><emphasis role="bold"><literal>,sensor-</literal></emphasis><emphasis><literal>&lt;token&gt;</literal></emphasis><emphasis role="bold"><literal>&#8221;</literal></emphasis> <emphasis role="bold"><literal>&#8220;</literal></emphasis><emphasis><literal>&lt;vendor&gt;</literal></emphasis><emphasis role="bold"><literal>,sensor-</literal></emphasis><emphasis><literal>&lt;token&gt;</literal></emphasis><emphasis role="bold"><literal>&#8221;</literal></emphasis>
(see <xref linkend="LoPAR.DeviceTree" />), provides an array of strings (see <xref linkend="dbdoclet.50569368_41461" />), provides an array of strings
containing the FRU location codes associated with each sensor. See containing the FRU location codes associated with each sensor. See
<xref linkend="LoPAR.Platform" />. Here, &#8220; <xref linkend="dbdoclet.50569341_35066" />. Here, &#8220;
<emphasis>&lt;vendor&gt;</emphasis>&#8221; corresponds to the <emphasis>&lt;vendor&gt;</emphasis>&#8221; corresponds to the
&#8220;&lt;vendor&gt;&#8221; column of &#8220;&lt;vendor&gt;&#8221; column of
<emphasis> <emphasis>
@ -2102,7 +2102,7 @@
<emphasis role="bold"><literal>/rtas</literal></emphasis> node.</para> <emphasis role="bold"><literal>/rtas</literal></emphasis> node.</para>
<para>Indices for DR sensors 9003 are obtained from the DRC index for the <para>Indices for DR sensors 9003 are obtained from the DRC index for the
DRC connector. See Requirement DRC connector. See Requirement
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569342_43470" />.</para>


<variablelist> <variablelist>
<varlistentry xml:id="dbdoclet.50569332_29762"> <varlistentry xml:id="dbdoclet.50569332_29762">
@ -2493,7 +2493,7 @@
</entry> </entry>
<entry> <entry>
<para>Multi-level isolation error (see <para>Multi-level isolation error (see
<xref linkend="LoPAR.Virtualization" />).</para> <xref linkend="dbdoclet.50569342_11827" />).</para>
</entry> </entry>
</row> </row>
<row> <row>

4
LoPAR/sec_rtas_error_classes.xml
Unescape Escape View File

@ -36,8 +36,8 @@
OSs know which interrupts may be handled by calling OSs know which interrupts may be handled by calling
<emphasis>check-exception</emphasis>. The OF structure for describing these <emphasis>check-exception</emphasis>. The OF structure for describing these
interrupts is defined in interrupts is defined in
<xref linkend="LoPAR.DeviceTree"/>. <xref linkend="dbdoclet.50569368_91814"/>.
This document also defines the mask parameter for the <xref linkend="dbdoclet.50569337_82470"/> also defines the mask parameter for the


<emphasis>check-exception</emphasis> and <emphasis>check-exception</emphasis> and
<emphasis>event-scan</emphasis> RTAS functions which limits the search for <emphasis>event-scan</emphasis> RTAS functions which limits the search for

2
LoPAR/sec_rtas_error_reporting_location_codes.xml
Unescape Escape View File

@ -28,7 +28,7 @@
information to error logs returned by the information to error logs returned by the
<emphasis>event-scan</emphasis> and <emphasis>event-scan</emphasis> and
<emphasis>check-exception</emphasis> RTAS services. Refer to <emphasis>check-exception</emphasis> RTAS services. Refer to
<xref linkend="LoPAR.RTAS"/> for more information on the <xref linkend="dbdoclet.50569341_35066"/> for more information on the
format and use of location codes. For event logs with Version 6 or later, format and use of location codes. For event logs with Version 6 or later,
the location code of FRU call out is contained in the Primary SRC the location code of FRU call out is contained in the Primary SRC
section, FRU call out sub-section of the Platform Event Log section, FRU call out sub-section of the Platform Event Log

4
LoPAR/sec_rtas_get_indices.xml
Unescape Escape View File

@ -43,8 +43,8 @@
<para>This RTAS call is not used for DR indicators (9001, 9002, and 9003) <para>This RTAS call is not used for DR indicators (9001, 9002, and 9003)
or DR sensors (9003). See the following sections in the DR chapter for more or DR sensors (9003). See the following sections in the DR chapter for more
information: information:
<xref linkend="LoPAR.Virtualization" /> and <xref linkend="dbdoclet.50569342_85040" /> and
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569342_61130" />.</para>
<para>It may require several calls to the <para>It may require several calls to the
<emphasis>ibm,get-indices</emphasis> RTAS routine to get the entire list of <emphasis>ibm,get-indices</emphasis> RTAS routine to get the entire list of
indicators or sensors of a particular type. Each call may specify a indicators or sensors of a particular type. Each call may specify a

2
LoPAR/sec_rtas_hot_plug.xml
Unescape Escape View File

@ -29,7 +29,7 @@
<para>An OS that wants to be notified of hotplug events will need to <para>An OS that wants to be notified of hotplug events will need to
set the appropriate arch-vector bit. Look for the hot-plug-events set the appropriate arch-vector bit. Look for the hot-plug-events
node in the /event-sources node of the OF device tree (see node in the /event-sources node of the OF device tree (see
<xref linkend="LoPAR.DeviceTree" />), enable the interrupts listed <xref linkend="sec_papr_bindings_hot_plug_events" />), enable the interrupts listed
in its “interrupts” property and provide an interrupt handler to call in its “interrupts” property and provide an interrupt handler to call
check-exception when one of those interrupts are received.</para> check-exception when one of those interrupts are received.</para>



2
LoPAR/sec_rtas_manage_storage_preservation.xml
Unescape Escape View File

@ -25,7 +25,7 @@


<para>Platforms may optionally preserve selected regions of storage <para>Platforms may optionally preserve selected regions of storage
(LMBs) across client program boot cycles. (LMBs) across client program boot cycles.
<xref linkend="LoPAR.Platform" /> for more information.</para> <xref linkend="dbdoclet.50569327_70628" /> for more information.</para>


<variablelist> <variablelist>
<varlistentry> <varlistentry>

18
LoPAR/sec_rtas_suspend_me.xml
Unescape Escape View File

@ -28,14 +28,14 @@
part of OS hibernation or migration to another platform. This RTAS call part of OS hibernation or migration to another platform. This RTAS call
is made by the last active processor thread of a partition. The OS uses is made by the last active processor thread of a partition. The OS uses
the H_JOIN hcall() (see the H_JOIN hcall() (see
<xref linkend="LoPAR.Virtualization" />) to deactivate other <xref linkend="dbdoclet.50569344_15933" />) to deactivate other
processing threads. Processing treads may exit H_JOIN due to an processing threads. Processing treads may exit H_JOIN due to an
unmaskable interrupt; if a thread has exited H_JOIN, unmaskable interrupt; if a thread has exited H_JOIN,
<emphasis>ibm,suspend-me</emphasis> fails with a status of &#8220;multiple <emphasis>ibm,suspend-me</emphasis> fails with a status of &#8220;multiple
processor threads active&#8221;. The wake up from suspension is triggered processor threads active&#8221;. The wake up from suspension is triggered
by partition state change (see by partition state change (see
<xref linkend="LoPAR.Virtualization" /> sections on "Partition Migration" <xref linkend="sec_vasi_partition_migration" /> and
and "Partition Hibernation"). The <xref linkend="sec_vasi_partition_hibernation" />). The
<emphasis>ibm,suspend-me</emphasis> RTAS call returns only on the calling <emphasis>ibm,suspend-me</emphasis> RTAS call returns only on the calling
virtual processor. Other virtual processors that were inactive when virtual processor. Other virtual processors that were inactive when
<emphasis>ibm,suspend-me</emphasis> was called remain so until they are <emphasis>ibm,suspend-me</emphasis> was called remain so until they are
@ -50,7 +50,7 @@
<emphasis>ibm,update-properties</emphasis> (see <emphasis>ibm,update-properties</emphasis> (see
<xref linkend="dbdoclet.50569332_40069" />) and/or <xref linkend="dbdoclet.50569332_40069" />) and/or
<emphasis>ibm,configure-connector</emphasis> (see <emphasis>ibm,configure-connector</emphasis> (see
<xref linkend="LoPAR.Virtualization" />). Also during suspension, some <xref linkend="dbdoclet.50569342_39636" />). Also during suspension, some
system parameters may have changed. See system parameters may have changed. See
<xref linkend="dbdoclet.50569332_10519" />, for details. The OS may want <xref linkend="dbdoclet.50569332_10519" />, for details. The OS may want
to re-scan selected system parameters.</para> to re-scan selected system parameters.</para>
@ -62,7 +62,7 @@
<listitem> <listitem>
<para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform <para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform
must implement the Logical Partitioning option (see must implement the Logical Partitioning option (see
<xref linkend="LoPAR.Virtualization" />) <xref linkend="dbdoclet.50569344_14591" />)
<emphasis>.</emphasis></para> <emphasis>.</emphasis></para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -191,7 +191,7 @@
<listitem> <listitem>
<para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform <para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform
must implement the Thread Join option (see must implement the Thread Join option (see
<xref linkend="LoPAR.Virtualization" />).</para> <xref linkend="dbdoclet.50569344_90755" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -236,7 +236,7 @@
<para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform <para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform
must support the &#8220;Partner partition suspended&#8221; CRQ Transport must support the &#8220;Partner partition suspended&#8221; CRQ Transport
Event (See Event (See
<xref linkend="LoPAR.Virtualization" />).</para> <xref linkend="dbdoclet.50569348_93265" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -273,7 +273,7 @@
<para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform <para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform
must implement the H_ENABLE_CRQ hcall() using the syntax and semantics must implement the H_ENABLE_CRQ hcall() using the syntax and semantics
described in described in
<xref linkend="LoPAR.Virtualization" />.</para> <xref linkend="dbdoclet.50569348_43427" />.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>


@ -312,7 +312,7 @@
<listitem> <listitem>
<para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform <para><emphasis role="bold">For the Partition Suspension option:</emphasis> The platform
must implement the LRDR option (See must implement the LRDR option (See
<xref linkend="LoPAR.Virtualization" />).</para> <xref linkend="dbdoclet.50569342_75053" />).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>



2
LoPAR/sec_rtas_update_properties.xml
Unescape Escape View File

@ -903,7 +903,7 @@
<row> <row>
<entry> <entry>
<para>TLB properties (See <para>TLB properties (See
<xref linkend="LoPAR.DeviceTree" />)</para> <xref linkend="dbdoclet.50569374_58783" />)</para>
</entry> </entry>
</row> </row>
<row> <row>

Write Preview
Loading…
Cancel
Save