|
|
|
|
<?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>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</year>
|
|
|
|
|
<holder>OpenPOWER Foundation</holder>
|
|
|
|
|
</copyright>
|
|
|
|
|
<!-- TODO: Set the correct document releaseinfo -->
|
|
|
|
|
<releaseinfo>Revision 2.0_pre2</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. It 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>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_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>
|
