diff --git a/DeviceTree/bk_main.xml b/DeviceTree/bk_main.xml index 5685527..443f0a5 100644 --- a/DeviceTree/bk_main.xml +++ b/DeviceTree/bk_main.xml @@ -1,7 +1,7 @@ - 2016 + 2016, 2018, 2020 OpenPOWER Foundation - Revision 0.5_pre4 + Revision 0.5_pre5 OpenPOWER @@ -52,7 +52,7 @@ Copyright details are filled in by the template. - + @@ -63,19 +63,123 @@ 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 + 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. - + 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 OpenPOWER Foundation Work Group (WG) Process document. It was created using the Master Template Guide version 0.9.5. Comments, - questions, etc. can be submitted to the public mailing list for this document at + questions, etc. can be submitted to the public mailing list for this document at TBD. + + 2020-04-06 + + + + Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows: + + + Add H_VIOCTL subfunctions for VNIC failover support + + + Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality + + + Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality + + + ibm,current-associativity-domain property + + + HPT resizing option - KVM only + + + Add Coherent Platform Facilities (CAPI) + + + XIVE Exploitation + + + Add 'OCC online/offline' events to 'IE' error log subsection + + + LPM Redundancy Phase II: Redundancy + + + Add optional sub-queue support to VFC on P9 and newer + + + Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128 + + + Add Virtual Serial Multiplex adapter interfaces + + + Maximum size of Dispatch Trace Log Buffer + + + Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation + + + Continued Extension of H_Send_Logical_LAN for large send packets + + + Add LPM Capablity keyword to RTAS AIX Support system parameter + + + XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2 + + + Add NVDIMM Protection and Encryption State system parameters + + + Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection + + + + + Additional, post PAPR 2.9 ACRs as follows: + + + Reserve a range of hcalls to to support Ultravisor + + + Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support + + + Updates to support vTPM 2.0 + + + Update XIVE Legacy hcalls to add H_Function + + + Add NVDIMM Secure Erase Command system parameter + + + Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer. + + + Extend Firmware Assisted Dump for ISA Version 3.0 + + + Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call + + + Document already-implemented NVRAM variables + + + Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag + + + + + + 2019-01-08 diff --git a/Error Handling/bk_main.xml b/Error Handling/bk_main.xml index 6d0582e..1e16af6 100644 --- a/Error Handling/bk_main.xml +++ b/Error Handling/bk_main.xml @@ -1,7 +1,7 @@ - 2016 + 2016, 2018, 2020 OpenPOWER Foundation - Revision 0.5_pre4 + Revision 0.5_pre5 OpenPOWER @@ -52,7 +52,7 @@ Copyright details are filled in by the template. - + The purpose of this document is to provide firmware and software @@ -62,19 +62,123 @@ 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 + 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. - + 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 OpenPOWER Foundation Work Group (WG) Process document. It was created using the Master Template Guide version 0.9.5. Comments, - questions, etc. can be submitted to the public mailing list for this document at + questions, etc. can be submitted to the public mailing list for this document at TBD. + + 2020-04-06 + + + + Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows: + + + Add H_VIOCTL subfunctions for VNIC failover support + + + Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality + + + Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality + + + ibm,current-associativity-domain property + + + HPT resizing option - KVM only + + + Add Coherent Platform Facilities (CAPI) + + + XIVE Exploitation + + + Add 'OCC online/offline' events to 'IE' error log subsection + + + LPM Redundancy Phase II: Redundancy + + + Add optional sub-queue support to VFC on P9 and newer + + + Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128 + + + Add Virtual Serial Multiplex adapter interfaces + + + Maximum size of Dispatch Trace Log Buffer + + + Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation + + + Continued Extension of H_Send_Logical_LAN for large send packets + + + Add LPM Capablity keyword to RTAS AIX Support system parameter + + + XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2 + + + Add NVDIMM Protection and Encryption State system parameters + + + Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection + + + + + Additional, post PAPR 2.9 ACRs as follows: + + + Reserve a range of hcalls to to support Ultravisor + + + Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support + + + Updates to support vTPM 2.0 + + + Update XIVE Legacy hcalls to add H_Function + + + Add NVDIMM Secure Erase Command system parameter + + + Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer. + + + Extend Firmware Assisted Dump for ISA Version 3.0 + + + Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call + + + Document already-implemented NVRAM variables + + + Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag + + + + + + 2019-01-08 @@ -210,7 +314,7 @@ 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 + Event Notification), Sections 1-3 of Chapter 16 (Service Indicators), and Appendix L (When to use: Fault vs. Error Log Indicators). diff --git a/Platform/bk_main.xml b/Platform/bk_main.xml index 96ba359..7a1aa88 100644 --- a/Platform/bk_main.xml +++ b/Platform/bk_main.xml @@ -1,7 +1,7 @@ - 2016 + 2016, 2018, 2020 OpenPOWER Foundation - Revision 0.5_pre4 + Revision 0.5_pre5 OpenPOWER @@ -52,7 +52,7 @@ Copyright details are filled in by the template. - + @@ -63,19 +63,123 @@ 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 + 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. - + 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 OpenPOWER Foundation Work Group (WG) Process document. It was created using the Master Template Guide version 0.9.5. Comments, - questions, etc. can be submitted to the public mailing list for this document at + questions, etc. can be submitted to the public mailing list for this document at TBD. + + 2020-04-06 + + + + Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows: + + + Add H_VIOCTL subfunctions for VNIC failover support + + + Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality + + + Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality + + + ibm,current-associativity-domain property + + + HPT resizing option - KVM only + + + Add Coherent Platform Facilities (CAPI) + + + XIVE Exploitation + + + Add 'OCC online/offline' events to 'IE' error log subsection + + + LPM Redundancy Phase II: Redundancy + + + Add optional sub-queue support to VFC on P9 and newer + + + Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128 + + + Add Virtual Serial Multiplex adapter interfaces + + + Maximum size of Dispatch Trace Log Buffer + + + Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation + + + Continued Extension of H_Send_Logical_LAN for large send packets + + + Add LPM Capablity keyword to RTAS AIX Support system parameter + + + XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2 + + + Add NVDIMM Protection and Encryption State system parameters + + + Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection + + + + + Additional, post PAPR 2.9 ACRs as follows: + + + Reserve a range of hcalls to to support Ultravisor + + + Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support + + + Updates to support vTPM 2.0 + + + Update XIVE Legacy hcalls to add H_Function + + + Add NVDIMM Secure Erase Command system parameter + + + Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer. + + + Extend Firmware Assisted Dump for ISA Version 3.0 + + + Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call + + + Document already-implemented NVRAM variables + + + Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag + + + + + + 2019-01-08 diff --git a/RTAS/bk_main.xml b/RTAS/bk_main.xml index e008adc..6ea6b0a 100644 --- a/RTAS/bk_main.xml +++ b/RTAS/bk_main.xml @@ -1,7 +1,7 @@ - 2016 + 2016, 2018, 2020 OpenPOWER Foundation - Revision 0.5_pre4 + Revision 0.5_pre5 OpenPOWER @@ -52,7 +52,7 @@ Copyright details are filled in by the template. - + @@ -63,19 +63,123 @@ 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 + 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. - + 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 OpenPOWER Foundation Work Group (WG) Process document. It was created using the Master Template Guide version 0.9.5. Comments, - questions, etc. can be submitted to the public mailing list for this document at + questions, etc. can be submitted to the public mailing list for this document at TBD. + + 2020-04-06 + + + + Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows: + + + Add H_VIOCTL subfunctions for VNIC failover support + + + Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality + + + Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality + + + ibm,current-associativity-domain property + + + HPT resizing option - KVM only + + + Add Coherent Platform Facilities (CAPI) + + + XIVE Exploitation + + + Add 'OCC online/offline' events to 'IE' error log subsection + + + LPM Redundancy Phase II: Redundancy + + + Add optional sub-queue support to VFC on P9 and newer + + + Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128 + + + Add Virtual Serial Multiplex adapter interfaces + + + Maximum size of Dispatch Trace Log Buffer + + + Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation + + + Continued Extension of H_Send_Logical_LAN for large send packets + + + Add LPM Capablity keyword to RTAS AIX Support system parameter + + + XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2 + + + Add NVDIMM Protection and Encryption State system parameters + + + Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection + + + + + Additional, post PAPR 2.9 ACRs as follows: + + + Reserve a range of hcalls to to support Ultravisor + + + Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support + + + Updates to support vTPM 2.0 + + + Update XIVE Legacy hcalls to add H_Function + + + Add NVDIMM Secure Erase Command system parameter + + + Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer. + + + Extend Firmware Assisted Dump for ISA Version 3.0 + + + Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call + + + Document already-implemented NVRAM variables + + + Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag + + + + + + 2019-01-08 diff --git a/Virtualization/bk_main.xml b/Virtualization/bk_main.xml index 001e459..78063cd 100644 --- a/Virtualization/bk_main.xml +++ b/Virtualization/bk_main.xml @@ -1,7 +1,7 @@ - 2016 + 2016, 2018, 2020 OpenPOWER Foundation - Revision 0.5_pre4 + Revision 0.5_pre5 OpenPOWER @@ -49,7 +49,7 @@ Copyright details are filled in by the template. - + The purpose of this document is to provide firmware and software architectural details for the virtualization components associated with an OpenPOWER Systems. @@ -58,19 +58,123 @@ 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 + 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. - + 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 OpenPOWER Foundation Work Group (WG) Process document. It was created using the Master Template Guide version 0.9.5. Comments, - questions, etc. can be submitted to the public mailing list for this document at + questions, etc. can be submitted to the public mailing list for this document at TBD. + + 2020-04-06 + + + + Revision 0.5_pre5 - Updates to include latest PAPR ACRs (2.9) as follows: + + + Add H_VIOCTL subfunctions for VNIC failover support + + + Add H_VIOCTL subfunction for virtual ethernet MAC scan functionality + + + Add H_VIOCTL subfunctions for virtual scsi and FC mobility preparation functionality + + + ibm,current-associativity-domain property + + + HPT resizing option - KVM only + + + Add Coherent Platform Facilities (CAPI) + + + XIVE Exploitation + + + Add 'OCC online/offline' events to 'IE' error log subsection + + + LPM Redundancy Phase II: Redundancy + + + Add optional sub-queue support to VFC on P9 and newer + + + Increase max num-entries for H_SEND_SUB_CRQ_INDIRECT to 128 + + + Add Virtual Serial Multiplex adapter interfaces + + + Maximum size of Dispatch Trace Log Buffer + + + Eliminate requirement for clearing TCP checksum field for ILLAN checksum calculation + + + Continued Extension of H_Send_Logical_LAN for large send packets + + + Add LPM Capablity keyword to RTAS AIX Support system parameter + + + XIVE Exploitation addition: Add ESB Reset Status to RTAS ibm,read-slot-reset-state2 + + + Add NVDIMM Protection and Encryption State system parameters + + + Change or Remove 0x9 and 0xA event subtypes for 'IE' error log subsection + + + + + Additional, post PAPR 2.9 ACRs as follows: + + + Reserve a range of hcalls to to support Ultravisor + + + Add New CAS Bit For SRIOV Virtual Function (VF) Dynamic DMA Window (DDW) Support + + + Updates to support vTPM 2.0 + + + Update XIVE Legacy hcalls to add H_Function + + + Add NVDIMM Secure Erase Command system parameter + + + Update H_REGISTER_VPA to add H_STATE return code for VPA and SLB shadow buffer. + + + Extend Firmware Assisted Dump for ISA Version 3.0 + + + Add a new return code, H_NOT_AVAILABLE, to start-cpu rtas call + + + Document already-implemented NVRAM variables + + + Update ibm,dynamic-memory-vN flags to include a "Hotplugged Memory" flag + + + + + + 2019-01-08 @@ -206,7 +310,7 @@ 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 + 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)