Tree cleanup: remove old directories for sub-docs.
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>pull/2/head
Jeff Scheel
4 years ago
parent
51a1657033
commit
4231cede14
@ -1,284 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<appendix xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
xml:id="dbdoclet.50569387_27251">
|
||||
<?dbhtml stop-chunking?>
|
||||
<title> Bibliography</title>
|
||||
<para>This section lists documents which were referenced in this specification or which provide
|
||||
additional information, and some useful information for obtaining these documents. Referenced
|
||||
documents are listed below. When any of the following standards are superseded by an approved
|
||||
revision, the revision shall apply.</para>
|
||||
<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>
|
||||
<para><citetitle>Power ISA</citetitle><anchor xml:id="dbdoclet.50569387_99718"
|
||||
xreflabel="Power ISA specification"/></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_45524"
|
||||
xreflabel="IEEE Open Firmware standard"/>
|
||||
<citetitle>IEEE 1275, IEEE Standard for Boot (Initialization Configuration) Firmware:
|
||||
Core Requirements and Practices</citetitle></para>
|
||||
<para>IEEE part number DS02683, ISBN 1-55937-426-8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_14175"
|
||||
xreflabel="IEEE Open Firmware Errata specification"/>
|
||||
<citetitle>Core Errata, IEEE P1275.7/D4</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_31707"
|
||||
xreflabel="Open Firmware TFTP extensions"/>
|
||||
<citetitle>Open Firmware Recommended Practice:OBP-TFTP
|
||||
Extension</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27008"
|
||||
xreflabel="Open Firmware Device Support Extensions specification"/>
|
||||
<citetitle>Open Firmware Recommended Practice: Device
|
||||
Support Extensions</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22451"
|
||||
xreflabel="PCI Bus Binding to Open Firmware standard"/>
|
||||
<citetitle>PCI Bus binding to: IEEE Std 1275-1994, Standard
|
||||
for Boot (Initialization, Configuration) Firmware</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_40740"
|
||||
xreflabel="Open Firmware Interrupt Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33384"
|
||||
xreflabel="Open Firmware Forth Source and FCode Image Support specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Forth Source
|
||||
and FCode Image Support</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_67880"
|
||||
xreflabel="Open Firmware Interrup Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33177"
|
||||
xreflabel="Open Firmware TFTP Booting extensions"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - TFTP Booting
|
||||
Extensions</citetitle>, Version 0.8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27351"
|
||||
xreflabel="Open Firmware Interposition specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice -
|
||||
Interposition</citetitle>, Version 0.2</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22601"
|
||||
xreflabel="MS-DOS Programmer's Reference specification"/>
|
||||
<citetitle>MS-DOS Programmer's Reference</citetitle></para>
|
||||
<para>Published by Microsoft</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_18190"
|
||||
xreflabel="Win32 Executable File Format article"/>
|
||||
<citetitle>Peering Inside the PE: A Tour of the Win32 Portable
|
||||
Executable File Format</citetitle></para>
|
||||
<para>Found in the March, 1994 issue of <citetitle> Microsoft Systems Journal</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_85757"
|
||||
xreflabel="CD-ROM Volume and File Structure standard"/>
|
||||
<citetitle> ISO-9660, Information processing -- Volume and
|
||||
file structure of CD-ROM for information interchange</citetitle></para>
|
||||
<para>Published by International Organization for Standardization</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38836"
|
||||
xreflabel="System V Application Binary Interface, PowerPC Processor supplement"/>
|
||||
<citetitle>System V Application Binary Interface, PowerPC
|
||||
Processor Supplement</citetitle></para>
|
||||
<para>By Sunsoft<citetitle></citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_11453"
|
||||
xreflabel="Standard Generalized Markup Language (SGML) standard"/>
|
||||
<citetitle>ISO Standard 8879:1986, Information Processing
|
||||
-- Text and Office Systems -- Standard Generalized Markup Language (SGML)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38891"
|
||||
xreflabel="Personal Computer Back Plane Bus standard"/>
|
||||
<citetitle>IEEE 996, A Standard for an Extended Personal Computer
|
||||
Back Plane Bus</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_65468"
|
||||
xreflabel="PCI Local Bus specification"/>
|
||||
<citetitle>PCI Local Bus Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_60429"
|
||||
xreflabel="PCI-to-PCI Bridge Architecture specification"/>
|
||||
<citetitle>PCI-to-PCI Bridge Architecture Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the
|
||||
PCI SIG website for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_87046"
|
||||
xreflabel="PCI Standard Hot-Plug Controller and Subsystem specification"/>
|
||||
<citetitle>PCI Standard Hot-Plug Controller and Subsystem
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_26550"
|
||||
xreflabel="PCI-X Protocol addendum"/>
|
||||
<citetitle>PCI-X Protocol Addendum to the PCI Local Bus Specification </citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI-X related components or platforms. See the PCI SIG website for the most
|
||||
current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_66784"
|
||||
xreflabel="PCI Express Base specification"/>
|
||||
<citetitle>PCI Express Base Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design PCI Express related components or platforms. See the PCI SIG website for
|
||||
the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_28381"
|
||||
xreflabel="PCI Express to PCI/PCI-X Bridge specification"/>
|
||||
<citetitle>PCI Express to PCI/PCI-X Bridge Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express related components or platforms. See the PCI SIG website for the most current
|
||||
version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_34114"
|
||||
xreflabel="System Management BIOS reference"/>
|
||||
<citetitle>System Management BIOS (SMBIOS) Reference
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<!-- TODO: Are the following 3 items needed? -->
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><!-- anchor xml:id="dbdoclet.50569387_72648" xreflabel=""/ --><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_16481"
|
||||
xreflabel="RS/6000 Product Topology Data System and Product Development guide"/>
|
||||
<citetitle>IBM RS/6000® Division, Product Topology Data System,
|
||||
Product Development Guide</citetitle></para>
|
||||
<para>Version 2.1</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_94229"
|
||||
xreflabel="Single Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Single Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI Express SR-IOV related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_42471"
|
||||
xreflabel="Multi-Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Multi-Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express MR-IOV related components or platforms. See the PCI SIG website for the
|
||||
most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
</orderedlist>
|
||||
|
||||
</appendix>
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,345 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<book xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
status="draft"
|
||||
xml:id="bk_main">
|
||||
|
||||
<!-- TODO: When ready to publish document, remove the 'status="draft"' statement from the book object above. -->
|
||||
|
||||
<title>Device Tree Bindings</title>
|
||||
<subtitle>Linux on Power Architecture Reference</subtitle>
|
||||
|
||||
<info>
|
||||
<author>
|
||||
<personname>
|
||||
<surname>System Software Work Group</surname>
|
||||
</personname>
|
||||
<email>syssw-chair@openpowerfoundation.org</email>
|
||||
<affiliation>
|
||||
<orgname>OpenPOWER Foundation</orgname>
|
||||
</affiliation>
|
||||
</author>
|
||||
<copyright>
|
||||
<year>2016, 2018, 2020</year>
|
||||
<holder>OpenPOWER Foundation</holder>
|
||||
</copyright>
|
||||
<!-- TODO: Set the correct document releaseinfo -->
|
||||
<releaseinfo>Revision 0.5_pre5</releaseinfo>
|
||||
<productname>OpenPOWER</productname>
|
||||
<pubdate/>
|
||||
|
||||
<legalnotice role="apache2">
|
||||
|
||||
<annotation>
|
||||
<remark>Copyright details are filled in by the template.</remark>
|
||||
</annotation>
|
||||
</legalnotice>
|
||||
|
||||
<!-- TODO: Update the following text with the correct document description (first paragraph),
|
||||
Work Group name, and Work Product track (both in second paragraph). -->
|
||||
<abstract>
|
||||
<para>The purpose of this document is to provide firmware and software
|
||||
architectural details associated with Device Tree Bindings on OpenPOWER Systems.
|
||||
The base content for this document were contributed to the OpenPOWER Foundation in the
|
||||
<citetitle>IBM Linux on Power Architecture Platform Reference (LoPAPR) Draft</citetitle>
|
||||
document which detailed Linux running on PowerVM. While this information is not always
|
||||
immediately applicable to new OpenPOWER modes of bare metal or KVM, many of the
|
||||
concepts and interfaces remain in some form. Until such time as the document addresses
|
||||
these new OpenPOWER modes and components, it will remain versioned less than 1.0. It should
|
||||
also be noted that the original document had numerous contributors inside IBM.</para>
|
||||
|
||||
<para>This document is a Standard Track, Work Group Specification work product owned by the
|
||||
System Software Workgroup and handled in compliance with the requirements outlined in the
|
||||
<citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document. It was
|
||||
created using the <citetitle>Master Template Guide</citetitle> version 0.9.5. Comments,
|
||||
questions, etc. can be submitted to the public mailing list for this document at
|
||||
<link xlink:href="http://tbd.openpowerfoundation.org">TBD</link>.</para>
|
||||
</abstract>
|
||||
|
||||
<revhistory>
|
||||
<!-- TODO: Update as new revisions created -->
|
||||
<revision>
|
||||
<date>2020-04-06</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for VNIC failover support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>ibm,current-associativity-domain property</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>HPT resizing option - KVM only</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Coherent Platform Facilities (CAPI)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add 'OCC online/offline' events to 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>LPM Redundancy Phase II: Redundancy</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add optional sub-queue support to VFC on P9 and newer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Virtual Serial Multiplex adapter interfaces</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Maximum size of Dispatch Trace Log Buffer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Continued Extension of H_Send_Logical_LAN for large send packets</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPM Capablity keyword to RTAS AIX Support system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Protection and Encryption State system parameters</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional, post PAPR 2.9 ACRs as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reserve a range of hcalls to to support Ultravisor</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Updates to support vTPM 2.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update XIVE Legacy hcalls to add H_Function</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Secure Erase Command system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend Firmware Assisted Dump for ISA Version 3.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Document already-implemented NVRAM variables</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2019-01-08</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre4 - Update document type to Work Group Note. Final review ready.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2018-07-30</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre3 - Updates to documentation in preparation for System SW WG review:</para>
|
||||
<orderedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reset document version to 0.5</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Improved Abstract</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2017-10-11</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre2 - Updates to include latest PAPR ACRs (2.8) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>ISA 2.07 privileged doorbell extensions (9/16/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>POWER ISA Name Change Category Vector.XOR to Vector.CRYPTO (11/4/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Enable Multiple Redirected RDMA mappings per page (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Block Invalidate Option (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Implementation Dependent Optimizations (3/13/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>System Firmware Service Entitlement Date (Warranty Date) Check (4/3/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Function for ibm,change-msi to specify 32 bit MSI (5/14/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Remove Client-Architecture-Support bit for UUID option (4/16/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>AddClient Architecture Support bit for RTAS ibm,change-msi (5/28/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add VNIC Server (5/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>VPA changes for P8 (EBB) (5/24/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add an hcall to clean up the entire MMU hashtable (11/20/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPCR[ILE] support to H_SET_MODE (5/31/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Root Node Properties (1/12/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extended Firmware Assisted Dump for P8 Registers (1/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Sufficient H_COP_OP output buffer (6/21/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_SEND_LOGICAL_LAN for large send packets (6/29/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_GET_MPP_X reporting coalesced pages (8/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,pcie-link-speed-stats property to support PCIe 3.0 link speeds (6/12/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend ibm,get-system-parameters RTAS to report Energy Management Tuning Parameters (3/18/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameters related to mgmt of FW Service Entitlement Warranty period (6/22/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameter to read LPAR Name string (10/7/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Redesign of properties for DRC information and dynamic memory (7/23/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add additional logical loction code sections (3/4/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add ibm,vnic-client-mac to support vNIC failover (2/29/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>hcall for registering the process table (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New device tree property for UUID (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Changes for Hotplug RTAS Events (10/24/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Support 64-bit PE TCEs in ibm,query-pe-dma-window (7/14/2016)</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2016-05-04</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre1 - initial conversion from IBM document. Extracted from
|
||||
Linux on Power Architecture Platform Reference (LoPAPR) version 1.1 dated March 24,
|
||||
2016 -- Appendix B (LoPAPR Binding) and Appendix C (PA Processor Binding).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
</revhistory>
|
||||
</info>
|
||||
|
||||
<!-- The ch_preface.xml file is required by all documents -->
|
||||
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>
|
||||
<xi:include href="../common/ch_LoPAR_preface.xml"/>
|
||||
|
||||
<!-- Chapter heading files -->
|
||||
<xi:include href="ch_introduction.xml"/>
|
||||
<xi:include href="ch_devtree_terms.xml"/>
|
||||
<xi:include href="ch_devtree_system.xml"/>
|
||||
<xi:include href="ch_devtree_pa.xml"/>
|
||||
|
||||
|
||||
<!-- Document specific appendices -->
|
||||
<xi:include href="app_bibliography.xml"/>
|
||||
<xi:include href="app_glossary.xml"/>
|
||||
|
||||
<!-- The app_foundation.xml appendix file is required by all documents. -->
|
||||
<xi:include href="../../Docs-Master/common/app_foundation.xml"/>
|
||||
|
||||
<xi:include href="../common/app_EOD.xml"/>
|
||||
|
||||
</book>
|
||||
@ -1,97 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<chapter xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
xml:id="ch_introduction">
|
||||
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>This document specifies the application of OF to an LoPAR System,
|
||||
including requirements and practices to support unique hardware and
|
||||
firmware specific to the platform implementation. The core requirements and
|
||||
practices specified by OF must be augmented by system-specific requirements
|
||||
to form a complete specification for the firmware implementation of an
|
||||
LoPAR System. This appendix establishes such additional requirements
|
||||
pertaining to the platform and the support required by OF.</para>
|
||||
|
||||
<para>This document also specifies the application of OF to a PA Processor
|
||||
(which covers all PowerPC processors and their successors), including
|
||||
requirements and practices to support unique firmware specific to a PA
|
||||
Processor. The core requirements and practices specified by OF must be
|
||||
augmented by processor-specific requirements to form a complete
|
||||
specification for the firmware implementation for a PA processor.
|
||||
<xref linkend="dbdoclet.50569374_59715" />
|
||||
establishes such additional requirements pertaining to the
|
||||
processor and the support required by OF.</para>
|
||||
|
||||
<para>This document further specifies the application of
|
||||
<emphasis>IEEE Std 1275-1994 Standard for Boot (Initialization,
|
||||
Configuration) Firmware, Core Practices and Requirements</emphasis>,
|
||||
<emphasis>Core Errata, IEEE P1275.7</emphasis> and appropriate OF Standards
|
||||
for LoPAR computer systems, including practices for client program
|
||||
interface and data formats.</para>
|
||||
|
||||
<section>
|
||||
<title>General Requirements</title>
|
||||
<para>An OF implementation for an LoPAR platform shall implement the
|
||||
core requirements as defined in
|
||||
<xref linkend="dbdoclet.50569387_45524" />, core errata
|
||||
<xref linkend="dbdoclet.50569387_14175" />, the PA Processor-specific
|
||||
extensions described in
|
||||
<xref linkend="dbdoclet.50569374_59715" />, other appropriate bindings
|
||||
and/or recommended practices contained in the references (see
|
||||
<xref linkend="dbdoclet.50569387_27251" />), and the LoPAR Binding
|
||||
specific extensions described in this appendix.</para>
|
||||
<para>In addition, an OF implementation for an LoPAR platform shall
|
||||
implement the
|
||||
<emphasis>Device Interface</emphasis>,
|
||||
<emphasis>Client Interface</emphasis> and
|
||||
<emphasis>User Interface</emphasis> as defined in
|
||||
<xref linkend="dbdoclet.50569387_45524" />.</para>
|
||||
<para>Some LoPAR Binding property names exceed the OF Base specification
|
||||
limit of 31 characters. LoPAR OF implementations shall support property
|
||||
names of at least 47 characters.</para>
|
||||
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Processor Architecture Requirements</title>
|
||||
|
||||
<para><xref linkend="dbdoclet.50569374_59715" /> specifies the application of
|
||||
<emphasis>
|
||||
<xref linkend="dbdoclet.50569387_45524" />
|
||||
</emphasis> to computer systems that use the PA instruction set, including
|
||||
instruction-set-specific requirements and practices for debugging, client
|
||||
program interface and data formats. An implementation of OF for PA shall
|
||||
implement the core requirements as defined in
|
||||
<xref linkend="dbdoclet.50569387_45524" />and the PA-specific extensions
|
||||
described in this binding.</para>
|
||||
<para>This appendix addresses
|
||||
<xref linkend="dbdoclet.50569387_99718" />. The descriptions that follow,
|
||||
and the relevant sections describing translation features for this binding,
|
||||
assume that the system’s PA processor(s) implement the entire PA
|
||||
(that is, all books of
|
||||
<xref linkend="dbdoclet.50569387_99718" />). Some processors may implement
|
||||
different Book II-III features; such processors may need a variant of this
|
||||
binding describing the differences to the mapping functions, etc.</para>
|
||||
|
||||
</section>
|
||||
|
||||
</chapter>
|
||||
@ -1,148 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||
<parent>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
<artifactId>workgroup-pom</artifactId>
|
||||
<version>1.0.0-SNAPSHOT</version>
|
||||
<relativePath>../pom.xml</relativePath>
|
||||
</parent>
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
|
||||
<!-- TODO: Rename the artifactID field to some appropriate for your new document -->
|
||||
<artifactId>LoPAR-DeviceTree</artifactId>
|
||||
|
||||
<packaging>jar</packaging>
|
||||
|
||||
<!-- TODO: Rename the name field to some appropriate for your new document -->
|
||||
<name>LoPAR-DeviceTree</name>
|
||||
|
||||
<properties>
|
||||
<!-- This is set by Jenkins according to the branch. -->
|
||||
<release.path.name></release.path.name>
|
||||
<comments.enabled>0</comments.enabled>
|
||||
</properties>
|
||||
<!-- ################################################ -->
|
||||
<!-- USE "mvn clean generate-sources" to run this POM -->
|
||||
<!-- ################################################ -->
|
||||
<build>
|
||||
<plugins>
|
||||
<plugin>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
|
||||
<artifactId>openpowerdocs-maven-plugin</artifactId>
|
||||
<!-- version set in ../pom.xml -->
|
||||
<executions>
|
||||
<execution>
|
||||
<id>generate-webhelp</id>
|
||||
<goals>
|
||||
<goal>generate-webhelp</goal>
|
||||
</goals>
|
||||
<phase>generate-sources</phase>
|
||||
<configuration>
|
||||
<!-- These parameters only apply to webhelp -->
|
||||
<enableDisqus>${comments.enabled}</enableDisqus>
|
||||
<disqusShortname>LoPAR-DeviceTree</disqusShortname>
|
||||
<enableGoogleAnalytics>1</enableGoogleAnalytics>
|
||||
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
|
||||
<generateToc>
|
||||
appendix toc,title
|
||||
article/appendix nop
|
||||
article toc,title
|
||||
book toc,title,figure,table,example,equation
|
||||
book/appendix nop
|
||||
book/chapter nop
|
||||
chapter toc,title
|
||||
chapter/section nop
|
||||
section toc
|
||||
part toc,title
|
||||
qandadiv toc
|
||||
qandaset toc
|
||||
reference toc,title
|
||||
set toc,title
|
||||
</generateToc>
|
||||
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
|
||||
<sectionAutolabel>1</sectionAutolabel>
|
||||
<tocSectionDepth>3</tocSectionDepth>
|
||||
<sectionLabelIncludesComponentLabel>1</sectionLabelIncludesComponentLabel>
|
||||
|
||||
<!-- TODO: Rename the webhelpDirname field to the new directory for new document -->
|
||||
<webhelpDirname>LoPAR_DeviceTree</webhelpDirname>
|
||||
|
||||
<!-- TODO: Rename the pdfFilenameBase field to the PDF name for new document -->
|
||||
<pdfFilenameBase>LoPAR_DeviceTree</pdfFilenameBase>
|
||||
|
||||
<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
|
||||
Consult with the Work Group Chair or a Technical Steering Committee member if you have
|
||||
questions about which value to select.
|
||||
|
||||
If no value is provided below, the document will default to "Work Group Notes".-->
|
||||
<workProduct>workgroupNotes</workProduct>
|
||||
<!-- workProduct>workgroupSpecification</workProduct -->
|
||||
<!-- workProduct>candidateStandard</workProduct -->
|
||||
<!-- workProduct>openpowerStandard</workProduct -->
|
||||
|
||||
<!-- TODO: Set the appropriate security policy for the document. For documents
|
||||
which are not "public" this will affect the document title page and
|
||||
create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
public = this document may be shared outside the
|
||||
foundation and thus this setting must be
|
||||
used only when completely sure it allowed
|
||||
foundationConfidential = this document may be shared freely with
|
||||
OpenPOWER Foundation members but may not be
|
||||
shared publicly
|
||||
workgroupConfidential = this document may only be shared within the
|
||||
work group and should not be shared with
|
||||
other Foundation members or the public
|
||||
|
||||
The appropriate starting security for a new document is "workgroupConfidential". -->
|
||||
<security>workgroupConfidential</security>
|
||||
<!-- security>foundationConfidential</security -->
|
||||
<!-- security>public</security -->
|
||||
|
||||
<!-- TODO: Set the appropriate work flow status for the document. For documents
|
||||
which are not "published" this will affect the document title page
|
||||
and create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
published = this document has completed all reviews and has
|
||||
been published
|
||||
draft = this document is actively being updated and has
|
||||
not yet been reviewed
|
||||
review = this document is presently being reviewed
|
||||
|
||||
The appropriate starting security for a new document is "draft". -->
|
||||
<!-- documentStatus>draft</documentStatus -->
|
||||
<documentStatus>review</documentStatus>
|
||||
<!-- documentStatus>publish</documentStatus -->
|
||||
|
||||
</configuration>
|
||||
</execution>
|
||||
</executions>
|
||||
<configuration>
|
||||
<!-- These parameters apply to pdf and webhelp -->
|
||||
<xincludeSupported>true</xincludeSupported>
|
||||
<sourceDirectory>.</sourceDirectory>
|
||||
<includes>
|
||||
<!-- TODO: If you desire, you may change the following filename to something more appropriate for the new document -->
|
||||
bk_main.xml
|
||||
</includes>
|
||||
|
||||
<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
|
||||
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
|
||||
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
|
||||
<includeCoverLogo>1</includeCoverLogo>
|
||||
<coverUrl>www.openpowerfoundation.org</coverUrl>
|
||||
</configuration>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</project>
|
||||
|
||||
@ -1,284 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<appendix xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
xml:id="dbdoclet.50569387_27251">
|
||||
<?dbhtml stop-chunking?>
|
||||
<title> Bibliography</title>
|
||||
<para>This section lists documents which were referenced in this specification or which provide
|
||||
additional information, and some useful information for obtaining these documents. Referenced
|
||||
documents are listed below. When any of the following standards are superseded by an approved
|
||||
revision, the revision shall apply.</para>
|
||||
<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>
|
||||
<para><citetitle>Power ISA</citetitle><anchor xml:id="dbdoclet.50569387_99718"
|
||||
xreflabel="Power ISA specification"/></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_45524"
|
||||
xreflabel="IEEE Open Firmware standard"/>
|
||||
<citetitle>IEEE 1275, IEEE Standard for Boot (Initialization Configuration) Firmware:
|
||||
Core Requirements and Practices</citetitle></para>
|
||||
<para>IEEE part number DS02683, ISBN 1-55937-426-8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_14175"
|
||||
xreflabel="IEEE Open Firmware Errata specification"/>
|
||||
<citetitle>Core Errata, IEEE P1275.7/D4</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_31707"
|
||||
xreflabel="Open Firmware TFTP extensions"/>
|
||||
<citetitle>Open Firmware Recommended Practice:OBP-TFTP
|
||||
Extension</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27008"
|
||||
xreflabel="Open Firmware Device Support Extensions specification"/>
|
||||
<citetitle>Open Firmware Recommended Practice: Device
|
||||
Support Extensions</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22451"
|
||||
xreflabel="PCI Bus Binding to Open Firmware standard"/>
|
||||
<citetitle>PCI Bus binding to: IEEE Std 1275-1994, Standard
|
||||
for Boot (Initialization, Configuration) Firmware</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_40740"
|
||||
xreflabel="Open Firmware Interrupt Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33384"
|
||||
xreflabel="Open Firmware Forth Source and FCode Image Support specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Forth Source
|
||||
and FCode Image Support</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_67880"
|
||||
xreflabel="Open Firmware Interrup Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33177"
|
||||
xreflabel="Open Firmware TFTP Booting extensions"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - TFTP Booting
|
||||
Extensions</citetitle>, Version 0.8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27351"
|
||||
xreflabel="Open Firmware Interposition specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice -
|
||||
Interposition</citetitle>, Version 0.2</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22601"
|
||||
xreflabel="MS-DOS Programmer's Reference specification"/>
|
||||
<citetitle>MS-DOS Programmer's Reference</citetitle></para>
|
||||
<para>Published by Microsoft</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_18190"
|
||||
xreflabel="Win32 Executable File Format article"/>
|
||||
<citetitle>Peering Inside the PE: A Tour of the Win32 Portable
|
||||
Executable File Format</citetitle></para>
|
||||
<para>Found in the March, 1994 issue of <citetitle> Microsoft Systems Journal</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_85757"
|
||||
xreflabel="CD-ROM Volume and File Structure standard"/>
|
||||
<citetitle> ISO-9660, Information processing -- Volume and
|
||||
file structure of CD-ROM for information interchange</citetitle></para>
|
||||
<para>Published by International Organization for Standardization</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38836"
|
||||
xreflabel="System V Application Binary Interface, PowerPC Processor supplement"/>
|
||||
<citetitle>System V Application Binary Interface, PowerPC
|
||||
Processor Supplement</citetitle></para>
|
||||
<para>By Sunsoft<citetitle></citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_11453"
|
||||
xreflabel="Standard Generalized Markup Language (SGML) standard"/>
|
||||
<citetitle>ISO Standard 8879:1986, Information Processing
|
||||
-- Text and Office Systems -- Standard Generalized Markup Language (SGML)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38891"
|
||||
xreflabel="Personal Computer Back Plane Bus standard"/>
|
||||
<citetitle>IEEE 996, A Standard for an Extended Personal Computer
|
||||
Back Plane Bus</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_65468"
|
||||
xreflabel="PCI Local Bus specification"/>
|
||||
<citetitle>PCI Local Bus Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_60429"
|
||||
xreflabel="PCI-to-PCI Bridge Architecture specification"/>
|
||||
<citetitle>PCI-to-PCI Bridge Architecture Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the
|
||||
PCI SIG website for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_87046"
|
||||
xreflabel="PCI Standard Hot-Plug Controller and Subsystem specification"/>
|
||||
<citetitle>PCI Standard Hot-Plug Controller and Subsystem
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_26550"
|
||||
xreflabel="PCI-X Protocol addendum"/>
|
||||
<citetitle>PCI-X Protocol Addendum to the PCI Local Bus Specification </citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI-X related components or platforms. See the PCI SIG website for the most
|
||||
current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_66784"
|
||||
xreflabel="PCI Express Base specification"/>
|
||||
<citetitle>PCI Express Base Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design PCI Express related components or platforms. See the PCI SIG website for
|
||||
the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_28381"
|
||||
xreflabel="PCI Express to PCI/PCI-X Bridge specification"/>
|
||||
<citetitle>PCI Express to PCI/PCI-X Bridge Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express related components or platforms. See the PCI SIG website for the most current
|
||||
version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_34114"
|
||||
xreflabel="System Management BIOS reference"/>
|
||||
<citetitle>System Management BIOS (SMBIOS) Reference
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<!-- TODO: Are the following 3 items needed? -->
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><!-- anchor xml:id="dbdoclet.50569387_72648" xreflabel=""/ --><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_16481"
|
||||
xreflabel="RS/6000 Product Topology Data System and Product Development guide"/>
|
||||
<citetitle>IBM RS/6000® Division, Product Topology Data System,
|
||||
Product Development Guide</citetitle></para>
|
||||
<para>Version 2.1</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_94229"
|
||||
xreflabel="Single Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Single Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI Express SR-IOV related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_42471"
|
||||
xreflabel="Multi-Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Multi-Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express MR-IOV related components or platforms. See the PCI SIG website for the
|
||||
most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
</orderedlist>
|
||||
|
||||
</appendix>
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,348 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<book xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
status="draft"
|
||||
xml:id="bk_main">
|
||||
|
||||
<!-- TODO: When ready to publish document, remove the 'status="draft"' statement from the book object above. -->
|
||||
|
||||
<title>Error Handling</title>
|
||||
<subtitle>Linux on Power Architecture Reference</subtitle>
|
||||
|
||||
<info>
|
||||
<author>
|
||||
<personname>
|
||||
<surname>System Software Work Group</surname>
|
||||
</personname>
|
||||
<email>syssw-chair@openpowerfoundation.org</email>
|
||||
<affiliation>
|
||||
<orgname>OpenPOWER Foundation</orgname>
|
||||
</affiliation>
|
||||
</author>
|
||||
<copyright>
|
||||
<year>2016, 2018, 2020</year>
|
||||
<holder>OpenPOWER Foundation</holder>
|
||||
</copyright>
|
||||
<!-- TODO: Set the correct document releaseinfo -->
|
||||
<releaseinfo>Revision 0.5_pre5</releaseinfo>
|
||||
<productname>OpenPOWER</productname>
|
||||
<pubdate/>
|
||||
|
||||
<legalnotice role="apache2">
|
||||
|
||||
<annotation>
|
||||
<remark>Copyright details are filled in by the template.</remark>
|
||||
</annotation>
|
||||
</legalnotice>
|
||||
|
||||
<!-- TODO: Update the mailing list information in second paragraph. -->
|
||||
<abstract>
|
||||
<para>The purpose of this document is to provide firmware and software
|
||||
architectural details associated with Error Recovery and Logging on OpenPOWER Systems.
|
||||
The base content for this document were contributed to the OpenPOWER Foundation in the
|
||||
<citetitle>IBM Linux on Power Architecture Platform Reference (LoPAPR) Draft</citetitle>
|
||||
document which detailed Linux running on PowerVM. While this information is not always
|
||||
immediately applicable to new OpenPOWER modes of bare metal or KVM, many of the
|
||||
concepts and interfaces remain in some form. Until such time as the document addresses
|
||||
these new OpenPOWER modes and components, it will remain versioned less than 1.0. It should
|
||||
also be noted that the original document had numerous contributors inside IBM.</para>
|
||||
|
||||
<para>This document is a Standard Track, Work Group Specification work product owned by the
|
||||
System Software Workgroup and handled in compliance with the requirements outlined in the
|
||||
<citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document. It was
|
||||
created using the <citetitle>Master Template Guide</citetitle> version 0.9.5. Comments,
|
||||
questions, etc. can be submitted to the public mailing list for this document at
|
||||
<link xlink:href="http://tbd.openpowerfoundation.org">TBD</link>.</para>
|
||||
</abstract>
|
||||
|
||||
<revhistory>
|
||||
<!-- TODO: Update as new revisions created -->
|
||||
<revision>
|
||||
<date>2020-04-06</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for VNIC failover support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>ibm,current-associativity-domain property</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>HPT resizing option - KVM only</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Coherent Platform Facilities (CAPI)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add 'OCC online/offline' events to 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>LPM Redundancy Phase II: Redundancy</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add optional sub-queue support to VFC on P9 and newer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Virtual Serial Multiplex adapter interfaces</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Maximum size of Dispatch Trace Log Buffer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Continued Extension of H_Send_Logical_LAN for large send packets</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPM Capablity keyword to RTAS AIX Support system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Protection and Encryption State system parameters</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional, post PAPR 2.9 ACRs as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reserve a range of hcalls to to support Ultravisor</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Updates to support vTPM 2.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update XIVE Legacy hcalls to add H_Function</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Secure Erase Command system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend Firmware Assisted Dump for ISA Version 3.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Document already-implemented NVRAM variables</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2019-01-08</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre4 - Update document type to Work Group Note. Final review ready.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2018-07-30</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre3 - Updates to documentation in preparation for System SW WG review:</para>
|
||||
<orderedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reset document version to 0.5</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Improved Abstract</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2017-10-11</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre2 - Updates to include latest PAPR ACRs (2.8) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>ISA 2.07 privileged doorbell extensions (9/16/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>POWER ISA Name Change Category Vector.XOR to Vector.CRYPTO (11/4/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Enable Multiple Redirected RDMA mappings per page (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Block Invalidate Option (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Implementation Dependent Optimizations (3/13/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>System Firmware Service Entitlement Date (Warranty Date) Check (4/3/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Function for ibm,change-msi to specify 32 bit MSI (5/14/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Remove Client-Architecture-Support bit for UUID option (4/16/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>AddClient Architecture Support bit for RTAS ibm,change-msi (5/28/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add VNIC Server (5/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>VPA changes for P8 (EBB) (5/24/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add an hcall to clean up the entire MMU hashtable (11/20/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPCR[ILE] support to H_SET_MODE (5/31/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Root Node Properties (1/12/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extended Firmware Assisted Dump for P8 Registers (1/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Sufficient H_COP_OP output buffer (6/21/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_SEND_LOGICAL_LAN for large send packets (6/29/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_GET_MPP_X reporting coalesced pages (8/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,pcie-link-speed-stats property to support PCIe 3.0 link speeds (6/12/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend ibm,get-system-parameters RTAS to report Energy Management Tuning Parameters (3/18/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameters related to mgmt of FW Service Entitlement Warranty period (6/22/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameter to read LPAR Name string (10/7/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Redesign of properties for DRC information and dynamic memory (7/23/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add additional logical loction code sections (3/4/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add ibm,vnic-client-mac to support vNIC failover (2/29/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>hcall for registering the process table (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New device tree property for UUID (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Changes for Hotplug RTAS Events (10/24/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Support 64-bit PE TCEs in ibm,query-pe-dma-window (7/14/2016)</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2016-05-04</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre1 - initial conversion from IBM document. Extracted from
|
||||
Linux on Power Architecture Platform Reference (LoPAPR) version 1.1 dated March 24,
|
||||
2016 -- Section 7.3.3 ([RTAS] Error and Event Reporting), Chapter 10 (Error and
|
||||
Event Notification), Sections 1-3 of Chapter 16 (Service Indicators), and
|
||||
Appendix L (When to use: Fault vs. Error Log Indicators).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
</revhistory>
|
||||
</info>
|
||||
|
||||
<!-- The ch_preface.xml file is required by all documents -->
|
||||
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>
|
||||
<xi:include href="../common/ch_LoPAR_preface.xml"/>
|
||||
|
||||
<!-- Chapter heading files -->
|
||||
<xi:include href="ch_notifications.xml"/>
|
||||
<xi:include href="ch_rtas_error_classes.xml"/>
|
||||
<xi:include href="ch_rtas_error_reporting.xml"/>
|
||||
<xi:include href="ch_error_codes.xml"/>
|
||||
|
||||
<!-- Document specific appendices -->
|
||||
<xi:include href="app_service_indicators.xml"/>
|
||||
<xi:include href="app_fault_v_errorlog.xml"/>
|
||||
<xi:include href="app_capi_error_handling.xml"/>
|
||||
<xi:include href="app_bibliography.xml"/>
|
||||
<xi:include href="app_glossary.xml"/>
|
||||
|
||||
<!-- The app_foundation.xml appendix file is required by all documents. -->
|
||||
<xi:include href="../../Docs-Master/common/app_foundation.xml"/>
|
||||
|
||||
<xi:include href="../common/app_EOD.xml"/>
|
||||
|
||||
</book>
|
||||
@ -1,148 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||
<parent>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
<artifactId>workgroup-pom</artifactId>
|
||||
<version>1.0.0-SNAPSHOT</version>
|
||||
<relativePath>../pom.xml</relativePath>
|
||||
</parent>
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
|
||||
<!-- TODO: Rename the artifactID field to some appropriate for your new document -->
|
||||
<artifactId>LoPAR-Error</artifactId>
|
||||
|
||||
<packaging>jar</packaging>
|
||||
|
||||
<!-- TODO: Rename the name field to some appropriate for your new document -->
|
||||
<name>LoPAR-Error</name>
|
||||
|
||||
<properties>
|
||||
<!-- This is set by Jenkins according to the branch. -->
|
||||
<release.path.name></release.path.name>
|
||||
<comments.enabled>0</comments.enabled>
|
||||
</properties>
|
||||
<!-- ################################################ -->
|
||||
<!-- USE "mvn clean generate-sources" to run this POM -->
|
||||
<!-- ################################################ -->
|
||||
<build>
|
||||
<plugins>
|
||||
<plugin>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
|
||||
<artifactId>openpowerdocs-maven-plugin</artifactId>
|
||||
<!-- version set in ../pom.xml -->
|
||||
<executions>
|
||||
<execution>
|
||||
<id>generate-webhelp</id>
|
||||
<goals>
|
||||
<goal>generate-webhelp</goal>
|
||||
</goals>
|
||||
<phase>generate-sources</phase>
|
||||
<configuration>
|
||||
<!-- These parameters only apply to webhelp -->
|
||||
<enableDisqus>${comments.enabled}</enableDisqus>
|
||||
<disqusShortname>LoPAR-Error</disqusShortname>
|
||||
<enableGoogleAnalytics>1</enableGoogleAnalytics>
|
||||
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
|
||||
<generateToc>
|
||||
appendix toc,title
|
||||
article/appendix nop
|
||||
article toc,title
|
||||
book toc,title,figure,table,example,equation
|
||||
book/appendix nop
|
||||
book/chapter nop
|
||||
chapter toc,title
|
||||
chapter/section nop
|
||||
section toc
|
||||
part toc,title
|
||||
qandadiv toc
|
||||
qandaset toc
|
||||
reference toc,title
|
||||
set toc,title
|
||||
</generateToc>
|
||||
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
|
||||
<sectionAutolabel>1</sectionAutolabel>
|
||||
<tocSectionDepth>3</tocSectionDepth>
|
||||
<sectionLabelIncludesComponentLabel>1</sectionLabelIncludesComponentLabel>
|
||||
|
||||
<!-- TODO: Rename the webhelpDirname field to the new directory for new document -->
|
||||
<webhelpDirname>LoPAR_Error_Handling</webhelpDirname>
|
||||
|
||||
<!-- TODO: Rename the pdfFilenameBase field to the PDF name for new document -->
|
||||
<pdfFilenameBase>LoPAR_Error_Handling</pdfFilenameBase>
|
||||
|
||||
<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
|
||||
Consult with the Work Group Chair or a Technical Steering Committee member if you have
|
||||
questions about which value to select.
|
||||
|
||||
If no value is provided below, the document will default to "Work Group Notes".-->
|
||||
<workProduct>workgroupNotes</workProduct>
|
||||
<!-- workProduct>workgroupSpecification</workProduct -->
|
||||
<!-- workProduct>candidateStandard</workProduct -->
|
||||
<!-- workProduct>openpowerStandard</workProduct -->
|
||||
|
||||
<!-- TODO: Set the appropriate security policy for the document. For documents
|
||||
which are not "public" this will affect the document title page and
|
||||
create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
public = this document may be shared outside the
|
||||
foundation and thus this setting must be
|
||||
used only when completely sure it allowed
|
||||
foundationConfidential = this document may be shared freely with
|
||||
OpenPOWER Foundation members but may not be
|
||||
shared publicly
|
||||
workgroupConfidential = this document may only be shared within the
|
||||
work group and should not be shared with
|
||||
other Foundation members or the public
|
||||
|
||||
The appropriate starting security for a new document is "workgroupConfidential". -->
|
||||
<security>workgroupConfidential</security>
|
||||
<!-- security>foundationConfidential</security -->
|
||||
<!-- security>public</security -->
|
||||
|
||||
<!-- TODO: Set the appropriate work flow status for the document. For documents
|
||||
which are not "published" this will affect the document title page
|
||||
and create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
published = this document has completed all reviews and has
|
||||
been published
|
||||
draft = this document is actively being updated and has
|
||||
not yet been reviewed
|
||||
review = this document is presently being reviewed
|
||||
|
||||
The appropriate starting security for a new document is "draft". -->
|
||||
<!-- documentStatus>draft</documentStatus -->
|
||||
<documentStatus>review</documentStatus>
|
||||
<!-- documentStatus>publish</documentStatus -->
|
||||
|
||||
</configuration>
|
||||
</execution>
|
||||
</executions>
|
||||
<configuration>
|
||||
<!-- These parameters apply to pdf and webhelp -->
|
||||
<xincludeSupported>true</xincludeSupported>
|
||||
<sourceDirectory>.</sourceDirectory>
|
||||
<includes>
|
||||
<!-- TODO: If you desire, you may change the following filename to something more appropriate for the new document -->
|
||||
bk_main.xml
|
||||
</includes>
|
||||
|
||||
<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
|
||||
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
|
||||
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
|
||||
<includeCoverLogo>1</includeCoverLogo>
|
||||
<coverUrl>www.openpowerfoundation.org</coverUrl>
|
||||
</configuration>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</project>
|
||||
|
||||
@ -1,87 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<section xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
xml:id="dbdoclet.50569332_16852">
|
||||
|
||||
<title>Error and Event Reporting</title>
|
||||
|
||||
<para>The error and event reporting RTAS calls are designed to provide an
|
||||
abstract interface into hardware registers in the system that may contain
|
||||
correctable or non-correctable errors and to provide an abstract interface
|
||||
to certain platform events that may be of interest to the OS. Such errors
|
||||
and events may be detected either by a periodic scan or by an exception trap.
|
||||
</para>
|
||||
|
||||
<para>These functions are not intended to replace the normal error handling
|
||||
in the OS. Rather, they enhance the OS’s abilities by providing an
|
||||
abstract interface to check for, report, and recover from errors or events
|
||||
on the platform that are not necessarily known to the OS. </para>
|
||||
|
||||
<para>The OS uses the error and event RTAS calls in two distinct ways:</para>
|
||||
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
|
||||
<para>Periodically, the OS calls <emphasis> event-scan</emphasis>
|
||||
<anchor xml:id="dbdoclet.50569332_marker-7330" xreflabel="event-scan"/> to have
|
||||
the system firmware check for any errors or events that have occurred. </para>
|
||||
|
||||
</listitem>
|
||||
<listitem>
|
||||
|
||||
<para>Whenever the OS receives an interrupt or exception that it cannot
|
||||
fully process, it calls <emphasis> check-exception.</emphasis></para>
|
||||
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
|
||||
<para>The first case covers all errors and events that do not signal their
|
||||
occurrence with an interrupt or exception. The second case covers those
|
||||
errors and events that do signal with an interrupt or exception. It is
|
||||
platform dependent whether any specific error or event causes an interrupt
|
||||
on that platform.</para>
|
||||
|
||||
<variablelist>
|
||||
|
||||
<varlistentry>
|
||||
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569332_16852"
|
||||
xrefstyle="select: labelnumber nopage"/>-1.</emphasis></term>
|
||||
<listitem>
|
||||
<para>RTAS must return the event generated by a
|
||||
particular interrupt or event source by either
|
||||
<emphasis> check-exception</emphasis> or <emphasis> event-scan</emphasis>,
|
||||
but not both.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><emphasis role="bold">R1-<xref linkend="dbdoclet.50569332_16852"
|
||||
xrefstyle="select: labelnumber nopage"/>-2.</emphasis></term>
|
||||
<listitem>
|
||||
<para><emphasis> check-exception </emphasis>
|
||||
and <emphasis> event-scan</emphasis> , on a 64-bit capable platform, must
|
||||
be able to handle platform resources that are accessed using 64-bit
|
||||
addresses when instantiated in 32-bit mode. </para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
</variablelist>
|
||||
</section>
|
||||
@ -1,357 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<book xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
status="draft"
|
||||
xml:id="bk_main">
|
||||
|
||||
<!-- TODO: When ready to publish document, remove the 'status="draft"' statement from the book object above. -->
|
||||
|
||||
<title>Platform</title>
|
||||
<subtitle>Linux on Power Architecture Reference</subtitle>
|
||||
|
||||
<info>
|
||||
<author>
|
||||
<personname>
|
||||
<surname>System Software Work Group</surname>
|
||||
</personname>
|
||||
<email>syssw-chair@openpowerfoundation.org</email>
|
||||
<affiliation>
|
||||
<orgname>OpenPOWER Foundation</orgname>
|
||||
</affiliation>
|
||||
</author>
|
||||
<copyright>
|
||||
<year>2016, 2018, 2020</year>
|
||||
<holder>OpenPOWER Foundation</holder>
|
||||
</copyright>
|
||||
<!-- TODO: Set the correct document releaseinfo -->
|
||||
<releaseinfo>Revision 0.5_pre5</releaseinfo>
|
||||
<productname>OpenPOWER</productname>
|
||||
<pubdate/>
|
||||
|
||||
<legalnotice role="apache2">
|
||||
|
||||
<annotation>
|
||||
<remark>Copyright details are filled in by the template.</remark>
|
||||
</annotation>
|
||||
</legalnotice>
|
||||
|
||||
<!-- TODO: Update the following text with the correct document description (first paragraph),
|
||||
Work Group name, and Work Product track (both in second paragraph). -->
|
||||
<abstract>
|
||||
<para>The purpose of this document is to provide firmware and software
|
||||
architectural details for the base Platform hardware associated with an OpenPOWER Systems.
|
||||
The base content for this document were contributed to the OpenPOWER Foundation in the
|
||||
<citetitle>IBM Linux on Power Architecture Platform Reference (LoPAPR) Draft</citetitle>
|
||||
document which detailed Linux running on PowerVM. While this information is not always
|
||||
immediately applicable to new OpenPOWER modes of bare metal or KVM, many of the
|
||||
concepts and interfaces remain in some form. Until such time as the document addresses
|
||||
these new OpenPOWER modes and components, it will remain versioned less than 1.0. It should
|
||||
also be noted that the original document had numerous contributors inside IBM.</para>
|
||||
|
||||
<para>This document is a Standard Track, Work Group Specification work product owned by the
|
||||
System Software Workgroup and handled in compliance with the requirements outlined in the
|
||||
<citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document. It was
|
||||
created using the <citetitle>Master Template Guide</citetitle> version 0.9.5. Comments,
|
||||
questions, etc. can be submitted to the public mailing list for this document at
|
||||
<link xlink:href="http://tbd.openpowerfoundation.org">TBD</link>.</para>
|
||||
</abstract>
|
||||
|
||||
<revhistory>
|
||||
<!-- TODO: Update as new revisions created -->
|
||||
<revision>
|
||||
<date>2020-04-06</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for VNIC failover support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>ibm,current-associativity-domain property</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>HPT resizing option - KVM only</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Coherent Platform Facilities (CAPI)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add 'OCC online/offline' events to 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>LPM Redundancy Phase II: Redundancy</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add optional sub-queue support to VFC on P9 and newer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Virtual Serial Multiplex adapter interfaces</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Maximum size of Dispatch Trace Log Buffer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Continued Extension of H_Send_Logical_LAN for large send packets</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPM Capablity keyword to RTAS AIX Support system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Protection and Encryption State system parameters</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional, post PAPR 2.9 ACRs as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reserve a range of hcalls to to support Ultravisor</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Updates to support vTPM 2.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update XIVE Legacy hcalls to add H_Function</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Secure Erase Command system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend Firmware Assisted Dump for ISA Version 3.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Document already-implemented NVRAM variables</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2019-01-08</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre4 - Update document type to Work Group Note. Final review ready.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2018-07-30</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre3 - Updates to documentation in preparation for System SW WG review:</para>
|
||||
<orderedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reset document version to 0.5</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Improved Abstract</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2017-10-11</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre2 - Updates to include latest PAPR ACRs (2.8) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>ISA 2.07 privileged doorbell extensions (9/16/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>POWER ISA Name Change Category Vector.XOR to Vector.CRYPTO (11/4/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Enable Multiple Redirected RDMA mappings per page (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Block Invalidate Option (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Implementation Dependent Optimizations (3/13/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>System Firmware Service Entitlement Date (Warranty Date) Check (4/3/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Function for ibm,change-msi to specify 32 bit MSI (5/14/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Remove Client-Architecture-Support bit for UUID option (4/16/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>AddClient Architecture Support bit for RTAS ibm,change-msi (5/28/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add VNIC Server (5/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>VPA changes for P8 (EBB) (5/24/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add an hcall to clean up the entire MMU hashtable (11/20/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPCR[ILE] support to H_SET_MODE (5/31/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Root Node Properties (1/12/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extended Firmware Assisted Dump for P8 Registers (1/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Sufficient H_COP_OP output buffer (6/21/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_SEND_LOGICAL_LAN for large send packets (6/29/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_GET_MPP_X reporting coalesced pages (8/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,pcie-link-speed-stats property to support PCIe 3.0 link speeds (6/12/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend ibm,get-system-parameters RTAS to report Energy Management Tuning Parameters (3/18/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameters related to mgmt of FW Service Entitlement Warranty period (6/22/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameter to read LPAR Name string (10/7/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Redesign of properties for DRC information and dynamic memory (7/23/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add additional logical loction code sections (3/4/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add ibm,vnic-client-mac to support vNIC failover (2/29/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>hcall for registering the process table (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New device tree property for UUID (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Changes for Hotplug RTAS Events (10/24/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Support 64-bit PE TCEs in ibm,query-pe-dma-window (7/14/2016)</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2016-05-04</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre1 - initial conversion from IBM document. Extracted from
|
||||
Linux on Power Architecture Platform Reference (LoPAPR) version 1.1 dated March 24,
|
||||
2016 -- Chapter 1 (Introduction), Chapter 2 (System Requirements),
|
||||
Chapter 3 (Address Map), Chapter 4 (I/O Bridges and Topology),
|
||||
Chapter 5 (Processors and Memory), Chapter 6 (Interrupt Controller),
|
||||
Chapter 8 (Non-volatile memory), Chapter 9 (I/O Devices),
|
||||
Chapter 11 (The Symmetric Multiprocessor Option), Chapter 12 (Product Topology),
|
||||
and Appendix H (Non-Uniform Memory Access [NUMA] Option).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
</revhistory>
|
||||
</info>
|
||||
|
||||
<!-- The ch_preface.xml file is required by all documents -->
|
||||
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>
|
||||
<xi:include href="../common/ch_LoPAR_preface.xml"/>
|
||||
|
||||
<!-- Chapter heading files -->
|
||||
<xi:include href="ch_platform_intro.xml"/>
|
||||
<xi:include href="ch_system_reqs.xml"/>
|
||||
<xi:include href="ch_address_map.xml"/>
|
||||
<xi:include href="ch_processors_memory.xml"/>
|
||||
<xi:include href="ch_interrupt_controller.xml"/>
|
||||
<xi:include href="ch_nonvolatile_memory.xml"/>
|
||||
<xi:include href="ch_smp.xml"/>
|
||||
<xi:include href="ch_numa.xml"/>
|
||||
<xi:include href="ch_io_topology.xml"/>
|
||||
<xi:include href="ch_io_devices.xml"/>
|
||||
<xi:include href="ch_product_topology.xml"/>
|
||||
|
||||
<!-- Document specific appendices -->
|
||||
<xi:include href="app_eeh_handling.xml"/>
|
||||
<xi:include href="app_bibliography.xml"/>
|
||||
<xi:include href="app_glossary.xml"/>
|
||||
|
||||
<!-- The app_foundation.xml appendix file is required by all documents. -->
|
||||
<xi:include href="../../Docs-Master/common/app_foundation.xml"/>
|
||||
|
||||
<xi:include href="../common/app_EOD.xml"/>
|
||||
|
||||
</book>
|
||||
@ -1,148 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||
<parent>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
<artifactId>workgroup-pom</artifactId>
|
||||
<version>1.0.0-SNAPSHOT</version>
|
||||
<relativePath>../pom.xml</relativePath>
|
||||
</parent>
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
|
||||
<!-- TODO: Rename the artifactID field to some appropriate for your new document -->
|
||||
<artifactId>LoPAR-Platform</artifactId>
|
||||
|
||||
<packaging>jar</packaging>
|
||||
|
||||
<!-- TODO: Rename the name field to some appropriate for your new document -->
|
||||
<name>LoPAR-Platform</name>
|
||||
|
||||
<properties>
|
||||
<!-- This is set by Jenkins according to the branch. -->
|
||||
<release.path.name></release.path.name>
|
||||
<comments.enabled>0</comments.enabled>
|
||||
</properties>
|
||||
<!-- ################################################ -->
|
||||
<!-- USE "mvn clean generate-sources" to run this POM -->
|
||||
<!-- ################################################ -->
|
||||
<build>
|
||||
<plugins>
|
||||
<plugin>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
|
||||
<artifactId>openpowerdocs-maven-plugin</artifactId>
|
||||
<!-- version set in ../pom.xml -->
|
||||
<executions>
|
||||
<execution>
|
||||
<id>generate-webhelp</id>
|
||||
<goals>
|
||||
<goal>generate-webhelp</goal>
|
||||
</goals>
|
||||
<phase>generate-sources</phase>
|
||||
<configuration>
|
||||
<!-- These parameters only apply to webhelp -->
|
||||
<enableDisqus>${comments.enabled}</enableDisqus>
|
||||
<disqusShortname>LoPAR-Platform</disqusShortname>
|
||||
<enableGoogleAnalytics>1</enableGoogleAnalytics>
|
||||
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
|
||||
<generateToc>
|
||||
appendix toc,title
|
||||
article/appendix nop
|
||||
article toc,title
|
||||
book toc,title,figure,table,example,equation
|
||||
book/appendix nop
|
||||
book/chapter nop
|
||||
chapter toc,title
|
||||
chapter/section nop
|
||||
section toc
|
||||
part toc,title
|
||||
qandadiv toc
|
||||
qandaset toc
|
||||
reference toc,title
|
||||
set toc,title
|
||||
</generateToc>
|
||||
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
|
||||
<sectionAutolabel>1</sectionAutolabel>
|
||||
<tocSectionDepth>3</tocSectionDepth>
|
||||
<sectionLabelIncludesComponentLabel>1</sectionLabelIncludesComponentLabel>
|
||||
|
||||
<!-- TODO: Rename the webhelpDirname field to the new directory for new document -->
|
||||
<webhelpDirname>LoPAR_Platform</webhelpDirname>
|
||||
|
||||
<!-- TODO: Rename the pdfFilenameBase field to the PDF name for new document -->
|
||||
<pdfFilenameBase>LoPAR_Platform</pdfFilenameBase>
|
||||
|
||||
<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
|
||||
Consult with the Work Group Chair or a Technical Steering Committee member if you have
|
||||
questions about which value to select.
|
||||
|
||||
If no value is provided below, the document will default to "Work Group Notes".-->
|
||||
<workProduct>workgroupNotes</workProduct>
|
||||
<!-- workProduct>workgroupSpecification</workProduct -->
|
||||
<!-- workProduct>candidateStandard</workProduct -->
|
||||
<!-- workProduct>openpowerStandard</workProduct -->
|
||||
|
||||
<!-- TODO: Set the appropriate security policy for the document. For documents
|
||||
which are not "public" this will affect the document title page and
|
||||
create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
public = this document may be shared outside the
|
||||
foundation and thus this setting must be
|
||||
used only when completely sure it allowed
|
||||
foundationConfidential = this document may be shared freely with
|
||||
OpenPOWER Foundation members but may not be
|
||||
shared publicly
|
||||
workgroupConfidential = this document may only be shared within the
|
||||
work group and should not be shared with
|
||||
other Foundation members or the public
|
||||
|
||||
The appropriate starting security for a new document is "workgroupConfidential". -->
|
||||
<security>workgroupConfidential</security>
|
||||
<!-- security>foundationConfidential</security -->
|
||||
<!-- security>public</security -->
|
||||
|
||||
<!-- TODO: Set the appropriate work flow status for the document. For documents
|
||||
which are not "published" this will affect the document title page
|
||||
and create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
published = this document has completed all reviews and has
|
||||
been published
|
||||
draft = this document is actively being updated and has
|
||||
not yet been reviewed
|
||||
review = this document is presently being reviewed
|
||||
|
||||
The appropriate starting security for a new document is "draft". -->
|
||||
<!-- documentStatus>draft</documentStatus -->
|
||||
<documentStatus>review</documentStatus>
|
||||
<!-- documentStatus>publish</documentStatus -->
|
||||
|
||||
</configuration>
|
||||
</execution>
|
||||
</executions>
|
||||
<configuration>
|
||||
<!-- These parameters apply to pdf and webhelp -->
|
||||
<xincludeSupported>true</xincludeSupported>
|
||||
<sourceDirectory>.</sourceDirectory>
|
||||
<includes>
|
||||
<!-- TODO: If you desire, you may change the following filename to something more appropriate for the new document -->
|
||||
bk_main.xml
|
||||
</includes>
|
||||
|
||||
<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
|
||||
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
|
||||
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
|
||||
<includeCoverLogo>1</includeCoverLogo>
|
||||
<coverUrl>www.openpowerfoundation.org</coverUrl>
|
||||
</configuration>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</project>
|
||||
|
||||
@ -1,284 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<appendix xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
xml:id="dbdoclet.50569387_27251">
|
||||
<?dbhtml stop-chunking?>
|
||||
<title> Bibliography</title>
|
||||
<para>This section lists documents which were referenced in this specification or which provide
|
||||
additional information, and some useful information for obtaining these documents. Referenced
|
||||
documents are listed below. When any of the following standards are superseded by an approved
|
||||
revision, the revision shall apply.</para>
|
||||
<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>
|
||||
<para><citetitle>Power ISA</citetitle><anchor xml:id="dbdoclet.50569387_99718"
|
||||
xreflabel="Power ISA specification"/></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_45524"
|
||||
xreflabel="IEEE Open Firmware standard"/>
|
||||
<citetitle>IEEE 1275, IEEE Standard for Boot (Initialization Configuration) Firmware:
|
||||
Core Requirements and Practices</citetitle></para>
|
||||
<para>IEEE part number DS02683, ISBN 1-55937-426-8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_14175"
|
||||
xreflabel="IEEE Open Firmware Errata specification"/>
|
||||
<citetitle>Core Errata, IEEE P1275.7/D4</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_31707"
|
||||
xreflabel="Open Firmware TFTP extensions"/>
|
||||
<citetitle>Open Firmware Recommended Practice:OBP-TFTP
|
||||
Extension</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27008"
|
||||
xreflabel="Open Firmware Device Support Extensions specification"/>
|
||||
<citetitle>Open Firmware Recommended Practice: Device
|
||||
Support Extensions</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22451"
|
||||
xreflabel="PCI Bus Binding to Open Firmware standard"/>
|
||||
<citetitle>PCI Bus binding to: IEEE Std 1275-1994, Standard
|
||||
for Boot (Initialization, Configuration) Firmware</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_40740"
|
||||
xreflabel="Open Firmware Interrupt Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33384"
|
||||
xreflabel="Open Firmware Forth Source and FCode Image Support specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Forth Source
|
||||
and FCode Image Support</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_67880"
|
||||
xreflabel="Open Firmware Interrup Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33177"
|
||||
xreflabel="Open Firmware TFTP Booting extensions"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - TFTP Booting
|
||||
Extensions</citetitle>, Version 0.8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27351"
|
||||
xreflabel="Open Firmware Interposition specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice -
|
||||
Interposition</citetitle>, Version 0.2</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22601"
|
||||
xreflabel="MS-DOS Programmer's Reference specification"/>
|
||||
<citetitle>MS-DOS Programmer's Reference</citetitle></para>
|
||||
<para>Published by Microsoft</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_18190"
|
||||
xreflabel="Win32 Executable File Format article"/>
|
||||
<citetitle>Peering Inside the PE: A Tour of the Win32 Portable
|
||||
Executable File Format</citetitle></para>
|
||||
<para>Found in the March, 1994 issue of <citetitle> Microsoft Systems Journal</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_85757"
|
||||
xreflabel="CD-ROM Volume and File Structure standard"/>
|
||||
<citetitle> ISO-9660, Information processing -- Volume and
|
||||
file structure of CD-ROM for information interchange</citetitle></para>
|
||||
<para>Published by International Organization for Standardization</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38836"
|
||||
xreflabel="System V Application Binary Interface, PowerPC Processor supplement"/>
|
||||
<citetitle>System V Application Binary Interface, PowerPC
|
||||
Processor Supplement</citetitle></para>
|
||||
<para>By Sunsoft<citetitle></citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_11453"
|
||||
xreflabel="Standard Generalized Markup Language (SGML) standard"/>
|
||||
<citetitle>ISO Standard 8879:1986, Information Processing
|
||||
-- Text and Office Systems -- Standard Generalized Markup Language (SGML)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38891"
|
||||
xreflabel="Personal Computer Back Plane Bus standard"/>
|
||||
<citetitle>IEEE 996, A Standard for an Extended Personal Computer
|
||||
Back Plane Bus</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_65468"
|
||||
xreflabel="PCI Local Bus specification"/>
|
||||
<citetitle>PCI Local Bus Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_60429"
|
||||
xreflabel="PCI-to-PCI Bridge Architecture specification"/>
|
||||
<citetitle>PCI-to-PCI Bridge Architecture Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the
|
||||
PCI SIG website for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_87046"
|
||||
xreflabel="PCI Standard Hot-Plug Controller and Subsystem specification"/>
|
||||
<citetitle>PCI Standard Hot-Plug Controller and Subsystem
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_26550"
|
||||
xreflabel="PCI-X Protocol addendum"/>
|
||||
<citetitle>PCI-X Protocol Addendum to the PCI Local Bus Specification </citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI-X related components or platforms. See the PCI SIG website for the most
|
||||
current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_66784"
|
||||
xreflabel="PCI Express Base specification"/>
|
||||
<citetitle>PCI Express Base Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design PCI Express related components or platforms. See the PCI SIG website for
|
||||
the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_28381"
|
||||
xreflabel="PCI Express to PCI/PCI-X Bridge specification"/>
|
||||
<citetitle>PCI Express to PCI/PCI-X Bridge Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express related components or platforms. See the PCI SIG website for the most current
|
||||
version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_34114"
|
||||
xreflabel="System Management BIOS reference"/>
|
||||
<citetitle>System Management BIOS (SMBIOS) Reference
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<!-- TODO: Are the following 3 items needed? -->
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><!-- anchor xml:id="dbdoclet.50569387_72648" xreflabel=""/ --><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_16481"
|
||||
xreflabel="RS/6000 Product Topology Data System and Product Development guide"/>
|
||||
<citetitle>IBM RS/6000® Division, Product Topology Data System,
|
||||
Product Development Guide</citetitle></para>
|
||||
<para>Version 2.1</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_94229"
|
||||
xreflabel="Single Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Single Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI Express SR-IOV related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_42471"
|
||||
xreflabel="Multi-Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Multi-Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express MR-IOV related components or platforms. See the PCI SIG website for the
|
||||
most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
</orderedlist>
|
||||
|
||||
</appendix>
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,347 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<book xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
status="draft"
|
||||
xml:id="bk_main">
|
||||
|
||||
<!-- TODO: When ready to publish document, remove the 'status="draft"' statement from the book object above. -->
|
||||
|
||||
<title>Runtime Abstraction Services</title>
|
||||
<subtitle>Linux on Power Architecture Reference</subtitle>
|
||||
|
||||
<info>
|
||||
<author>
|
||||
<personname>
|
||||
<surname>System Software Work Group</surname>
|
||||
</personname>
|
||||
<email>syssw-chair@openpowerfoundation.org</email>
|
||||
<affiliation>
|
||||
<orgname>OpenPOWER Foundation</orgname>
|
||||
</affiliation>
|
||||
</author>
|
||||
<copyright>
|
||||
<year>2016, 2018, 2020</year>
|
||||
<holder>OpenPOWER Foundation</holder>
|
||||
</copyright>
|
||||
<!-- TODO: Set the correct document releaseinfo -->
|
||||
<releaseinfo>Revision 0.5_pre5</releaseinfo>
|
||||
<productname>OpenPOWER</productname>
|
||||
<pubdate/>
|
||||
|
||||
<legalnotice role="apache2">
|
||||
|
||||
<annotation>
|
||||
<remark>Copyright details are filled in by the template.</remark>
|
||||
</annotation>
|
||||
</legalnotice>
|
||||
|
||||
<!-- TODO: Update the following text with the correct document description (first paragraph),
|
||||
Work Group name, and Work Product track (both in second paragraph). -->
|
||||
<abstract>
|
||||
<para>The purpose of this document is to provide firmware and software
|
||||
architectural details associated with Runtime Abstraction Services (firmware) on OpenPOWER Systems.
|
||||
The base content for this document were contributed to the OpenPOWER Foundation in the
|
||||
<citetitle>IBM Linux on Power Architecture Platform Reference (LoPAPR) Draft</citetitle>
|
||||
document which detailed Linux running on PowerVM. While this information is not always
|
||||
immediately applicable to new OpenPOWER modes of bare metal or KVM, many of the
|
||||
concepts and interfaces remain in some form. Until such time as the document addresses
|
||||
these new OpenPOWER modes and components, it will remain versioned less than 1.0. It should
|
||||
also be noted that the original document had numerous contributors inside IBM.</para>
|
||||
|
||||
<para>This document is a Standard Track, Work Group Specification work product owned by the
|
||||
System Software Workgroup and handled in compliance with the requirements outlined in the
|
||||
<citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document. It was
|
||||
created using the <citetitle>Master Template Guide</citetitle> version 0.9.5. Comments,
|
||||
questions, etc. can be submitted to the public mailing list for this document at
|
||||
<link xlink:href="http://tbd.openpowerfoundation.org">TBD</link>.</para>
|
||||
</abstract>
|
||||
|
||||
<revhistory>
|
||||
<!-- TODO: Update as new revisions created -->
|
||||
<revision>
|
||||
<date>2020-04-06</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for VNIC failover support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>ibm,current-associativity-domain property</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>HPT resizing option - KVM only</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Coherent Platform Facilities (CAPI)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add 'OCC online/offline' events to 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>LPM Redundancy Phase II: Redundancy</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add optional sub-queue support to VFC on P9 and newer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Virtual Serial Multiplex adapter interfaces</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Maximum size of Dispatch Trace Log Buffer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Continued Extension of H_Send_Logical_LAN for large send packets</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPM Capablity keyword to RTAS AIX Support system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Protection and Encryption State system parameters</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional, post PAPR 2.9 ACRs as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reserve a range of hcalls to to support Ultravisor</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Updates to support vTPM 2.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update XIVE Legacy hcalls to add H_Function</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Secure Erase Command system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend Firmware Assisted Dump for ISA Version 3.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Document already-implemented NVRAM variables</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2019-01-08</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre4 - Update document type to Work Group Note. Final review ready.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2018-07-30</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre3 - Updates to documentation in preparation for System SW WG review:</para>
|
||||
<orderedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reset document version to 0.5</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Improved Abstract</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2017-10-11</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre2 - Updates to include latest PAPR ACRs (2.8) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>ISA 2.07 privileged doorbell extensions (9/16/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>POWER ISA Name Change Category Vector.XOR to Vector.CRYPTO (11/4/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Enable Multiple Redirected RDMA mappings per page (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Block Invalidate Option (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Implementation Dependent Optimizations (3/13/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>System Firmware Service Entitlement Date (Warranty Date) Check (4/3/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Function for ibm,change-msi to specify 32 bit MSI (5/14/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Remove Client-Architecture-Support bit for UUID option (4/16/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>AddClient Architecture Support bit for RTAS ibm,change-msi (5/28/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add VNIC Server (5/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>VPA changes for P8 (EBB) (5/24/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add an hcall to clean up the entire MMU hashtable (11/20/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPCR[ILE] support to H_SET_MODE (5/31/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Root Node Properties (1/12/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extended Firmware Assisted Dump for P8 Registers (1/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Sufficient H_COP_OP output buffer (6/21/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_SEND_LOGICAL_LAN for large send packets (6/29/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_GET_MPP_X reporting coalesced pages (8/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,pcie-link-speed-stats property to support PCIe 3.0 link speeds (6/12/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend ibm,get-system-parameters RTAS to report Energy Management Tuning Parameters (3/18/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameters related to mgmt of FW Service Entitlement Warranty period (6/22/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameter to read LPAR Name string (10/7/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Redesign of properties for DRC information and dynamic memory (7/23/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add additional logical loction code sections (3/4/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add ibm,vnic-client-mac to support vNIC failover (2/29/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>hcall for registering the process table (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New device tree property for UUID (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Changes for Hotplug RTAS Events (10/24/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Support 64-bit PE TCEs in ibm,query-pe-dma-window (7/14/2016)</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2016-05-04</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre1 - initial conversion from IBM document. Extracted from
|
||||
Linux on Power Architecture Platform Reference (LoPAPR) version 1.1 dated March 24,
|
||||
2016 -- Chapter 7 (Run-time Abstration Services), Appendix G (Firmware Assisted
|
||||
Dump Data Format), and Appendix I (CMO Characteristics Definition).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
</revhistory>
|
||||
</info>
|
||||
|
||||
<!-- The ch_preface.xml file is required by all documents -->
|
||||
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>
|
||||
<xi:include href="../common/ch_LoPAR_preface.xml"/>
|
||||
|
||||
<!-- Chapter heading files -->
|
||||
<xi:include href="ch_rtas_introduction.xml"/>
|
||||
<xi:include href="ch_rtas_environment.xml"/>
|
||||
<xi:include href="ch_rtas_call_defn.xml"/>
|
||||
<xi:include href="ch_firmware_dump.xml"/>
|
||||
<xi:include href="ch_cmo_def.xml"/>
|
||||
|
||||
|
||||
<!-- Document specific appendices -->
|
||||
<xi:include href="app_bibliography.xml"/>
|
||||
<xi:include href="app_glossary.xml"/>
|
||||
|
||||
<!-- The app_foundation.xml appendix file is required by all documents. -->
|
||||
<xi:include href="../../Docs-Master/common/app_foundation.xml"/>
|
||||
|
||||
<xi:include href="../common/app_EOD.xml"/>
|
||||
|
||||
</book>
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,148 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||
<parent>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
<artifactId>workgroup-pom</artifactId>
|
||||
<version>1.0.0-SNAPSHOT</version>
|
||||
<relativePath>../pom.xml</relativePath>
|
||||
</parent>
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
|
||||
<!-- TODO: Rename the artifactID field to some appropriate for your new document -->
|
||||
<artifactId>LoPAR-RTAS</artifactId>
|
||||
|
||||
<packaging>jar</packaging>
|
||||
|
||||
<!-- TODO: Rename the name field to some appropriate for your new document -->
|
||||
<name>LoPAR-RTAS</name>
|
||||
|
||||
<properties>
|
||||
<!-- This is set by Jenkins according to the branch. -->
|
||||
<release.path.name></release.path.name>
|
||||
<comments.enabled>0</comments.enabled>
|
||||
</properties>
|
||||
<!-- ################################################ -->
|
||||
<!-- USE "mvn clean generate-sources" to run this POM -->
|
||||
<!-- ################################################ -->
|
||||
<build>
|
||||
<plugins>
|
||||
<plugin>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
|
||||
<artifactId>openpowerdocs-maven-plugin</artifactId>
|
||||
<!-- version set in ../pom.xml -->
|
||||
<executions>
|
||||
<execution>
|
||||
<id>generate-webhelp</id>
|
||||
<goals>
|
||||
<goal>generate-webhelp</goal>
|
||||
</goals>
|
||||
<phase>generate-sources</phase>
|
||||
<configuration>
|
||||
<!-- These parameters only apply to webhelp -->
|
||||
<enableDisqus>${comments.enabled}</enableDisqus>
|
||||
<disqusShortname>LoPAR-RTAS</disqusShortname>
|
||||
<enableGoogleAnalytics>1</enableGoogleAnalytics>
|
||||
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
|
||||
<generateToc>
|
||||
appendix toc,title
|
||||
article/appendix nop
|
||||
article toc,title
|
||||
book toc,title,figure,table,example,equation
|
||||
book/appendix nop
|
||||
book/chapter nop
|
||||
chapter toc,title
|
||||
chapter/section nop
|
||||
section toc
|
||||
part toc,title
|
||||
qandadiv toc
|
||||
qandaset toc
|
||||
reference toc,title
|
||||
set toc,title
|
||||
</generateToc>
|
||||
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
|
||||
<sectionAutolabel>1</sectionAutolabel>
|
||||
<tocSectionDepth>3</tocSectionDepth>
|
||||
<sectionLabelIncludesComponentLabel>1</sectionLabelIncludesComponentLabel>
|
||||
|
||||
<!-- TODO: Rename the webhelpDirname field to the new directory for new document -->
|
||||
<webhelpDirname>LoPAR_RTAS</webhelpDirname>
|
||||
|
||||
<!-- TODO: Rename the pdfFilenameBase field to the PDF name for new document -->
|
||||
<pdfFilenameBase>LoPAR_RTAS</pdfFilenameBase>
|
||||
|
||||
<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
|
||||
Consult with the Work Group Chair or a Technical Steering Committee member if you have
|
||||
questions about which value to select.
|
||||
|
||||
If no value is provided below, the document will default to "Work Group Notes".-->
|
||||
<workProduct>workgroupNotes</workProduct>
|
||||
<!-- workProduct>workgroupSpecification</workProduct -->
|
||||
<!-- workProduct>candidateStandard</workProduct -->
|
||||
<!-- workProduct>openpowerStandard</workProduct -->
|
||||
|
||||
<!-- TODO: Set the appropriate security policy for the document. For documents
|
||||
which are not "public" this will affect the document title page and
|
||||
create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
public = this document may be shared outside the
|
||||
foundation and thus this setting must be
|
||||
used only when completely sure it allowed
|
||||
foundationConfidential = this document may be shared freely with
|
||||
OpenPOWER Foundation members but may not be
|
||||
shared publicly
|
||||
workgroupConfidential = this document may only be shared within the
|
||||
work group and should not be shared with
|
||||
other Foundation members or the public
|
||||
|
||||
The appropriate starting security for a new document is "workgroupConfidential". -->
|
||||
<security>workgroupConfidential</security>
|
||||
<!-- security>foundationConfidential</security -->
|
||||
<!-- security>public</security -->
|
||||
|
||||
<!-- TODO: Set the appropriate work flow status for the document. For documents
|
||||
which are not "published" this will affect the document title page
|
||||
and create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
published = this document has completed all reviews and has
|
||||
been published
|
||||
draft = this document is actively being updated and has
|
||||
not yet been reviewed
|
||||
review = this document is presently being reviewed
|
||||
|
||||
The appropriate starting security for a new document is "draft". -->
|
||||
<!-- documentStatus>draft</documentStatus -->
|
||||
<documentStatus>review</documentStatus>
|
||||
<!-- documentStatus>publish</documentStatus -->
|
||||
|
||||
</configuration>
|
||||
</execution>
|
||||
</executions>
|
||||
<configuration>
|
||||
<!-- These parameters apply to pdf and webhelp -->
|
||||
<xincludeSupported>true</xincludeSupported>
|
||||
<sourceDirectory>.</sourceDirectory>
|
||||
<includes>
|
||||
<!-- TODO: If you desire, you may change the following filename to something more appropriate for the new document -->
|
||||
bk_main.xml
|
||||
</includes>
|
||||
|
||||
<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
|
||||
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
|
||||
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
|
||||
<includeCoverLogo>1</includeCoverLogo>
|
||||
<coverUrl>www.openpowerfoundation.org</coverUrl>
|
||||
</configuration>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</project>
|
||||
|
||||
@ -1,284 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<appendix xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
xml:id="dbdoclet.50569387_27251">
|
||||
<?dbhtml stop-chunking?>
|
||||
<title> Bibliography</title>
|
||||
<para>This section lists documents which were referenced in this specification or which provide
|
||||
additional information, and some useful information for obtaining these documents. Referenced
|
||||
documents are listed below. When any of the following standards are superseded by an approved
|
||||
revision, the revision shall apply.</para>
|
||||
<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>
|
||||
<para><citetitle>Power ISA</citetitle><anchor xml:id="dbdoclet.50569387_99718"
|
||||
xreflabel="Power ISA specification"/></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_45524"
|
||||
xreflabel="IEEE Open Firmware standard"/>
|
||||
<citetitle>IEEE 1275, IEEE Standard for Boot (Initialization Configuration) Firmware:
|
||||
Core Requirements and Practices</citetitle></para>
|
||||
<para>IEEE part number DS02683, ISBN 1-55937-426-8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_14175"
|
||||
xreflabel="IEEE Open Firmware Errata specification"/>
|
||||
<citetitle>Core Errata, IEEE P1275.7/D4</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_31707"
|
||||
xreflabel="Open Firmware TFTP extensions"/>
|
||||
<citetitle>Open Firmware Recommended Practice:OBP-TFTP
|
||||
Extension</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27008"
|
||||
xreflabel="Open Firmware Device Support Extensions specification"/>
|
||||
<citetitle>Open Firmware Recommended Practice: Device
|
||||
Support Extensions</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22451"
|
||||
xreflabel="PCI Bus Binding to Open Firmware standard"/>
|
||||
<citetitle>PCI Bus binding to: IEEE Std 1275-1994, Standard
|
||||
for Boot (Initialization, Configuration) Firmware</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_40740"
|
||||
xreflabel="Open Firmware Interrupt Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33384"
|
||||
xreflabel="Open Firmware Forth Source and FCode Image Support specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Forth Source
|
||||
and FCode Image Support</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_67880"
|
||||
xreflabel="Open Firmware Interrup Mapping specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - Interrupt
|
||||
Mapping</citetitle>, Version 1.0</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_33177"
|
||||
xreflabel="Open Firmware TFTP Booting extensions"/>
|
||||
<citetitle>Open Firmware: Recommended Practice - TFTP Booting
|
||||
Extensions</citetitle>, Version 0.8</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_27351"
|
||||
xreflabel="Open Firmware Interposition specification"/>
|
||||
<citetitle>Open Firmware: Recommended Practice -
|
||||
Interposition</citetitle>, Version 0.2</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_22601"
|
||||
xreflabel="MS-DOS Programmer's Reference specification"/>
|
||||
<citetitle>MS-DOS Programmer's Reference</citetitle></para>
|
||||
<para>Published by Microsoft</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_18190"
|
||||
xreflabel="Win32 Executable File Format article"/>
|
||||
<citetitle>Peering Inside the PE: A Tour of the Win32 Portable
|
||||
Executable File Format</citetitle></para>
|
||||
<para>Found in the March, 1994 issue of <citetitle> Microsoft Systems Journal</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_85757"
|
||||
xreflabel="CD-ROM Volume and File Structure standard"/>
|
||||
<citetitle> ISO-9660, Information processing -- Volume and
|
||||
file structure of CD-ROM for information interchange</citetitle></para>
|
||||
<para>Published by International Organization for Standardization</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38836"
|
||||
xreflabel="System V Application Binary Interface, PowerPC Processor supplement"/>
|
||||
<citetitle>System V Application Binary Interface, PowerPC
|
||||
Processor Supplement</citetitle></para>
|
||||
<para>By Sunsoft<citetitle></citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_11453"
|
||||
xreflabel="Standard Generalized Markup Language (SGML) standard"/>
|
||||
<citetitle>ISO Standard 8879:1986, Information Processing
|
||||
-- Text and Office Systems -- Standard Generalized Markup Language (SGML)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_38891"
|
||||
xreflabel="Personal Computer Back Plane Bus standard"/>
|
||||
<citetitle>IEEE 996, A Standard for an Extended Personal Computer
|
||||
Back Plane Bus</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_65468"
|
||||
xreflabel="PCI Local Bus specification"/>
|
||||
<citetitle>PCI Local Bus Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_60429"
|
||||
xreflabel="PCI-to-PCI Bridge Architecture specification"/>
|
||||
<citetitle>PCI-to-PCI Bridge Architecture Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design conventional PCI related components or platforms. See the
|
||||
PCI SIG website for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_87046"
|
||||
xreflabel="PCI Standard Hot-Plug Controller and Subsystem specification"/>
|
||||
<citetitle>PCI Standard Hot-Plug Controller and Subsystem
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_26550"
|
||||
xreflabel="PCI-X Protocol addendum"/>
|
||||
<citetitle>PCI-X Protocol Addendum to the PCI Local Bus Specification </citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI-X related components or platforms. See the PCI SIG website for the most
|
||||
current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_66784"
|
||||
xreflabel="PCI Express Base specification"/>
|
||||
<citetitle>PCI Express Base Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document
|
||||
at the time that they design PCI Express related components or platforms. See the PCI SIG website for
|
||||
the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_28381"
|
||||
xreflabel="PCI Express to PCI/PCI-X Bridge specification"/>
|
||||
<citetitle>PCI Express to PCI/PCI-X Bridge Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express related components or platforms. See the PCI SIG website for the most current
|
||||
version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_34114"
|
||||
xreflabel="System Management BIOS reference"/>
|
||||
<citetitle>System Management BIOS (SMBIOS) Reference
|
||||
Specification</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<!-- TODO: Are the following 3 items needed? -->
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><!-- anchor xml:id="dbdoclet.50569387_72648" xreflabel=""/ --><citetitle>(List Number Reserved for Compatibility)</citetitle></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_16481"
|
||||
xreflabel="RS/6000 Product Topology Data System and Product Development guide"/>
|
||||
<citetitle>IBM RS/6000® Division, Product Topology Data System,
|
||||
Product Development Guide</citetitle></para>
|
||||
<para>Version 2.1</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_94229"
|
||||
xreflabel="Single Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Single Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at
|
||||
the time that they design PCI Express SR-IOV related components or platforms. See the PCI SIG website
|
||||
for the most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><anchor xml:id="dbdoclet.50569387_42471"
|
||||
xreflabel="Multi-Root I/O Virtualization and Sharing specification"/>
|
||||
<citetitle>Multi-Root I/O Virtualization and Sharing Specification</citetitle></para>
|
||||
<para>All designers are responsible for assuring that they use the most current version of this document at the
|
||||
time that they design PCI Express MR-IOV related components or platforms. See the PCI SIG website for the
|
||||
most current version of this document.</para>
|
||||
</listitem>
|
||||
|
||||
</orderedlist>
|
||||
|
||||
</appendix>
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,349 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
Copyright (c) 2016 OpenPOWER Foundation
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
|
||||
-->
|
||||
<book xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0"
|
||||
xml:id="bk_main">
|
||||
|
||||
<title>Virtualization</title>
|
||||
<subtitle>Linux on Power Architecture Reference</subtitle>
|
||||
|
||||
<info>
|
||||
<author>
|
||||
<personname>
|
||||
<surname>System Software Work Group</surname>
|
||||
</personname>
|
||||
<email>syssw-chair@openpowerfoundation.org</email>
|
||||
<affiliation>
|
||||
<orgname>OpenPOWER Foundation</orgname>
|
||||
</affiliation>
|
||||
</author>
|
||||
<copyright>
|
||||
<year>2016, 2018, 2020</year>
|
||||
<holder>OpenPOWER Foundation</holder>
|
||||
</copyright>
|
||||
<!-- TODO: Set the correct document releaseinfo -->
|
||||
<releaseinfo>Revision 0.5_pre5</releaseinfo>
|
||||
<productname>OpenPOWER</productname>
|
||||
<pubdate/>
|
||||
|
||||
<legalnotice role="apache2">
|
||||
|
||||
<annotation>
|
||||
<remark>Copyright details are filled in by the template.</remark>
|
||||
</annotation>
|
||||
</legalnotice>
|
||||
|
||||
<abstract>
|
||||
<para>The purpose of this document is to provide firmware and software
|
||||
architectural details for the virtualization components associated with an OpenPOWER Systems.
|
||||
The base content for this document was contributed to the OpenPOWER Foundation in the
|
||||
<citetitle>IBM Linux on Power Architecture Platform Reference (LoPAPR) Draft</citetitle>
|
||||
document which detailed Linux running on PowerVM. While this information is not always
|
||||
immediately applicable to new OpenPOWER modes of bare metal or KVM, many of the
|
||||
concepts and interfaces remain in some form. Until such time as the document addresses
|
||||
these new OpenPOWER modes and components, it will remain versioned less than 1.0. It should
|
||||
also be noted that the original document had numerous contributors inside IBM.</para>
|
||||
|
||||
<para>This document is a Standard Track, Work Group Specification work product owned by the
|
||||
System Software Workgroup and handled in compliance with the requirements outlined in the
|
||||
<citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document. It was
|
||||
created using the <citetitle>Master Template Guide</citetitle> version 0.9.5. Comments,
|
||||
questions, etc. can be submitted to the public mailing list for this document at
|
||||
<link xlink:href="http://tbd.openpowerfoundation.org">TBD</link>.</para>
|
||||
</abstract>
|
||||
|
||||
<revhistory>
|
||||
<!-- TODO: Update as new revisions created -->
|
||||
<revision>
|
||||
<date>2020-04-06</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for VNIC failover support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>ibm,current-associativity-domain property</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>HPT resizing option - KVM only</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Coherent Platform Facilities (CAPI)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add 'OCC online/offline' events to 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>LPM Redundancy Phase II: Redundancy</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add optional sub-queue support to VFC on P9 and newer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Virtual Serial Multiplex adapter interfaces</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Maximum size of Dispatch Trace Log Buffer</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Continued Extension of H_Send_Logical_LAN for large send packets</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPM Capablity keyword to RTAS AIX Support system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Protection and Encryption State system parameters</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional, post PAPR 2.9 ACRs as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reserve a range of hcalls to to support Ultravisor</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Updates to support vTPM 2.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update XIVE Legacy hcalls to add H_Function</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add NVDIMM Secure Erase Command system parameter</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend Firmware Assisted Dump for ISA Version 3.0</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Document already-implemented NVRAM variables</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2019-01-08</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre4 - Update document type to Work Group Note. Final review ready.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2018-07-30</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 0.5_pre3 - Updates to documentation in preparation for System SW WG review:</para>
|
||||
<orderedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Reset document version to 0.5</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Improved Abstract</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2017-10-11</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre2 - Updates to include latest PAPR ACRs (2.8) as follows:</para>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>ISA 2.07 privileged doorbell extensions (9/16/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>POWER ISA Name Change Category Vector.XOR to Vector.CRYPTO (11/4/2012)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Enable Multiple Redirected RDMA mappings per page (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add Block Invalidate Option (3/5/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Implementation Dependent Optimizations (3/13/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>System Firmware Service Entitlement Date (Warranty Date) Check (4/3/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Function for ibm,change-msi to specify 32 bit MSI (5/14/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Remove Client-Architecture-Support bit for UUID option (4/16/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>AddClient Architecture Support bit for RTAS ibm,change-msi (5/28/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add VNIC Server (5/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>VPA changes for P8 (EBB) (5/24/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add an hcall to clean up the entire MMU hashtable (11/20/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add LPCR[ILE] support to H_SET_MODE (5/31/2013)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New Root Node Properties (1/12/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extended Firmware Assisted Dump for P8 Registers (1/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Sufficient H_COP_OP output buffer (6/21/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_SEND_LOGICAL_LAN for large send packets (6/29/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend H_GET_MPP_X reporting coalesced pages (8/24/2014)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update ibm,pcie-link-speed-stats property to support PCIe 3.0 link speeds (6/12/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Extend ibm,get-system-parameters RTAS to report Energy Management Tuning Parameters (3/18/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameters related to mgmt of FW Service Entitlement Warranty period (6/22/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Additional System Parameter to read LPAR Name string (10/7/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Redesign of properties for DRC information and dynamic memory (7/23/2015)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add additional logical loction code sections (3/4/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add ibm,vnic-client-mac to support vNIC failover (2/29/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>hcall for registering the process table (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>New device tree property for UUID (3/21/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Changes for Hotplug RTAS Events (10/24/2016)</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Support 64-bit PE TCEs in ibm,query-pe-dma-window (7/14/2016)</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2017-05-18</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revision 2.0_pre1 - initial conversion from IBM document. Extracted from
|
||||
Linux on Power Architecture Platform Reference (LoPAPR) version 1.1 dated March 24,
|
||||
2016 -- Chapter 14 (Logical Partitioning Option), Chapter 13 (Dynamic Reconfiguration
|
||||
Option), Chapter 17 (Virtualized Input/Output), Appendix A (SPLPAR Characteristics
|
||||
Definitions), Appendix D (A Protocol for a Virtual TTY Interface), Appendix E
|
||||
(A Protocol for VSCSI Communications), Appendix F (A Protocol for VMC Communications),
|
||||
Appendix J (Platform Dependent hcalls), and Appendix K (A Protocol for VNIC Communications)</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
</revhistory>
|
||||
</info>
|
||||
|
||||
<!-- The ch_preface.xml file is required by all documents -->
|
||||
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>
|
||||
<xi:include href="../common/ch_LoPAR_preface.xml"/>
|
||||
|
||||
<!-- Chapter heading files -->
|
||||
<xi:include href="ch_lpar_option.xml"/>
|
||||
<xi:include href="ch_platform_hcalls.xml"/>
|
||||
<xi:include href="ch_splpar.xml"/>
|
||||
<xi:include href="ch_dynamic_reconfig.xml"/>
|
||||
<xi:include href="ch_virtual_io.xml"/>
|
||||
<xi:include href="ch_virtual_tty.xml"/>
|
||||
<xi:include href="ch_virtual_scsi.xml"/>
|
||||
<xi:include href="ch_virtual_nic.xml"/>
|
||||
<xi:include href="ch_virtual_tpm.xml"/>
|
||||
<xi:include href="ch_vmc_comm.xml"/>
|
||||
|
||||
<!-- Document specific appendices -->
|
||||
<xi:include href="app_bibliography.xml"/>
|
||||
<xi:include href="app_glossary.xml"/>
|
||||
|
||||
<!-- The app_foundation.xml appendix file is required by all documents. -->
|
||||
<xi:include href="../../Docs-Master/common/app_foundation.xml"/>
|
||||
|
||||
<xi:include href="../common/app_EOD.xml"/>
|
||||
|
||||
</book>
|
||||
@ -1,148 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||
<parent>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
<artifactId>workgroup-pom</artifactId>
|
||||
<version>1.0.0-SNAPSHOT</version>
|
||||
<relativePath>../pom.xml</relativePath>
|
||||
</parent>
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
|
||||
<!-- TODO: Rename the artifactID field to some appropriate for your new document -->
|
||||
<artifactId>LoPAR-Virtualization</artifactId>
|
||||
|
||||
<packaging>jar</packaging>
|
||||
|
||||
<!-- TODO: Rename the name field to some appropriate for your new document -->
|
||||
<name>LoPAR-Virtualization</name>
|
||||
|
||||
<properties>
|
||||
<!-- This is set by Jenkins according to the branch. -->
|
||||
<release.path.name></release.path.name>
|
||||
<comments.enabled>0</comments.enabled>
|
||||
</properties>
|
||||
<!-- ################################################ -->
|
||||
<!-- USE "mvn clean generate-sources" to run this POM -->
|
||||
<!-- ################################################ -->
|
||||
<build>
|
||||
<plugins>
|
||||
<plugin>
|
||||
|
||||
<groupId>org.openpowerfoundation.docs</groupId>
|
||||
|
||||
<artifactId>openpowerdocs-maven-plugin</artifactId>
|
||||
<!-- version set in ../pom.xml -->
|
||||
<executions>
|
||||
<execution>
|
||||
<id>generate-webhelp</id>
|
||||
<goals>
|
||||
<goal>generate-webhelp</goal>
|
||||
</goals>
|
||||
<phase>generate-sources</phase>
|
||||
<configuration>
|
||||
<!-- These parameters only apply to webhelp -->
|
||||
<enableDisqus>${comments.enabled}</enableDisqus>
|
||||
<disqusShortname>LoPAR-Virtualization</disqusShortname>
|
||||
<enableGoogleAnalytics>1</enableGoogleAnalytics>
|
||||
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
|
||||
<generateToc>
|
||||
appendix toc,title
|
||||
article/appendix nop
|
||||
article toc,title
|
||||
book toc,title,figure,table,example,equation
|
||||
book/appendix nop
|
||||
book/chapter nop
|
||||
chapter toc,title
|
||||
chapter/section nop
|
||||
section toc
|
||||
part toc,title
|
||||
qandadiv toc
|
||||
qandaset toc
|
||||
reference toc,title
|
||||
set toc,title
|
||||
</generateToc>
|
||||
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
|
||||
<sectionAutolabel>1</sectionAutolabel>
|
||||
<tocSectionDepth>3</tocSectionDepth>
|
||||
<sectionLabelIncludesComponentLabel>1</sectionLabelIncludesComponentLabel>
|
||||
|
||||
<!-- TODO: Rename the webhelpDirname field to the new directory for new document -->
|
||||
<webhelpDirname>LoPAR_Virtualization</webhelpDirname>
|
||||
|
||||
<!-- TODO: Rename the pdfFilenameBase field to the PDF name for new document -->
|
||||
<pdfFilenameBase>LoPAR_Virtualization</pdfFilenameBase>
|
||||
|
||||
<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
|
||||
Consult with the Work Group Chair or a Technical Steering Committee member if you have
|
||||
questions about which value to select.
|
||||
|
||||
If no value is provided below, the document will default to "Work Group Notes".-->
|
||||
<workProduct>workgroupNotes</workProduct>
|
||||
<!-- workProduct>workgroupSpecification</workProduct -->
|
||||
<!-- workProduct>candidateStandard</workProduct -->
|
||||
<!-- workProduct>openpowerStandard</workProduct -->
|
||||
|
||||
<!-- TODO: Set the appropriate security policy for the document. For documents
|
||||
which are not "public" this will affect the document title page and
|
||||
create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
public = this document may be shared outside the
|
||||
foundation and thus this setting must be
|
||||
used only when completely sure it allowed
|
||||
foundationConfidential = this document may be shared freely with
|
||||
OpenPOWER Foundation members but may not be
|
||||
shared publicly
|
||||
workgroupConfidential = this document may only be shared within the
|
||||
work group and should not be shared with
|
||||
other Foundation members or the public
|
||||
|
||||
The appropriate starting security for a new document is "workgroupConfidential". -->
|
||||
<security>workgroupConfidential</security>
|
||||
<!-- security>foundationConfidential</security -->
|
||||
<!-- security>public</security -->
|
||||
|
||||
<!-- TODO: Set the appropriate work flow status for the document. For documents
|
||||
which are not "published" this will affect the document title page
|
||||
and create a vertical running ribbon on the internal margin of the
|
||||
security status in all CAPS. Values and definitions are formally
|
||||
defined by the IPR policy. A layman's definition follows:
|
||||
|
||||
published = this document has completed all reviews and has
|
||||
been published
|
||||
draft = this document is actively being updated and has
|
||||
not yet been reviewed
|
||||
review = this document is presently being reviewed
|
||||
|
||||
The appropriate starting security for a new document is "draft". -->
|
||||
<!-- documentStatus>draft</documentStatus -->
|
||||
<documentStatus>review</documentStatus>
|
||||
<!-- documentStatus>publish</documentStatus -->
|
||||
|
||||
</configuration>
|
||||
</execution>
|
||||
</executions>
|
||||
<configuration>
|
||||
<!-- These parameters apply to pdf and webhelp -->
|
||||
<xincludeSupported>true</xincludeSupported>
|
||||
<sourceDirectory>.</sourceDirectory>
|
||||
<includes>
|
||||
<!-- TODO: If you desire, you may change the following filename to something more appropriate for the new document -->
|
||||
bk_main.xml
|
||||
</includes>
|
||||
|
||||
<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
|
||||
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
|
||||
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
|
||||
<includeCoverLogo>1</includeCoverLogo>
|
||||
<coverUrl>www.openpowerfoundation.org</coverUrl>
|
||||
</configuration>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</project>
|
||||
|
||||
Loading…
Reference in New Issue